Profile Management

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

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, Recurse y Merge. Recurse y Merge definen el rendimiento cuando Profile Management transfiere la carpeta. Otro subelemento optativo es ExcludeFiles, 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>
Estructura de los archivos de definición de aplicaciones