Especificando o formato de saída para JSON

Quando a saída está no formato JSON, é possível configurar elementos filhos únicos para sempre serem uma Matriz ou um Objeto de acordo com suas necessidades de negócios

Não é possível atualizar essa opção no tempo de execução Você deve reimplementar o EAR com o pacote de customização se fizer alguma mudança.

Os elementos filhos únicos que começam com o nome da tag do elemento-pai são exibidos como Matrizes e outros são exibidos como Objetos. Por exemplo,
  • XPath: OrderList/Order - O elemento único de Order é sempre gerado como uma matriz JSON.
  • XPath: Activities / Activity-Elemento único de Activity é sempre gerado como um objeto JSON.

É possível usar esse utilitário para cenários que possuem critérios diferentes ou necessidades de negócios diferentes

Etapas para configurar o formato de saída para JSON

  1. Inclua o arquivo xapiRest_jsonXPathTransformations.xml na pasta runtime/extensions/global/template/resource que contém detalhes sobre os elementos a serem configurados como sempre uma Matriz ou um Objeto
    Nota: deve-se fornecer o XPath completo do elemento que você deseja configurar como uma Matriz ou um Objeto. Por exemplo, para configurar o elemento de Ajuste em Order.OrderLines.OrderLine.LineAdjustments.Adjustment para sempre ser uma Matriz, use o XPath como Order/OrderLines/OrderLine/LineAdjustments/Adjustment
    Arquivo XML de amostra:
    <JSONTransformations>
         <Transformation Type="ForceToObject" XPath="AllocationRuleList/AllocationRule"  />
         <Transformation Type="ForceToArray" XPath="Activities/Activity"  />
    </JSONTransformations>
    

    O arquivo de amostra xapiRest_jsonXPathTransformations.xml.sample é fornecido sob a pasta runtime/resource

  2. Construa o pacote de customização
    ./sci_ant.sh -f ../devtoolkit/devtoolkit_extensions.xml export from runtime/bin
  3. Reconstrua o EAR com o JAR de customização
    ./om-compose.sh update-extn <path to extensions.jar>