Proceso de exportación del árbol de proyectos¶
Al exportar el tipo ComponentTree, el Árbol de proyectos se exporta total o parcialmente. Entre otras cosas, el ID y el estado de los componentes se pueden tomar del archivo resultante.
La exportación puede realizarse como archivo XML o JSON.
Info
Si se exporta el Árbol de proyectos completo, se tiene en cuenta la información de todas las versiones durante la exportación (WithVersions=Y) o se selecciona JSON como formato de exportación, en determinadas circunstancias se puede crear una cantidad muy grande de datos. Si este es el caso, se recomienda exportar sólo una ruta específica de los Árbol de proyectos y ninguna información sobre las versiones o seleccionar la exportación a un archivo XML.
Además de las claves descritas en la sección archivo de parámetros , el archivo de parámetros también puede contener las siguientes claves específicas para esta exportación.
Sección Common¶
En la sección [Common] se pueden configurar las siguientes claves:
| Teclas | Descripción | Valores |
|---|---|---|
| Dir | Ruta relativa de la parte del árbol de proyectos que se va a exportar. Esta clave se ignora si se especifica un valor para ComponentID. | - Si esta clave está vacía (valor por defecto), se exporta todo el Árbol de proyectos . (A excepción de los directorios y componentes a los que el usuario ejecutor no tiene acceso). |
| - Si la clave no está vacía, la entrada debe ir precedida de una barra invertida ("\"). | ||
| - También se puede introducir la ruta de un componente (con nombre). | ||
| WithVersions | Determina si se debe mostrar información sobre las versiones. | - Y: La información se emite. - N: La información no se emite (Valor estándar). |
| OnlyLatestVersion | Determina si la información sólo debe emitirse para la última versión o para todas las versiones. El requisito es que el parámetro WithVersions tenga el valor Y. Son posibles los siguientes valores: | - Y: Sólo se emite información sobre la última versión. - N: Se emite toda la información (Valor estándar). |
| WithMasterData | Determina si debe emitirse información sobre los datos maestros. | - Y: Se emite la información (Valor estándar). - N: La información no se emite. |
| EnableNodeTree | Determina si la jerarquía de directorios del proyecto debe crearse como nodo XML. | - Y: Los nodos XML están creados. - N: Los nodos XML no se crean (Valor estándar). |
Ejemplo de activación¶
Archivo de parámetros exportComponentTree.ini¶
[Common]
ReportType=ComponentTree
ExportFile=D:\Test\myComponentTree.xml
WithVersions=N
WithMasterData=Y
EnableNodeTree=N
[User]
Account={User}
Password={Password}
Resumen de los atributos XML que aparecen en el archivo de resultados¶
Elemento raíz¶
El elemento <raíz> es el punto de partida del Árbol de proyectos
Nodo de elemento¶
El elemento<node> representa un directorio en el Árbol de proyectos. Este elemento sólo se emite si la clave EnableNodeTree se transfirió al archivo de parámetros con el valor Y.
| Atributos | Descripción |
|---|---|
| Name="..." | Nombre del directorio |
Elemento componente¶
El elemento <component> contiene información sobre el componente.
| Atributos | Descripción |
|---|---|
| Name="..." | Nombre del componente |
| Path="..." | Ruta relativa del directorio de proyectos del componente |
| Id="..." | Id del componente único (en formato GUID) |
| TypeId="..." | ID del tipo de componente (en formato GUID) |
| State="n" | Información de estado del componente. Si el valor se ve como un número binario de 32 bits, se puede leer la siguiente información: 0x00000010: Bloqueado para otros usuarios 0x00000020: Marcado como en desarrollo |
| MultiEdit="..." | Indica si el componente tiene o no la propiedad Multi-User Editing. Los siguientes valores son posibles Y y N. |
Datos de los elementos¶
El elemento <data> contiene una lista de los datos maestros del componente. Este elemento sólo se emite si la clave WithMasterData se transfirió en el archivo de parámetros con el valor Y.
| Atributos | Descripción |
|---|---|
| D1="..." D2="..." ... D10="..." | Datos maestros de los componentes |
Versiones de los elementos¶
El elemento <Versions> continene información sobre las versiones de un componente. Este elemento sólo se emite si la clave WithVersions se transfirió en el archivo de parámetros con el valor Y.
Elemento Version¶
El elemento <Versions> contiene los siguientes atributos:
| Atributos | Descripción |
|---|---|
| Id="..." | ID de versión del registro de datos |
| Número="n" | Número de versión del registro de datos |
| TimeStampUTC="..." | Hora del versionado (UTC) |
| TimeStampLocal="..." | Hora de versionado (hora local) |
| UserDefined="..." | Identificador de versión definido por el usuario |
| UserId="..." | ID único del usuario (en formato GUID) que creó la versión |
| UserName="..." | Usuario que ha creado la versión |
| ComputerName="..." | Equipo en el que se creó la versión |
| Comment="..." | Comentario |
| ChangeReason="..." | Motivo del cambio |
| SubDirArchive="..." | Nombre de la carpeta en la que se almacena la versión correspondiente del componente (como el archivo Archive.zip) en el archivo del servidor |
| StateArchive="n" | Información adicional sobre la versión. Si el valor se ve como un número binario de 32 bits, se puede leer la siguiente información: 0x00000002: Se ejecutó el check-out del archivo. 0x00000020: Se ejecutó el check-in del archivo. 0x00000040: El archivo ha sido borrado (por el usuario especificado). |
| SizeUncompressed | Tamaño del componente |
| SizeCompressed | Tamaño empaquetado del componente |
Etiquetas de los elementos¶
El elemento <Tag> contiene información sobre las etiquetas asignadas a cada versionado. Este elemento sólo se emite si tiene asignada al menos una etiqueta.
Elemento Tag¶
El elemento <Tag> contiene información sobre el contenido de una etiqueta.
| Atributos | Descripción |
|---|---|
| Name="..." | Nombre de la etiqueta |
Elemento LockState¶
El elemento <LockState> contiene información sobre el estado de bloqueo de un componente. Este elemento sólo se emite si existe un estado de bloqueo.
| Atributos | Descripción |
|---|---|
| State="n" | Especifica el estado de bloqueo del componente. Son posibles los siguientes valores:\1: Bloqueado\2: En desarrollo |
| UserId="..." | ID del usuario (en formato GUID) que ha asignado el estado de bloqueo |
| UserName="..." | Usuario que ha asignado el estado de bloqueo |
| EmailAddress="..." | Correo electrónico del usuario que asignó el estado de bloqueo. Si no se especifica ninguna dirección de correo electrónico, se añade una cadena vacía. |
| TimeStampLocal="..." | Hora a la que se asignó el estado de bloqueo (hora local) |
| TimeStampUTC="..." | Hora a la que se asignó el estado de bloqueo (UTC) |
| Days="n" | Especifica cuánto tiempo ha estado bloqueado el componente (en días). |
| ComputerName="..." | Equipo desde el que se asignó el estado de bloqueo |
| Comment="..." | Comentario que se introdujo al bloquear |