Referencias técnicas

Esta sección incluye información útil que puedes necesitar al trabajar con SAP BAPI.

Crear entradas de matriz para tipos de entrada de tabla

En la actividad Ejecutar BAPI , los tipos de entrada de tabla para BAPI se representan como entradas de matriz. Esto requiere que crees manualmente los objetos. Estamos trabajando activamente en una solución para simplificar las asignaciones de matrices y mejorar la experiencia general.

Esta sección explica cómo crear entradas de matriz equivalentes para una tabla de tipo nativo en SAP BAPI, con ejemplos en Studio Desktop versión 2023.10 y Studio Web.

Vamos a explicar este tema con el ejemplo de un objeto BAPI_PO_CREATE .

Studio Desktop (Lenguaje C#)

1. En la actividad Ejecutar BAPI , selecciona el objeto BAPI_PO_CREATE .
2. Después de seleccionar el objeto, el resto de los campos se recuperan automáticamente.
3. Para una tabla de PO_ITEMS, por ejemplo, quieres crear una matriz de objetos equivalente. Selecciona el menú del botón Más + junto al campo PO_ITEMS para abrir el Editor de expresiones.
4. En la ventana Editor de expresiones , escribe UiPath.IntegrationService.Activities.SWEntities. Esto carga una lista de elementos. Puedes utilizar IntelliSense para ayudar con el desplazamiento.
5. En la lista, elige el elemento que corresponda a tu InArgument (en este caso, bapis_sub_execute_TABLES_sub_PO_ITEMS_CREATE). Este elemento siempre es único para una tabla.
   
   

   

   
   
6. A continuación, escribe un punto (.) y elige Bundle.bapis_sub_execute_TABLES_sub_PO_ITEMS_Create de la lista disponible. Añade dos pares de corchetes al final: []{}.
7. En este punto, se crea una instancia de la matriz y está listo para construir el objeto dentro de ella.
   
   

   

   
   
   Nota: El ID CEBA75DCD15 es un identificador único generado por nosotros, específico para tu conexión SAP BAPI para cada objeto. El ID es único para cada objeto.
8. Copia la línea del paso anterior y añade paréntesis () al final. Ahora está listo para asignar las propiedades dentro del objeto.
   
   

   

   
   
9. Introduce un punto (.) para buscar todas las propiedades dentro del objeto.
   
   

   

   
   
10. Asigna las propiedades según sea necesario y selecciona Guardar.
    
    

    

    
    

Muestra:

new UiPath.IntegrationService.Activities.SWEntities.CD6D3C0011F_bapis_sub_execute_TABLES_sub_PO_ITEMS_Create_CFXVARGYNSGMNQOY1M9XDRN8OK3VIHY.Bundle.bapis_sub_execute_TABLES_sub_PO_ITEMS_Create[] {
    new UiPath.IntegrationService.Activities.SWEntities.CD6D3C0011F_bapis_sub_execute_TABLES_sub_PO_ITEMS_Create_CFXVARGYNSGMNQOY1M9XDRN8OK3VIHY.Bundle.bapis_sub_execute_TABLES_sub_PO_ITEMS_Create()
    {
        PO_ITEM = 00001,
        PUR_MAT = "TG12",
        PLANT = "1710"
    },
    new UiPath.IntegrationService.Activities.SWEntities.CD6D3C0011F_bapis_sub_execute_TABLES_sub_PO_ITEMS_Create_CFXVARGYNSGMNQOY1M9XDRN8OK3VIHY.Bundle.bapis_sub_execute_TABLES_sub_PO_ITEMS_Create()
    {
        PO_ITEM = 00002,
        PUR_MAT = "TG12",
        PLANT = "1710"
    }
}

Studio Web (idioma VB)

Tomemos el mismo ejemplo y veamos cómo podemos lograr el resultado en Studio Web.

1. En la actividad Ejecutar BAPI , selecciona el objeto BAPI_PO_CREATE .
2. Después de seleccionar el objeto, el resto de los campos se recuperan automáticamente.
3. Para una tabla de PO_ITEMS, por ejemplo, quieres crear una matriz de objetos equivalente. Selecciona Ver más para abrir el editor de expresiones.
   
   

   

   
   
4. Escribe New, seguido de un espacio, y luego bapis. Esto desencadena que IntelliSense muestre una lista de elementos. En la lista, selecciona el elemento que coincida con tu InArgument, en este caso bapis_sub_execute_TABLES_sub_PO_ITEMS_CREATE. Este elemento siempre es único para una tabla.
   
   

   

   
   
   
   

   

   
   
5. A continuación, añade un par de llaves {}. Dentro de los corchetes, escribe un punto .. A continuación, puedes ver las propiedades disponibles dentro del objeto.
   
   

   

   
   
6. Asigna las propiedades según sea necesario y selecciona Guardar.
   
   

   

   
   

Muestra:

{ 
    New bapis_sub_execute_TABLES_sub_PO_ITEMS_Create With 
    { 
        .PO_ITEM = 00001,
        .PUR_MAT = "TG12",
        .PLANT = "1710"
    },
    New bapis_sub_execute_TABLES_sub_PO_ITEMS_Create With 
    { 
        .PO_ITEM = 00002,
        .PUR_MAT = "TG12",
        .PLANT = "1710"
    }
}

Preguntas frecuentes

¿El paquete de actividades SAP BAPI es compatible con proyectos Windows y multiplataforma?

Sí, el paquete de actividades SAP BAPI es compatible con los tipos de proyecto de Windows y multiplataforma en Studio Desktop.

¿Por qué no veo todas las propiedades necesarias de una BAPI en el lienzo de la actividad?

Cuando una propiedad de una BAPI concreta es de tipo estructura, la entrada (estructura) en sí no se muestra en el lienzo de la actividad Ejecutar BAPI , pero se muestran sus propiedades subyacentes. Incluso si la BAPI requiere ciertas propiedades dentro de la estructura, se siguen mostrando como opcionales en el lienzo principal, lo que a menudo conduce a una interfaz de actividad desordenada. SAP no indica qué campos son obligatorios dentro de la estructura y solo proporciona información sobre la estructura obligatoria. Por lo tanto, debes identificar y asignar manualmente los campos necesarios en consecuencia. Puedes leer más sobre esta limitación en este hilo de la comunidad SAP: Campos obligatorios de BAPI.

¿Por qué no veo los tipos de entrada de tabla para las BAPI?

En la actividad Ejecutar BAPI , los tipos de entrada de tabla para BAPI se representan como entradas de matriz. Esto requiere que crees manualmente los objetos. Consulta los ejemplos proporcionados en Crear entradas de matriz para tipos de entrada de tabla.

Estamos trabajando activamente en una solución para simplificar las asignaciones de matrices.

¿Por qué no puedo ver todas mis entradas en el lienzo?

De forma predeterminada, solo se muestran los campos obligatorios en el lienzo de la actividad principal. Puedes acceder y configurar campos opcionales en el panel Administrar propiedades . Selecciona las entradas adicionales que necesitas y utiliza la opción Actualizar campos para llevarlas al lienzo principal.

¿Se admite la invocación de RFC?

La invocación de RFC no es compatible actualmente con el paquete de actividades SAP BAPI.

¿Existen requisitos previos de instalación para utilizar las actividades de SAP BAPI?

No se necesitan instalaciones para utilizar las nuevas actividades SAP BAPI de Integration Service. Necesitas la versión 2023.10 o superior de UiPath Studio o puedes empezar a crear tus automatizaciones directamente en Studio Web.

¿Cómo puedo determinar si la actividad Ejecutar BAPI se ha realizado correctamente?

Todas las BAPI incluyen una matriz _RETURN dentro de la sección Tablas de salida. Esto proporciona salidas como LOG_NO, CODE, MESSAGE, etc. Comprueba estos valores para evaluar el éxito o el fracaso de la ejecución de BAPI.

¿Puedo utilizar una dirección IP en lugar de un nombre DNS para el nombre de host?

El uso de una dirección IP ofrece una ventaja significativa: la singularidad. Cuando utilizas un nombre DNS como mycompany.com/sap/bapi, dependes de la traducción de DNS, el enrutamiento y otros componentes de red. Esto puede dar lugar a posibles problemas y problemas de red. Por lo tanto, te recomendamos que utilices direcciones IP para garantizar una experiencia de creación de conexiones más fiable.

¿Puedo utilizar la actividad SAP BAPI de Integration Service si mi aplicación SAP está alojada en las instalaciones o en una nube dedicada?

Sí. Si tu sistema SAP S/4HANA está alojado en una plataforma en la nube como Azure, debes tener una dirección IP pública, que es suficiente para acceder. Si tu sistema SAP es local, debes permitir el acceso desde direcciones IP externas específicas, lo que implica configurar los ajustes de tu firewall.

¿El sistema gestiona automáticamente las confirmaciones de BAPI?

Sí. Como utilizamos el conector Java de SAP, el sistema detecta automáticamente si un BAPI requiere una confirmación y desencadena BAPI_TRANSACTION_COMMIT para garantizar que la transacción se guarde. Esto elimina la necesidad de intervención manual.