Envío de IDOCs Mediante HTTP

TAPM50 Workload Analysis
Envo de IDOCs mediante

HTTP
Eduardo Gonzlez Bautista
2005 REALTECH
Copyright
Copyright 2005 SAP ESPAA. Reservados todos los derechos.

Prohibida la distribucin, reproduccin o traduccin de este
manual o de parte del mismo, sea cual sea el fin y la forma, sin
la autorizacin expresa por escrito de SAP ESPAA. La
informacin contenida en este manual puede modificarse o
complementarse sin previo aviso.
Reservados todos los derechos.
2005 REALTECH
Resumen del curso
2005 REALTECH
Objetivos del curso
Una vez terminado este curso, podr:

z Conocer las posibilidades ofrecidas por
la interfaz IDoc para el intercambio
electrnico de datos por HTTP
z Utilizar la interfaz IDoc
2005 REALTECH
Antes de empezar
z Requisitos previos:
Conocimientos bsicos del sistema R/3
z A quien va dirigido:
Administradores
Consultores
Miembros del equipo de proyecto
z Duracin: 1,5 Horas
2005 REALTECH
Contenidos
Resumen
Unidad 1
Introduccin
Unidad 7
Testeo del escenario

distribuido
Unidad 2
Configuracin del protocolo

HTTP
Unidad 8
Procesamiento de errores
Unidad 3
Definicin de servicios ICF
Unidad 4
Definicin de destinos RFC
Unidad 5
Configuracin del entorno

ALE
Conclusiones
Apndices
2005 REALTECH
Introduccin
Introduccin
Configuracin del
protocolo HTTP
Definicin de
servicios ICF
Definicin de
destinos RFC
Configuracin del
escenario ALE
Procesamiento de
errores
2005 REALTECH
Contenidos/Objectivos
Contenidos
z Concepto de IDoc y trminos fundamentales
z Flujo de datos y procesos en la interfaz IDoc
Objetivos
Una vez terminado esta unidad, podr:
z Explicar los trminos IDoc, EDI y ALE
z Identificar los pasos bsicos en el proceso de IDocs
2005 REALTECH
Qu es un IDoc?
IDoc es un formato standard de SAP para la transferencia electrnica de

datos entre sistemas
IDoc significa Intermediate Document. Es intermedio por dos aspectos:
Mensaje orientado Los datos estn almacenados en los sistemas como

documentos de aplicacin. Es este documento de aplicacin el lenguaje
hablado por los sistemas involucrados
Asncrono Los datos son almacenados en el IDoc depus de la creacin del
documento de aplicacin.
2005 REALTECH
EDI y ALE
z
Existen dos reas de aplicacin

especiales de IDocs:
EDI Intercambio electrnico

de datos entre diferentes
compaias
ALE Intercambio electrnico

de datos entre diferentes
sistemas de una compaa
Los sistemas pueden intercambiar IDocs directamente o traducidos a otros

formatos estndares por subsistemas EDI
Las aplicaciones que utilicen IDocs como formato de intercambio deben

ser capaces de escribir datos en un IDoc, leer datos de un IDoc o ambos
En los sistemas SAP nicamente se utilza el formato IDoc
2005 REALTECH
Flujo del proceso: Envo de datos
El envo de datos mediante IDocs desde un sistema SAP a otro sistema

externo es conocido como Proceso de Salida
El proceso de salida incluye los siguientes pasos:
2005 REALTECH

Creacin del documento de aplicacin
2005 REALTECH

Creacin del correspondiente IDoc de salida
2005 REALTECH

Determinacin del interlocutor y de la puerta y verificacin de ambos
2005 REALTECH

Determinacin del interlocutor y de la puerta y verificacin de ambos
Envo del IDoc al sistema externo
2005 REALTECH
Configuracin: Envo de datos
Mediante la definicin de la puertas se determina el sistema que recibir

los IDocs y los parmetros tcnicos necesarios
2005 REALTECH
Configuracin: Envo de datos
Un acuerdo de interlocutor establece la relacin entre el tipo de mensaje

salida, el interlocutor que lo va a recibir y la puerta por donde va a ser
enviado.
2005 REALTECH
Flujo del proceso: Recepcin de

datos
La recepcin de datos envados desde sistemas externos y el proceso

