SAP OData
Um conector OData que pode ser usado para invocar serviços SAP ODATA para executar várias operações, como criar, ler, atualizar e excluir entidades, além de invocar funções no serviço.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps |
| Power Automate | Premium | Todas as regiões do Power Automate |
| Contato | |
|---|---|
| Nome | Microsoft |
| URL |
Suporte do Microsoft LogicApps Suporte do Microsoft Power Automate Suporte do Microsoft Power Apps |
| Metadados do conector | |
|---|---|
| Publicador | Microsoft |
| Site | https://www.odata.org/ |
| Política de privacidade | https://privacy.microsoft.com/privacystatement |
Problemas e limitações conhecidos
- O conector não é uma implementação completa do protocolo OData e pode não dar suporte a todos os cenários.
- Somente o suporte de "Leitura" para a funcionalidade tabular do Power Apps.
- Para serviços OData que têm respostas $metadata grandes, procure usar a ação "Criar qualquer tipo de solicitação OData" e o parâmetro "bypassMetadata" para evitar problemas de desempenho.
Suporte à Rede Virtual (Versão Prévia Pública)
Quando o conector é usado em um ambiente do Power Platform vinculado a uma rede virtual, limitações se aplicam:
- Não há suporte para o gateway de dados local
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Anônimo | Use o acesso anônimo para o Serviço OData. | Todas as regiões | Não compartilhável |
| Basic | Use o nome de usuário e a senha para acessar o Serviço OData. | Todas as regiões | Não compartilhável |
| ID do Microsoft Entra Integrada (com APIM) | Use a ID do Microsoft Entra para acessar a instância do SAP. | Todas as regiões | Não compartilhável |
| Microsoft Entra ID com SuccessFactors (Pré-visualização) | Use a ID do Microsoft Entra para autenticação no SuccessFactors. | Todas as regiões | Não compartilhável |
| Padrão [PRETERIDO] | Essa opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores. | Todas as regiões | Não compartilhável |
Anônimo
ID de autenticação: Anônimo
Aplicável: todas as regiões
Use o acesso anônimo para o Serviço OData.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| OData Base URI | cadeia | Verdade | |
| Gateway | gatewaySetting | Gateway local (consulte https://docs.microsoft.com/data-integration/gateway mais detalhes | |
| Nome da chave de API | cadeia | ||
| Valor da chave de API | secureString | ||
| Nome do cliente SAP | cadeia | ||
| Valor do cliente SAP | secureString |
Básico
ID de autenticação: Básico
Aplicável: todas as regiões
Use o nome de usuário e a senha para acessar o Serviço OData.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| OData Base URI | cadeia | Verdade | |
| Nome de usuário | secureString | Verdade | |
| Senha | secureString | Verdade | |
| Gateway | gatewaySetting | Gateway local (consulte https://docs.microsoft.com/data-integration/gateway mais detalhes | |
| Nome da chave de API | cadeia | ||
| Valor da chave de API | secureString | ||
| Nome do cliente SAP | cadeia | ||
| Valor do cliente SAP | secureString |
ID do Microsoft Entra Integrada (com APIM)
ID de autenticação: oauth
Aplicável: todas as regiões
Use a ID do Microsoft Entra para acessar a instância do SAP.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| URI do recurso da ID do Microsoft Entra (URI da ID do Aplicativo) | cadeia | O identificador usado na ID do Microsoft Entra para identificar o recurso de destino. | Verdade |
| OData Base URI | cadeia | Verdade | |
| Gateway | gatewaySetting | Gateway local (consulte https://docs.microsoft.com/data-integration/gateway mais detalhes | |
| Nome da chave de API | cadeia | ||
| Valor da chave de API | secureString | ||
| Nome do cliente SAP | cadeia | ||
| Valor do cliente SAP | secureString |
ID do Microsoft Entra usando SuccessFactors (versão prévia)
ID de autenticação: oauthsuccessfactors
Aplicável: todas as regiões
Use a ID do Microsoft Entra para autenticação no SuccessFactors.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Success Factors token URL | cadeia | URL do ponto de extremidade do token OAuth successFactors (formato: https://<api-server>/oauth/token). |
Verdade |
| ID do cliente do provedor de serviços | cadeia | Sua ID do cliente OAuth2 do SuccessFactors. | Verdade |
| ID da empresa | cadeia | CompanyId | Verdade |
| URL de Recurso do Microsoft Entra (URI da ID do Aplicativo) | cadeia | O identificador usado na ID do Microsoft Entra para identificar o recurso de destino. | Verdade |
| OData Base URI | cadeia | Verdade |
Padrão [PRETERIDO]
Aplicável: todas as regiões
Essa opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| OData Base URI | cadeia | Verdade | |
| Tipo de autenticação | cadeia | Tipo de autenticação para se conectar ao Serviço OData. | Verdade |
| Nome de usuário | secureString | O nome de usuário a ser usado para se conectar ao Serviço OData. | Verdade |
| Senha | secureString | A senha a ser usada para se conectar ao Serviço OData. | Verdade |
| Gateway | gatewaySetting | Gateway local (consulte https://docs.microsoft.com/data-integration/gateway mais detalhes |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 2500 | 60 segundos |
Ações
| Atualizar a entidade OData |
Atualizar a entidade OData. |
| Consultar entidades OData |
Consultar dados de entidades OData. |
| Criar entidade OData |
Criar entidade OData. |
| Criar qualquer tipo de solicitação OData |
Crie qualquer tipo de solicitação OData. |
| Criar qualquer tipo de solicitação OData em massa (versão prévia) |
Crie qualquer tipo de solicitação OData em massa. |
| Excluir entidade OData |
Excluir entidade OData. |
| Ler a entidade OData |
Leia a entidade OData. |
Atualizar a entidade OData
Atualizar a entidade OData.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da entidade OData
|
entity | True | string |
Especifique o nome da entidade OData. |
|
Entrada de entidade OData
|
entryInput | True | dynamic |
Especifique a entrada da Entidade OData. |
|
caminho relativo
|
relativePath | string |
Combinado com o URI OData da conexão para criar o URI completo com o qual interagir. |
Retornos
Consultar entidades OData
Consultar dados de entidades OData.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da entidade OData
|
entity | True | string |
Especifique o nome da entidade OData. |
|
caminho relativo
|
relativePath | string |
Combinado com o URI OData da conexão para criar o URI completo com o qual interagir. |
|
|
$top
|
top | number |
Opção de consulta $top opcional. |
|
|
$skip
|
skip | number |
Opção de consulta $skip opcional. |
|
|
$select
|
select | string |
Opção de consulta $select opcional. |
|
|
$filtro
|
filter | string |
Opção de consulta $filter opcional. |
|
|
$expand
|
expand | string |
Opção de consulta $expand opcional. |
|
|
$orderby
|
orderby | string |
Opção de consulta $orderby opcional. |
|
|
$search
|
search | string |
Opção de consulta $search opcional. |
|
|
$inlinecount
|
inlinecount | string |
Opção de consulta $inlinecount opcional. |
Retornos
Criar entidade OData
Criar entidade OData.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da entidade OData
|
entity | True | string |
Especifique o nome da entidade OData. |
|
Entrada de entidade OData
|
entryInput | True | dynamic |
Especifique a entrada da Entidade OData. |
|
caminho relativo
|
relativePath | string |
Combinado com o URI OData da conexão para criar o URI completo com o qual interagir. |
Retornos
Criar qualquer tipo de solicitação OData
Crie qualquer tipo de solicitação OData.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
caminho relativo
|
relativePath | True | string |
Combinado com o URI OData da conexão para criar o URI completo com o qual interagir. |
|
httpMethod
|
httpMethod | True | string | |
|
queryString
|
queryString | object | ||
|
conteúdo
|
payload | object | ||
|
bypassMetadata
|
bypassMetadata | boolean |
Ignora $metadata chamadas (para desempenho), exceto para buscar tokens CSRF. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
código de status
|
statusCode | integer | |
|
estruturado
|
response.structured | object | |
|
Desestruturado
|
response.unstructured | string |
Criar qualquer tipo de solicitação OData em massa (versão prévia)
Crie qualquer tipo de solicitação OData em massa.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
caminho relativo
|
relativePath | True | string |
Combinado com o URI OData da conexão para criar o URI completo com o qual interagir. |
|
httpMethod
|
httpMethod | True | string | |
|
queryString
|
queryString | object | ||
|
conteúdo
|
payload | object | ||
|
bypassMetadata
|
bypassMetadata | boolean |
Ignora $metadata chamadas (para desempenho), exceto para buscar tokens CSRF. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
código de status
|
statusCode | integer | |
|
estruturado
|
response.structured | object | |
|
Desestruturado
|
response.unstructured | string |
Excluir entidade OData
Excluir entidade OData.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da entidade OData
|
entity | True | string |
Especifique o nome da entidade OData. |
|
Entrada de entidade OData
|
entryInput | True | dynamic |
Especifique a entrada da Entidade OData. |
|
caminho relativo
|
relativePath | string |
Combinado com o URI OData da conexão para criar o URI completo com o qual interagir. |
Retornos
- response
- object
Ler a entidade OData
Leia a entidade OData.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da entidade OData
|
entity | True | string |
Especifique o nome da entidade OData. |
|
Entrada de entidade OData
|
entryInput | True | dynamic |
Especifique a entrada da Entidade OData. |
|
caminho relativo
|
relativePath | string |
Combinado com o URI OData da conexão para criar o URI completo com o qual interagir. |
|
|
$top
|
top | number |
Opção de consulta $top opcional. |
|
|
$skip
|
skip | number |
Opção de consulta $skip opcional. |
|
|
$select
|
select | string |
Opção de consulta $select opcional. |
|
|
$filtro
|
filter | string |
Opção de consulta $filter opcional. |
|
|
$expand
|
expand | string |
Opção de consulta $expand opcional. |
|
|
$orderby
|
orderby | string |
Opção de consulta $orderby opcional. |
|
|
$search
|
search | string |
Opção de consulta $search opcional. |
|
|
$inlinecount
|
inlinecount | string |
Opção de consulta $inlinecount opcional. |
Retornos
Definições
objeto
Esse é o tipo 'object'.