A Web Service Connector munkafolyamat-útmutatója a SOAP-hez

Ez a cikk azt ismerteti, hogyan hozhat létre új projektet az adatforráshoz a webszolgáltatás konfigurációs eszközében. Projekt létrehozásához kövesse az alábbi lépéseket.

1. Nyissa meg a webszolgáltatás konfigurációs eszközét. It opens a blank project.

   

2. Select SOAP Project and then select Add.

   

3. A következő lapon adja meg a következő információkat, majd válassza a Következő:

   • Az új webszolgáltatás neve
   • Cím (WSDL-elérési út) a közzétett szolgáltatások, végpontok és műveletek lekéréséhez
   • Namespace
   • Biztonsági mód (hitelesítési típus)

4. Ebben a mintában a hitelesítő adatok lap az Alapszintű biztonsági módra (az előző lépésben kiválasztott módra) vonatkozó követelményekkel jelenik meg. Ha a biztonsági módhoz a "Nincs" érték van megadva, akkor a hitelesítő adatok lap nem jelenik meg. Válassza a Következőlehetőséget.

   

5. A WSDL elérési útja elérhető a szolgáltatásadatok lekéréséhez, és megjelenik a közzétett függvények listája. Ha a megadott WSDL-elérési út helytelen, akkor a konfigurációs eszköz nem tudja lekérni a szolgáltatás adatait, és hibát jelez.

   

6. A felderítés végrehajtása után felsorolja a végpontot és a felderített műveleteket. Válassza ki a Befejezésopciót.

   

7. Compilation is performed. Az összeállítás az adatszerződés összeállításának folyamata, amely időigényes művelet lehet. A felhasználót tájékoztatjuk a fordítási hibákról. A felderítés végrehajtása után az eszköz a következő oldalt jeleníti meg:

   

8. Expanding SOAP project and selecting exposed endpoint provided below screen. Ez a képernyő felsorolja a végpont alatt deklarált műveleteket.

   

9. Expanding endpoint displays list of operations. A művelet egy végpont által deklarált függvény. Minden művelet a szolgáltatáson belül elvégezhető feladattípust kezeli. Ez a képernyő felsorolja a művelethez deklarált argumentumokat. Ezek az argumentumok akkor lesznek definiálva, ha a művelet a munkafolyamatok konfigurálásához használatos.

   

10. A következő lépés az összekötőtérséma meghatározása, amely az objektumtípus létrehozásával és az objektumtípusok definiálásával érhető el. Select Object Types and then select Add. Az új ablakban adjon hozzá egy új objektumtípust, és adjon meg egy nevet. Kattintson az OK gombra.

    

11. Adding an object type provides below screen.

    

12. Az objektumtípusnak megfelelő jobb oldali panel lehetővé teszi a kijelölt objektumtípus attribútumainak és tulajdonságainak karbantartását. Válassza a Hozzáadás lehetőséget. Egy új ablak nyílik meg attribútumok hozzáadásához:

    

    

13. Az összes szükséges attribútum hozzáadása után a következő képernyő jelenik meg:

    

14. Az objektumtípus és -attribútumok létrehozása után üres munkafolyamatokat biztosít, amelyek a Microsoft Identity Manager 2016 (MIM) alkalmazásban végrehajtott műveleteket végzik.

    

Munkafolyamatok konfigurálása a Webszolgáltatás-konfigurációs eszközben

A következő lépés a munkafolyamatok konfigurálása az objektumtípushoz. A munkafolyamat-fájlok olyan tevékenységek sorozatai, amelyeket a Web Services-összekötő futtatáskor használ. A munkafolyamatokkal implementálhatja a megfelelő MIM-műveletet. A webszolgáltatás konfigurációs eszközével négy különböző munkafolyamat hozható létre:

• Importálás: Adatok importálása adatforrásból a következő két munkafolyamattípushoz:

  • Teljes importálás: Konfigurálható teljes importálás.
  • Deltaimportálás: A webszolgáltatás konfigurációs eszköze nem támogatja.