subsiguiente en el sistema SAP es conocido Proceso de Entrada
El proceso de entrada incluye los siguientes pasos:
2005 REALTECH

datos

Recepcin de los datos del IDoc
2005 REALTECH

datos

Creacin del IDoc de entrada
2005 REALTECH

datos

Determinacin del tipo via acuerdo de interlocutores
2005 REALTECH

datos

Determinacin del tipo via acuerdo de interlocutores
2005 REALTECH
Configuracin: Recepcin de datos
Los elementos que intervienen en el proceso de entrada coinciden con los elementos
que intervienen en el proceso de salida
2005 REALTECH
Resumen
Ahora puede:
z Entender los conceptos IDoc, EDI y ALE
z Describir los procesos de envo y recepcin de IDocs
z Enumerar los elementos necesarios para la configuracin de los
procesos de envo y recepcin de IDocs
2005 REALTECH
Configuracin del protocolo HTTP

Introduccin
Configuracin del
protocolo HTTP
Definicin de
servicios ICF
Definicin de
destinos RFC
Configuracin del
escenario ALE
Procesamiento de
errores
2005 REALTECH
Contenidos
z Verificacin/Activacin de ICM (Internet Communication Manager)
z Verificacin/Activacin del servicio HTTP
z Configuracin de los parmetros del servicio HTTP
Objetivos
z Explicar el componente ICM
z Verificar y/o activar los servicios ICM y HTTP
z Configurar los parmetros del servicio HTTP
2005 REALTECH
Monitor ICM
Browser
GUI
Java Dispatcher
BBDD
ABAP schema
JAVA schema
2005 REALTECH
Java Server
Process
Dispatcher
Java Server
Process
Message
Service
Java Server
Process
Message
server
Work Process
Enqueue
Service
Work Process
Work Process
Enqueue
server
ICM
ICM soporta varios

protocolos (HTTP,
HTTPS y SMTP)
Gateway
ICM es el proceso
responsable de las
comunicaciones
mediante HTTP
Otros
sistemas
Internet
Monitor ICM
z La configuracin del puerto HTTP se compone de las

siguientes tareas:
2005 REALTECH
Monitor ICM

siguientes tareas:
Determinar si ICM est funcionando y HTTP est activo
2005 REALTECH
Monitor ICM

siguientes tareas:
Ajustar la configuracin de los parmetros HTTP
2005 REALTECH
Monitor ICM

siguientes tareas:
Ajustar la configuracin de los parmetros HTTP
Verificar si los prametros HTTP estn activos
2005 REALTECH
Verificacin del servicio HTTP
z Transaccin: SMICM
Si el ICM est
funcionando, deber
mostrar el status
runs
En caso contrario, ser

necesario reiniciar el
proceso desde el
monitor ICM o
implementando el
parmetro
rdisp/start_icman en el
perfil de la instancia
2005 REALTECH
Verificacin del servicio HTTP
Go toServices
El servicio HTTP deber tener el status Activo
El puerto del servicio deber ser uno de los definidos en el

parmetro icm/server_port_<x>
2005 REALTECH
Configuracin de parmetros HTTP
Existe un conjunto de parmetros del sistema que controlan las

comunicaciones HTTP:
icm/plugin_<x> Determina la localizacin y el nombre del

plug-in que administra las peticiones HTTP.
icm/plugin_0 para HTTP

icm/plugin_1 para HTTPS
icm/plugin_2 para SMTP
icm/server_port_<x> Define el puerto y alguna propiedad

opcional para el protocolo
2005 REALTECH
El indicador <x> debe corresponderse con el mismo valor

definido en el parmetro icm/plugin_<x> para el mismo
protocolo
rdisp/start_icman El proceso ICM se iniciar si el valor del

parmetro es true en la configuracin del perfil de instancia
Por defecto el valor del parmetro es true
ms/http_port Determina el puerto sobre el cul SAP

Message Server acepta solicitudes HTTP
2005 REALTECH
z Goto ParametersDisplay
z
El puerto definido para el

ICM en la configuracin
del perfil no debe ser
utilizado por otro
servicio o programa. De
otra forma, el servicio
para el protocolo no
funcionar
Para activar las

