TOTVS Fluig Español

Árvore de páginas


Hablando de datasets...

Los Datasets son componentes que permiten estandarizar el acceso a la información que proviene de sitios externos a la plataforma, tales como aplicaciones y bases de datos. Los datasets de alto rendimiento tienen un caché de almacenamiento de datos obtenidos externamente, que tiene como objetivo reducir el número de accesos a los servicios de datos externos, es decir, crea una copia de la estructura de datos dentro de la plataforma para consulta, mejorando el rendimiento de los datasets desarrollados sobre la plataforma. De esta manera, los datos se consultan en la misma plataforma, evitando el acceso a los datos en el sistema proveedor externo para cada solicitud.

Este recurso permite crear datasets y definir cuáles serán offline en dispositivos móviles, cuáles se debe sincronizar con el proveedor externo de datos, la frecuencia de sincronización, desactivar aquellos que ya no estén en uso, entre otras opciones.

Los datasets activos se muestran con un color de fuente más fuerte, para destacarse con relación a los datasets que ya no se están utilizando.


¡Manténgase informado!

Obtenga más información sobre el desarrollo de datasets ingresando a la documentación técnica.


Mostrar datasets

01. En el menú principal, activar Panel de control y a continuación verificar el agrupador Desarrollo y activarlo Datasets.

02. Ver todos los datasets mostrados en la lista.

Se puede buscar un dataset específico por medio del campo Buscar, que se encuentra en la esquina superior derecha de la ventana, o utilizar el botón Filtrar para elegir los datasets que se devolverán.


Filtrar dataset

01. Activar el botón Filtrar, que se encuentra en la parte superior derecha de la pantalla.

02. Seleccione los datasets que desea visualizar en pantalla. Se puede filtrar por situación (activos, inactivos y/o en edición) y también por tipo (internos, simples y/o avanzados).

Los datasets del/de los tipo/s elegido/s aparecerán en una lista.


Nuevo dataset simple

01. Activar Nuevo dataset, seleccione Simple.

02. En el campo Código, ingresar un código para el dataset.

Para evitar incoherencias, el código y la descripción del dataset no deben contener caracteres especiales (con excepción de "_" y "-").

03. En el campo Descripción, ingresar una descripción para el dataset.

04. En el campo Servicio, seleccione un servicio para el dataset.

Es posible registrar un nuevo Dataset de servicios REST. Para ello, basta con tener servicios de este tipo ya registrados.

Si no tiene ningún servicio registrado, basta con ir al menú de Servicios en la pestaña General del Panel de control para crear un nuevo.