• Exportálás: Adatok exportálása a MIM-ből egy csatlakoztatott adatforrásba. A művelethez az alábbi három intézkedés támogatott. Ezeket a műveleteket a követelményeknek megfelelően konfigurálhatja.

  • Hozzáad
  • Delete
  • Helyettesít

• Jelszó: Jelszókezelés végrehajtása a felhasználó számára (objektumtípus). Ehhez a művelethez két művelet érhető el:

  • Jelszó beállítása
  • Jelszó módosítása

• Kapcsolat tesztelése: Konfiguráljon egy munkafolyamatot annak ellenőrzéséhez, hogy az adatforrás-kiszolgálóval való kapcsolat sikeresen létrejött-e.

Megjegyzés

Ezeket a munkafolyamatokat konfigurálhatja a projekthez, vagy letöltheti az alapértelmezett projektet a Microsoft letöltőközpontból.

Munkafolyamat-tervező

A Munkafolyamat-tervező megnyitja a munkaterületet, hogy igény szerint konfigurálja a munkafolyamatot. Minden objektumtípushoz (új/meglévő) a konfigurációs eszköz biztosítja az eszköz által támogatott munkafolyamatok csomópontjait.

A Munkafolyamat-tervező a következő felhasználói felületi elemekből áll:

• csomópontok a bal oldali panelen: Ezek segítségével kiválaszthatja, hogy melyik munkafolyamatot szeretné megtervezni.

• Központi munkafolyamat-tervező: Itt elvetheti a munkafolyamatok konfigurálásához szükséges tevékenységeket. Különböző MIM-műveletek (exportálás, importálás, jelszókezelés) végrehajtásához használhatja a .NET Workflow Framework 4 szabványos és egyéni munkafolyamat-tevékenységeit. A webszolgáltatás-konfigurációs eszköz szabványos és egyéni munkafolyamat-tevékenységeket használ. További információ a standard tevékenységekről: Tevékenységtervezők használata.

  • A Központi munkafolyamat-tervezőben a tevékenység mellett felkiáltójellel ellátott piros kör azt jelzi, hogy a művelet elesett, és nincs megfelelően és teljesen definiálva. Vigye az egérmutatót a piros kör fölé a pontos hiba kiderítéséhez. A tevékenység helyes definiálása után a piros kör a sárga információs jelre változik.

  • A Központi munkafolyamat-tervezőben a tevékenység mellett egy sárga háromszög információs jel jelzi, hogy a tevékenység definiálva van, de a tevékenység befejezéséhez további műveletek is elvégezhetők. Mutasson a sárga háromszögre a további információk megtekintéséhez.

• Eszközkészlet: Az összes eszközt tartalmazza, beleértve a rendszer- és egyéni tevékenységeket, valamint az előre definiált utasításokat a munkafolyamat megtervezéséhez. További információ: Toolbox.

• Eszközkészlet-szakaszok: Az eszközkészlet a következő szakaszokat és kategóriákat tartalmazza:

  • Description: The header of the Toolbox. Egy lap hozzáfér az eszközkészlethez és a kijelölt munkafolyamat-tevékenység tulajdonságaihoz.

  • Import munkafolyamat: Egyéni tevékenységek a munkafolyamatok importálásának konfigurálásához.

  • Exportálási munkafolyamat: Az exportálási munkafolyamatok konfigurálásához egyéni tevékenységek.

  • Gyakori: Egyéni tevékenységek a munkafolyamatok konfigurálásához.

  • Hibakeresési: A rendszerben hibakeresésre definiált munkafolyamat-tevékenységek a 4. munkafolyamatban. Ezek a tevékenységek lehetővé teszik a munkafolyamatok problémakövetését.

  • Nyilatkozatok: A rendszer munkafolyamat-tevékenységei, amelyek a 4. munkafolyamatban lettek definiálva. További információért lásd: Tevékenységtervezők használata.

• Tulajdonságok: A Tulajdonságok lap egy adott munkafolyamat-tevékenység tulajdonságait jeleníti meg, amely a tervezőterületre kerül, és ki van választva. A bal oldali ábrán a hozzárendelt tevékenység tulajdonságai láthatók. Minden tevékenység esetében a tulajdonságok eltérnek, és az egyéni munkafolyamat konfigurálásakor használatosak. Ezen a lapon meghatározhatja a központi munkafolyamat-tervezőbe elvetett kijelölt eszköz attribútumait. For more information, see Properties.