modificaciones a los
parmetros de
configuracin del
servicio HTTP es
necesario reiniciar el
sistema
2005 REALTECH
Resumen
Ahora puede:
z Entender y explicar el componente ICM
z Verificar la configuracin necesaria para el funcionamiento del
servicio HTTP
z Configurar el servicio HTTP
2005 REALTECH
Definicin de servicios ICF

Introduccin
Configuracin del
protocolo HTTP
Definicin de
servicios ICF
Definicin de
destinos RFC
Configuracin del
escenario ALE
Procesamiento de
errores
2005 REALTECH
Contenidos
z Creacin del servicio ICF para la recepcin de mensajes XML
z Creacin del servicio ICF para el testeo
Objetivos
z Explicar Internet Control Framework
z Crear servicios Internet Control Framework
2005 REALTECH
Internet Control Framework
z Transaccin: SICF
Proporciona un entorno para la

gestin de solicitudes HTTP as
como herramientas (debuggin,
trace, ...) para el anlisis de las
mismas
default_host representa la raz de

la URL (<servidor>:<puerto>)
Los nodos inferiores del rbol

representan las rutas de los
diferentes servicios
2005 REALTECH
Internet Control Framework
z Existen 3 puntos importantes que deben recordarse sobre

la estructura del ICF :
SAP suministra todos los servicios estndares bajo el nodo

sap
No debern crearse nuevos servicios bajo este nodo
Los servicios creados bajo el nodo public no requieren logon

al sistema
Todos los servicios se crean inactivos
2005 REALTECH
Definicin del servicio
z Para definir el servicio del ejemplo, se necesitan completar

las siguientes tareas:
2005 REALTECH

Creacin de un nuevo nodo
2005 REALTECH

Creacin de un servicio para la gestin de los mensajes XML

de entrada
2005 REALTECH


de entrada
Definicin del gestor de solicitudes
2005 REALTECH


de entrada
Activacin del servicio
2005 REALTECH


de entrada
Creacin de un servicio de test
2005 REALTECH


de entrada
Testeo del nuevo servicio
2005 REALTECH
Servicio/Host Virtual Crear Servicio
O click en Nuevo (Icono)
En la ventana emergente deber indicarse un nombre para el

servicio (ej. customer ) y seleccionar el radio button Servicio
Independiente
A continuacin se mostrar otra pantalla donde podrn

definirse las propiedades del elemento
2005 REALTECH
El propsito de este nodo es el de agrupar los servicios

por lo que slo ser necesario completar el campo
Descripcin (ej. Custom Top Level Node ) de la nueva
pantalla
Creacin de un servicio
Seleccionar el nuevo nodo creado y Servicio/Host Virtual

Crear Servicio
O click en Nuevo (Icono)
En la ventana emergente deber indicarse, de nuevo, un

nombre para el servicio (ej. xmlInbound ) y seleccionar el
radio button Servicio Independiente
A continuacin se mostrar otra vez la pantalla donde podrn

definirse las propiedades del elemento
2005 REALTECH
Gestor de solicitudes
En la pestaa Lista contr. de la ventana de definicin de

propiedades del servicio se indica el gestor de solicitudes
2005 REALTECH
CL_HTTP_IDOC_XML_REQUEST es el gestor estndar

proporcionado por SAP para el proceso de Idoc XML
Este gestor transforma los datos del mensaje XML de

entrada a formato Idoc, lo transfiere a la capa ALE y enva
una respuesta al emisor de la solicitud HTTP
CL_HTTP_IDOC_XML_REQUEST es una clase ABAP que

implementa el mtodo HANDLE_REQUEST de la interface
IF_HTTP_EXTENSION
La implementacin del mtodo proporciona la lgica de

proceso del gestor y crea la respuesta HTTP
Seleccionar el servicio y Servicio/Host Virtual Activar
2005 REALTECH
SAP proporciona un servicio pblico de ping

(default_host/test/sap/public/ping)
Para la creacin del servicio de test, repetir las tareas previas

indicando de nuevo un nombre para el servicio (ej. ping) y una
descripcin (ej. Ping with logon)
El gestor de solicitud para el servicio de test ser

CL_HTTP_EXT_PING
2005 REALTECH
El servicio debe ser activado
Test del nuevo servicio
En el navegador de internet introducir la URL

