Crear Web Service SAP R3 - Historial de revisiones

Gvelasquez en 12:57 7 dic 2017

2017-12-07T12:57:32Z

Rmarimon: /* Actualizar el timeout */

2017-06-14T22:23:16Z

‎Actualizar el timeout

Rmarimon: /* Exponer función en Web Service */

2017-06-14T22:16:07Z

‎Exponer función en Web Service

Rmarimon: 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...»

2015-10-22T12:24:21Z

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...»

Página nueva

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

{|class="wikitable"
!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 ===

{|class="wikitable"
!columna!!descripción
|-
|PA0002||Representative from RRHH.
|-
|TVGRT||Representative from Sales.
|-
|KNKK||Monto de Crédito.
|}

=== Product ===

{|class="wikitable"
!columna!!descripción
|-
|MARA||Product.
|-
|MAKT||Name.
|-
|KONP, A004||Price.
|}

=== Stock ===

{|class="wikitable"
!columna!!descripción
|-
|MARD||Stock.
|}

=== Warehouse ===

{|class="wikitable"
!columna!!descripción
|-
|T001L||Warehouse.
|}

=== Term ===

{|class="wikitable"
!columna!!descripción
|-
|T052||Terms.
|}

=== Invoice, CreditNote, DebitNote ===

{|class="wikitable"
!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"

<pre>
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).
</pre>

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: [[File: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).

== 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í:

<pre>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:sap-com:document:sap:soap:functions:mc-style">
</pre>

* Al exponer la función ha de quedar con el nombre ZnimboxRfcReadTable.

Siendo el tag urn:

<pre>
<urn:ZnimboxRfcReadTable>...</urn:ZnimboxRfcReadTable>
</pre>

* 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:

<pre>
<soapenv:Header/>
</pre>

<pre>
<Fieldname>...</Fieldname>
</pre>

<pre>
<QueryTable>...</QueryTable>
</pre>

<pre>
<Fields>
<item>
<Fieldname>KUNNR</Fieldname>
<Offset />
<Length />
<Type />
<Fieldtext/>
</item>
</Fields>
</pre>

Los tags del response deben quedar:

<pre>

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

</pre>

@@ Línea 125: / Línea 125: @@
 == 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.
+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:
-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:
-−
 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.
-Si tiene alguna duda o necesita alguna información adicional no dude en contactarnos. Saludos.
+'''Recomendamos asignar los valores'''
 == Request para consumir el Web Service ==

← Revisión anterior		Revisión de 22:16 14 jun 2017
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 ==

@@ Línea 92: / Línea 92: @@
 Pasos:
-. 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)
+. 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)
 . 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"