Estructura del archivo de definición de la aplicación
Este artículo describe la estructura XML de los archivos de definición de aplicación de Profile Management. Esta estructura se aplica tanto al perfilador de aplicaciones como a la configuración multiplataforma.
Diagrama de arquitectura
-
Declaración XML y atributo de codificación
La declaración XML debe especificar el atributo, <?xml version=”1.0”>.
Encoding=”UTF-8” es un atributo recomendado.
-
GroupDefinitions
Un contenedor de colecciones de grupos. Actúa como el elemento raíz del documento XML. Sus atributos incluyen version y GUID. Son atributos obligatorios.
-
Group
Define la configuración de una subaplicación. Sus atributos son name y GUID. Son atributos obligatorios.
-
Object
Define una configuración de una subaplicación. Sus atributos son name y GUID. Son atributos obligatorios.
-
Platform
Platform proporciona diferentes definiciones en distintos sistemas operativos. Puede usar un atributo opcional OSVersionNumber para especificar el sistema operativo. Cuando no hay ningún atributo, todas las plataformas aceptan la definición interna de la configuración. Platform debe contener uno de los siguientes elementos: RegKey, RegValue, File, Folder y Wallpaper.
-
RegKey
Define una configuración como una clave en el registro. Debe contener el elemento Key. Incluye dos subelementos opcionales, Recurse y Merge. Recurse y Merge definen el rendimiento cuando Profile Management itinera la clave. Otro subelemento opcional es ExcludeValues. ExcludeValues define los valores del registro que se pueden excluir.
-
RegValue
Define una configuración como un valor en el registro. Debe contener Key para especificar la ruta de su clave principal.
-
Carpeta
Define una configuración como una carpeta. Debe contener Path para especificar la ruta de la carpeta. Tiene subelementos opcionales,
RecurseyMerge. Recurse y Merge definen el rendimiento cuando Profile Management itinera la carpeta. Otro subelemento opcional esExcludeFiles, que define los archivos que se pueden excluir. -
Archivo
Define una configuración como un archivo. Debe contener Path para especificar la ruta de su carpeta principal, y
FileNamepara especificar el nombre de un archivo. -
Fondo de pantalla
Define todas las configuraciones de fondo de pantalla. No se requieren atributos ni subelementos. Profile Management itinera estas configuraciones automáticamente.
-
Key
Especifica la ruta de la clave del registro o la ruta de la clave principal del registro. Key es el subelemento de RegKey y RegValue.
-
ValueName
Especifica el nombre del valor del registro. Es un subelemento de RegValue.
-
Path
Especifica la ruta de la carpeta o la ruta de la carpeta principal. Es un subelemento de Carpeta y Archivo. Se pueden adoptar variables de Profile Management.
-
FileName
Especifica el nombre de un archivo. Es un subelemento de Archivo.
-
Recurse
Subelemento opcional de RegKey y Carpeta. Si este elemento existe, Profile Management explora la clave y la carpeta de forma recursiva.
-
Merge
Subelemento opcional de RegKey y Carpeta. Si este elemento existe, Profile Management fusiona (pero no sustituye) la clave y la carpeta.
-
ExcludeValues
Subelemento opcional de RegKey. Especifica los valores que se pueden excluir al explorar la clave.
-
ExcludeFiles
Subelemento opcional de Carpeta. Especifica los archivos que se pueden excluir al explorar la carpeta.
-
Exclude
Subelemento de ExcludeValues y ExcludeFiles. Especifica los elementos excluidos de archivos o valores de registro.
Nota
Asegúrese de que su documento contenga un formato de sintaxis correcto. Profile Management comprueba estos archivos utilizando el archivo de validación CPSValidationSchema.xsd cuando se cargan. Puede encontrar el archivo de validación en la ruta de instalación de Profile Management. Profile Management ignora los archivos incorrectos y registra los mensajes de error en el registro.
Ejemplo
<?xml version="1.0" encoding="UTF-8"?>
<!-- Copyright 2011 Citrix Systems, Inc. All Rights Reserved. -->
<GroupDefinitions GUID="748E63D3-426E-4796-9C32-420B25DB2D9F" Version="4.0.0.0">
<!-- Application Settings -->
<Group GUID="0FCCCF29-0A0E-482d-A77E-3F39A8A854A6" Name="Application Settings">
<!-- Registry Key Setting Example -->
<Object GUID="637EC13C-2D47-4142-A8EB-3CEA6D53522A" Name="Software\Application\certain key">
<Platform>
<RegKey>
<Key>Software\Microsoft\Office\certain key</Key>
<Merge/>
<Recurse/>
<ExcludeValues>
<Exclude>excluded value 1</Exclude>
<Exclude>excluded value 2</Exclude>
<Exclude>excluded value 3</Exclude>
</ExcludeValues>
</RegKey>
</Platform>
</Object>
<!-- Registry Value Setting Example -->
<Object GUID="3C896310-10C4-4e5f-90C7-A79F4E653F81" Name="Software\Application\certain value">
<!-- Folder Setting Example -->
<Object GUID="7F8615D0-5E63-4bd0-982D-B7740559C6F9" Name="!CTX_ROAMINGAPPDATA!\Application\setting folder">
<Platform>
<Folder>
<!-- We can use Citrix variable if necessary -->
<Path>!CTX_ROAMINGAPPDATA!\Application\setting folder</Path>
<Merge/>
<Recurse/>
<ExcludeFiles>
<Exclude>excluded file 1</Exclude>
<Exclude>excluded file 2</Exclude>
<Exclude>excluded file 3</Exclude>
</ExcludeFiles>
</Folder>
</Platform>
</Object>
<!-- File Setting Example -->
<Object GUID="7F8615D0-5E63-4bd0-982D-B7740559C6F9" Name="!CTX_ROAMINGAPPDATA!\Application\file.txt">
<Platform>
<File>
<!-- We can use Citrix variable if necessary -->
<Path>!CTX_ROAMINGAPPDATA!\Application</Path>
<FileName>file.txt</FileName>
</File>
</Platform>
</Object>
<!-- Setting based on different OS -->
<Object GUID="1B43DE3F-EC9C-463c-AC19-CD01D00219B6" Name="!CTX_ROAMINGAPPDATA!\Application\%osname%\folder">
<!-- Assuming that the folder locates differently when in different platforms -->
<Platform OSVersionNumber="6.1">
<!-- Win7 -->
<Folder>
<Path>!CTX_ROAMINGAPPDATA!\Application\Win7\folder</Path>
<Recurse/>
</Folder>
</Platform>
<Platform OSVersionNumber="10.0">
<!-- Win10 -->
<Folder>
<Path>!CTX_ROAMINGAPPDATA!\Application\Win10\folder</Path>
<Recurse/>
</Folder>
</Platform>
</Object>
</Group>
</GroupDefinitions>