Saltar al contenido

Actividad de Recepción de IDoc de SAP

Introducción

Una actividad de SAP Recepción de IDoc, utilizando su conexión SAP, recibe un Documento Intermedio (IDoc) saliente de SAP y está destinada a ser utilizada como fuente en una operación.

Para enviar un IDoc entrante a SAP, utiliza la actividad IDoc.

Requisitos previos

Antes de utilizar esta actividad, se deben cumplir requisitos previos adicionales.

Crear una actividad de Recepción de IDoc de SAP

Una instancia de una actividad de SAP Recepción de IDoc se crea a partir de una conexión SAP utilizando su tipo de actividad Recepción de IDoc.

Para crear una instancia de una actividad, arrastra el tipo de actividad al lienzo de diseño o copia el tipo de actividad y pégalo en el lienzo de diseño. Para más detalles, consulta Crear una instancia de actividad o herramienta en Reutilización de componentes.

Una actividad existente de SAP Recepción de IDoc se puede editar desde estas ubicaciones:

Configurar una actividad de Recepción de IDoc de SAP

Sigue estos pasos para configurar una actividad de SAP Recepción de IDoc:

Paso 1: Ingresar un nombre y seleccionar un tipo de mensaje IDoc

En este paso, se debe proporcionar un nombre para la actividad y seleccionar un tipo de mensaje IDoc. Cada elemento de la interfaz de usuario de este paso se describe a continuación.

Configuración de la actividad SAP Recibir IDoc paso 1

  • Nombre: Ingrese un nombre para identificar la actividad. El nombre debe ser único para cada actividad de Recibir IDoc de SAP y no debe contener barras diagonales / ni dos puntos :.

  • Seleccionar un tipo de mensaje IDoc: Esta sección muestra los tipos de mensajes IDoc disponibles en el punto final de SAP.

    • Tipo de mensaje IDoc seleccionado: Después de seleccionar un tipo de mensaje IDoc, se lista aquí.

    • Buscar: Ingrese el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de tipos de mensajes IDoc. La búsqueda no distingue entre mayúsculas y minúsculas. Si los tipos de mensajes IDoc ya se muestran en la tabla, los resultados de la tabla se filtran en tiempo real con cada pulsación de tecla. Para recargar los tipos de mensajes IDoc desde el punto final al buscar, ingrese los criterios de búsqueda y luego actualice, como se describe a continuación.

    • Actualizar: Haga clic en el ícono de actualización o en la palabra Actualizar para recargar los tipos de mensajes IDoc desde el punto final de SAP. Esto puede ser útil si se han agregado tipos de mensajes IDoc a SAP. Esta acción actualiza todos los metadatos utilizados para construir la tabla de tipos de mensajes IDoc que se muestran en la configuración.

    • Seleccionar un tipo de mensaje IDoc: Dentro de la tabla, haga clic en cualquier parte de una fila para seleccionar un tipo de mensaje IDoc. Solo se puede seleccionar un tipo de mensaje IDoc. La información disponible para cada tipo de mensaje IDoc se obtiene del punto final de SAP:

      • Nombre: El nombre del tipo de mensaje IDoc.

      • Descripción: Muestra el nombre del tipo de mensaje IDoc.

    Consejo

    Si la tabla no se llena con los tipos de mensaje IDoc disponibles, la conexión SAP puede no ser exitosa. Asegúrese de estar conectado volviendo a abrir la conexión y volviendo a probar las credenciales.

  • Guardar y salir: Si está habilitado, haga clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

  • Siguiente: Haga clic para almacenar temporalmente la configuración de este paso y continuar al siguiente paso. La configuración no se guardará hasta que haga clic en el botón Finalizado en el último paso.

  • Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.

Paso 2: Seleccionar un tipo de IDoc

En este paso, seleccione un tipo de IDoc. Cada elemento de la interfaz de usuario de este paso se describe a continuación.

