Jak funguje aktualizovatelná nápověda

Toto téma vysvětluje, jak aktualizovatelná nápověda zpracovává soubor HelpInfo XML a soubory CAB pro každý modul a nainstaluje 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. (Chcete-li zobrazit schéma, přečtěte si téma HelpInfo XML Schema.) Pak Update-Help vyhledá místní soubor HelpInfo XML modulu v adresáři modulu v 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 modulu. Pokud je číslo verze vzdáleného souboru větší než číslo verze místního souboru nebo pokud pro modul neexistuje žádný místní soubor HelpInfo XML, Update-Help připraví se ke stažení nových souborů 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 adresáře modulu konkrétního jazyka na 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 obsahoval elementy pouze pro soubor CAB, který nainstaloval. Pak uloží místní soubor HELPInfo XML do adresáře modulu a ukončí 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é složce a pak tyto soubory použije k aktualizaci souborů nápovědy na počítači uživatele.

Rutina Save-Help provede následující akce v reakci na příkaz, který uloží soubory nápovědy pro modul ve sdílené složce určené 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. (Chcete-li zobrazit schéma, přečtěte si téma HelpInfo XML Schema.) Potom Save-Help vyhledá místní soubor XML HelpInfo v adresáři, který je 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 modulu. Pokud je číslo verze vzdáleného souboru větší než číslo verze v místním souboru nebo pokud neexistuje žádný místní soubor HelpInfo XML pro modul v adresáři DestinationPath , Save-Help připraví se ke stažení nových souborů 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-Help stáhne soubor CAB a uloží ho do adresáře DestinationPath . (Nevytvoří žá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 obsahoval elementy pouze pro soubor CAB, který uložil. Pak uloží místní soubor HELPInfo XML do adresáře DestinationPath a ukončí aktualizaci.

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

6. Update-Help získá vzdálený soubor HelpInfo XML z adresáře SourcePath . Pak vyhledá místní soubor HELPInfo XML v adresáři modulu v 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 modulu. Pokud je číslo verze vzdáleného souboru větší než číslo verze v místním souboru nebo pokud neexistuje žádný místní soubor HelpInfo XML, Update-Help připraví se na instalaci nových souborů nápovědy.

8. Update-Help vybere 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 adresáře modulu specifického pro jazyk 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 obsahoval elementy pouze pro soubor CAB, který nainstaloval. Pak uloží místní soubor HELPInfo XML do adresáře modulu a ukončí aktualizaci.