Ejecución de PxTAL
Soporte del paquete Px
Compatibilidad con paquetes
TAL soporta paquetes de Servigistics InService 6.5 y 7.1. La versión se identifica según la información de publicación incluida en el paquete.
|
|
Se deben cargar paquetes de 6.5 o 7.1. No se pueden cargar tipos diferentes.
|
Limitaciones del paquete
A continuación se proporcionan algunas limitaciones de los datos del paquete:
• No utilice el carácter "#" en los nombres de fichero incluidos en los paquetes de Servigistics InService.
Si un nombre de fichero contiene este carácter, el proceso de transformación y carga fallará con el siguiente error:
[ERROR,ProcessActionHandler] Failed node: fetchApplicableFilesForPartsList within flow:getRegistryFromIMANSubFlow_PD , reason #path to a partslist item(The system cannot find the file specified) java.io.FileNotFoundException:#path to a partslist item(The system cannot find the file specified)
• No utilice el carácter de barra vertical (|) en los valores de propiedad APEX, a menos que se utilice para representar un O lógico.
Contenido del paquete Px
Un paquete Px se compone de las carpetas y los ficheros que se muestran en la siguiente tabla:
|
Nombre
|
Fichero/Carpeta
|
Descripción
|
|
com.ptc.arbortext.windchill.partlist.PartList
|
Carpeta
|
Se incluyen las listas de artículos según se hace referencia en *-DMPmap.xml. El nombre de la carpeta suele ser el nombre del tipo basado en qué datos se crean en SIM/SP.
|
|
com.ptc.ptcnet.DynamicDocument
|
Carpeta
|
Se incluyen los documentos dinámicos según se hace referencia en *-DMPmap.xml. Normalmente, el contenido es específico de DITA XML, XML general, PDF o imágenes. El nombre de la carpeta suele ser el nombre del tipo basado en qué datos se crean en SIM/SP.
|
|
reps
|
Carpeta
|
Se incluyen las imágenes asociadas de *_Hierarchy.xml.
|
|
*_Hierarchy.xml
|
Fichero
|
Fichero de la jerarquía de productos en el que se proporciona la información jerárquica de la estructura de productos.
|
|
*_Hierarchy.xml.meta
|
Fichero
|
Archivo de metadatos de la jerarquía de productos.
|
|
*-DMPmap.xml
|
Fichero
|
Fichero de la estructura de información (IS) o de la estructura de la publicación (PS), que proporciona normalmente una tabla de contenido. Los datos también están presentes en la estructura jerárquica.
|
|
*-DMPmap.xml.meta
|
Fichero
|
Fichero compañero de metadatos IS o PS.
|
|
OptionsDefinition.xml
|
Fichero
|
Definición de la lista de opciones y elecciones junto con su asociación al contexto (PH o IS).
|
|
partThumbnails.zip
|
Fichero
|
Imágenes asociadas con artículos.
|
|
ProductInstances.xml
|
Fichero
|
Fichero de la instancia de producto que proporciona el número de serie para la asignación de contexto. En este fichero se incluyen varios valores en un solo fichero.
|
|
publishInfo.xml
|
Fichero
|
Información de metadatos relacionados con el paquete publicado. Normalmente se indican el ID del paquete, la fecha de publicación, la configuración regional, la secuencia del paquete y un señalizador en los que se indican si se trata de un paquete completo o incremental.
En el fichero se incluye un parámetro Bundle-Source para identificar el propietario del paquete. Si esta propiedad no existe, el proceso TAL utiliza por defecto la propiedad orgName de los objetos Rootobjects del origen del paquete.
Las siguientes propiedades permiten determinar si un paquete es completo o incremental:
• JobSpecification/@increment
• JobSpecification/@incremental
En un paquete completo se incluirán valores como increment="0" o incremental="false". En un paquete incremental se incluirán valores como increment="1" o incremental="true".
El idioma del paquete se identifica mediante el parámetro Language del elemento JobSpecification:
|
|
ReadyForTAL
|
Fichero
|
El fichero centinela de cero bytes en el que se indica que el paquete está listo para TAL. Si este fichero no está presente, el paquete no se procesará.
|
|
referencedObjects.xml
|
Fichero
|
Se indican los distintos objetos a los que se hace referencia desde varios objetos.
En un paquete IS típico, contiene el URI del contexto (como atributo de destino) al que está conectado a través de relatedContext.xml. Los detalles sobre el URI y los objetos relacionados también se encuentran en este fichero, igual que los detalles de PRODUCT relacionados con el atributo ServiceInformation.
|
|
referencedParts.xml
|
Fichero
|
Fichero específico de artículo en el que se proporcionan los detalles de todos los artículos a los que se hace referencia en la lista de artículos.
|
|
relatedContexts.xml
|
Fichero
|
Se indica el contexto al que está asociado el paquete (normalmente IS o PS).
|
|
relatedParts.xml
|
Fichero
|
Se proporciona información sobre las relaciones entre artículos, tales como alternativo, sustitución y referencia cruzada.
|
|
translation.xml
|
Fichero
|
Se proporcionan los valores localizados de los atributos localizados que se utilizan en distintos objetos de negocio, como PH, IS, PS, PL, IEXML, PDFM, gráficos y artículo.
|
|
excludedObjects.xml
|
Fichero
|
Se proporcionan los URI de contenido que se debe borrar del contenido publicado anterior.
|
|
ModelItemPartObjects.xml
|
Fichero
|
Elemento genérico de IE que se utiliza para crear vínculos desde un objeto IEXML de origen a cero o más objetos IEXML relacionados.
|
|
contentMap.xml
|
Fichero
|
Fichero de asignación en el que se proporciona el URI para asignaciones físicas del fichero. También se incluyen valores de suma de control, suma de control de metadatos y fecha de recopilación que se utilizan para decidir si se deben cargar los datos.
|
Estructuras de información y estructuras de la publicación
El fichero *-DMPMap.xml representa el fichero IS o PS. Los componentes de estas entidades se describen en esta sección. La terminología que se utiliza procede del lenguaje que se emplea en SIM/SP. Por ejemplo, IsRoot es el tipo simplificado wt.part.WTPart que finaliza en …|com.ptc.sis.IsRoot.
En las estructuras de información se incluyen los siguientes nodos:
• Nodos <topicref>
◦ IsRoot
◦ IsGroup
◦ ContentRef (que es un soporte de contenido)
• Vínculos de uso del nodo padre al hijo
• Efectividad de servicio cuyo objetivo es cualquiera de los nodos anteriores
• Representaciones seleccionadas de estos nodos
La estructura puede hacer referencia a gráficos, documentos XML o listas de artículos. También puede obtener metadatos de estos objetos de referencia.
En las estructuras de la publicación se incluyen los siguientes nodos:
• Nodos (incluido el hook generado) <topicref>
◦ PsRoot
◦ PsSection
◦ PsToc
◦ PsIndex
◦ ContentRef
• Vínculos de uso del nodo padre al hijo
• Efectividad de servicio cuyo objetivo es cualquiera de los nodos anteriores
La estructura puede hacer referencia a documentos XML o listas de artículos. También puede obtener metadatos de estos objetos de referencia.
Un nodo típico de una de estas estructuras podría parecerse al siguiente:
<topicref id="..."
href="uri of node"
copy-to="relative path of Information Element (IE)"
format="dita|pdf|xml|…"
...>
En un paquete incremental sin cambios en los elementos de información, el atributo copy-to no está presente.
Elementos de información
Todos los elementos de información abarcan el contenido principal y sus metadatos. Los siguientes diferentes tipos de contenido se soportan en paquetes Px.
Componentes de Partslist
• La propia Partlist
• Imagen GDD (documento dinámico gráfico) o su GDD publicado con posterioridad
◦ Contenido principal
◦ Sus representaciones
◦ Sus adjuntos
• PartListItem
◦ Artículo
• Vínculos de uso del nodo padre al hijo
• Efectividad de servicio cuyo objetivo es cualquiera de los anteriores
Componentes de documento XML
• DD (documento dinámico) principal
◦ Sus metadatos
◦ Su contenido principal
• Imagen de referencia
◦ Contenido principal
◦ Sus representaciones
◦ Sus adjuntos
• Contenido XML resuelto durante el proceso de publicación
◦ Xinclude
◦ Referencia de tema DITA
◦ conref, conkeyref, etc. de DITA
Las referencias cruzadas a documentos XML externos no son componentes de la entidad.
Contenido gráfico
• GDD (documento dinámico gráfico) principal
◦ Sus metadatos
◦ Su contenido principal
◦ Sus representaciones
◦ Sus adjuntos
Artículo
• Artículo
◦ Metadatos (maestros y de instancia)
◦ Artículos relacionados
◦ Efectividad de servicio cuyo objetivo es el artículo
◦ Imágenes reducidas
Actualmente, los artículos se extraen además de publicarse, pero la publicación no lo considera una entidad, sino un componente de una lista de artículos. En la publicación se incluyen actualmente los artículos relacionados.
Markup de la efectividad de servicio
La efectividad de servicio no es una entidad, sino información asociada con muchas entidades. Representa la información de filtrado en los distintos objetos de IE. Aparece como metadatos dentro de cualquier objeto al que se dirige. Por ejemplo:
Tipos de paquete
En Servigistics InService hay dos tipos de paquetes Px. El tipo de paquete se identifica según el fichero publishInfo.xml.
Se soportan los siguientes tipos:
• Paquete PH
En este tipo de paquete se transporta la información sobre la jerarquía unificada de productos y la instancia de producto relacionada. En este paquete se suelen incluir los siguientes tipos de datos:
◦ Jerarquía de productos (PH) (*Hierarchy.xml)
◦ Instancias de producto (PI) (ProductInstances.xml)
◦ Opciones y elecciones (OptionsDefinitions.xml)
◦ PublishInfo.xml
• Paquete IS o PS
Estos tipos de paquetes transportan la información acerca de la estructura de información (IS) o la estructura de la publicación (PS). En este paquete se suelen incluir los siguientes tipos de datos:
◦ relatedContext.xml
◦ IS
◦ Elementos de información (IEXML, PDFM, gráficos, lista de artículos): conectados normalmente a través de IS
◦ Elementos de información genéricos
◦ Artículos asociados a listas de artículos
◦ Relaciones de artículos
◦ Documentos relacionados con el artículo
◦ Opciones y elecciones
◦ Árbol de síntomas
◦ PublishInfo.xml
• Paquete que no es de producto
Este paquete es como el paquete IS, pero sin ningún fichero relatedContext.xml. Esto significa que el paquete no está asociado a ningún contexto del producto. Normalmente, estos tipos de paquetes están asociados a una categoría definida en el fichero publishInfo.xml.
Identificación del contexto y la categoría de un paquete
En la información de contexto se indica el contexto del producto al que está asociado un elemento. En Servigistics InService, el contexto se utiliza para almacenar, filtrar y localizar distintos elementos del sistema. Un paquete IS o PS se asocia normalmente a un contexto. Se debe tener en cuenta que un paquete PH no está asociado a ningún contexto, ya que este tipo de paquete es el propio contexto. En Servigistics InService, los paquetes PH se cargan en cada segmento.
En un paquete Px, existe un fichero relatedContext.xml que se utiliza para identificar el contexto al que está asociado el paquete. Se debe tener en cuenta que un paquete puede hacer referencia a contextos individuales o a varios contextos. A continuación se muestra parte del fichero relatedContext.xml. El atributo src hace referencia al IS o PS. El atributo target hace referencia a la información de contexto.
Por ejemplo:
La categoría de un paquete se encuentra en el fichero PublishInfo.xml. Por ejemplo:
Ficheros centinela de paquete
Los ficheros centinela son ficheros especiales de cero bites que se crean en el paquete para señalar distintos estados de procesamiento. Pueden estar presentes los siguientes ficheros centinela:
• ReadyForTAL
Este fichero lo genera el propietario del paquete. La presencia de este fichero significa que el paquete está completamente generado y se puede procesar mediante TAL.
• PrepTAL
Este fichero se crea cuando se cargan varios paquetes a la vez con la tarea de transformación y carga.
• TransformInProgress_Recopilación o TransformInProgress_ID_paquete
El nombre de este fichero se determina por la opción de si se ha activado el uso compartido del contenido. Se denomina TransformInProgress_Recopilación cuando el uso compartido del contenido no está activado. Se denomina TransformInProgress_ID_paquete cuando el uso compartido del contenido está activado. El fichero se crea cuando la transformación está en curso.
• TransformFailed_Recopilación o TransformFailed_ID_paquete
El nombre de este fichero se determina por la opción de si se ha activado el uso compartido del contenido. Se denomina TransformFailed_Recopilación cuando el uso compartido del contenido no está activado. Se denomina TransformFailed_ID_paquete cuando el uso compartido del contenido está activado. Este fichero lo crea la tarea Transform cuando inicia su ejecución. El fichero se borrará si la tarea Transform se ha realizado correctamente.
• TransformCompleted_Recopilación o TransformCompleted_ID_paquete
El nombre de este fichero se determina por la opción de si se ha activado el uso compartido del contenido. Se denomina TransformCompleted_Recopilación cuando el uso compartido del contenido no está activado. Se denomina TransformCompleted_ID_paquete cuando el uso compartido del contenido está activado. Este fichero lo crea la tarea Transform cuando inicia su ejecución. Este fichero se crea tras la correcta finalización de la tarea de transformación para una recopilación.
• tal_completed
Este fichero se crea cuando la tarea de transformación ha finalizado.
• tal_failed
Este fichero se crea cuando la tarea de transformación falla.
Exclusión de objetos de un paquete
Si hay objetos que se deben excluir específicamente de un paquete, es necesario incluir el fichero excludedObjects.xml en el paquete. En este fichero se incluye una serie de etiquetas Object en las que se proporcionan los elementos id y uri de los objetos que no se desean cargar con el paquete.
A continuación se muestra un ejemplo de este fichero:
<?xml version="1.0" encoding="UTF-8"?>
<ExcludedObjects>
<Object id="PartListItem_8153223"
uri="x-wc://com.ptc.arbortext.windchill.partlist.PartListItem:8153223"/>
<Object id="PartListItem_8153222"
uri="x-wc://com.ptc.arbortext.windchill.partlist.PartListItem:8153222"/>
<Object id="WTPartMaster_8118901"
uri="x-wc://f5e0179d8f894049:wt.part.WTPartMaster:0069313461"/>
<Object id="WTPartMaster_8118955"
uri="x-wc://134e815ca9117606:wt.part.WTPartMaster:0069313463"/>
<Object id="WTPartMaster_8118947"
uri="x-wc://ce2ace730699a033:wt.part.WTPartMaster:0069313462"/>
<Object id="EPMDocumentMaster_8143009"
uri="x-wc://file=0000020874.png"/>
</ExcludedObjects>