05. Al seleccionar los servicios SOAP, REST o JDBC, las opciones de relleno aparecerán de forma diferente de uno a otro. Rellene los campos según el servicio seleccionado.

    Al seleccionar el tipo de servicio SOAP, rellene los siguientes campos:

    Operación
    Al seleccionar el icono de lupa, podrá seleccionar una de las operaciones disponibles. Las operaciones se enumeran por nombre y PortType (ColleagueService).


    Configurar
    En la configuración de la operación seleccionada, se pueden configurar las propiedades, SOAP Headers y Tratamiento de retorno.

    Propiedades

    • Autenticación básica: seleccione si desea o no autenticación. Puede definir un usuario y una contraseña.
    • SSL - habilitar cuando el servicio de sucursal requiere uso de ssl. Deshabilitar Chunking - deshabilitar el envío del sobre soap completo.
    • Listar mensajes SOAP - habilitar para mostrar los mensajes de envío y recepción en el registro.
    • Tiempo de respuesta - habilitar para mostrar el tiempo que la solicitud aguarda por la respuesta.

    Claves del dataset

    Permite definir las claves que se utilizarán en el momento de la sincronización sin conexión, para evitar la duplicación de registros en cada sincronización.

    SOAP Headers
    Permite agregar un header(encabezado).

    Tratamiento Retorno

    • Extraer resultado: Permite seleccionar esta opción para extraer un informe en formato xml e incluir una etiqueta.

    Activar Guardar para completar la configuración.

    Parámetros
    Rellene los parámetros de acuerdo con lo solicitado:

    Atribuição
    -Nulo ou Variável (Ao selecionar Nulo, o campo Valor é automaticamente dispensado).

    Valor
    -WKCompany o WKUser (Se verá cuando se selecciona el campo de asignación como variable).

    Al seleccionar el tipo de servicio REST, rellene los siguientes campos:

    Operación
    Al seleccionar el icono de lupa, podrá seleccionar una de las operaciones disponibles. Las operaciones se enumeran por nombre, método (GET) y API.

    Configurar
    Nas configurações da operação selecionada, podem ser configuradas as Propriedades, Headers e Tratamento retorno.

    Propiedades

    • SSL - habilitar cuando el servicio de sucursal requiere uso de ssl.
    • Listar mensajes - habilitar para mostrar los mensajes de envío y recepción en el registro.
    • Tiempo de respuesta - habilitar para mostrar el tiempo que la solicitud aguarda por la respuesta.


    Claves del dataset


    Permite definir las claves que se utilizarán en el momento de la sincronización sin conexión, para evitar la duplicación de registros en cada sincronización.

    Headers

    Permite agregar un header (encabezado).

    Tratamiento Retorno

    • Extraer resultado: Permite seleccionar esta opción para extraer un informe en formato JSON e incluir una ruta de acceso.

    Activar Guardar para completar la configuración.

    Parámetros
    Rellene los parámetros de acuerdo con lo solicitado:

    Atribuição
    -Nulo ou Variável (Ao selecionar Nulo, o campo Valor é automaticamente dispensado).

    Valor
    -WKCompany o WKUser (Se verá cuando se selecciona el campo de asignación como variable).

    Al seleccionar el tipo de servicio JDBC, rellene los siguientes campos:

    Mesa
    Al seleccionar el icono de lupa, podrá seleccionar una de las tablas disponibles. Las operaciones aparecerán por nombre y tipo (Table, VI o Synonym).

    Configurar

    En la configuración de la tabla seleccionada, se pueden configurar algunas propiedades como:

    • Limitar Resultado: habilitar para limitar el número de registros devueltos.
    • Campo clave para la tabla - Permite seleccionar un campo clave para la tabla, pudiendo ser: limit o offset.

    Activar Guardar para completar la creación.


    Campos
    Llene los campos de acuerdo con lo solicitado:

    • Filtros - Permite agregar filtros a los campos.

    Para crear filtros, debe configurar alguna información. Son ellas:

    Operación
    Permite seleccionar una de las operaciones disponibles: AND, OR o NOT.


    Valor inicial
    Establecer un valor inicial. Ex: 1.

    Valor final
    Establecer un valor final. Ex: 3.

    Uso similar
    Buscar por el contenido, no exacto, pero que contenga parte del valor informado. Sólo tienes que seleccionar Sí o No.

    • Olver - permitir devolver o no un valor. Basta con flegar Sí o No.
    • Ordenar: permite ordenar los campos en orden ascendente o descendente.


    06. Activar Guardar.


    Nuevo dataset avanzado

    01. Activar Nuevo dataset, seleccione Avanzado.

    02. En el campo Código, ingresar un código para el dataset.

    Para evitar incoherencias, el código y la descripción del dataset no deben contener caracteres especiales (con excepción de "_" y "-").

    03. En el campo Descripción, ingresar una descripción para el dataset.

    De esta manera, se incluirá un nuevo registro de dataset avanzado, y se abrirá la pantalla para editar el código fuente del dataset. El código fuente se mantendrá como borrador mientras el usuario autenticado active la opción Guardar. Los cambios de código fuente solo se aplicarán al dataset en el momento en que el usuario haya finalizado los cambios, activando el botón Publicar.

    Más información sobre la construcción de un dataset avanzado ingresando a nuestra documentación técnica, disponible aquí.


    Habilitar dataset offline en el mobile

    01. Activar el ícono de edición que se encuentra en la columna Offline mobile, representado por la imagen de un lápiz.

    02. En la ventana que aparece, definir la información requerida

    La configuración estándar es No (Off).

    La información requerida es:

    ¿Utilizar caché en dispositivos móviles?

    Cuando está seleccionado, determina que los datos del dataset se almacenan en el caché cuando se utiliza en dispositivos móviles. En este caso, el botón se muestra con la indicación ON (sí), que indica que el recurso está activo. Cuando se activa para inhabilitar el recurso, el botón aparece con la indicación OFF (no), que indica que el recurso está inhabilitado.

    Tiempo de caducidad del caché mobile

    Tiempo en el que los datos almacenados se consideran válidos y permanecen en el caché de dispositivos móviles antes de actualizarlos de nuevo.

    ¿No utilizar caché cuando el dispositivo mobile esté online?

    Cuando está activado, determina que no se consultarán los datos en caché cuando el dispositivo móvil esté online, es decir, que se requerirán desde el sistema externo.

    03. Activar Guardar.

    Attencion

    Los nuevos datos creados en dispositivos móviles, cuando se utiliza el modo offline, solo estarán disponibles para consulta en otros formularios después que la aplicación móvil pasa por un proceso de sincronización con el servidor del TOTVS Fluig Plataforma. Para entender más sobre este proceso, acceda en esta página al paso Configurando sincronización de datasets.

    Los datasets del tipo Internos no tendrán esta opción editable. Solo se mostrarán como estándar, Interno.


    Importar dataset

    01. Activar Importar.

    02. Seleccionar el servidor al que se importará el dataset.

    El servidor debe estar correctamente registrado, de acuerdo con las instrucciones del ítem Plataforma ❙ Servidores. La importación solo funcionará si, en el servidor seleccionado, la instalación de TOTVS Fluig Plataforma tiene una actualización 1.6.5 (Liquid) o superior. Si ya existe un dataset con el mismo código del dataset importado de otro servidor, la plataforma emitirá un mensaje de alerta y, si el usuario confirma la acción, se creará una nueva versión con la implementación del dataset importado.

     03. Activar Importar.


    Exportar dataset

    01. Seleccionar en la lista el/los dataset que se debe/n exportar.

    02. Activar el botón Exportar.

    03. Seleccionar el servidor al que se exportará el dataset.

    El servidor debe estar correctamente registrado, de acuerdo con las instrucciones del ítem Plataforma ❙ Servidores. La importación solo funcionará si, en el servidor seleccionado, la instalación de TOTVS Fluig Plataforma tiene una actualización 1.6.5 (Liquid) o superior.

    04. Activar Exportar.


    Configurar el permiso de acceso en el dataset

    A través del recurso Permisos del Panel de control se puede definir los usuarios, roles o grupos que tendrán acceso a los datasets de tipo Interno. Consulte más detalles en Plataforma ❙ Recursos de permiso en APIs, datasets y webservices.


    Sincronización de datasets

    Los recursos de sincronización se encuentran en una pantalla específica, a la que se puede acceder activando el enlace de la columna Sincronización. Para obtener más información sobre esta característica, ingrese a la página de Sincronización de datasets.


    Más acciones de datasets

    Los datasets muestran varias acciones específicas, que se pueden ver activando el ícono Barras horizontales, que se encuentra en la columna Más acciones. Para obtener más información sobre estos recursos, ingrese a la página Más acciones de datasets.


    ¡Atención!

    Esta documentación está válida a partir de la actualización 1.7.0 - Lake. Si usted utiliza una actualización anterior, ésta puede contener informaciones diferentes de las que visualiza en su plataforma.