http://<server>:<port>/sap/public/ping donde <server> es la
direccin (ej. IP) del servidor SAP y <port> es el puerto HTTP
definido en el parmetro del perfil de la instancia
Si el ping se ha ejecutado con xito, el navegador mostrar el

mensaje Server reached successfully
Si el ping no se ha ejecutado con xito, el navegador mostrar

el mensaje You are not authorized to view this page
2005 REALTECH
Test del nuevo servicio
En el navegador de internet introducir la URL

http://<server>:<port>/customer/ping donde <server> es la
direccin (ej. IP) del servidor SAP y <port> es el puerto HTTP
definido en el parmetro del perfil de la instancia
Este test requiere autenticacin en el sistema SAP
El navegador solicitar la identificacin del usuario
Si el ping se ha ejecutado con xito, el navegador mostrar el

mensaje Server reached successfully
Si el ping no se ha ejecutado con xito, el navegador mostrar

el mensaje You are not authorized to view this page
2005 REALTECH
Resumen
Ahora puede:
z Entender y explicar Internet Control Framework
z Crear y configurar servicios en la estructura ICF
z Testear los servicios creados
2005 REALTECH
Definicin de destinos RFC

Introduccin
Configuracin del
protocolo HTTP
Definicin de
servicios ICF
Definicin de
destinos RFC
Configuracin del
escenario ALE
Procesamiento de
errores
2005 REALTECH
Contenidos
z Definicin de un destino RFC
Objetivos
z Crear un destino RFC
2005 REALTECH
Creacin de destino RFC
z Transaccin: SM59
Tratar Crear
Indicar un nombre para el destino RFC siguiendo la

convencin de nombres
O click en Crear (pulsador)
<sid>CLT<ccc>_<service> donde <sid> es el ID del

sistema, <ccc> es el nmero de mandante y <service> es
el nombre del servicio que va a utilizar el destino RFC
Seleccionar el tipo de conexin H (Conexin HTTP a sistema

R/3) e indicar un descripcin
2005 REALTECH
En la pestaa Opciones tcnicas, informar los campos

Mq.destino con la direccin de la mquina de destino (p.e.
IP), Nm.servicio con el puerto HTTP (p.e. 8000) y PrefVaAcc
con la ruta del servicio (p.e. /customer/ping o
customer/xmlInbound)
En la pestaa Entr.sist/Segur indicar nicamente los datos de

Entrada al sistema conservando los valores de Opciones de
seguridad por defecto
2005 REALTECH
TestConexin
O click en Probar conexin (pulsador)
Para el servicio ping, el sistema mostrar el mensaje Server

reached successfully
Para el servicio xmlInbound, el sistema mostrar el mensaje

HTTP/1.0 409 ENCODING=UFT-8 is missing
2005 REALTECH
El gestor del servico HTTP/XML mostrar siempre este

mensaje si el segmento de cabecera del mensaje no
contiene la cadena encoding=UTF-8. La codificacin a
UTF-8 es un prerequisitio para este servicio
Resumen
Ahora puede:
z Crear destinos RFC de tipo Conexin HTTP a sistema R/3
z Verificar los destino RFC creados
2005 REALTECH
Atencin
z Antes de continuar con la siguiente seccin, donde se

configurar el escenario ALE, debern implementarse los
sistemas involucrados en el intercambio de mensajes
como emisores (p.e. con un destino RFC) y como
receptores (p.e. con un servicio ICF)
2005 REALTECH
Configuracin del escenario ALE

Introduccin
Configuracin del
protocolo HTTP
Definicin de
servicios ICF
Definicin de
destinos RFC
Configuracin del
escenario ALE
Procesamiento de
errores
2005 REALTECH
Contenidos
z Creacin del modelo de distribucin
z Definicin de la puerta ALE tipo XML HTTP
z Creacin del acuerdo entre interlocutores
Objetivos
z Configurar un escenario distribuido para el intercambio de mensajes
2005 REALTECH
Creacin del modelo de distribucin
z La configuracin del escenario ALE para distribucin de

mensajes se compone de la siguientes tareas:
2005 REALTECH

Creacin un modelo de distribucin
2005 REALTECH

Definicin de una puerta ALE tipo XML HTTP
2005 REALTECH

