Operaciones

Selecciona el tipo de mutación. Puede ser:

• Custom. Estas operaciones varias pueden realizar cualquier acción vinculada al nodo (incluyendo la creación, actualización o supresión) y devolver cualquier estructura o referencia. Puedes definirlas libremente.

• Create/Update/Delete. Estas son operaciones estándar de GraphQL. Un nodo solo puede tener una de cada.

Para los subprogramas, selecciona Custom.

El tipo de mutación Custom no está permitido para las operaciones y las clases basadas en ventanas.

Selecciona el método de operación. Puede ser:

• Importación, Script o Script de nodo para un tipo de mutación Custom;

• Ventana, Importación o Clase para un tipo de mutación de Create/Update/Delete.

Para los subprogramas, selecciona Script.

Para los modelos de importación/exportación, selecciona Importación.

Para las ventanas, selecciona Ventana.

Para las clases, selecciona Clase.

Selecciona Script de nodo para declarar las operaciones que se ejecutan a nivel de Sage X3 Services en un nodo. La operación ejecuta una función desarrollada en TypeScript que es similar a valores calculados.

Selecciona o introduce el identificador de la operación de API de Sage X3.

El identificador de la operación debe ser único.

Selecciona el nodo en el que se genera la operación. El nodo muestra la operación cuando exploras el gráfico mediante una herramienta externa.

Puedes vincular varias operaciones personalizadas al mismo nodo.

Solo puedes definir una operación Create, Update o Delete para un nodo. Por ejemplo, SalesOrder.create o SalesOrder.delete.

Cuando se generan los nodos, Sage X3 solo considera la operación Create, Update o Delete activa definida en la función Operaciones (GESAPIOPE).

Define el nombre de la operación GraphQL para generar en el nodo seleccionado.

El nombre de la operación debe ser único en la definición del nodo, como el nombre de una propiedad.

El nombre de la operación debe respetar la nomenclatura "camelCase". Por ejemplo, updatePickTicketLine.

Para los tipos de mutación Create/Update/Delete, el nombre de la operación no se utiliza en el esquema de GraphQL, que siempre emplea la nomenclatura estándar, como SalesOrder.create, SalesOrder.delete o SalesOrder.update.

Selecciona el módulo de la operación.

Un código de actividad permite:

• definir como opcional un elemento del diccionario si el valor asociado al código de actividad es nulo;

• identificar elementos específicos si se marcan con un código que comienza por X, Y o Z.

Introduce el identificador que se utiliza como referencia para las fichas de enlaces de nodos generadas para la operación.

Este campo se inicializa por defecto con el identificador de la operación.

Introduce un nombre de nodo para la solicitud.

Este campo se inicializa por defecto con el nombre de operación de GraphQL, pero se puede modificar.

El nombre del nodo debe respetar la nomenclatura "PascalCase".

Después de guardar la operación, en la tabla de enlaces de nodos se genera automáticamente un nodo temporal (no vinculado a una tabla de base de datos) según el identificador de Enlace nodos (solicitud) y el nombre de Nombre nodo (solicitud).

Para los subprogramas, este nodo técnico almacena el mapeo entre los parámetros del subprograma y las propiedades temporales disponibles en el nodo principal para compilar la carga de la mutación y ejecutar la mutación.

Las propiedades temporales se añaden al nodo principal cuando generas el paquete en VS Code.

Para los modelos de importación/exportación, las ventanas o las clases, este nodo técnico mapea los campos al nodo principal y compila la carga de la mutación.

Una operación que utiliza un modelo de importación, una ventana o una clase está vinculada al nodo principal asociado al modelo de importación, la ventana o la clase.

La definición del nodo está disponible en la función Diccionario de enlace (GESAPINOD).

Selecciona el paquete en el que quieras generar la operación.

Para una mutación de script, este valor es el mismo que el de Enlace nodos (solicitud). La definición del nodo para la respuesta es la misma que la definición del nodo de la solicitud.

Este campo no está disponible para las operaciones que utilizan un modelo de importación/exportación o una ventana.

Selecciona la autorización funcional para la operación de API.

La operación se vincula al derecho de acceso funcional definido en el perfil de función del usuario (derechos de acceso por planta).

Marca esta casilla para definir el tipo de mutación Create para la operación.

Marca esta casilla para definir el tipo de mutación Update para la operación.

En los modelos de importación/exportación, esta casilla depende de la casilla Actualización autorizada de la función Modelos import./export. (GESAOE).

Al seleccionar el subprograma, las variables se cargan automáticamente en la columna Enlace.

Introduce el nombre de las propiedades para mapear las variables del subprograma en la definición del nodo.