• tevékenységsáv: A tevékenységsáv három elemet tartalmaz: Változók, Argumentumokés Importálás. Ezeket az elemeket a munkafolyamat-tevékenységekkel együtt használjuk. For more information, see A developer's introduction to Windows Workflow Foundation (WF) in .NET 4.

Teljes importálási munkafolyamat konfigurálása a webszolgáltatás konfigurációs eszközében

Az alábbi lépések bemutatják, hogyan konfigurálhat teljes importálási munkafolyamatokat a SOAP-hoz a webszolgáltatás konfigurációs eszközével.

Figyelmeztetés

Ez a minta csak munkafolyamatot hoz létre. Előfordulhat, hogy módosítani kell a munkafolyamatot, például egyéni logikát használni az API-ban.

1. Válassza ki a konfigurálni kívánt teljes importálási munkafolyamatot. A Argumentumok és Importok már meg vannak határozva, és a tevékenységekre jellemzőek. További információért tekintse meg az alábbi képernyőket.

   

   

   A hívások újrakonfigurálása után módosítsa a névteret módosító attribútumok nevét, adja hozzá vagy módosítsa a névteret olyan változókra, amelyek az API visszatérési struktúrájára és a régi névtérre hivatkozó objektumtípusokra hivatkoznak. A jobb oldali panelen található eszközkészlet tartalmazza a konfigurációhoz szükséges összes egyéni munkafolyamat-specifikus tevékenységet. Rendelje hozzá az értékeket a logikához használni kívánt változókhoz. Lépjen a központi munkafolyamat-tervező alsó szakaszára, és deklarálja a változókat. A változók deklarálása a következő lépésben lesz.

2. Add a Sequence activity. Húzza a Sequence tevékenységtervezőt a eszközkészletből, és helyezze a Windows Munkafolyamat-tervező felületére. Tekintse meg az alábbi képernyőket. A Sequence tevékenység a sorrendben végrehajtott gyermektevékenységek rendezett gyűjteményét tartalmazza.

   

3. Változó hozzáadásához keresse meg Változó létrehozása. Type wsResponse for the Name, select the Variable type drop-down, and then select Browse for Types. Megjelenik egy párbeszédpanel. Select generated>default>Response. Keep the Scope and Default values unselected. Másik lehetőségként állítsa be ezeket az értékeket a Tulajdonságok nézettel.

   

   

4. Most adja hozzá az összes többi változót, és az alábbi az utolsó képernyő.

   

5. Drag one more Sequence activity designer from the Toolbox within already added Sequence activity.

6. Drag a WebServiceCallActivity presented under Common. This activity is used to invoke Web service operation available after Discovery. Ez egy egyéni tevékenység, és gyakori a különböző műveleti forgatókönyvekben.

   

   A webszolgáltatás-művelet használatához állítsa be a következő tulajdonságokat:

   • szolgáltatásnév: Adja meg a webszolgáltatás nevét.

   • végpontnév: Adja meg a kijelölt szolgáltatás végpontnevét.

   • művelet neve: Adja meg a szolgáltatás megfelelő műveletét.

   • Argumentum: Válassza ki a argumentumokat. A következő párbeszédpanelen rendelje hozzá az argumentumértékeket az alábbi ábrán látható módon:

     

     Fontos

     Ezen a párbeszédpanelen ne módosítsa a Név, Irányvagy Típus elemeket egy argumentumnál. Ha ezen értékek bármelyike módosul, a tevékenység érvénytelenné válik. Only set the Value for the argument. Az ábrán látható módon a wsResponse értéke be van állítva.

7. Vegyen fel egy ForEach tevékenységet WebServiceCallActivity alatt. Ez a tevékenység az objektumtípus összes attribútuma (horgonyok és nem horgonyok) iterálására szolgál. Miközben ezt a tevékenységet a Munkafolyamat-tervező felületére húzza, az automatikusan számba adja az objektum összes attribútumnevét. Állítsa be a szükséges értékeket az alábbi képernyőn:

   