Definicin de una puerta ALE tipo XML HTTP
Creacin del acuerdo entre intelocutores
2005 REALTECH
z Transaccin: BD64
TratarVista modeloCrear
O click en Crear vista modelo (pulsador)
En la ventana emergente deber indicarse un Texto breve y un

Nombre tcnico para la nueva vista modelo
2005 REALTECH
Para aadir un tipo de mensaje a la vista modelo, seleccionar

y TratarInsertar tipo mensaje
O click en Insertar tipo mensaje (pulsador)
Informar los campos Emisor con el nombre del sistema lgico

emisor, Destinatario con el sistema lgico receptor y Tipo de
mensaje con el nombre del tipo de mensaje a enviar (p.e.
MATMAS o ALEUAD)
2005 REALTECH
Definicin de una puerta ALE tipo XML

HTTP
z Transaccin: WE21
Seleccionar el nodo XML-HTTP y PuertaCrear
O click Nuevo (Icono)
Indicar un nombre para la puerta, una descripcin y

seleccionar el destino RFC creado en la seccin anterior
En Tipo de Contenido, marcar radio button Text/XML
z Las puertas deben crearse tanto en el sistema emisor

como en el receptor
2005 REALTECH
Creacin del acuerdo entre interlocutores
z Transaccin: WE20
Interlocutor EDICrear
O click en Nuevo (icono)
Indicar el sistema lgico elegido en el campo Ninterl.EDI y el

tipo de interlocutor adecuado en Tp.int.EDI
2005 REALTECH
En este caso, el tipo de interlocutor EDI ser siempre LS

(Sistema lgico)
Creacin del acuerdo entre interlocutores
En la tabla Parmetros salida se establece la relacin entre el

tipo de mensaje de salida, el interlocutor emisor y la puerta
por donde va a ser enviado
En la tabla Parm.entrada se establece la relacin entre el

tipo de mensaje de entrada, el interlocutor receptor y el
cdigo de operacin que identifica la forma de procesamiento
del mensaje
z Los acuerdos entre interlocutores deben ser creados en

los sistemas involucrados en el escenario del intercambio
electrnico de datos
2005 REALTECH
Resumen
Ahora puede:
z Explicar el escenario ALE
z Enumerar y configurar los elementos que componen el
escenario ALE
2005 REALTECH
Introduccin
Configuracin del
protocolo HTTP
Definicin de
servicios ICF
Definicin de
destinos RFC
Configuracin del
entorno ALE
Procesamiento de
errores
2005 REALTECH
Contenidos
z Procesamiento de errores
z RFC transaccional
Objetivos
Una vez terminado este curso, podr:
z Reprocesar los mensajes errneos
z Conocer los errores producidos al procesar los mensajes
2005 REALTECH
z Cuando se produce un error en la comunicacin con RFC,

el sistema intenta de nuevo establecer la comunicacin un
determinado nmero de veces durante un intervalo
definido
z Tan pronto como alguno de los intentos tenga xito, el
sistema dar como finalizado el proceso
z Si ninguno de los intentos de conexin finaliza con xito,
el Idoc permanecer en la cola tRFC y el tRFC ser aadido
a la lista de tRFCs fracasados
2005 REALTECH
RFC transaccional
z Transaccin: SM58
Permite el reproceso de los IDocs errneos por fallos en la

comunicacin con tRFC
Si el reproceso tiene xito, el IDoc es transmitido y el tRFC es

borrado de la lista de tRFC fracasados
z Este mtodo garantiza el envo nico de cada documento

y proporciona un mtodo para el reproceso de IDocs
despus de errores en la comunicacin
2005 REALTECH
IDocs errneos
z Los errores de comunicacin con puertas XML HTTP

pueden generar un Idoc con status 02
z Esto indica dos tipos de errores
Error de comunicacin al envar con HTTP
Error al envar con HTTP
2005 REALTECH
Resumen
Ahora puede:
z Comprobar el estado de un mensaje
z Reprocesar un mensaje errneo
2005 REALTECH
Conclusiones
Introduccin
Configuracin del
Protocolo HTTP
Definicin de
Servicios ICF
Definicin de
Destinos RFC
Configuracin del
escenario ALE
Procesamiento de
errores
2005 REALTECH
Conclusiones
Ahora puede:
z Verificar y configurar el protocolo HTTP