Después de guardar la operación, en la tabla de enlaces de nodos se crean automáticamente un nodo temporal y propiedades según el identificador del nodo y los nombres del nodo y de las propiedades.

El nodo temporal se muestra en la función Enlaces de nodos (GESANODEB).

Los nodos temporales y las propiedades se muestran en la función Diccionario de enlace (GESAPINOD), en la lista de selección Script.

En VS Code, las propiedades se generan como temporales en el nodo, lo que significa que no están vinculadas a campos de la base de datos como las propiedades normales, que están asociadas a campos de la tabla en la función Tablas (GESATB).

En esta columna se indica el nodo al que pertenecen los campos importados.

Al seleccionar el modelo de importación/exportación, los campos se cargan automáticamente en la columna Enlace.

Si configuras correctamente los identificadores del modelo de importación y sus nodos correspondientes, los nombres de las propiedades también se cargan automáticamente.

Tienes que seleccionar manualmente las propiedades temporales utilizadas para mapear el campo técnico definido en el modelo de importación.

Después de guardar la operación, en la tabla de enlaces de nodos se crean automáticamente el registro de enlace de nodos y las propiedades correspondientes.

La operación del nodo se muestra en la función Enlaces de nodos (GESANODEB), en la lista de selección Importaciones.

La operación del nodo y las propiedades se muestran en la función Diccionario de enlace (GESAPINOD).

Introduce el nombre de la colección desnormalizada a la que pertenece la propiedad.

Utiliza este campo para configurar las colecciones.

Introduce el nombre de la colección en la columna Propiedad y selecciona Colección en la misma línea para el nivel principal de la colección.

El nivel principal debe estar en la línea inmediatamente superior a la colección.

Si hay varias colecciones bajo el mismo nodo principal, tienes que definir esta línea principal para cada colección.

Marca esta casilla para validar las propiedades por mapear en los campos de la pantalla.

Los campos que se añadan posteriormente en la definición de la pantalla se mostrarán en la operación de API asociada, pero no estarán seleccionados. Luego podrás definir los nombres de las propiedades correspondientes desde el nodo y seleccionar los nuevos campos para el mapeo.

Aunque falte una propiedad obligatoria en el mapeo, puedes guardar la operación, pero no activarla.

Al seleccionar la ventana, los campos por mapear se cargan automáticamente en la columna Enlace.

Utiliza este campo para configurar las colecciones.

Introduce el nombre de la colección en la columna Propiedad y selecciona Colección en la misma línea para el nivel principal de la colección.

El nivel principal debe estar en la línea inmediatamente superior a la colección.

Si hay varias colecciones bajo el mismo nodo principal, tienes que definir esta línea principal para cada colección.

Utiliza este campo para configurar las colecciones.

Introduce el nombre de colección definido en el nivel principal de la columna Propiedad de la colección.

En esta columna se define la presentación de los campos dentro del bloque.

• Tabla. Los campos se organizan en una tabla de líneas desplazable (horizontal y verticalmente si es necesario).

• Lista. Lista de campos independientes entre sí.

• Texto. Visualización de un texto en un fondo fijo sin introducirlo.

• Invisible. Declaración de una sección de lista invisible. Se utiliza para incluir en una pantalla campos técnicos que no se muestran, pero que se pueden utilizar por los procesos vinculados a la pantalla.

• Browser. Para páginas web.

• Editor HTML. Reservado para la entrada de la documentación.

• Business Intelligence. Para ejecutar un informe BO (reservado para Supervisor).

Marca esta casilla para validar las propiedades por mapear en los campos de la clase.

Los campos que se añadan posteriormente en la definición de la clase se mostrarán en la operación de API asociada, pero no estarán seleccionados. Luego podrás definir los nombres de las propiedades correspondientes desde el nodo y seleccionar los nuevos campos para el mapeo.

Aunque falte una propiedad obligatoria en el mapeo, puedes guardar la operación, pero no activarla.

Al seleccionar la clase, los campos por mapear se cargan automáticamente en la columna Enlace.

Utiliza este campo para configurar las colecciones.

Introduce el nombre de la colección en la columna Propiedad y selecciona Colección en la misma línea para el nivel principal de la colección.

El nivel principal debe estar en la línea inmediatamente superior a la colección.

Si hay varias colecciones bajo el mismo nodo principal, tienes que definir esta línea principal para cada colección.

Utiliza este campo para configurar las colecciones.

Introduce el nombre de colección definido en el nivel principal de la columna Propiedad de la colección.

Un código de actividad permite:

• definir como opcional un elemento del diccionario si el valor asociado al código de actividad es nulo;

• identificar elementos específicos si se marcan con un código que comienza por X, Y o Z.

Introduce el nombre de la colección a la que pertenece la propiedad.