Diferencia entre revisiones de «Crear Web Service SAP R3»

De wiki
Saltar a: navegación, buscar
(Página creada con «== Resumen == Para extraer los datos de las tablas de SAP es necesario crear una función y exponerla en un Web Service. == Tablas consultadas == === Customer === {|cl...»)
 
(Exponer función en Web Service)
Línea 122: Línea 122:
  
 
Es importante al momento de escoger el endpoint para la función marcar el check "Mapping der Namen", este check hace que tanto el endpoint como la función sean expuestas usando notación CamelCase (XML es case sensitive y necesitamos que la función sea expuesta a través del web service tomando eso en cuenta).
 
Es importante al momento de escoger el endpoint para la función marcar el check "Mapping der Namen", este check hace que tanto el endpoint como la función sean expuestas usando notación CamelCase (XML es case sensitive y necesitamos que la función sea expuesta a través del web service tomando eso en cuenta).
 +
 +
== Actualizar el timeout ==
 +
 +
Se investigó a fondo la razón de las fallas y se encontró que eran provocadas por un "TIMEOUT" arrojado desde SAPR3, ya que el tiempo máximo de respuesta es superado lo que ocasiona un cierre la conexión.
 +
 +
Ya de nuestro lado estamos utilizando iteradores para extraer los datos en trozos pequeños, sin embargo el "TIMEOUT" persiste. Este problema no es nuevo para nosotros, nos ha ocurrido anteriormente con otros clientes con grandes volúmenes de datos, la solución según la documentación oficial puede ser consultada aca:
 +
 +
Timeout:
 +
http://help.sap.com/saphelp_nw73/helpdata/en/48/88b52977323cb8e10000000a42189d/content.htm
 +
Server Port:
 +
http://help.sap.com/saphelp_nw73/helpdata/en/48/3ae05299c172d0e10000000a42189c/content.htm
 +
 +
Específicamente la parte que nos interesa corregir es:
 +
Recommendation
 +
In systems where the standard timeout setting of 60 seconds for the keep-alive and processing timeouts is not sufficient due to long-running applications, SAP recommends that both the TIMEOUT and PROCTIMEOUT parameters are set for the services concerned so that they can be configured independently of each other. The TIMEOUT value should not be set unnecessarily high.
 +
We recommend you set this parameter as follows:
 +
icm/server_port_0 = PROT=HTTP,PORT=1080,TIMEOUT=60,PROCTIMEOUT=600
 +
in order to allow a maximum processing time of 10 minutes.
 +
Recomendamos asignar los valores "TIMEOUT=120,PROCTIMEOUT=900" los cuales han funcionado anteriormente para clientes con un volumen de datos similar al de ustedes.
 +
 +
Si tiene alguna duda o necesita alguna información adicional no dude en contactarnos. Saludos.
  
 
== Request para consumir el Web Service ==
 
== Request para consumir el Web Service ==

Revisión de 18:16 14 jun 2017

Contenido

Resumen

Para extraer los datos de las tablas de SAP es necesario crear una función y exponerla en un Web Service.


Tablas consultadas

Customer

columna descripción
KNB1 Clientes de una Sociedad.
KNA1 Name, Region, Address y phone.
KNKK Credit Amount
ADR6 Email.
KNVP Representative from RRHH.
KNVV Representative from Sales.

Representative

columna descripción
PA0002 Representative from RRHH.
TVGRT Representative from Sales.
KNKK Monto de Crédito.

Product

columna descripción
MARA Product.
MAKT Name.
KONP, A004 Price.

Stock

columna descripción
MARD Stock.

Warehouse

columna descripción
T001L Warehouse.

Term

columna descripción
T052 Terms.

Invoice, CreditNote, DebitNote

columna descripción
VBRK Billing Document (sales document).
VBPA Representative from RRHH.
VRKPA Representative from Sales.
BSID Pending.
BSAD Pending.

Crear función a exponer

Pasos:

1. Navegar hasta la transacción SE37 en SAP y copiar el módulo de funciones RFC_READ_TABLE con el nomber ZNIMBOX_RFC_READ_TABLE (debe ser obligatoriamente este nombre)

2. En el código fuente de la función, ubicar la sección "ASSIGN WORK TO CASTING TYPE” cerca de la línea 165 y reemplazarlo con el siguiente código"

 DATA: BEGIN OF WORK, BUFFER(30000), END OF WORK.
 
 FIELD-SYMBOLS: <WA> TYPE ANY, <COMP> TYPE ANY.
 " --- begin of modification
 " ASSIGN WORK TO <WA> CASTING TYPE (QUERY_TABLE).
 DATA: tab_ref TYPE REF TO data.
 CREATE DATA tab_ref TYPE (query_table).
 ASSIGN  tab_ref->* TO <wa>.
 " --- end of modification
 IF ROWCOUNT > 0.
   ROWCOUNT = ROWCOUNT + ROWSKIPS.
 ENDIF.
 
 SELECT * FROM (QUERY_TABLE) INTO <WA> WHERE (OPTIONS). 

Esta sustitución en el código de la función RFC_READ_TABLE permite que la nueva función pueda leer campos de tipo float.

3. Guardar y activar la nueva funcion presionando Ctrl + F3

Exponer función en Web Service

Seguir las indicaciones expuestas en el siguiente documento para exponer la función y obtener el WSDL que necesitamos: Archivo:ExposeWebService.pdf

Es importante al momento de escoger el endpoint para la función marcar el check "Mapping der Namen", este check hace que tanto el endpoint como la función sean expuestas usando notación CamelCase (XML es case sensitive y necesitamos que la función sea expuesta a través del web service tomando eso en cuenta).

Actualizar el timeout

Se investigó a fondo la razón de las fallas y se encontró que eran provocadas por un "TIMEOUT" arrojado desde SAPR3, ya que el tiempo máximo de respuesta es superado lo que ocasiona un cierre la conexión.

Ya de nuestro lado estamos utilizando iteradores para extraer los datos en trozos pequeños, sin embargo el "TIMEOUT" persiste. Este problema no es nuevo para nosotros, nos ha ocurrido anteriormente con otros clientes con grandes volúmenes de datos, la solución según la documentación oficial puede ser consultada aca:

Timeout: http://help.sap.com/saphelp_nw73/helpdata/en/48/88b52977323cb8e10000000a42189d/content.htm Server Port: http://help.sap.com/saphelp_nw73/helpdata/en/48/3ae05299c172d0e10000000a42189c/content.htm

Específicamente la parte que nos interesa corregir es: Recommendation In systems where the standard timeout setting of 60 seconds for the keep-alive and processing timeouts is not sufficient due to long-running applications, SAP recommends that both the TIMEOUT and PROCTIMEOUT parameters are set for the services concerned so that they can be configured independently of each other. The TIMEOUT value should not be set unnecessarily high. We recommend you set this parameter as follows: icm/server_port_0 = PROT=HTTP,PORT=1080,TIMEOUT=60,PROCTIMEOUT=600 in order to allow a maximum processing time of 10 minutes.

Recomendamos asignar los valores "TIMEOUT=120,PROCTIMEOUT=900" los cuales han funcionado anteriormente para clientes con un volumen de datos similar al de ustedes.

Si tiene alguna duda o necesita alguna información adicional no dude en contactarnos. Saludos.

Request para consumir el Web Service

Es importante asegurarnos que el request para consumir el Web Service cumpla con las siguientes condiciones. Esto es automático si se exporta el web service desde el ERP pero debe ser configurado específicamente si la función se exporta desde PI

  • El tag soapenv debe ser de la siguiente manera, atributos deben ser así:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:sap-com:document:sap:soap:functions:mc-style">
  • Al exponer la función ha de quedar con el nombre ZnimboxRfcReadTable.

Siendo el tag urn:

<urn:ZnimboxRfcReadTable>...</urn:ZnimboxRfcReadTable>
  • La mayoría de los tags usan el standard Java, donde la primera letra de cada palabra es mayúscula y el resto minúsculas (excepto: item, soapenv, urn)

Los tags del request deben quedar de la siguiente manera:

<soapenv:Header/>
<Fieldname>...</Fieldname>
<QueryTable>...</QueryTable>
<Fields>
  <item>
    <Fieldname>KUNNR</Fieldname>
    <Offset />
    <Length />
    <Type />
    <Fieldtext/>
  </item>
</Fields>

Los tags del response deben quedar:


      <ns0:ZnimboxRfcReadTable.Response xmlns:ns0="urn:sap-com:document:sap:rfc:functions">
         <Data>
            <item>
               <Wa/>
            </item>
            <item>
               <Wa></Wa>
            </item>
         </Data>
         <Fields>
            <item>
               <Fieldname></Fieldname>
               <Offset></Offset>
               <Length></Length>
               <Type></Type>
               <Fieldtext></Fieldtext>
            </item>
         </Fields>
         <Options>
            <item>
               <Text/>
            </item>
         </Options>
      </ns0:ZnimboxRfcReadTable.Response>