8. Drag a CreateCSEntryChangeScope activity within ForEach body. Ez a tevékenység a CSEntryChange objektum egy példányának létrehozására szolgál a munkafolyamat-tartományban az egyes rekordokhoz, miközben adatokat kér le a céladatforrásból. Dragging this activity provides below screen. CreateAnchorAttribute tevékenységek automatikusan öröklődnek.

   

9. Állítsa be a DN-kifejezés értékét ‘string.Concat ("Employee",item.EmployeeID)’-ként. Állítsa be az AnchorValue értékét az EmployeeID esetében a 'Convert.ToString(item.EmployeeID)'értékre. Set the ObjectTypeName as Employee. A módosítások elvégzése után a következő képernyő jelenik meg:

   

   Megjegyzés

   A horgonyértékek és az objektumnevek a közzétett webszolgáltatástól függően változnak. Az ábrán egy példa látható.

10. Húzzon egy CreateAttributeChange tevékenységet a CreateAnchorAttribute tevékenység alá. The number of activities to drag is equal to the number of non-anchor attributes. Referenciaként tekintse meg az alábbi ábrát.

    

11. Húzza a CreateValueChangeActivity elemet a CreateAttributeChange tevékenységbe, és állítsa be az attribútumértéket az alábbi képernyő szerint.

    

    Megjegyzés

    A tevékenység használatához válassza ki és rendelje hozzá a megfelelő mezőket a legördülő listából, és rendelje hozzá az értékeket. Többértékű attribútumok esetén több CreateValueChangeActivity tevékenységet csepegtethet egy CreateAttributeChangeActivity tevékenységbe.

12. Egy attribútum feltételeinek hozzáadásához adjon hozzá egy Ha tevékenységet a következő ábra szerint.

    

13. Finally, add an Assign activity and set the expression, as shown in the following figure:

    beállítása

14. Mentse a projektet a %FIM_INSTALL_FOLDER%\Synchronization Service\Extensionshelyen.

    Az alapértelmezett projekteket a célrendszeren %FIM_INSTALL_DIR\2010\Synchronization Service\Extensions helyen kell letölteni és menteni. A projektek ezután láthatók a webszolgáltatás-összekötő varázslóban.

    A végrehajtható fájl futtatásakor a rendszer kérni fogja a telepítés helyének megadását. Adja meg a mentési helyet.

    Fontos

    A projektfájl bármilyen helyről menthető és nyitható meg (a végrehajtó megfelelő hozzáférési jogosultságaival). Csak a Synchronization Service\Extension mappába mentett projektfájlok jelölhetők ki a WebSzolgáltatás-összekötő varázslóban, amely a MIM szinkronizálási felhasználói felületén keresztül érhető el.

    A webszolgáltatás-konfigurációs eszközt futtató felhasználónak a következő jogosultságokra van szüksége:

    • Teljes hozzáférés a Szinkronizálási szolgáltatás bővítmény mappához.
    • Read access to the registry key HKLM\System\CurrentControlSet\Services\FIMSynchronizationService\Parameters through which, the Extension folder path is located.

Exportálási munkafolyamatok konfigurálása a webszolgáltatás konfigurációs eszközében

Az alábbi szakaszok bemutatják, hogyan exportálhatja a munkafolyamatokat a webszolgáltatás konfigurációs eszközével.

Munkafolyamatok hozzáadása

Exportálási munkafolyamatok hozzáadásához kövesse a webszolgáltatás konfigurációs eszközének lépéseit.

1. Válassza ki a konfigurálni kívánt exportálási munkafolyamatot. Under Export, select Add. A Argumentumok és Importok már meg vannak határozva, és a tevékenységekre jellemzőek. Tekintse meg az alábbi képernyőket referenciának.

   

