Actividad Escribir OData

Esta actividad toma la salida de la actividad Leer OData como entrada con otros detalles como la carga útil, el código de estado http, etc. y genera la salida que es necesario pasar de nuevo como respuesta.

Propiedades de configuración para la actividad Escribir OData

Tabla 1. Configurar propiedades de panel
Nombre del campo Descripción
Versión de OData La versión de OData que esta actividad va a utilizar. Se debe utilizar la misma versión en todas las actividades de una única orquestación. La única versión admitida actualmente es 4.0.
Seleccionar datos de entrada Seleccione una de las opciones sobre cómo proporcionar la estructura de datos de negocio a la actividad Leer OData. La API de OData se crea según esta estructura o estructuras proporcionadas.
  • Esquema XML existente: seleccione esta opción para examinar un esquema existente disponible en la orquestación. Solo se puede seleccionar un objeto con esta opción lo que significa que la API de OData admitirá solo un objeto de nivel superior. Esta opción se utiliza si las orquestaciones de Cast Iron tienen que exponer la API de OData.
  • URL de punto final (API de OData): seleccione esta opción para hablar con una aplicación de API de OData externa. En este caso Cast Iron hace de cliente. Se debe proporcionar el URL de raíz de servicio de la aplicación externa. Esta opción no se admite a partir de la versión 7.5.1 y se añadirá en versiones futuras.
  • Nuevo esquema XML para admitir varias entidades: seleccione esta opción para admitir objetos de nivel superior en la API de OData. Se debe pegar un esquema XML que contiene uno o varios elementos globales en el área de texto proporcionada. Esta opción se utiliza si las orquestaciones de Cast Iron tienen que exponer la API de OData. Por ejemplo, consulte el esquema XML de ejemplo proporcionado a continuación.

Se proporciona como ejemplo un esquema XML de muestra que contiene objetos de cuenta y producto.

<?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>
Tabla 2. Correlacionar parámetros de entrada
Nombre del campo Descripción
serviceName Este es el nombre de la API ReST de OData y será parte del URL. El valor de esta propiedad debe ser el mismo que el valor de la propiedad "URL (vía de acceso después del nombre de host)" en el panel Configurar de la actividad "Recibir solicitud" HTTP. Cuando coincide el URL con este nombre (por ejemplo: http://host/serviceName), proporciona el documento de servicio en la respuesta.
protocol El protocolo admitido por la API ReST de OData. Es necesario que este valor tome uno de los dos valores admitidos (HTTP o HTTPS) como valor predeterminado.
host El host en el que se ejecuta la API. El valor de esta propiedad se debe correlacionar desde la salida de la actividad "Recibir solicitud" HTTP.
method El método HTTP de la solicitud. El valor de esta propiedad se debe correlacionar desde la salida de la actividad "Recibir solicitud" HTTP.
Accept El valor de cabecera Accept. El valor de esta propiedad se puede establecer en el valor predeterminado o se puede correlacionar desde la salida de la actividad "Recibir solicitud" HTTP. Los valores admitidos son application/json y application/xml.
Content-Type El valor de cabecera Content-Type. El valor de esta propiedad se puede establecer en el valor predeterminado o se puede correlacionar desde la salida de la actividad "Recibir solicitud" HTTP. Los valores admitidos son application/json y application/xml.
resourcePath Esta propiedad contiene la vía de acceso de URL de la llamada y se correlaciona desde la salida de la actividad Leer OData.
entities Esta propiedad es de tipo matriz de series y contiene los nombres de conjunto de entidades solicitados en el URL y se correlaciona desde la salida de la actividad Leer OData. Por ejemplo, si el serviceName es /test y la estructura de datos de negocio es account (del esquema anterior) el url que obtendrá todos los detalles de cuenta será http://hostname/test/accounts. En este ejemplo, el nombre del conjunto de entidades es accounts.
fieldName Si la solicitud de un nombre de campo está presente en una estructura de datos de negocio el nombre del campo estará presente en esta propiedad. El valor de esta propiedad se correlaciona desde la salida de la actividad Leer OData. Por ejemplo, si el URL solicitado es http://hostname/test/accounts(5)/accountName, el valor de fieldName será accountName.
additionalpath Si hay algún elemento adicional como $value o $count en el url de solicitud, el valor estará presente en esta propiedad y se correlacionará desde la salida de la actividad Leer OData.
primaryKeys

Si el URL de solicitud contiene claves primarias, esa información estará presente en este campo y el valor se correlacionará desde la salida de la actividad Leer OData.

Ejemplos de URL:

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

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

La estructura primaryKeys contendrá el nombre de campo, el valor y el tipo de datos de la clave primaria.

status

Contiene el código de estado HTTP que se devuelve en la respuesta de la operación DELETE.

writeODataInput

La estructura de objetos de negocio que se tiene que serializar y devolver en la respuesta.

writeODataQueryParametersInput

Los parámetros de consulta que se tienen que aplicar en los datos de respuesta. Los valores se correlacionan desde la salida Leer OData.

writeODataHttpHeadersInput

Las cabeceras HTTP que se tienen que aplicar en los datos de respuesta. Los valores se correlacionan desde la salida Leer OData.

Tabla 3. Propiedades de Correlacionar salidas
Nombre del campo Descripción
writeODataOutput Los datos que se tienen que enviar como respuesta. Contiene el código de estado HTTP, el mensaje HTTP y la carga útil de respuesta.
writeODataHttpHeadersOutput Esta propiedad contiene las cabeceras HTTP que se tienen que enviar como respuesta.