— Integração SAP

Construtor de consultas SAP OData

Monte consultas OData V2 ou V4 corretas para serviços do S/4HANA sem decorar a sintaxe. Roda no navegador; nada é enviado.

Observação: os controles da ferramenta estão em inglês por enquanto.

$filter

Your query

Request URL

/sap/opu/odata/sap/API_SALES_ORDER_SRV/A_SalesOrder?$filter=SalesOrganization%20eq%20'1010'&$select=SalesOrder,SoldToParty,TotalNetAmount&$orderby=SalesOrder%20desc&$top=50&$format=json

CPI OData receiver — Query Options

$filter=SalesOrganization eq '1010'&$select=SalesOrder,SoldToParty,TotalNetAmount&$orderby=SalesOrder desc&$top=50&$format=json

ABAP sample (SM59 destination)

" Sample only. GET requests need no CSRF token; POST/PUT/DELETE must
" first fetch one (header X-CSRF-Token: Fetch) and send it back.
DATA lo_client TYPE REF TO if_http_client.
DATA lv_path   TYPE string VALUE '/A_SalesOrder?$filter=SalesOrganization%20eq%20''1010''&$select=SalesOrder,SoldToParty,TotalNetAmount&$orderby=SalesOrder%20desc&$top=50&$format=json'.

" Recommended: SM59 destination (Z_ODATA_DEST is a placeholder name).
cl_http_client=>create_by_destination(
  EXPORTING destination = 'Z_ODATA_DEST'
  IMPORTING client      = lo_client
  EXCEPTIONS OTHERS     = 1 ).
" Without a destination: cl_http_client=>create_by_url( url = '/sap/opu/odata/sap/API_SALES_ORDER_SRV/A_SalesOrder?$filter=SalesOrganization%20eq%20''1010''&$select=SalesOrder,SoldToParty,TotalNetAmount&$orderby=SalesOrder%20desc&$top=50&$format=json' ... ).
IF sy-subrc <> 0.
  RETURN. " destination missing or not reachable
ENDIF.

cl_http_utility=>set_request_uri( request = lo_client->request uri = lv_path ).
lo_client->request->set_method( if_http_request=>co_request_method_get ).
lo_client->request->set_header_field( name = 'Accept' value = 'application/json' ).

lo_client->send( EXCEPTIONS OTHERS = 1 ).
IF sy-subrc <> 0.
  lo_client->close( ).
  RETURN.
ENDIF.
lo_client->receive( EXCEPTIONS OTHERS = 1 ).
IF sy-subrc <> 0.
  lo_client->get_last_error( IMPORTING message = DATA(lv_error) ).
  lo_client->close( ).
  RETURN.
ENDIF.

lo_client->response->get_status( IMPORTING code = DATA(lv_status) ).
DATA(lv_json) = lo_client->response->get_cdata( ).
lo_client->close( ).
IF lv_status <> 200.
  " lv_json holds the OData error body — log it, do not treat as data.
  RETURN.
ENDIF.

Perguntas frequentes

Qual a diferença entre filtros OData V2 e V4?
O V2 usa substringof() para busca de texto, literais datetime'…' e guid'…' e $inlinecount=allpages. O V4 usa contains(), literais de data e GUID sem prefixo e $count=true. O construtor troca a sintaxe quando você muda a versão.
Onde colo o resultado para o CPI?
No campo Query Options do adaptador receptor OData (ou no assistente de consulta), sem o ponto de interrogação inicial.
A ferramenta acessa meu sistema SAP?
Não. Tudo roda no navegador. Nada é enviado à ERPClimb nem à SAP.

Confira os nomes de entidades e propriedades no $metadata do seu serviço. A ERPClimb é independente e não é afiliada à SAP SE.