2. Add a Sequence activity. Húzza a Sequence tevékenységtervezőt a eszközkészletből, és helyezze a Windows Munkafolyamat-tervező felületére. A Sequence tevékenység a sorrendben végrehajtott gyermektevékenységek rendezett gyűjteményét tartalmazza. Select Create Variable. Rendelje hozzá az értékeket a logikához használni kívánt változókhoz.

   

   Megjegyzés

   A változó hozzáadásának lépéseit a teljes importálási munkafolyamatoklétrehozására vonatkozó szakasz ismerteti.

3. Drag a ForEach activity within already added Sequence activity to iterate over anchor attribute values.

4. Select Properties and set the Values as per below screen. Here objectToExport is argument.

   

5. Set DisplayName as ForEach<AnchorAttribute>

   

6. Állítsa be a(z) TypeArgument-t a(z) Microsoft.MetadirectoryServices.AnchorAttributeértékre.

   

7. Add a Switch activity within the ForEach body of the AnchorAttribute.

   

8. Adjon hozzá egy kifejezést az alábbi képernyő szerint.

   

9. Select Add a new case and enter a value for the EmployeeId. Drag a Sequence activity and within it add an Assign activity.

   

10. Assign the To and Value properties for the Assign activity.

    

11. A ForEach tevékenység horgonyértékekhez használatos. Add another ForEach activity to assign non-anchor values. Ebben a példában a AttributeChange horgonyt használjuk.

    

12. Add a Switch activity within ForEach body of the AttributeChange anchor.

    

13. Adjon hozzá egy kifejezést az alábbi képernyő szerint.

    

14. Select Add a new case and enter a value for the FirstName. Drag a Sequence activity and within it add an Assign activity. Assign the To and Value properties for the Assign activity.

    

15. Adjon meg értékeket a szükséges attribútumokhoz, például LastName, e-mailstb.

    

16. Under Common, drag a WebServiceCallActivity and set Values for its Arguments.

    

    Fontos

    Ezen a párbeszédpanelen ne módosítsa a Név, Irányvagy Típus elemeket egy argumentumnál. Ha ezen értékek bármelyike módosul, a tevékenység érvénytelenné válik. Only set the Value for the argument. Az ábrán látható módon a wsResponse értéke be van állítva.

17. Végül adjon hozzá egy Ha tevékenységet a webszolgáltatás-műveletből visszaadott válaszok ellenőrzéséhez.

Az exportálási munkafolyamat létrehozása a hozzáadása művelettel befejeződött:

Mentse a projektet a %FIM_INSTALL_FOLDER%\Synchronization Service\Extensionshelyen.

Munkafolyamatok törlése

Az exportálási munkafolyamatok törléséhez kövesse a webszolgáltatás konfigurációs eszközének lépéseit.

1. Válassza ki a konfigurálni kívánt exportálási munkafolyamatot. Under Export, select Delete. A Argumentumok és Importok már meg vannak határozva, és a tevékenységekre jellemzőek. Tekintse meg az alábbi képernyőket referenciának.

   

2. Add a Sequence activity. Select Create Variable. Rendelje hozzá az értékeket a logikához használni kívánt változókhoz.

   

   Megjegyzés

   A változó hozzáadásának lépéseit a teljes importálási munkafolyamatoklétrehozására vonatkozó szakasz ismerteti.

3. Drag a ForEach activity within already added Sequence activity to iterate over anchor attribute values.

4. Select Properties and set the Values per below screen. Here objectToExport is argument.

   

5. Set the DisplayName as ForEach\<AnchorAttribute\>:

   

6. Állítsa be a TypeArgument értékét Microsoft.MetadirectoryServices.AnchorAttribute:

   

7. Add a Switch activity within the ForEach body of the AnchorAttribute.

   

8. Adjon hozzá egy kifejezést az alábbi képernyő szerint.

   

9. Select Add a new case and enter a value for the EmployeeId. Drag a Sequence activity and within it add an Assign activity.

   

10. Assign the To and Value properties for the Assign activity.

    

11. Under Common, drag a WebServiceCallActivity and set Values for its Arguments.

    

    Fontos

    Ezen a párbeszédpanelen ne módosítsa a Név, Irányvagy Típus elemeket egy argumentumnál. Ha ezen értékek bármelyike módosul, a tevékenység érvénytelenné válik. Only set the Value for the argument. Az ábrán látható módon a employeeID értéke be van állítva.