z Crear los servicios ICF que gestin la entrada de
mensajes va HTTP
z Definir los destinos RFC para establecer la
comunicacin entre los sistemas involucrados
z Configuracin del escenario ALE
2005 REALTECH
Bibliografa
z SAP help portal http://help.sap.com

z Notas en el rea de aplicacin BC
z SAP Service Marketplace
http://service.sap.com/netweaver
http://service.sap.com/ha
z SAP Developper Network
2005 REALTECH
Apndice
Introduccin
Configuracin del
Protocolo HTTP
Definicin de
Servicios ICF
Definicin de
Destinos RFC
Configuracin del
escenario ALE
Procesamiento de
errores
2005 REALTECH

Envío de IDOCs Mediante HTTP

Diunggah oleh

Informasi Dokumen

Hak Cipta

Format Tersedia

Bagikan dokumen Ini

Bagikan atau Tanam Dokumen

Opsi Berbagi

Apakah menurut Anda dokumen ini bermanfaat?

Apakah konten ini tidak pantas?

Hak Cipta:

Format Tersedia

Envío de IDOCs Mediante HTTP

Diunggah oleh

Hak Cipta:

Format Tersedia

TAPM50 Workload Analysis

Envo de IDOCs mediante

Copyright 2005 SAP ESPAA. Reservados todos los derechos.

Resumen del curso

Objetivos del curso

Una vez terminado este curso, podr:

Conocimientos bsicos del sistema R/3

Miembros del equipo de proyecto

z Duracin: 1,5 Horas

Testeo del escenario

Configuracin del protocolo

Definicin de servicios ICF

Definicin de destinos RFC

Configuracin del entorno

IDoc es un formato standard de SAP para la transferencia electrnica de

IDoc significa Intermediate Document. Es intermedio por dos aspectos:

Mensaje orientado Los datos estn almacenados en los sistemas como

Existen dos reas de aplicacin

EDI Intercambio electrnico

ALE Intercambio electrnico

Los sistemas pueden intercambiar IDocs directamente o traducidos a otros

Las aplicaciones que utilicen IDocs como formato de intercambio deben

En los sistemas SAP nicamente se utilza el formato IDoc

Flujo del proceso: Envo de datos

El envo de datos mediante IDocs desde un sistema SAP a otro sistema

El proceso de salida incluye los siguientes pasos:

Flujo del proceso: Envo de datos

El envo de datos mediante IDocs desde un sistema SAP a otro sistema

El proceso de salida incluye los siguientes pasos:

Creacin del documento de aplicacin

Flujo del proceso: Envo de datos

El envo de datos mediante IDocs desde un sistema SAP a otro sistema

El proceso de salida incluye los siguientes pasos:

Creacin del documento de aplicacin

Creacin del correspondiente IDoc de salida

Flujo del proceso: Envo de datos

El envo de datos mediante IDocs desde un sistema SAP a otro sistema

El proceso de salida incluye los siguientes pasos:

Creacin del documento de aplicacin

Creacin del correspondiente IDoc de salida

Determinacin del interlocutor y de la puerta y verificacin de ambos

Flujo del proceso: Envo de datos

El envo de datos mediante IDocs desde un sistema SAP a otro sistema

El proceso de salida incluye los siguientes pasos:

Creacin del documento de aplicacin

Creacin del correspondiente IDoc de salida

Determinacin del interlocutor y de la puerta y verificacin de ambos

Envo del IDoc al sistema externo

Configuracin: Envo de datos

Mediante la definicin de la puertas se determina el sistema que recibir

Configuracin: Envo de datos

Un acuerdo de interlocutor establece la relacin entre el tipo de mensaje

Flujo del proceso: Recepcin de

La recepcin de datos envados desde sistemas externos y el proceso

El proceso de entrada incluye los siguientes pasos:

Flujo del proceso: Recepcin de

La recepcin de datos envados desde sistemas externos y el proceso

El proceso de entrada incluye los siguientes pasos:

Recepcin de los datos del IDoc

Flujo del proceso: Recepcin de

La recepcin de datos envados desde sistemas externos y el proceso

El proceso de entrada incluye los siguientes pasos:

Recepcin de los datos del IDoc

Creacin del IDoc de entrada