Spécification du format de sortie pour JSON

Lorsque la sortie est au format JSON, vous pouvez configurer des éléments enfant uniques pour qu'ils soient toujours un tableau ou un objet en fonction de vos besoins métier.

Vous ne pouvez pas mettre à jour cette option lors de l'exécution. Vous devez redéployer le fichier EAR avec le package de personnalisation si vous apportez des modifications.

Les éléments enfant uniques qui commencent par le nom de balise de l'élément parent sont générés sous forme de tableaux et les autres sont générés sous forme d'objets. Exemple :
  • XPath : OrderList/Order - Un seul élément de l'ordre est toujours édité sous la forme d'un tableau JSON.
  • XPath: Activités / Activité-Un élément unique de l'activité est toujours généré en tant qu'objet JSON.

Vous pouvez utiliser cet utilitaire pour les scénarios qui ont des critères ou des besoins métier différents.

Procédure de configuration du format de sortie pour JSON

  1. Ajoutez le fichier xapiRest_jsonXPathTransformations.xml dans le dossier runtime/extensions/global/template/resource qui contient des détails sur les éléments à configurer comme toujours un tableau ou un objet.
    Remarque: Vous devez fournir l'expression XPath complète de l'élément que vous souhaitez définir en tant que tableau ou objet. Par exemple, pour configurer l'élément d'ajustement dans Order.OrderLines.OrderLine.LineAdjustments.Adjustment pour qu'il soit toujours un tableau, utilisez le XPath Order/OrderLines/OrderLine/LineAdjustments/Adjustment.
    Exemple de fichier XML:
    <JSONTransformations>
     <Transformation Type="ForceToObject" XPath="AllocationRuleList/AllocationRule"  />
     <Transformation Type="ForceToArray" XPath="Activities/Activity"  />
</JSONTransformations>

    L'exemple de fichier xapiRest_jsonXPathTransformations.xml.sample est fourni sous le dossier runtime/resource .

  2. Générez le package de personnalisation.
    ./sci_ant.sh -f ../devtoolkit/devtoolkit_extensions.xml export from runtime/bin
  3. Régénérez le fichier EAR avec le fichier JAR de personnalisation.
    ./om-compose.sh update-extn <path to extensions.jar>