Jak funguje aktualizovatelná nápověda

Toto téma vysvětluje, jak aktualizovatelná nápověda zpracovává soubory HelpInfo XML a CAB pro každý modul a instaluje aktualizovanou nápovědu pro uživatele.

Proces Update-Help

Následující seznam popisuje akce rutiny Update-Help, když uživatel spustí příkaz pro aktualizaci souborů nápovědy pro modul v konkrétní jazykové verzi uživatelského rozhraní.

1. Update-Help získá vzdálený soubor HelpInfo XML z umístění určeného hodnotou klíče HelpInfoURI v manifestu modulu a ověří soubor proti schématu. (Informace o zobrazení schématu najdete v tématu HelpInfo XML Schema.) Pak vyhledá místní soubor HelpInfo XML pro modul v Update-Help adresáři modulu na počítači uživatele.

2. Update-Help porovná číslo verze souborů nápovědy pro zadanou jazykovou verzi uživatelského rozhraní ve vzdálených a místních souborech HelpInfo XML pro modul. Pokud je číslo verze vzdáleného souboru větší než číslo verze místního souboru nebo pokud neexistuje žádný místní soubor HelpInfo XML pro modul, připraví se na stažení nových souborů Update-Help nápovědy.

3. Update-Help vybere soubor CAB pro modul z umístění určeného elementem HelpContentUri ve vzdáleném souboru HelpInfo XML. K identifikaci souboru CAB používá název modulu, identifikátor GUID modulu a jazykovou verzi uživatelského rozhraní.

4. Update-Help stáhne soubor CAB, rozbalí ho, ověří soubory obsahu nápovědy a uloží soubory obsahu nápovědy do podadresáře modulu pro konkrétní jazyk v počítači uživatele.

5. Update-Help vytvoří místní soubor HelpInfo XML zkopírováním vzdáleného souboru HelpInfo XML. Upraví místní soubor HelpInfo XML tak, aby v souboru CAB byl jenom prvky, které nainstaloval. Pak uloží místní soubor HelpInfo XML do adresáře modulu a dokončí aktualizaci.

Proces Save-Help

Následující seznam popisuje akce rutin Save-Help a Update-Help, když uživatel spustí příkazy pro aktualizaci souborů nápovědy ve sdíleném souboru a pak tyto soubory použije k aktualizaci souborů nápovědy v počítači uživatele.

Rutina v reakci na příkaz provede následující akce pro uložení souborů nápovědy pro modul do sdílené složky, která je určena Save-Help parametrem DestinationPath.

1. Save-Help získá vzdálený soubor HelpInfo XML z umístění určeného hodnotou klíče HelpInfoURI v manifestu modulu a ověří soubor proti schématu. (Informace o zobrazení schématu najdete v tématu HelpInfo XML Schema.) Pak vyhledá místní soubor HelpInfo XML v adresáři, který je Save-Help určený parametrem DestinationPath v Save-Help příkazu .

2. Save-Help porovná číslo verze souborů nápovědy pro zadanou jazykovou verzi uživatelského rozhraní ve vzdálených a místních souborech HelpInfo XML pro modul. Pokud je číslo verze vzdáleného souboru větší než číslo verze místního souboru nebo pokud není v adresáři DestinationPath žádný místní soubor HelpInfo XML pro modul, připraví se na stažení nových souborů Save-Help nápovědy.

3. Save-Help vybere soubor CAB pro modul z umístění určeného elementem HelpContentUri ve vzdáleném souboru HelpInfo XML. K identifikaci souboru CAB používá název modulu, identifikátor GUID modulu a jazykovou verzi uživatelského rozhraní.

4. Save-Helpstáhne soubor CAB a uloží ho do adresáře DestinationPath. (Nevytváří žádné podadresáře specifické pro jazyk.)

5. Save-Help vytvoří místní soubor HelpInfo XML zkopírováním vzdáleného souboru HelpInfo XML. Upraví místní soubor HelpInfo XML tak, aby v souboru CAB byl jenom prvky, které uložil. Potom uloží místní soubor HelpInfo XML do adresáře DestinationPath a dokončí aktualizaci.

   Rutina v reakci na příkaz provede následující akce a aktualizuje soubory nápovědy v počítači uživatele ze souborů ve sdílené složky určené parametrem Update-Help SourcePath.

6. Update-Helpzíská vzdálený soubor HelpInfo XML z adresáře SourcePath. Pak hledá místní soubor HelpInfo XML v adresáři modulu na počítači uživatele.

7. Update-Help porovná číslo verze souborů nápovědy pro zadanou jazykovou verzi uživatelského rozhraní ve vzdálených a místních souborech HelpInfo XML pro modul. Pokud je číslo verze vzdáleného souboru větší než číslo verze místního souboru nebo pokud neexistuje žádný místní soubor HelpInfo XML, připraví se na instalaci Update-Help nových souborů nápovědy.

8. Update-Helpvybere soubor CAB pro modul z adresáře SourcePath. K identifikaci souboru CAB používá název modulu, identifikátor GUID modulu a jazykovou verzi uživatelského rozhraní.

9. Update-Help rozbalí soubor CAB, ověří soubory obsahu nápovědy a uloží soubory obsahu nápovědy do podadresáře modulu v podadresáři modulu v počítači uživatele.

10. Update-Help vytvoří místní soubor HelpInfo XML zkopírováním vzdáleného souboru HelpInfo XML. Upraví místní soubor HelpInfo XML tak, aby v souboru CAB byl jenom prvky, které nainstaloval. Pak uloží místní soubor HelpInfo XML do adresáře modulu a dokončí aktualizaci.