6.2 Configuración de Actores

Configuración de Actores

Estructura del JSON

1. Raíz

{
    "flowName": "engine/elementConfig", // No modificar
    "appId": "PNG", // No modificar
    "extRequest": "9999", // No modificar
    "TransactionType": "1", // No modificar
    "parameters": {...} // Se detalla en la siguiente sección
...}

2. Parámetros

"parameters": {
      "operationId": "17",
      "user": "[email protected]",
      "activeFlag": 1,
      "code": "CLIENTE",
      "name": "Cliente",
      "icon": "0xef31;#FFAB7C",
      "attributeCod": "COD_CLIE",
      "category": "c",
      "apiFicha": "fls/getClienteCard",
      "cardOptions": {
          "searchBy": [
              {
                  "source": "COD_CLIE",
                  "label": "Código del cliente"
              },
              {
                  "source": "id",
                  "datasource": "element.CLIENTE",
                  "label": "Nombre del cliente"
              }
          ],
          "transactionTabs": [
              {
                  "code": "actions",
                  "label": "Transacciones",
                  "turnOn": true
              }
          ]
      },
      "viewAttributeMapping": {
          "label": "NAME_CLIE",
          "labelPatron": "",
          "value": "",
          "parentKey": "",
          "limit": 1000,
          "orderBy": ""
      },
      "queryCharts": {
          "atributesPieChart": [],
          "atributeHistorygramChart": ""
      },
      "eventCode": "",
      "eventLabel": "",
      "flowCode": "",
      "formCode": "",
      "formName": "",
      "formGroup": {
          "code": "GRPCONF",
          "name": "Configuración de actores",
          "base64Image": "",
          "category": "GRPTYPECONF",
          "categoryLabel": "Configuraciones"
      },
      "formOperationAreasTrigger": "",
      "categoryEvent": {
          "code": "CONFIG",
          "label": "Configuración"
      },
      "ruleLevels": [
          {
              "name": "Estrategias de negocios",
              "category": "COMMERCIAL"
          },
          {
              "name": "Procesos internos",
              "category": "TECHNICAL"
          }
      ],
      "groups": [{...}], // Se detalla en la siguiente sección
      "controls": {...}  // Se detalla en la siguiente sección
}

3. Grupos

"groups": [
    {
        "code": "DATA_PROV",
        "name": "Datos proveedor",
        "base64Image": "",
        "category": "REG_PROV",
        "categoryLabel": "Registro proveedor",
        "categoryType": "A",
        "noShowInForm": false,
        "attributes": [
            {
                "code": "PROVEE_COD",
                "label": "ID Proveedor (DNI)",
                "type": "STRING",
                "category": "DATA",
                "history": false,
                "elementCategory": "p",
                "length": 40,
                "dataSource": "",
                "typeSelecction": "MULTIPLE",
                "defaultValue": "",
                "validateCondition": "notExist(element.PROVEE[?(@.dni == '#data_prov.provee_cod#')])",
                "renderCondition": "cond(isNaN(parseInt('#_ELEMENT.id#')))",
                "noShowInForm": false,
                "valueFrom": "PROVEE_COD",
                "readOnly": true,
                "helptext": "",
                "errortext": "",
                "formula": "",
                "delete": true
            }
        ]
    }
]

4. Controles

"controls": { 
		  "setTableStruct": true, 
		  "configElement": true, 
		  "configEvent": true, 
		  "configFlow": true, 
		  "configForm": true,
		  "returnJsonEvent": true,
			"returnJsonFlow": true,             
			"returnJsonForm": true         
}

{
    "user": "[email protected]",
    "operationId": 14,
    "activeFlag": 1,
    "code": "LOTE",
    "name": "Lotes",
    "attributeCod": "COD_LOTE",
    "category": "c",
    "apiFicha": "",
	"cardOptions": {
        "searchBy": [
			{
			"source": "pro_agri_lote",
			"label": "Proyecto agrícola al que pertenece el lote",
			"datasource": "sepiia.CURUB_LOTE"
			},
			{
			"source": "predio_lote",
			"label": "Predio al que pertenece el lote",
			"datasource": "sepiia.CURUB_LOTE"
			},
			{
			"source": "key",
			"label": "Código del lote",
			"datasource": "sepiia.CURUB_LOTE"
			}
			],
        "transactionTabs": [
			{
			"code": "executed",
			"label": "Registros completados",
			"turnOn": true
			},
			{
			"code": "availables",
			"label": "Registros disponibles",
			"turnOn": false
			},
			{
			"code": "actions",
			"label": "Acciones",
			"turnOn": false
			}
			]
		}
}

Consideraciones

Luego de ejecutar por primera vez la API, se debe crear una regla en el evento creado, para asegurar el funcionamiento correcto y el registro en la base de datos.

• Hay restricciones con el cambio de tipo de datos de un atributo, por lo que:
• ✅ Se puede cambiar el tamaño de un STRING.
• ✅ Se puede cambiar de INTEGER a STRING.
• ✅ Se puede cambiar de DATE, TIME, DATETIME a STRING.
• ❌ No se puede cambiar de STRING a INTEGER.
• ❌ No se puede cambiar de STRING a DATE, TIME o DATETIME.

• En los casos que no se pueda, se debe primero eliminar el atributo y luego volver a crearlo con el nuevo tipo de datos.

• Se recomienda usar el Configurador del flujo y formulario (ConfigForm= true, ConfigFlow=true) de la API del actor cuando con este se va a configurar un flujo y formulario para el Registro del actor.
• Por ejemplo: crear un cliente con sus datos básicos, crear un Producto con sus datos básicos, etc.

• No se recomienda cuando el flujo y formulario es de tipo transaccional y corresponde a un flujo de un proceso del negocio, donde pueden llegar a estar involucrados uno o más actores (ConfigForm= false, ConfigFlow=false).

a. Valores posibles del TYPE

b. Valores posibles del CATEGORY