✒️ABAP Los IDocs de salida

1.- Introducción a las Interfases de Salida.

Los IDocs de salida se pueden generar mediante.

• Output types. Se utilizan cuando la información a enviar se trata de documentos de negocio o mejor llamados transaccionales, como por ejemplo un pedido o una factura. Para ello, la aplicación debe ser EDI/ALE Enable.
• Punteros de modificación:. Se utiliza para replicar datos maestros(son la fuente de información central para su empresa) o modificaciones de los mismos
• Programa de extracción estándar. Igual que los Punteros de modificación.
• Programa de extracción Z:

Puntos de Salida ó (Output types): Se crean a través de la transacción NACE cuando se crea el tipo de salida a través de la transacción NACE, se generán automaticamente registros en las tablas estándar NAST Y TNAR, vale la pena destacar que generalmente los tipos de salida output types son creados por los administradores del sistema SAP o SAPBASIS.

2.- Output types.

Es un método de generación de IDocs de salida que se utiliza para datos transaccionales.

El manejo del lado funcional es el mismo utilizado para impresión de formularios:

• Se define un Output Message(mensaje de salida), configurado como salida ALE /EDI.
• Se asocia dicho mensaje al documento que desea enviarse.
• Se debe configurar además, el mensaje de logística en la herramienta ALE(Acuerdo de Interlocutores)

Pasos para configurar un mensaje vía Output type, son:

• identificamos el tipo de mensaje IDoc a envìar: Por tratarse de documentos de negocio, generalmente se utilizan mensajes estándar y eventualmente, se generen ampliaciones de estos mensajes, para envìar información no contenida en el mismo.
• Definimos el código de proceso de salida: Si se utiliza un tipo de mensaje estándar, se utilizará un código de proceso estándar. Si se han generado ampliaciones para este tipo de mensaje, se modificará el módulo de función del código de proceso utilizando User Exits o ampliaciones.
• Definimos el puerto de salida y la forma de envío.
• Definimos (en el caso en que sea necesario) la función de la puerta ABAP.

3.- Código de Proceso de Salida.

También llamado Process Code de slida, es el que indica como se debe procesar el IDoc de salida.

• Los códigos de proceso de entrada, realmente procesan el IDoc para crear o modificar información en documentos de negocio.
  
• Los códigos de proceso de salida, NO graban información en el documento o en el objeto, sino que obtienen la información del mismo, y la transforman a formato IDoc para poder ser enviada.
• Se definen códigos de procesos por cada tipo de Mensaje (Tipos de IDocs), y cada código de proceso está asociado a un módulo de función, este módulo de función es el encargado de ejecutarlo.
• En la mayoría de los procesos de salida, se utilizan códigos de proceso estándar para la generación de IDocs, ya que la información a envìar generalmente proviene de documentos de negocio.
• Todos los módulos de función estándar asociados a códigos de proceso, cuentan con una serie de ampliaciones, donde puede agregarse código Z, en caso que el Tipo Base vaya asociado a una ampliación Z.
• Para definir códigos de procesos de salida Z, se utilizan la transacción WE41

WE41: Transacción estándar WE41 para la creación de los códigos de proceso de salida.

4.- Punteros de modificación.

Se utilizan para envíar o duplicar datos maestros en sistemas externos, cuando esto datos son creados o modificados.

• BD61: Transaccion que se utiliza para la ACTIVACIÓN global de los punteros de modificación.
• BD50: Transacción que se utiliza para la ACTIVACIÓN de los punteros de modificación de IDocs.
• BD52: Transacción que se utiliza para la GENERACIÓN de los punteros de modificación de IDocs. Debemos definir las tablas y campos, en esta misma transacción BD52.
• Primero introducimos el tipo de Mensaje.
• Segundo, ingresamos el objeto de modificación, la tabla y el campo.
• BD60: Transacción que se utiliza para la CREACIÓN del módulo de funciones que lee los punteros de modificación de un IDoc.
• Para crear la relación Tipo de mensaje y el Modulo de Función, previamente debimos de haber creado el Módulo de función y este es el que ingresaremos posteriormente en la transacción BD60.

Para crear el MODULO DE FUNCIONES Z, tomaremos el encabezado de un módulo estándar y agregaremos nuestro código. La lógica del módulo de función contendrá los siguientes pasos:

• Leer los punteros de modificación generados usando la función CHANGE_POINTERS_READ.
• Analizar los punteros de modificación para determinar cuáles documentos son válidos.
• Determinar la clave de documento de aplicación del paso anterior.
• Seleccionar datos de aplicación de la base de datos, usando la clave de objeto identificada.
• Completar la información del registro de control del IDoc.
• Completar una tabla interna de estructura EDIDD(se utiliza para almacenar datos de un IDOC) con registros de datos para todos los segmentos.
• Llamar al servicio MASTER_IDOC_DISTRIBUTE para crear los datos en la base de datos.
• Actualizar el estado de los punteros modificados.
• Ejecutar un COMMIT WORK.
• Finlamente ejecutaremos el programa RBDMIDOC para ejecutar el IDoc, introduciendo el tipo de mensaje.

Programa RBDMIDOC: Programa que se utiliza para crear IDocs a tráves de punteros de modificación para un tipo de mensaje especifico. Una vez creados los envía al sistema receptor y marca a los punteros de modificación como procesados en el respectivo tipo de mensaje.

Otras transacciones útiles cuando se trabaja con punteros de modificación son:

• BD21: Para seleccionar punteros de modificación.
• BD22: Para borrar punteros de modificación.
• BD40: Para leer punteros de modificación para grupos

5.- Programas de extracción estándar.

Estos programas se utilizan para envíar a los sistemas receptores, DATOS MAESTROS en forma masiva, para cargas iniciales, o cuando se desea replicar información del sistema central a los subsistemas del ambiente.

Programas extractores estándar son:

• BD10: Maestro de Materiales.
  
• BD12: Maestro de Clientes.
• BD 14: Maestro de Proveedores.
• Podemos crear LOS PROPIOS PROGRAMAS EXTRACTORES generadore de IDocs. Estos programas utilizan el módulo de función MASTER_IDOC_DISTRIBUITE para distribuir la información generada a los sistemas receptores.
• Se debe actualizar el Acuerdo de Interlocutores y el Modelo de Distribución, para definir cuales serán los receptores.

6.- Programas de extracción Z.

Pasos a seguir para la creación de un IDoc de salida desde un programa ABAP, son los siguientes:

• Seleccionar la información de la Base de Datos de acuerdo a los parámetros de seleccon ingresados.
• Completar la información correspondiente al registro de control.
• Completar una tabla interna de tipo EDIDD con los registros de datos de los segmentos correspondientes.
• Llamar al servicio de la capa ALE (MASTER_IDOC_DISTRIBUITE) para crear los IDocs en la Base de Datos.
• Ejecutar un COMMIT WORK.
• Enviar el IDoc a su destinatario invocando al programa RSEOUT00.

Una vez completados estos pasos, quedo creado el IDoc. El mismo se guarda fisicamente en las tablas EDIDC y EDID4. Se le puede ver por medio de la transacción WE05.

Transacción WE05: Se utiliza para visualizar un listado con los IDocs existentes en el sistema.

TABLAS ESTANDAR DE IDOC.

• EDIDD: Tabla sirve para almacenar datos de un IDoc
• EDIDC: Almacena los registros de control de un IDoc.
• EDID4: Almacena los registros de datos de un IDoc.