Exportar el árbol de proyectos
Puede exportar el Árbol de proyectos total o parcialmente. El archivo exportado incluye claves como los ID de componentes y sus estados, entre otra información.
Además de seleccionar el formato de exportación, puede configurar otros parámetros de exportación, como:
- Proceso de exportación de todo el Árbol de proyectos , una sección o un componente específico.
- Indica si se incluye información de la versión, y de ser así, si se exporta únicamente la última versión o todas las versiones.
- Si se incluyen datos maestros de los componentes.
- Indica si se representa la estructura de directorio del proyecto como un nodo XML.
Si exporta el Árbol de proyectos completo, incluye toda la información sobre versiones (WithVersions=Y) o selecciona JSON como formato de exportación, el volumen de datos resultante puede ser muy grande. Si este es el caso, se recomienda exportar sólo una ruta específica del Árbol de proyectos y ninguna información sobre las versiones o seleccionar la exportación a un archivo XML.
Configuración del ExportModule
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}
Archivo de salida
Proceso de exportación en formato XML o JSON, en función de la opción de salida seleccionada.
El archivo de salida XML contiene los siguientes elementos:
root:
El elemento <root> es el punto de partida del Árbol de proyectos.
node:
El elemento <note> representa un directorio en el Árbol de proyectos. Este elemento sólo aparece si la jerarquía de directorios del proyecto se creó como nodo XML.
| Atributos | Descripción |
|---|---|
| Name="..." | Nombre del directorio |
component:
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. |
data:
El elemento <data> contiene una lista de los datos maestros del componente.
Este elemento aparece únicamente si se exportaron los datos maestros.
| Atributos | Descripción |
|---|---|
| D1="..." D2="..." ... D10="..." | Datos maestros de los componentes |
Versions:
El elemento <Versions> contiene información sobre las versiones de un componente.
Este elemento sólo aparece si se exportartó información sobre las versiones.
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 creó 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 |
Tags:
El elemento <Tag> contiene información sobre las etiquetas asignadas a cada versión.
Este elemento sólo aparece si se asignó al menos una etiqueta.
Tag:
El elemento <Tag> contiene información sobre el contenido de una etiqueta.
| Atributos | Descripción |
|---|---|
| Name="..." | Nombre de la etiqueta |
LockState:
El elemento <LockState> contiene información sobre el estado de bloqueo de un componente.
Este elemento se incluye en la salida sólo si al menos un componente tiene estado de bloqueo.
| Atributos | Descripción |
|---|---|
| State="n" | Especifica el estado de bloqueo del componente. 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 |
Contenido relacionado