- Primeros pasos
- Instalación y configuración
- Uso de Data Service
- Referencia
- Ejemplos y Tutoriales
Guía de usuario del servicio de datos
Uso de entidades en los proyectos
Al utilizar entidades creadas en Data Service, puedes gestionar y manipular los datos agregados en un único objeto, sin tener que trabajar con ellos de forma granular. Para ello, necesitas Studio v2020.8 o posterior.
El siguiente ejemplo recupera los datos sobre los Juegos Olímpicos y las medallas de los 10 primeros países para cada categoría de juegos, junto con las medallas que ganaron.
Siguiendo los pasos detallados en la página Creación de una entidad, creamos una entidad para almacenar información sobre las naciones participantes, las fechas de apertura y cierre, y las medallas que ganaron.
La entidad Olimpiadas tiene los siguientes campos: Nombre, Naciones, Fechas de apertura y cierre. La entidad Medallas tiene los siguientes campos: País, Oro, Plata, Bronce y el número total de medallas. Las dos entidades están vinculadas entre sí con la etiqueta Relación.
Importa la entidad dentro de tu flujo de trabajo en Studio.
El siguiente flujo de trabajo extrae información sobre una edición de Olimpiadas determinada, asigna los datos a los argumentos y los pasa a través del flujo de trabajo principal.
Para ello, definimos un argumento para cada tipo de información que estamos recopilando, resultando en 5 argumentos importados.
Con el uso de entidades, solo debemos importar y trabajar con dos argumentos para recopilar los datos.
inOlympics Year y outOlympics a sus respectivas propiedades, las mismas que los campos definidos en la entidad. Al utilizar las entidades, se reduce el número de argumentos necesarios para transferir la información mediante la asignación adecuada de datos a sus campos de entidad respectivos.
Una vez recopilados los datos, puedes utilizar la actividad Crear registro de entidad para añadir la información a Data Service.
En este ejemplo, utilizamos los argumentos importados para pasar la información recopilada a Data Service. Los registros de entrada y salida son los valores de las variables de tipo Olimpiadas utilizadas para transmitir los datos.
Después de ejecutar el proyecto, se creó el siguiente registro en Data Service:
Los registros estructurados en una tabla de datos pueden pasarse a Data Service utilizando la actividad Para cada fila . En este ejemplo, estamos invocando un flujo de trabajo que recopila datos estructurados sobre el número de medallas ganadas por cada país y pasa estos registros a Data Service.
Después de ejecutar el flujo de trabajo, los siguientes datos se almacenan en Data Service:
La relación establecida entre las entidades Olimpiadas y Medallas nos permite utilizar el registro de datos de una en la otra. Por ejemplo, el valor del campo Olimpiadas dentro de la entidad Medallas es el mismo que en la entidad relacionada.
La actividad Consultar registros de entidad se puede utilizar para obtener una lista de registros de Data Service. En el siguiente ejemplo, utilizamos la actividad para consultar los registros de datos de la entidad Olimpiadas , permitir al usuario elegir una edición de las Olimpiadas y, desde la entidad Medallas , escribir el número de medallas que ganó cada país participante.
Name != NULL del Generador de Consultas. Esto recorre todos los registros de la columna Nombre y los vuelca en la variable listOlympics que se utilizará en la actividad Diálogo de entrada.
listOlympics.Select(Function (o as Olympics) o.Name).ToArray en la actividad Introducir diálogo. Alternativamente, se puede utilizar la actividad Para cada (For Each).
selectedOlympics y se utiliza en otra actividad Consultar registros de entidad para recorrer la lista de medallas ganadas en esa edición específica. Esta condición se estableció utilizando la opción equals en el Generador de consultas.
La consulta puede ser realizada en la entidad seleccionada, y en los registros de entidades relacionadas también.
Los servicios de datos pueden almacenar potencialmente un gran número de registros. Para consultar solo un número determinado de registros, utilice las propiedades de Paginación de la actividad Consulta de registros de entidades. La propiedad Superior admite un número máximo de 1.000, esto significa que se pueden consultar 1.000 registros a la vez.
Este ejemplo consulta los primeros cinco registros, y luego los siguientes cinco registros hasta tomar los últimos registros de la lista.
skip Int64 el valor inicial de 0, y luego su valor se incrementa después de cada bucle hasta que se toma el último registro.
Después de tomar las cinco primeras medallas, la actividad Para cada se utiliza para escribir los países participantes y el número de medallas que ganaron en el archivo Bloc de notas.
El siguiente escenario explica los pasos para actualizar un esquema de entidad en Data Service y luego sincronizar los datos con Studio.
En Data Service, ve a la entidad Medallas , haz clic en Crear nuevo campo y añade una nueva columna HostCountry de tipo Sí/No. Haz clic en Guardar.
En Studio, haz clic en Gestionar entidades, y luego en el botón Actualizar. Se ha detectado un cambio en la entidad Medallas, como se muestra en la columna Cambios. Haga clic en Guardar y la entidad se actualizará en Studio.
La actividad Actualizar registro de entidad puede utilizarse para actualizar registros de tu flujo de trabajo directamente en Data Service.
En este ejemplo, estamos consultando ciertos registros de la entidad Medallas y actualizándolos automáticamente usando la actividad mencionada.
En la entidad Medallas, el país anfitrión de cada edición está marcado con un asterisco junto a su nombre. Por ejemplo, para la edición de 2012, el país anfitrión se registra como Gran Bretaña (GBR)* en la columna de las Olimpiadas.
listMedals y usamos la actividad Para cada (For Each) para hacer un bucle a través de cada elemento y asignar el valor Verdadero (True) en la columna PaísAnfitrión junto al país que alojó una edición en particular.
La actividad Actualizar registro de entidad puede utilizarse en muchos otros escenarios para pasar datos y actualizar registros en Data Service.
