Especificación del formato de salida para JSON

Cuando la salida está en formato JSON, puede configurar elementos hijo únicos para que siempre sean una matriz u objeto según sus necesidades empresariales.

No puede actualizar esta opción en tiempo de ejecución. Debe volver a desplegar el EAR con el paquete de personalización si realiza algún cambio.

Los elementos hijo únicos que empiezan con el nombre de etiqueta del elemento padre se generan como matrices y otros se generan como objetos. Por ejemplo:
  • XPath: OrderList/Order - Un solo elemento de Order siempre se muestra como una matriz JSON.
  • XPath: Actividades/Actividad-El elemento único de la actividad siempre se genera como un objeto JSON.

Puede utilizar este programa de utilidad para escenarios que tienen un criterio o necesidad empresarial diferente.

Pasos para configurar el formato de salida para JSON

  1. Añada el archivo xapiRest_jsonXPathTransformations.xml en la carpeta runtime/extensions/global/template/resource que contiene detalles sobre los elementos que se van a configurar como siempre una matriz o un objeto.
    Nota: Debe proporcionar el XPath completo del elemento que desea establecer como una matriz o un objeto. Por ejemplo, para configurar el elemento Ajuste en Order.OrderLines.OrderLine.LineAdjustments.Adjustment para que sea siempre una matriz, utilice XPath como Order/OrderLines/OrderLine/LineAdjustments/Adjustment.
    Archivo XML de ejemplo:
    <JSONTransformations>
     <Transformation Type="ForceToObject" XPath="AllocationRuleList/AllocationRule"  />
     <Transformation Type="ForceToArray" XPath="Activities/Activity"  />
</JSONTransformations>

    El archivo de ejemplo xapiRest_jsonXPathTransformations.xml.sample se proporciona en la carpeta runtime/resource .

  2. Cree el paquete de personalización.
    ./sci_ant.sh -f ../devtoolkit/devtoolkit_extensions.xml export from runtime/bin
  3. Vuelva a crear el EAR con el JAR de personalización.
    ./om-compose.sh update-extn <path to extensions.jar>