Crear Web Service SAP R3

De wiki
Saltar a: navegación, buscar

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 nombre 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

Cuando hay muchas transacciones es necesario variar el timeout de las solicitudes que se hacen a SAP. Si bien utilizamos iteradores para extraer datos en pedazos pequeños, hay veces que el volumen es demasiado. La solución oficial para cambiar el TIMEOUT es la siguiente:

  • 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 alto.

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>