Structure du fichier de définition d’application

Ce document décrit la structure XML des fichiers de définition d’application de Profile Management. Cette structure s’applique à la fois au profileur d’applications et aux paramètres multi-plateformes.

Tableau d’architecture

image localisée

  • Déclaration XML et attribut Encoding

    La déclaration XML doit spécifier l’attribut <?xml version=”1.0”>.

    Encoding=”UTF-8” est un attribut recommandé.

  • GroupDefinitions

    Conteneur de collections de groupes. Il agit en tant qu’élément racine du document XML. Ses attributs incluent version et GUID. Ce sont des attributs obligatoires.

  • Group

    Définit les paramètres d’une sous-application. Ses attributs sont name et GUID. Ce sont des attributs obligatoires.

  • Object

    Définit un paramètre d’une sous-application. Ses attributs sont name et GUID. Ce sont des attributs obligatoires.

  • Platform

    Fournit différentes définitions dans différents systèmes d’exploitation. Il peut utiliser un attribut facultatif OSVersionNumber pour spécifier le système d’exploitation. Lorsqu’il n’y a pas d’attribut, toutes les plates-formes acceptent la définition interne du paramètre. Platform doit contenir l’un des éléments suivants : RegKey, RegValue, File, Folder et Wallpaper.

  • RegKey

    Définit un paramètre en tant que clé dans le registre. Il doit contenir l’élément Key. Il comprend deux sous-éléments facultatifs, Recurse et Merge. Recurse et Merge définissent les performances lorsque Profile Management utilise la clé en itinérance. ExcludeValues est un autre sous-élément facultatif qui définit les valeurs de registre pouvant être exclues.

  • RegValue

    Définit un paramètre en tant que valeur dans le registre. Il doit contenir Key pour spécifier le chemin de sa clé parente.

  • Folder

    Définit un paramètre en tant que dossier. Il doit contenir Path pour spécifier le chemin du dossier. Il comprend deux sous-éléments facultatifs, Recurse et Merge. Recurse et Merge définissent les performances lorsque Profile Management utilise le dossier en itinérance. ExcludeFiles est un autre sous-élément facultatif qui définit les fichiers pouvant être exclus.

  • File

    Définit un paramètre en tant que fichier. Il doit contenir Path pour spécifier le chemin de son dossier parent et FileName pour spécifier le nom d’un fichier.

  • Wallpaper

    Définit tous les paramètres de fond d’écran. Aucun attribut ou sous-élément n’est requis. Profile Management utilise ces paramètres en itinérance automatiquement.

  • Key

    Spécifie le chemin de la clé de registre ou le chemin de la clé de registre parente. Key est le sous-élément de RegKey et RegValue.

  • ValueName

    Spécifie le nom de la valeur de registre. C’est un sous-élément de RegValue.

  • Path

    Spécifie le chemin du dossier ou le chemin du dossier parent. C’est un sous-élément de Folder et File. Les variables de Profile Management peuvent être adoptées.

  • Filename

    Spécifie le nom d’un fichier. C’est un sous-élément de File.

  • Recurse

    Sous-élément facultatif de RegKey et Folder. Si cet élément existe, Profile Management utilise la clé et le dossier en itinérance de manière récursive.

  • Merge

    Sous-élément facultatif de RegKey et Folder. Si cet élément existe, Profile Management fusionne (mais ne remplace pas) la clé et le dossier.

  • ExcludeValues

    Sous-élément facultatif de RegKey. Spécifie les valeurs qui peuvent être exclues lors de l’itinérance de la clé.

  • ExcludeFiles

    Sous-élément facultatif de Folder. Spécifie les fichiers qui peuvent être exclus lors de l’itinérance du dossier.

  • Exclude

    Sous-élément de ExcludeValues et ExcludeFiles. Spécifie les éléments exclus des fichiers ou des valeurs de registre.

Remarque

Assurez-vous que le format de la syntaxe de votre document est correct. Profile Management vérifie ces fichiers en utilisant le fichier de validation CPSValidationSchema.xsd lorsque ces fichiers sont chargés. Le fichier de validation se trouve sous le chemin d’installation de Profile Management. Profile Management ignore les fichiers incorrects et enregistre les messages d’erreur dans le journal.

Exemple

<?xml version="1.0" encoding="UTF-8"?>

<!-- Copyright 2011 Citrix Systems, Inc. Tous droits réservés. -->

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

<!-- Paramètres de l'application -->

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

<!-- Exemple de paramètre de clé de registre -->

<Object GUID="637EC13C-2D47-4142-A8EB-3CEA6D53522A" Name="Software\Application\clé">

<Platform>

<RegKey>

<Key>Software\Microsoft\Office\clé</Key>

<Merge/>

<Recurse/>

<ExcludeValues>

<Exclude>valeur exclue 1</Exclude>

<Exclude>valeur exclue 2</Exclude>

<Exclude>valeur exclue 3</Exclude>

</ExcludeValues>

</RegKey>

</Platform>

</Object>

<!-- Exemple de paramètre de valeur de registre -->

<Object GUID="3C896310-10C4-4e5f-90C7-A79F4E653F81" Name="Software\Application\valeur">

<!-- Exemple de dossier de paramètre -->

<Object GUID="7F8615D0-5E63-4bd0-982D-B7740559C6F9" Name="!CTX_ROAMINGAPPDATA!\Application\dossier de paramètre">

<Platform>

<Folder>

<! -- Nous pouvons utiliser la variable Citrix si nécessaire -->

<Path>!CTX_ROAMINGAPPDATA!\Application\dossier de paramètre</Path>

<Merge/>

<Recurse/>

<ExcludeFiles>

<Exclude>fichier exclu 1</Exclude>

<Exclude>fichier exclu 2</Exclude>

<Exclude>fichier exclu 3</Exclude>

</ExcludeFiles>

</Folder>

</Platform>

</Object>

<!-- Exemple de fichier de paramètre -->

<Object GUID="7F8615D0-5E63-4bd0-982D-B7740559C6F9" Name="!CTX_ROAMINGAPPDATA!\Application\fichier.txt">

<Platform>

<File>

<! - Nous pouvons utiliser la variable Citrix si nécessaire ->

<Path>!CTX_ROAMINGAPPDATA!\Application</Path>

<FileName>fichier.txt</FileName>

</File>

</Platform>

</Object>

<!-- Paramètre basé sur un système d'exploitation différent -->

<Object GUID="1B43DE3F-EC9C-463c-AC19-CD01D00219B6" Name="!CTX_ROAMINGAPPDATA!\Application\%nomOS%\dossier">

<!-- En supposant que le dossier se trouve dans un emplacement différent dans d'autres plates-formes -->

<Platform OSVersionNumber="6.1">

<!-- Win7 -->

<Folder>

<Path>!CTX_ROAMINGAPPDATA!\Application\Win7\dossier</Path>

<Recurse/>

</Folder>

</Platform>

<Platform OSVersionNumber = "10.0">

<!-- Win10 -->

<Folder>

<Path>!CTX_ROAMINGAPPDATA!\Application\Win10\dossier</Path>

<Recurse/>

</Folder>

</Platform>

</Object>

</Group>

</GroupDefinitions>

Structure du fichier de définition d’application