Fonctionnement de l’aide actualisable

Cette rubrique explique comment l’aide pouvant être mise à jour traite le fichier XML HelpInfo et les fichiers CAB pour chaque module et installe l’aide mise à jour pour les utilisateurs.

Processus de Update-Help

La liste suivante décrit les actions de l’applet de commande Update-Help lorsqu’un utilisateur exécute une commande pour mettre à jour les fichiers d’aide d’un module dans une culture d’interface utilisateur particulière.

1. Update-Help obtient le fichier XML HelpInfo distant à partir de l’emplacement spécifié par la valeur de la clé HelpInfoURI dans le manifeste du module et valide le fichier sur le schéma. (Pour afficher le schéma, consultez HelpInfo XML Schema.) Recherche ensuite Update-Help un fichier XML HelpInfo local pour le module dans le répertoire du module sur l’ordinateur de l’utilisateur.

2. Update-Help compare le numéro de version des fichiers d’aide pour la culture d’interface utilisateur spécifiée dans les fichiers XML HelpInfo distants et locaux du module. Si le numéro de version du fichier distant est supérieur au numéro de version du fichier local ou s’il n’existe aucun fichier XML HelpInfo local pour le module, Update-Help prépare le téléchargement de nouveaux fichiers d’aide.

3. Update-Help sélectionne le fichier CAB du module à partir de l’emplacement spécifié par l’élément HelpContentUri dans le fichier XML HelpInfo distant. Il utilise le nom du module, le GUID du module et la culture de l’interface utilisateur pour identifier le fichier CAB.

4. Update-Help télécharge le fichier CAB, le décompresse, valide les fichiers de contenu d’aide et enregistre les fichiers de contenu d’aide dans le sous-répertoire spécifique à la langue du répertoire de module sur l’ordinateur de l’utilisateur.

5. Update-Help crée un fichier XML HelpInfo local en copiant le fichier XML HelpInfo distant. Il modifie le fichier XML HelpInfo local afin qu’il inclut uniquement les éléments du fichier CAB qu’il a installé. Ensuite, il enregistre le fichier XML HelpInfo local dans le répertoire du module et conclut la mise à jour.

Processus de Save-Help

La liste suivante décrit les actions des applets de commande Save-Help et Update-Help lorsqu’un utilisateur exécute des commandes pour mettre à jour les fichiers d’aide dans un partage de fichiers, puis utiliser ces fichiers pour mettre à jour les fichiers d’aide sur l’ordinateur de l’utilisateur.

L’applet Save-Help de commande effectue les actions suivantes en réponse à une commande pour enregistrer les fichiers d’aide d’un module dans un partage de fichiers spécifié par le paramètre DestinationPath .

1. Save-Help obtient le fichier XML HelpInfo distant à partir de l’emplacement spécifié par la valeur de la clé HelpInfoURI dans le manifeste du module et valide le fichier sur le schéma. (Pour afficher le schéma, consultez HelpInfo XML Schema.) Recherche ensuite Save-Help un fichier XML HelpInfo local dans le répertoire spécifié par le paramètre DestinationPath dans la Save-Help commande.

2. Save-Help compare le numéro de version des fichiers d’aide pour la culture d’interface utilisateur spécifiée dans les fichiers XML HelpInfo distants et locaux du module. Si le numéro de version du fichier distant est supérieur au numéro de version du fichier local ou s’il n’existe aucun fichier XML HelpInfo local pour le module dans le répertoire DestinationPath , Save-Help prépare le téléchargement de nouveaux fichiers d’aide.

3. Save-Help sélectionne le fichier CAB du module à partir de l’emplacement spécifié par l’élément HelpContentUri dans le fichier XML HelpInfo distant. Il utilise le nom du module, le GUID du module et la culture de l’interface utilisateur pour identifier le fichier CAB.

4. Save-Help télécharge le fichier CAB et l’enregistre dans le répertoire DestinationPath . (Il ne crée pas de sous-répertoires spécifiques au langage.)

5. Save-Help crée un fichier XML HelpInfo local en copiant le fichier XML HelpInfo distant. Il modifie le fichier XML HelpInfo local afin qu’il inclut uniquement les éléments du fichier CAB qu’il a enregistré. Ensuite, il enregistre le fichier XML HelpInfo local dans le répertoire DestinationPath et conclut la mise à jour.

   L’applet Update-Help de commande effectue les actions suivantes en réponse à une commande pour mettre à jour les fichiers d’aide sur l’ordinateur d’un utilisateur à partir des fichiers d’un partage de fichiers spécifié par le paramètre SourcePath .

6. Update-Help obtient le fichier XML HelpInfo distant à partir du répertoire SourcePath . Ensuite, il recherche un fichier XML HelpInfo local dans le répertoire du module sur l’ordinateur de l’utilisateur.

7. Update-Help compare le numéro de version des fichiers d’aide pour la culture d’interface utilisateur spécifiée dans les fichiers XML HelpInfo distants et locaux du module. Si le numéro de version du fichier distant est supérieur au numéro de version du fichier local ou s’il n’existe aucun fichier XML HelpInfo local, Update-Help prépare l’installation de nouveaux fichiers d’aide.

8. Update-Help sélectionne le fichier CAB du module dans le répertoire SourcePath . Il utilise le nom du module, le GUID du module et la culture de l’interface utilisateur pour identifier le fichier CAB.

9. Update-Help décompresse le fichier CAB, valide les fichiers de contenu d’aide et enregistre les fichiers de contenu d’aide dans le sous-répertoire spécifique au langage du répertoire de module sur l’ordinateur de l’utilisateur.

10. Update-Help crée un fichier XML HelpInfo local en copiant le fichier XML HelpInfo distant. Il modifie le fichier XML HelpInfo local afin qu’il inclut uniquement les éléments du fichier CAB qu’il a installé. Ensuite, il enregistre le fichier XML HelpInfo local dans le répertoire du module et conclut la mise à jour.