Configuración de la actividad SAP Recibir IDoc paso 2

  • Seleccionar un tipo de IDoc: Esta sección muestra los tipos de IDoc disponibles en el punto final de SAP.

    • Tipo de mensaje IDoc seleccionado: El tipo de mensaje IDoc seleccionado en el paso anterior se lista aquí.

    • Tipo de IDoc seleccionado: Después de seleccionar un tipo de IDoc, se lista aquí.

    • Buscar: Ingrese el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de tipos de IDoc. La búsqueda no distingue entre mayúsculas y minúsculas. Si los tipos de IDoc ya se muestran en la tabla, los resultados de la tabla se filtran en tiempo real con cada pulsación de tecla. Para recargar los tipos de IDoc desde el punto final al buscar, ingrese los criterios de búsqueda y luego actualice, como se describe a continuación.

    • Actualizar: Haga clic en el ícono de actualización o en la palabra Actualizar para recargar los tipos de IDoc desde el punto final de SAP. Esto puede ser útil si se han agregado tipos de IDoc a SAP. Esta acción actualiza todos los metadatos utilizados para construir la tabla de tipos de IDoc mostrada en la configuración.

    • Seleccionar un tipo de IDoc: Dentro de la tabla, haga clic en cualquier parte de una fila para seleccionar un tipo de IDoc. Solo se puede seleccionar un tipo de IDoc. La información disponible para cada tipo de IDoc se obtiene del punto final de SAP:

      • Nombre: El nombre del tipo de IDoc.

      • Descripción: Muestra el nombre del tipo de IDoc.

    Consejo

    Si la tabla no se llena con los tipos de IDoc disponibles, la conexión SAP puede no ser exitosa. Asegúrate de estar conectado volviendo a abrir la conexión y volviendo a probar las credenciales.

  • Atrás: Haz clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

  • Siguiente: Haz clic para almacenar temporalmente la configuración de este paso y continuar al siguiente paso. La configuración no se guardará hasta que hagas clic en el botón Finalizado en el último paso.

  • Descartar cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pedirá que confirmes que deseas descartar los cambios.

Paso 3: Revisar los esquemas de datos

Se muestran los esquemas de solicitud o respuesta. Cada elemento de la interfaz de usuario de este paso se describe a continuación.

Configuración de la actividad SAP Recibir IDoc paso 3

  • Esquema de datos: Estos esquemas de datos son heredados por transformaciones adyacentes y se muestran nuevamente durante el mapeo de transformaciones.

    Para obtener información sobre los campos del esquema de IDoc, consulta el Portal de Ayuda de SAP o contacta a tu administrador de SAP o consultor de SAP.

  • Actualizar: Haz clic en el ícono de actualización o en la palabra Actualizar para regenerar esquemas desde el punto final de SAP. Esta acción también regenera un esquema en otras ubicaciones a lo largo del proyecto donde se hace referencia al mismo esquema, como en una transformación adyacente.

  • Atrás: Haz clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

  • Finalizado: Haz clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.

  • Descartar cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Siguientes pasos

Después de configurar una actividad de SAP Recibir IDoc, primero configura una operación, y luego despliega la operación y habilita eventos.

Configurar una operación

Completa la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de la operación. También puedes configurar los ajustes de la operación, que incluyen la capacidad de encadenar operaciones que están en los mismos o diferentes flujos de trabajo.

Las acciones del menú para una actividad son accesibles desde el panel del proyecto y el lienzo de diseño. Para más detalles, consulta el menú de acciones de actividad en Conceptos básicos de conectores.

Las actividades de SAP Recibir IDoc pueden usarse como fuente con estos patrones de operación:

Las operaciones que contienen una actividad de SAP solo pueden tener una actividad de SAP y no pueden contener también actividades de NetSuite, Salesforce, Salesforce Service Cloud, ServiceMax, o SOAP. Ten en cuenta que actualmente hay un problema conocido donde las operaciones que contienen más de uno de estos tipos de actividades parecen ser válidas y pueden ser desplegadas sin error. Sin embargo, la operación fallará en tiempo de ejecución.

Para utilizar la actividad con funciones de scripting, escribe los datos en una ubicación temporal y luego utiliza esa ubicación temporal en la función de scripting.

Desplegar la operación y habilitar eventos

Una vez que la operación esté configurada, despliega la operación. Desplegar la operación activa un interruptor que está presente en la parte inferior de la operación en el lienzo de diseño. Por defecto, la escucha de eventos está deshabilitada.

Para habilitar la escucha de eventos para la operación, haz clic en el interruptor:

consume activity events enabled

Cuando la escucha de eventos está habilitada, la operación se ejecutará cuando sea activada por el evento configurado.

Nota

Las actividades que escuchan el mismo evento en múltiples operaciones o múltiples proyectos rastrearán esos eventos por separado y recibirán un IDoc en cada actividad configurada. Es decir, cada operación configurada con un evento habilitado se ejecutará cuando ocurra el evento.

Después de que la operación se active, puedes validar el comportamiento revisando los registros de la operación. Se realiza una entrada de registro por cada mensaje procesado por la operación que escucha.

Los administradores también pueden habilitar o deshabilitar la escucha de eventos desde la Consola de Administración en la página de Proyectos.

Solución de problemas

Si experimentas problemas, se recomiendan los siguientes pasos de solución de problemas:

  • Confirma que los valores para el Conteo de Oyentes, Destino y Servicio de Puerta de Enlace campos de conexión sean válidos, ya que valores inválidos para estos campos pueden resultar en un error al desplegar la operación o habilitar el oyente.

  • Desactiva el oyente en la operación (descrito arriba), reinicia los agentes privados y vuelve a habilitar el oyente en la operación.

Para pasos adicionales de solución de problemas, consulta Solución de problemas del servicio de escucha.