Atividade Gravar OData

Essa atividade obtém a saída da atividade Ler OData como entrada junto a outros detalhes, como carga útil, código de status de HTTP, etc. e gera a saída que precisa ser passada de volta como resposta.

Propriedades de configuração para a atividade Gravar OData

Tabela 1. Propriedades do painel Configurar
Nome do Campo Descrição
Versão de OData A versão de OData a ser usada para essa atividade. A mesma versão precisa ser usada em todas as atividades em uma única orquestração. A única versão suportada atualmente é 4.0.
Selecionar dados de entrada Selecione uma das opções sobre como fornecer a estrutura de dados de negócios para a atividade Ler OData. O OData API é criado com base nesta(s) estrutura(s) de negócios fornecida(s).
  • Esquema XML existente: selecione essa opção para procurar um esquema existente disponível na orquestração. É possível selecionar somente um objeto com essa opção, o que significa que o OData API estará suportando apenas um objeto de nível superior. Essa opção será usada se OData API precisar ser exposto por orquestrações de Cast Iron.
  • URL de terminal (OData API): selecione essa opção para conversar com um aplicativo OData API externo. Neste caso, o Cast Iron está agindo como cliente. A URL raiz de serviço do aplicativo externo precisa ser fornecida. Essa opção não é suportada a partir da versão 7.5.1 e será incluída em versões futuras.
  • Novo esquema XML para suportar múltiplas entidades: selecione essa opção para suportar múltiplos objetos de nível superior no OData API. Um esquema XML que contém um ou mais elementos globais precisa ser colado na área de texto fornecida. Essa opção será usada se OData API precisar ser exposto por orquestrações de Cast Iron. Por exemplo, consulte o esquema XML de amostra especificado abaixo.

Um esquema XML de amostra contendo objetos de conta e de produto é especificado como exemplo.

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"
 xmlns:ras="http://www.sample.com/xmlns/prod/sample"
 targetNamespace="http://www.sample.com/xmlns/prod/sample">
 <element name="account" type="ras:AccountObject"/>
 <element name="product" type="ras:ProductObject"/>
 <complexType name="AccountObject">
  <sequence maxOccurs="1" minOccurs="1">                       
        <element maxOccurs="1" minOccurs="0" name="accountId" type="int"/>                       
        <element maxOccurs="1" minOccurs="0" name="accountName" type="string"/>                       
        <element maxOccurs="1" minOccurs="0" name="valid" type="boolean"/>           
  </sequence>
 </complexType>
 <complexType name="ProductObject"> 
  <sequence maxOccurs="1" minOccurs="1">
   <element maxOccurs="1" minOccurs="1" name="pid" type="int"/>
   <element maxOccurs="1" minOccurs="0" name="productName" type="string"/>                       
   <element maxOccurs="1" minOccurs="0" name="description" type="string"/>                       
   <element maxOccurs="1" minOccurs="0" name="stock" type="int"/>           
  </sequence> 
 </complexType>
</schema>
Tabela 2. Propriedades de Mapear entrada
Nome do Campo Descrição
serviceName Esse é o nome do OData ReST API e fará parte da URL. O valor dessa propriedade deve ser o mesmo valor da propriedade "URL (caminho depois de nome do host)" no painel Configurar da atividade de HTTP "Receber solicitação". Quando a URL com esse nome (por exemplo: http://host/serviceName) é pressionada, ela fornece o documento de serviço na resposta.
protocol O protocolo suportado por seu OData ReST API. Esse valor precisa ser padronizado com um dos dois valores suportados (HTTP ou HTTPS).
host O host no qual a API está em execução. O valor para essa propriedade deve ser mapeado a partir da saída da atividade de HTTP "Receber solicitação".
Método O método de HTTP da solicitação. O valor para essa propriedade deve ser mapeado a partir da saída da atividade de HTTP "Receber solicitação".
Aceitar O valor do cabeçalho Aceitar. O valor dessa propriedade pode ser configurado com o valor padrão ou mapeado a partir da saída da atividade de HTTP "Receber solicitação". Os valores suportados são application/json e application/xml.
Content-Type O valor do cabeçalho de Tipo de conteúdo. O valor dessa propriedade pode ser configurado com o valor padrão ou mapeado a partir da saída da atividade de HTTP "Receber solicitação". Os valores suportados são application/json e application/xml.
resourcePath Essa propriedade contém o caminho da URL da chamada e é mapeada a partir da saída da atividade Ler OData.
entities Essa propriedade é do tipo matriz de sequência e contém o(s) nome(s) do(s) conjunto(s) de entidade solicitado(s) na URL e é mapeada a partir da saída da atividade Ler OData. Por exemplo, se o serviceName é /test e a estrutura de dados de negócios selecionada é account (do esquema acima), a URL para obter todos os detalhes da conta é http://hostname/test/accounts. Neste exemplo, o nome do conjunto de entidade é accounts.
fieldName Se a solicitação por um nome de campo estiver presente em uma estrutura de dados de negócios, o nome do campo estará presente nessa propriedade. O valor dessa propriedade é mapeado a partir da saída da atividade Ler OData. Por exemplo, se a URL solicitada for http://hostname/test/accounts(5)/accountName, o valor de fieldName será accountName.
additionalpath Se houver algum token adicional, como $value ou $count, na URL de solicitação, esse valor estará presente nessa propriedade e será mapeado a partir da saída da atividade Ler OData.
primaryKeys

Se a URL de solicitação contiver chaves primárias, essas informações estarão presentes nesse campo e o valor será mapeado a partir da saída da atividade Ler OData.

Exemplos de URL:

http://hostname/test/accounts(5)

http://hostname/test/salesorder(orderid='so1',name='ask')

A estrutura primaryKeys conterá o nome do campo, o valor e o tipo de dados da chave primária.

status

Contém o código de status HTTP que é retornado na resposta para a operação DELETE.

writeODataInput

A estrutura do objeto de negócios que precisa ser serializada e retornada na resposta.

writeODataQueryParametersInput

Os parâmetros de consulta que precisam ser aplicados nos dados de resposta. Os valores são mapeados a partir da saída de Ler OData.

writeODataHttpHeadersInput

Os cabeçalhos de HTTP que precisam ser aplicados nos dados de resposta. Os valores são mapeados a partir da saída de Ler OData.

Tabela 3. Propriedades de Mapear saída
Nome do Campo Descrição
writeODataOutput Os dados que precisam ser enviados como resposta. Eles contêm o código de status HTTP, a mensagem HTTP e a carga útil de resposta.
writeODataHttpHeadersOutput Essa propriedade contém os cabeçalhos de HTTP que precisam ser enviados como resposta.