A frissíthető súgó működése

  • Cikk

Ez a témakör azt ismerteti, hogy a Frissíthető súgó hogyan dolgozza fel a HelpInfo XML-fájlt és a CAB-fájlokat az egyes modulokhoz, és hogyan telepíti a frissített súgót a felhasználók számára.

A Update-Help folyamat

Az alábbi lista az Update-Help parancsmag azon műveletét ismerteti, amikor egy felhasználó egy adott felhasználói felületi kulturális környezetben futtat egy parancsot egy modul súgófájljának frissítéséhez.

  1. Update-Help lekért távoli HelpInfo XML-fájlt a modul jegyzékfájljában található HelpInfoURI kulcs értéke által megadott helyről, és ellenőrzi a fájlt a sémában. (A séma megtekintéséhez lásd: HelpInfo XML-séma.) Ezután egy helyi HelpInfo XML-fájlt keres a modulhoz a modul könyvtárában Update-Help a felhasználó számítógépén.

  2. Update-Help összehasonlítja a modul távoli és helyi HelpInfo XML-fájljaiban a megadott felhasználói felületi kulturális környezet súgófájljának verziószámát. Ha a távoli fájl verziószáma nagyobb, mint a helyi fájl verziószáma, vagy ha a modulnak nincs helyi HelpInfo XML-fájlja, akkor előkészíti az új súgófájlok Update-Help letöltését.

  3. Update-Help kiválasztja a modul CAB-fájlját a távoli HelpInfo XML-fájl HelpContentUri eleme által megadott helyről. A CAB-fájl azonosításához a modul nevét, a modul GUID azonosítóját és a felhasználói felület kulturális környezetét használja.

  4. Update-Help letölti a CAB-fájlt, kicsomagolja, ellenőrzi a súgótartalom fájljait, és menti a súgótartalom fájljait a modulkönyvtár nyelvspecifikus alkönyvtárába a felhasználó számítógépén.

  5. Update-Help A létrehoz egy helyi HelpInfo XML-fájlt a távoli HelpInfo XML-fájl másolása segítségével. Úgy szerkeszti a helyi HelpInfo XML-fájlt, hogy csak a telepített CAB-fájl elemeit tartalmazza. Ezután menti a helyi HelpInfo XML-fájlt a modul könyvtárába, és befejezi a frissítést.

A Save-Help folyamat

Az alábbi lista ismerteti a Save-Help és Update-Help parancsmagok azon műveletét, amikor egy felhasználó parancsokat futtat a fájlmegosztásban lévő súgófájlok frissítéséhez, majd ezeket a fájlokat használja a felhasználó számítógépén található súgófájlok frissítéséhez.

A parancsmag a következő műveleteket végzi el egy parancsra válaszul, amely egy modul súgófájljainak a DestinationPath paraméter által megadott fájlmegosztásba Save-Help való mentésére használható.

  1. Save-Help lekért távoli HelpInfo XML-fájlt a modul jegyzékfájljában található HelpInfoURI kulcs értéke által megadott helyről, és ellenőrzi a fájlt a sémában. (A séma megtekintéséhez lásd: HelpInfo XML-séma.) Ezután egy helyi HelpInfo XML-fájlt keres a DestinationPath paraméter által a Save-Help parancsban megadott Save-Help könyvtárban.

  2. Save-Help összehasonlítja a modul távoli és helyi HelpInfo XML-fájljaiban a megadott felhasználói felületi kulturális környezet súgófájljának verziószámát. Ha a távoli fájl verziószáma nagyobb, mint a helyi fájl verziószáma, vagy ha nincs helyi HelpInfo XML-fájl a modulhoz a DestinationPath könyvtárban, előkészíti az új súgófájlok letöltését. Save-Help

  3. Save-Help kiválasztja a modul CAB-fájlját a távoli HelpInfo XML-fájl HelpContentUri eleme által megadott helyről. A CAB-fájl azonosításához a modul nevét, a modul GUID azonosítóját és a felhasználói felület kulturális környezetét használja.

  4. Save-Helpletölti a CAB-fájlt, és menti a DestinationPath könyvtárba. (Nem hoz létre nyelvspecifikus alkönyvtárakat.)

  5. Save-Help A létrehoz egy helyi HelpInfo XML-fájlt a távoli HelpInfo XML-fájl másolása segítségével. Úgy szerkeszti a helyi HelpInfo XML-fájlt, hogy csak a mentett CAB-fájl elemeit tartalmazza. Ezután menti a helyi HelpInfo XML-fájlt a DestinationPath könyvtárba, és befejezi a frissítést.

    A parancsmag a következő műveleteket végzi el egy parancsra válaszul, amely frissíti a felhasználó számítógépén lévő súgófájlokat a SourcePath paraméter által megadott fájlmegosztásban lévő Update-Help fájlokból.

  6. Update-Helplekérte a távoli HelpInfo XML-fájlt a SourcePath könyvtárból. Ezután egy helyi HelpInfo XML-fájlt keres a felhasználó számítógépén található modulkönyvtárban.

  7. Update-Help összehasonlítja a modul távoli és helyi HelpInfo XML-fájljaiban a megadott felhasználói felületi kulturális környezet súgófájljának verziószámát. Ha a távoli fájl verziószáma nagyobb, mint a helyi fájl verziószáma, vagy ha nincs helyi HelpInfo XML-fájl, előkészíti az új Update-Help súgófájlok telepítését.

  8. Update-Helpkiválasztja a modul CAB-fájlját a SourcePath könyvtárból. A CAB-fájl azonosításához a modul nevét, a modul GUID azonosítóját és a felhasználói felület kulturális környezetét használja.

  9. Update-Help kicsomagolja a CAB-fájlt, ellenőrzi a súgótartalom fájljait, és menti a súgótartalom fájljait a modulkönyvtár nyelvspecifikus alkönyvtárába a felhasználó számítógépén.

  10. Update-Help A létrehoz egy helyi HelpInfo XML-fájlt a távoli HelpInfo XML-fájl másolása segítségével. Úgy szerkeszti a helyi HelpInfo XML-fájlt, hogy csak a telepített CAB-fájl elemeit tartalmazza. Ezután menti a helyi HelpInfo XML-fájlt a modul könyvtárába, és befejezi a frissítést.