ÍNDICE

  1. Visión general
  2. Ejemplo de utilización
  3. Tablas utilizadas


Importante

Esta funcionalidad está disponible a partir del release 12.1.33 (Expedición continua con fecha >= al  24/06/2022).

ATENCIÓN: Paquetes necesarios para el funcionamiento de la rutina

Para o funcionamento desta rotina, foi necessária a criação de dois campos e um índice:

  • Campos A1P_CUSTOM e A1N_CUSTOM;
  • Índice 2 para la tabla A1Q.

Por lo tanto, se debe aplicar el paquete de la expedición continua de la Facturación o del Backoffice Protheus superior o igual a la fecha de corte 17/03/2022.

Más informaciones se pueden obtener en las documentaciones DT API Tipos de Cards y gráficos personalizadosDT Validación en la eliminación de Tipos de Cards y  gráficos personalizados.

01. VISIÓN GENERAL

El menú Personalizaciones (Mantenimiento de Cards y gráficos personalizados) permite Incluir, Editar Eliminar tipos de gráficos y cards personalizados.

02. EJEMPLO DE UTILIZACIÓN


Para listar los tipos de Cards y gráficos personalizados, simplemente haga clic en la opción 'Personalizaciones' del menú. Esta opción de menú está disponible solamente para usuarios administradores.

Al acceder esta opción menú, aparecerá la pantalla de mantenimiento de Cards y gráficos personalizados, donde tiene 2 solapas: una solapa para listar y filtrar tipos de card y otra solapa para listar y filtrar tipos de gráfico:

En esta pantalla, aparecerán todos los registros que estuvieran con los campos A1P_CUSTOM y A1N_CUSTOM = .T.

En esta pantalla, aparecerán todos los registros que estuvieran con los campos A1P_CUSTOM y A1N_CUSTOM = .T.

Al incluir un tipo de Card personalizado, este se incluye en la base de datos informando el campo A1N_CUSTOM = .T., campo que indica cuando un dato se personaliza o no. Vea a continuación el proceso de inclusión:

Haga clic en la opción Incluir, informe el título para el card y seleccione la opción de 'Tipo' como 'Card':

Al seleccionar la opción de 'Tipo' como 'Card', un formulario se abre solicitando los cuatro endpoints necesarios para el funcionamiento de un Card. Para entender detalladamente cada uno de estos, consulte la documentación CoreDash - Creación de nuevos Cards y Gráficos, tópico EJEMPLO DE UTILIZACIÓN.

URI Servicio del Card: Servicio que devuelve las informaciones que se podrán presentar en el card (Correspondiente al endpoint cardInfo del ejemplo citado anteriormente).

URI Servicio de campos: Servicio que devuelve la propiedad y el nombre de los campos que se podrán presentar en el card (Correspondiente al endpoint fieldsInfo del ejemplo citado anteriormente).

URI Servicio de ítems: Servicio que devuelve las informaciones que se podrán presentar en la opción 'Detalles" del card (Correspondiente al endpoint itemsDetails del ejemplo citado anteriormente).

URI Servicio de filtro: Servicio que devuelve los campos que se podrán utilizar en el filtro del card (Correspondiente al endpoint cardFilter del ejemplo citado anteriormente).

Complete el formulario informando los endpoints y haga clic en 'Validar':

La opción 'Validar' se liberará solo cuando todos los campos estén informados. Su función es validar si todos los endpoints volvieron a la estructura necesaria, según el documento CoreDash - Creación de nuevos Cards y gráficos, tópico EJEMPLO DE UTILIZACIÓN (Respuesta esperada para este endpoint). Si alguno de los servicios informados no devuelve la estructura correcta, la opción 'Grabar' no se liberará y volverá el mensaje de error para cada endpoint que falló.

Haga clic en 'Grabar':

Incluya un Card con el nuevo Tipo registrado:

  1. Haga clic en Cards.
  2. Incluya el Card según la documentación Administrar Cards.

Vincule el nuevo card creado a una visión:

Posicione en el ítem que desea modificar y haga clic en el icono de lápiz:

Modifique lo que sea necesario y haga clic en 'Validar':

Haga clic en 'Grabar':

Posicione en el ítem que desea eliminar y haga clic en el icono de basurero:

En el mantenimiento de tipos de gráfico personalizados, están disponibles tres opciones: Incluir, Modificar y Eliminar:

Al incluir un tipo de gráfico personalizado, este se incluye en la base de datos informando el campo A1P_CUSTOM = .T., campo que indica cuando un dato se personaliza o no. Vea a continuación el proceso de inclusión:

Haga clic en la opción Incluir, informe el título para el gráfico y seleccione la opción de 'Tipo' como 'Gráfico':

Al seleccionar la opción de 'Tipo' como 'Gráfico', un formulario se abre solicitando los tres endpoints necesarios para el funcionamiento de un gráfico. Para entender detalladamente cada uno de estos, consulte la documentación CoreDash - Creación de nuevos Cards y Gráficos, tópico EJEMPLO DE UTILIZACIÓN.

URI Servicio del formulario: Servicio que devuelve el formulario para registro del gráfico (Correspondiente al endpoint form del ejemplo citado anteriormente).

URI Servicio de datos: Servicio que devuelve los datos que se presentarán en el gráfico (Correspondiente al endpoint retdados del ejemplo citado anteriormente).

URI Servicio de ítems: Servicio que devuelve las informaciones que se presentarán en la opción 'Detalles' del gráfico (Correspondiente al endpoint itemsDetails del ejemplo citado anteriormente).

Complete el formulario informando los endpoints y haga clic en 'Validar':

La opción 'Validar' se liberará solo cuando todos los campos estén informados. Su función es validar si todos los endpoints volvieron a la estructura necesaria, según el documento CoreDash - Creación de nuevos Cards y gráficos, tópico EJEMPLO DE UTILIZACIÓN (Respuesta esperada para este endpoint). Si alguno de los servicios informados no devuelve la estructura correcta, la opción 'Grabar' no se liberará y volverá el mensaje de error para cada endpoint que falló.

Haga clic en 'Grabar':

Incluya un gráfico con el nuevo Tipo registrado:

  1. Haga clic en Gráficos.
  2. Incluya Gráfico según la documentación Administrar Gráficos.

Vincule el nuevo gráfico creado a una visión:

Posicione en el ítem que desea modificar y haga clic en el icono de lápiz:

Modifique lo que sea necesario y haga clic en 'Validar':

Haga clic en 'Grabar':

Posicione en el ítem que desea eliminar y haga clic en el icono de basurero:

03. TABLAS UTILIZADAS