Estructura del archivo de definición de aplicación

Last published : Nov 13, 2026
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ó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 gestiona la clave. Otro subelemento opcional es ExcludeValues. ExcludeValues define los valores de 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, Recurse y Merge. Recurse y Merge definen el rendimiento cuando Profile Management gestiona la carpeta. Otro subelemento opcional es ExcludeFiles, 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 FileName para 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 gestiona estas configuraciones automáticamente.
  • Key
    Especifica la ruta de la clave de registro o la ruta de la clave de registro principal. Key es el subelemento de RegKey y RegValue.
  • ValueName
    Especifica el nombre del valor de 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. -->

&lt;GroupDefinitions GUID="748E63D3-426E-4796-9C32-420B25DB2D9F" Version="4.0.0.0">

<!-- Application Settings -->

&lt;Group GUID="0FCCCF29-0A0E-482d-A77E-3F39A8A854A6" Name="Application Settings">

<!-- Registry Key Setting Example -->

&lt;Object GUID="637EC13C-2D47-4142-A8EB-3CEA6D53522A" Name="Software\Application\certain key">

&lt;Platform>

&lt;RegKey>

&lt;Key>Software\Microsoft\Office\certain key&lt;/Key>

&lt;Merge/>

&lt;Recurse/>

&lt;ExcludeValues>

&lt;Exclude>excluded value 1&lt;/Exclude>

&lt;Exclude>excluded value 2&lt;/Exclude>

&lt;Exclude>excluded value 3&lt;/Exclude>

&lt;/ExcludeValues>

&lt;/RegKey>

&lt;/Platform>

&lt;/Object>

<!-- Registry Value Setting Example -->

&lt;Object GUID="3C896310-10C4-4e5f-90C7-A79F4E653F81" Name="Software\Application\certain value">

<!-- Folder Setting Example -->

&lt;Object GUID="7F8615D0-5E63-4bd0-982D-B7740559C6F9" Name="!CTX_ROAMINGAPPDATA!\Application\setting folder">

&lt;Platform>

&lt;Folder>

<!-- We can use Citrix variable if necessary -->

&lt;Path>!CTX_ROAMINGAPPDATA!\Application\setting folder&lt;/Path>

&lt;Merge/>

&lt;Recurse/>

&lt;ExcludeFiles>

&lt;Exclude>excluded file 1&lt;/Exclude>

&lt;Exclude>excluded file 2&lt;/Exclude>

&lt;Exclude>excluded file 3&lt;/Exclude>

&lt;/ExcludeFiles>

&lt;/Folder>

&lt;/Platform>

&lt;/Object>

<!-- File Setting Example -->

&lt;Object GUID="7F8615D0-5E63-4bd0-982D-B7740559C6F9" Name="!CTX_ROAMINGAPPDATA!\Application\file.txt">

&lt;Platform>

&lt;File>

<!-- We can use Citrix variable if necessary -->

&lt;Path>!CTX_ROAMINGAPPDATA!\Application&lt;/Path>

&lt;FileName>file.txt&lt;/FileName>

&lt;/File>

&lt;/Platform>

&lt;/Object>

<!-- Setting based on different OS -->

&lt;Object GUID="1B43DE3F-EC9C-463c-AC19-CD01D00219B6" Name="!CTX_ROAMINGAPPDATA!\Application\%osname%\folder">

<!-- Assuming that the folder locates differently when in different platforms -->

&lt;Platform OSVersionNumber="6.1">

<!-- Win7 -->

&lt;Folder>

&lt;Path>!CTX_ROAMINGAPPDATA!\Application\Win7\folder&lt;/Path>

&lt;Recurse/>

&lt;/Folder>

&lt;/Platform>

&lt;Platform OSVersionNumber="10.0">

<!-- Win10 -->

&lt;Folder>

&lt;Path>!CTX_ROAMINGAPPDATA!\Application\Win10\folder&lt;/Path>

&lt;Recurse/>

&lt;/Folder>

&lt;/Platform>

&lt;/Object>

&lt;/Group>

&lt;/GroupDefinitions>