Ampliación de una plantilla XML de salida

Puede sustituir las plantillas XML que están en el producto con extensiones de plantilla.

Acerca de esta tarea

Muchas API utilizan una plantilla XML de salida para definir qué se devuelve. Cada API tiene su propia plantilla XML, que se recoge del archivo <runtime_sandbox>/repository/xapi/template/merged/api/apiName.xml . Los archivos en este directorio forman parte del producto y no deben modificarse. No obstante, estas plantillas se pueden sustituir implementando extensiones de plantilla.

Para ampliar un archivo de plantilla:

Procedimiento

Copie el archivo <runtime_sandbox>/repository/xapi/template/merged/api/apiName.xml de plantilla en el directorio <runtime_sandbox>/extensions/global/template/api/ , manteniendo el mismo nombre de archivo.

Si el directorio /global/template/api/ no existe, cree la estructura de directorios necesaria.
Modifique el archivo copia, según sea necesario. Para ampliar un archivo de plantilla, añada la etiqueta Extn en la etiqueta de entidad. Por ejemplo, si ha añadido una columna EXTN_COLOR a la tabla YFS_ITEM, también debe añadir la etiqueta Extn debajo de la etiqueta Item en el archivo getItemDetails.xml de la siguiente manera:
```
<Item ItemKey=""....> 
   <PrimaryInfo MasterCatalogID="" .../> 
     ...
	   <Extn ExtnColor=""/> 
</Item>
```
Nota: Si está ampliando una plantilla XML de salida, coloque los archivos ampliados en la carpeta <runtime_sandbox>/extensions/global/template/api . Pero al proporcionar el nombre del archivo template.api durante la definición de servicio, la vía de acceso debe ser /global/template/api/CUSTOM-TEMPLATE-API.