Importar metadados OData do SAP como uma API

Importar metadados do OData

1. No menu à esquerda, selecione APIs>+ Adicionar API.

2. Em Criar com base na definição, selecione OData.

   

3. Insira as configurações de API. Você pode atualizar suas configurações mais tarde acessando a guia Configurações da API.

   1. Na especificação OData, insira uma URL para um ponto de extremidade de metadados OData, normalmente a URL para a raiz do serviço, acrescentada de /$metadata. Como alternativa, selecione um arquivo XML OData local a ser importado.

   2. Insira as configurações restantes para configurar sua API. Essas configurações são explicadas no tutorial Importar e publicar sua primeira API.

4. Selecione Criar.

   A API é adicionada à lista de APIs . Os conjuntos de entidades e as funções expostas na descrição de metadados do OData são exibidos na guia Conjuntos de entidades e funções da API.

   

Atualizar o esquema OData

Você pode acessar um editor no portal para exibir o esquema da API OData. Se a API for alterada, você também poderá atualizar o esquema em Gerenciamento de API de um arquivo ou de um ponto de extremidade de serviço OData.

1. No portal do Azure, navegue até a instância do Gerenciamento de API.

2. No menu à esquerda, selecione sua API OData APIs.

3. Na guia Conjuntos de entidades e funções, selecione o menu de contexto (…) ao lado de um conjunto de entidades ou de uma função e escolha Editar.

   

4. Examine o esquema. Se você quiser atualizá-lo, selecione Atualizar do arquivo ou Atualizar esquema do ponto de extremidade.

   

Testar a API OData

1. No menu à esquerda, selecione sua API OData APIs.

2. Na guia Conjuntos de entidades e funções, selecione o menu de contexto (…) ao lado de um conjunto de entidades ou de uma função e escolha Testar.

   

3. No console de teste, insira os parâmetros de modelo, os parâmetros de consulta e os cabeçalhos do teste e selecione Testar. Saiba mais sobre como testar uma API no portal.

Proteger sua API OData

Proteja sua API OData aplicando políticas de autenticação e autorização existentes e uma política de validação OData para protegê-la contra ataques por meio de solicitações de API OData.

Converter metadados OData para JSON de OpenAPI

1. Converta o XML OData em formato JSON de OpenAPI. Use uma ferramenta de código-fonte aberto OASIS para OData v2 ou OData v4, dependendo do XML de metadados.

   Este é um exemplo de comando para converter o XML do OData v2 para o serviço de teste epm_ref_apps_prod_man_srv:

   odata-openapi -p --basePath '/sap/opu/odata/sap/epm_ref_apps_prod_man_srv' \
    --scheme https --host <your IP address>:<your SSL port> \
    ./epm_ref_apps_prod_man_srv.xml
   

   Observação

   • Para fins de teste com apenas um arquivo XML, você pode usar um conversor baseado na Web baseado na ferramenta de código-fonte aberto.
   • Com a ferramenta ou o conversor baseado na Web, especificar o < endereço IP>: <porta> do seu servidor SAP OData é opcional. Como alternativa, adicione essas informações posteriormente em sua especificação OpenAPI gerada ou depois de importar para o Gerenciamento de API.

2. Salve o arquivo openapi-spec.json localmente para importá-lo para o Gerenciamento de API.

Importar e publicar uma API de back-end

1. No menu de navegação lateral, na seção APIs, selecione APIs.

2. Em Criar uma definição, selecione Especificação de OpenAPI.

   

3. Clique em selecionar um arquivo e selecione o arquivo openapi-spec.json que você salvou localmente em uma etapa anterior.

4. Insira as configurações de API. Você pode definir os valores durante a criação ou configurá-los mais tarde, acessando a guia Configurações.

   • No sufixo de URL da API, é recomendável usar o mesmo caminho de URL do serviço SAP original.

   • Para obter mais informações sobre configurações de API, confira o tutorial Importar e publicar sua primeira API.

5. Selecione Criar.

Concluir a configuração de API

Adicione as três operações a seguir à API que você importou.

• GET /$metadata

  Operação	Descrição	Configuração adicional para a operação
  GET /$metadata	Permite que o Gerenciamento de API alcance o ponto de extremidade $metadata, que é necessário para a integração de cliente com o servidor OData. Essa operação necessária não está incluída na especificação OpenAPI que você gerou e importou.	Adicione uma resposta 200 OK.

  

• HEAD /

  Operação	Descrição	Configuração adicional para a operação
  HEAD /	Habilita o cliente a trocar tokens de CSRF (solicitação intersite forjada) com o servidor SAP, quando necessário. O SAP também permite a troca de tokens CSRF usando o verbo GET. A troca de token CSRF não é abordada neste artigo. Confira um exemplo de trecho de política de Gerenciamento de API para troca de token do agente.	N/D

  

• GET /

  Operação	Descrição	Configuração adicional para a operação
  GET /	Habilita a configuração de política na raiz do serviço.	Configure a seguinte política rewrite-uri de entrada para acrescentar uma barra à direita às solicitações que são encaminhadas para a raiz do serviço: <rewrite-uri template="/" copy-unmatched-params="true" /> Essa política remove a possível ambiguidade de solicitações com ou sem barras à direita, que são tratadas de maneira diferente por alguns back-ends.

  

Além disso, configure a autenticação para seu back-end usando um método apropriado para seu ambiente. Para obter exemplos, consulte Políticas de autenticação e autorização do Gerenciamento de API.

Testar sua API

1. Navegue até sua instância de Gerenciamento de API.

2. No menu de navegação lateral, na seção APIs, selecione APIs.

3. Em Todas as APIs, selecione a API importada.

4. Selecione a guia Teste para acessar o console de teste.

5. Selecione uma operação, insira os valores necessários e selecione Enviar.

   Por exemplo, teste a chamada GET /$metadata para verificar a conectividade com o back-end do SAP

6. Exiba a resposta. Para solucionar problemas, rastreie a chamada.

7. Quando o teste for concluído, saia do console de teste.