Estendendo um modelo de XML de saída

É possível substituir os modelos XML que estão no produto com extensões de modelo.

Sobre esta tarefa

Muitas APIs usam um modelo XML de saída para definir o que é retornado. Cada API possui seu próprio modelo XML, que é retirado do arquivo <runtime_sandbox>/repository/xapi/template/merged/api/apiName.xml . Os arquivos neste diretório fazem parte do produto e não devem ser alterados. No entanto, estes modelos podem ser substituídos implementando extensões de modelo.

Para estender um arquivo de modelo:

Procedimento

  1. Copie o arquivo <runtime_sandbox>/repository/xapi/template/merged/api/apiName.xml de modelo no diretório <runtime_sandbox>/extensions/global/template/api/ , mantendo o mesmo nome de arquivo.

    Se o diretório /global/template/api/ não existir, crie a estrutura de diretório necessária.

  2. Modifique o arquivo copiado, conforme necessário. Para estender um arquivo de modelo, inclua a tag Extn sob a tag de entidade. Por exemplo, se você tiver adicionado uma coluna EXTN_COLOR à tabela YFS_ITEM, também deverá adicionar a tag Extn sob a tag Item no arquivo getItemDetails.xml da seguinte forma:
    <Item ItemKey=""....> 
       <PrimaryInfo MasterCatalogID="" .../> 
         ...
    	   <Extn ExtnColor=""/> 
    </Item>
    Nota: Se você estiver estendendo um modelo XML de saída, coloque seus arquivos estendidos na pasta <runtime_sandbox>/extensions/global/template/api Mas ao fornecer o nome do arquivo template.api durante a definição de serviço, o caminho deve ser /global/template/api/CUSTOM-TEMPLATE-API.