SDK .NET

Los primeros pasos con el SDK .NET en Play: instalación, conexión, lectura de la zona de pruebas, generador de WriteOperations y regeneración de MyDinaup.

Desarrollo → Conectar → SDK .NET es la guía de inicio para integrar Dinaup en aplicaciones .NET (CLI, APIs, Blazor y servicios Windows) con clases tipadas e IntelliSense para cada sección de tu empresa. La pantalla muestra cuatro pasos con código ya rellenado con tu endpoint y tu clave, abre el generador de WriteOperations y regenera tu biblioteca MyDinaup.

La referencia del SDK, con sus módulos y su cliente, está en SDK .NET.

Antes de empezar

La aplicación Desarrollo en la licencia y el interruptor Desarrollador en tu usuario. Ver Desarrollo.
Una clave API activa. Sin ella, la pantalla abre con el aviso Necesitas una clave API: si eres administrador, el botón Crear clave API lleva a Administración → Claves API; si no, el aviso dice que las emite un administrador de tu empresa. Ver Claves API.

1. Instalación

La tarjeta 1. Instalación da el comando para añadir el paquete NuGet al proyecto:

dotnet add package Dinaup

2. Configuración

La tarjeta 2. Configuración muestra el código C# que conecta con tu empresa con DinaupClientC.ConnectAsync: el endpoint, que es el servidor de tu licencia (https://<clave de conexión>.dinaup.io), y las dos partes de una clave API, la pública y la secreta. Si la empresa tiene alguna clave, el ejemplo lleva la pública de la primera y la tarjeta lo indica. La secreta no sale en pantalla: el ejemplo lleva TU_CLAVE_SECRETA, y la real está en la ficha de la clave, en Claves API. Sin ninguna clave, la pública es TU_API_KEY.

3. Leer datos

La tarjeta 3. Leer datos muestra una llamada a GetRowsAsync sobre la Zona de pruebas de tu licencia, con el filtro eliminado = false, y recorre las filas escribiendo su texto principal. Funciona sin modificar nada. Los IDs de tus secciones y campos están en Esquema.

4. Escribir datos

La tarjeta 4. Escribir datos abre, con Abrir WriteOperation Builder, el generador de código de escritura con los campos tipados de tu empresa.

WriteOperation Builder

Elige la sección

En Sección, pulsa la caja y elige la sección en la ventana Elegir la sección sobre la que se escribe. Salen las secciones de datos; no las plantillas base ni las tablas de líneas. Hasta entonces la ventana dice Selecciona una sección para comenzar.

Con la sección elegida, la tarjeta muestra cuántos campos tiene, la etiqueta Con lista si tiene tabla de líneas, y el Section ID con un botón para copiarlo.

Elige los campos

En Campos, marca los campos en Principales y, si hay lista, en Lista. Cada uno muestra su etiqueta, su nombre interno y el icono de su formato. Todos marca todos los de su bloque; Limpiar vacía la selección. La tarjeta cuenta los seleccionados.

Solo salen los campos que admiten escritura desde el generador. Hasta que marcas alguno, el panel de código dice Selecciona campos a la izquierda para generar el código.

Copia el código

Código generado tiene tres pestañas: C#, JavaScript y Python. Copiar pone en el portapapeles la pestaña activa.

C# crea una WriteOperation con Guid.Empty (registro nuevo; con el Guid de un registro existente lo edita), añade cada campo a DataMainRow y, si hay lista, una fila a DataListRows, y ejecuta RunWriteOperationAsync con el ID de la sección.
JavaScript y Python montan el cuerpo JSON (Main y List cuando hay lista) y hacen el POST a https://<clave de conexión>.dinaup.io/api/WriteOperations?sectionId=<id>&fieldPrimary=id&scripts=false con la cabecera Authorization: Bearer.

Cada campo va comentado con su etiqueta y su formato; los valores quedan vacíos para que los rellenes.

Si la sección que acabas de crear no aparece, la ventana avisa: Esa sección no está en el esquema. El esquema se guarda 24 horas.

5. Tu biblioteca MyDinaup

La tarjeta 5. Tu biblioteca MyDinaup regenera MyDinaup, la biblioteca con las clases tipadas de tus secciones e informes. La ve cualquiera con acceso a Desarrollo.

Pulsa Regenerar MyDinaup y confirma con Regenerar. El servidor de tu licencia genera de nuevo la biblioteca y la sube a su repositorio de GitHub. Tarda varios minutos. Mientras tanto, el botón dice Regenerando… y la tarjeta pide que no cierres la pantalla.

Aviso	Qué significa
MyDinaup regenerado	La biblioteca ya está en su repositorio. Falta publicar el paquete: los pasos están en MyDinaup.
No se ha podido regenerar MyDinaup	El cuerpo del aviso da el motivo. Por ejemplo, que la licencia no tiene un repositorio configurado.

Después

Los formatos de los valores (fechas, decimales, booleanos) están en Inicio.
Las primeras escrituras, en la Zona de pruebas.
Las consultas con agregados sin crear un informe, con IAQuery.

En esta página