Introducción
Las Opciones de consulta globales y la expansión de Propiedades de navegación en acciones GET ALL, y la Navegación de segundo nivel en acciones CREATE ofrecen un mayor control al configurar integraciones con SAP. Al recuperar datos, puede definir límites de registros, paginación, criterios de ordenamiento, selección de atributos y expansión de entidades relacionadas mediante Propiedades de navegación. Al configurar acciones CREATE, puede recorrer las relaciones entre entidades hasta un segundo nivel para identificar los atributos necesarios para payloads complejos. Las opciones de consulta globales y la navegación de segundo nivel están disponibles para conexiones OData V2 y OData V4.
Antes de empezar
Asegúrese de cumplir los siguientes prerequisitos:
•Configure una conexión de SAP Cloud utilizando SAP BTP
•Seleccione un servicio OData V2 u OData V4 válido
•Configure una acción de SAP de uno de los siguientes tipos:
oGET ALL, para usar Opciones de consulta globales y expansión de Propiedades de navegación
oCREATE, para usar Navegación de segundo nivel
Optimización de consultas con Opciones de consulta globales en una acción GET ALL
Las Opciones de consulta globales en las acciones GET ALL proporcionan un control preciso sobre la forma en que Bizagi recupera datos de SAP S/4HANA Cloud. Puede definir la cantidad de registros que se devuelven, el orden en que se recuperan y los atributos específicos incluidos en la respuesta, lo que reduce la cantidad de datos transferidos y mejora el rendimiento de la integración al trabajar con grandes volúmenes de datos.
Opciones disponibles
Las siguientes opciones de consulta están disponibles:
•Paginación de resultados: Controla la cantidad de datos devueltos al definir el número máximo de registros a recuperar.
•Ordenamiento de resultados: Define el orden en el que los registros se devuelven en los resultados de la consulta.
•Selección de atributos: Especifica qué atributos se incluyen en la respuesta, de modo que solo se recupere la información requerida por el proceso.
Comportamiento según la versión de OData
•OData V2: Las opciones de optimización se aplican únicamente a la entidad principal. La paginación, la ordenación y la selección de atributos afectan solo los resultados de esa entidad.
•OData V4: Las opciones de optimización se aplican a la entidad principal y a las entidades relacionadas incluidas mediante la expansión de Propiedades de navegación, lo que proporciona un control más preciso sobre la información devuelta.
Cómo configurar Opciones de consulta globales en una acción GET ALL
Para configurar Opciones de consulta globales en una acción GET ALL, siga estos pasos:
1.En el asistente de creación de acciones de SAP, seleccione la acción GET ALL.
Se muestran las opciones de optimización.
2.Configure los parámetros requeridos:
•Paginación: Use $top para definir el número máximo de registros y $skip para definir el desplazamiento.
•Ordenamiento: Use $orderby para definir el orden de los resultados.
•Proyección: Use $select para elegir los atributos de la entidad principal que se van a recuperar.
|
$top y $skip controlan directamente cuántos registros se recuperan en la consulta. |
Expansión de Propiedades de navegación en una acción GET ALL
La expansión de Propiedades de navegación le permite incluir datos de entidades relacionadas en una única solicitud GET ALL. Este enfoque reduce la necesidad de realizar solicitudes adicionales, simplifica la configuración de la integración y mejora la eficiencia en la recuperación de datos. La expansión de Propiedades de navegación está disponible en acciones GET ALL para entidades con relaciones definidas.
Comportamiento según la versión de OData
•OData V2 – Expansión simple: Devuelve todos los atributos de las entidades relacionadas expandidas. No es posible seleccionar atributos individuales.
•OData V4 – Expansión controlada: Permite seleccionar atributos específicos de las entidades relacionadas expandidas, de modo que solo se devuelva la información necesaria.
Cómo expandir Propiedades de navegación en una acción GET ALL
Para expandir Propiedades de navegación, siga estos pasos:
1.En el asistente de creación de acciones de SAP, seleccione una acción GET ALL en la que esté disponible la configuración de Propiedades de navegación.
2.Localice las Propiedades de navegación a expandir y seleccione una o más relaciones desde la lista desplegable.
Cada Propiedad de navegación seleccionada se añade automáticamente a la configuración de la acción.
Navegación de segundo nivel en una acción CREATE
La Navegación de segundo nivel en una acción CREATE le permite explorar visualmente y comprender la estructura jerárquica de las entidades relacionadas al enviar datos desde Bizagi hacia SAP S/4HANA Cloud.
Cuando la entidad principal expone Propiedades de navegación, esta navegación le ayuda a identificar atributos por nivel, comprender estructuras anidadas en el payload JSON y realizar el mapeo de datos con mayor precisión durante la configuración de acciones CREATE.
Modelo de navegación
El modelo de navegación se estructura de la siguiente manera:
•Nivel 0 – Entidad principal: Representa la entidad base sobre la cual se define la acción CREATE.
•Nivel 1 – Primera relación: Representa el primer nivel de información relacionada, que normalmente se utiliza para estructuras dependientes como ítems, detalles o asignaciones asociadas con la entidad principal.
•Nivel 2 – Relación de la relación: Representa un nivel jerárquico más profundo en el que la información relacionada se organiza en múltiples capas de dependencia.
|
La navegación de segundo nivel está disponible únicamente para exploración visual y no modifica la estructura de datos enviada a SAP. |
Cómo usar la Navegación de segundo nivel en una acción CREATE
Para usar la Navegación de segundo nivel en una acción CREATE, siga estos pasos:
1.En el asistente de creación de acciones de SAP, seleccione una entidad y elija el método CREATE.
2.En la lista de atributos, seleccione un atributo que contenga Propiedades de navegación. Por ejemplo, NP___Item .
3.En las Salidas de la Lista de objetos y atributos, seleccione la Propiedad de navegación asociada con la entidad principal. Por ejemplo, NP___Item.
4.Ahora se encuentra en el primer nivel de navegación. Seleccione una Propiedad de navegación relacionada, como NP___ItemPartner .
5.En el segundo nivel, revise los atributos de la entidad relacionada. La ruta completa de navegación se muestra en la ruta de exploración, por ejemplo: NP___Item < NP___ItemPartner.
Last Updated 7/17/2026 12:58:41 PM