12. Finally add an If activity to check the responses returned from the web service operation.

Az exportálási munkafolyamat törlése a Törlés művelettel befejeződött:

Mentse a projektet a %FIM_INSTALL_FOLDER%\Synchronization Service\Extensionshelyen.

Munkafolyamatok cseréje

Cserélje le az exportálási munkafolyamatokat a webszolgáltatás-konfigurációs eszköz alábbi lépéseivel.

1. Válassza ki a konfigurálni kívánt exportálási munkafolyamatot. Under Export, select Replace. A Argumentumok és Importok már meg vannak határozva, és a tevékenységekre jellemzőek. See below screen for reference.

   

2. Add a Sequence activity.

3. Drag a ForEach activity for the <AnchorAttribute>.

4. Adjon hozzá egy másik ForEach<AttributeChange> tevékenységet a nem horgonyértékek hozzárendeléséhez.

5. Végül a képernyő az alábbi ábrához hasonlóan néz ki. A tevékenység konfigurálására vonatkozó utasításokat az exportálási munkafolyamatok hozzáadására vonatkozó szakaszban találja.

   

6. Under Common, drag a WebServiceCallActivity and set Values for its Arguments.

   

   Fontos

   Ezen a párbeszédpanelen ne módosítsa a Név, Irányvagy Típus elemeket egy argumentumnál. Ha ezen értékek bármelyike módosul, a tevékenység érvénytelenné válik. Only set the Value for the argument. As shown in this figure, the value employee is set.

7. Végül adjon hozzá egy Ha tevékenységet a webszolgáltatás-műveletből visszaadott válaszok ellenőrzéséhez.

Az exportálási munkafolyamat cseréje a cseréje művelettel befejeződött:

Mentse a projektet a %FIM_INSTALL_FOLDER%\Synchronization Service\Extensionshelyen.

Hibakeresési tevékenységek

A munkafolyamat-sablon hibakereséséhez az alábbi egyéni tevékenységek érhetők el.

Log activity

A Napló tevékenység használatával szöveges üzeneteket írhat a naplófájlba. További információ: naplózás.

Megjegyzés

If you aren't able to easily debug your workflow, try debugging the workflow in the production environment.

A Napló tevékenység használatához állítsa be a következő tulajdonságokat. A tulajdonságok akkor jelennek meg, ha kijelöli a tevékenységet a Munkafolyamat-tervezőben, és megtekinti a tevékenységhez tartozó Tulajdonságok.

WriteLine-tevékenység

A WriteLine tevékenység használatával szöveges üzeneteket írhat egy szolgáltató írójának. Ha nem érhető el író, a WriteLine tevékenység a szöveget a konzolablakba írja.

In the text box, write the message that you want to be visible in the writer target.

Fontos

A konzolablak nem használható ehhez a tevékenységhez. Ehhez a feladathoz használjon egy másik ablakkimenet-írót.

A WriteLine tevékenység használatához állítsa be a következő tulajdonságokat. A tulajdonságok akkor jelennek meg, ha kijelöli a tevékenységet a Munkafolyamat-tervezőben, és megtekinti a tevékenységhez tartozó Tulajdonságok.

• naplószintű: A naplóértékbe írandó tartalom mennyiségét adja meg. A lehetséges értékek a következők:

  • Magas: Írja be a LogText üzenetet a naplófájlba, ha a napló súlyossága Magas értékre van állítva.
  • Verbose: Write the LogText message to the log file if the log severity is set to Verbose.
  • Tiltás: Ne írjon a naplófájlba.

• LogText: Megadja a naplóba írandó szöveges tartalmat.

• Címke: Hozzáad egy címkét a szöveghez a naplóban írt tartalom típusának azonosításához. A lehetséges értékek a következők: Hiba, nyomkövetés vagy figyelmeztetés.

Következő lépések

• Általános webszolgáltatás-összekötő áttekintése
• Webszolgáltatás-konfigurációs eszköz telepítése
• SOAP üzembe helyezési útmutatója
• REST üzembe helyezési útmutató
• Web Service MA configuration