Estructura del archivo de definición de 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
Diagrama de arquitectura(/en-us/profile-management/2503/media/definitionfilestructure.jpg)
-
Declaración XML y atributo de codificaciónLa declaración XML debe especificar el atributo, \<?xml version="1.0"\>.Encoding="UTF-8" es un atributo recomendado.
-
GroupDefinitionsUn contenedor de colecciones de grupos. Actúa como el elemento raíz del documento XML. Sus atributos incluyen version y GUID. Son atributos obligatorios.
-
GroupDefine la configuración de una subaplicación. Sus atributos son name y GUID. Son atributos obligatorios.
-
ObjectDefine una configuración de una subaplicación. Sus atributos son name y GUID. Son atributos obligatorios.
-
PlatformPlatform 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.
-
RegKeyDefine 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 gestiona la clave. Otro subelemento opcional es ExcludeValues. ExcludeValues define los valores de registro que se pueden excluir.
-
RegValueDefine una configuración como un valor en el registro. Debe contener Key para especificar la ruta de su clave principal.
-
CarpetaDefine 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 gestiona la carpeta. Otro subelemento opcional esExcludeFiles, que define los archivos que se pueden excluir. -
ArchivoDefine 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 pantallaDefine todas las configuraciones de fondo de pantalla. No se requieren atributos ni subelementos. Profile Management gestiona estas configuraciones automáticamente.
-
KeyEspecifica la ruta de la clave de registro o la ruta de la clave de registro principal. Key es el subelemento de RegKey y RegValue.
-
ValueNameEspecifica el nombre del valor de registro. Es un subelemento de RegValue.
-
PathEspecifica 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.
-
FileNameEspecifica el nombre de un archivo. Es un subelemento de Archivo.
-
RecurseSubelemento opcional de RegKey y Carpeta. Si este elemento existe, Profile Management explora la clave y la carpeta de forma recursiva.
-
MergeSubelemento opcional de RegKey y Carpeta. Si este elemento existe, Profile Management fusiona (pero no sustituye) la clave y la carpeta.
-
ExcludeValuesSubelemento opcional de RegKey. Especifica los valores que se pueden excluir al explorar la clave.
-
ExcludeFilesSubelemento opcional de Carpeta. Especifica los archivos que se pueden excluir al explorar la carpeta.
-
ExcludeSubelemento 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>