Estructura de los archivos de definición de aplicaciones
Este artículo describe la estructura XML de los archivos de definición de aplicaciones de Profile Management. Esta estructura se aplica tanto al perfil de aplicación como a la configuración multiplataforma.
Gráfico de la arquitectura
-
Atributo de declaración XML y 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 versión y GUID. Son atributos obligatorios.
-
Grupo
Define los parámetros de una subaplicación. Sus atributos son nombre y GUID. Son atributos obligatorios.
-
Objeto
Define un parámetro de una subaplicación. Sus atributos son nombre y GUID. Son atributos obligatorios.
-
Platform
Platform proporciona diferentes definiciones en diferentes sistemas operativos. Puede usar el atributo optativo OSVersionNumber para especificar el sistema operativo. Cuando no hay ningún atributo, todas las plataformas aceptan la definición interna del parámetro. La plataforma debe contener uno de los siguientes elementos: RegKey, RegValue, File, Folder y Wallpaper.
-
RegKey
Define un parámetro como una clave de Registro. Debe contener un elemento Key. Incluye dos subelementos optativos: Recurse y Merge. Recurse y Merge definen el rendimiento cuando Profile Management transfiere la clave. Otro subelemento opcional es ExcludeValues. ExcludeValues define los valores del Registro que se pueden excluir.
-
RegValue
Define un parámetro como un valor de Registro. Debe contener Key para especificar la ruta de su clave superior.
-
Carpeta
Define un parámetro como una carpeta. Debe contener Path para especificar la ruta de la carpeta. Incluye subelementos optativos,
RecurseyMerge. Recurse y Merge definen el rendimiento cuando Profile Management transfiere la carpeta. Otro subelemento optativo esExcludeFiles, que define los archivos que se pueden excluir. -
Archivo
Define un parámetro como un archivo. Debe contener Path para especificar la ruta de su carpeta superior, y
FileName, para especificar el nombre de un archivo. -
Wallpaper
Define todos los parámetros de tapiz de pantalla. No requiere atributos ni subelementos. Profile Management transfiere automáticamente estos parámetros.
-
Clave
Especifica la ruta de la clave de Registro o la ruta de la clave de Registro superior. Key es el subelemento de RegKey y RegValue.
-
ValueName
Especifica el nombre del valor de Registro. Es un subelemento de RegValue.
-
Ruta
Especifica la ruta de la carpeta o la ruta de la carpeta superior. Es un subelemento de Folder y File. Las variables de Profile Management pueden ser adoptadas.
-
FileName
Especifica el nombre de un archivo. Es un subelemento de File.
-
Recurse
Subelemento optativo de RegKey y Folder. Si este elemento existe, Profile Management transfiere la clave y la carpeta de manera recursiva.
-
Merge
Subelemento optativo de RegKey y Folder. Si este elemento existe, Profile Management fusiona (pero no sustituye) la clave y la carpeta.
-
ExcludeValues
Subelemento optativo de RegKey. Especifica los valores que se pueden excluir al transferir la clave.
-
ExcludeFiles
Subelemento optativo de Folder. Especifica los archivos que se pueden excluir al transferir la clave.
-
Exclude
Subelemento de ExcludeValues y ExcludeFiles. Especifica los elementos excluidos de archivos o valores de Registro.
Nota
Compruebe que su documento contiene un formato de sintaxis correcto. Profile Management verifica estos archivos mediante el archivo de validación CPSValidationSchema.xsd cuando se cargan. El archivo de validación se encuentra en la ruta de instalación de Profile Management. Profile Management ignora los archivos incorrectos y guarda registros de los mensajes de error.
Sample
<?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>