Průvodce pracovním postupem konektoru webových služeb pro soap

Tento článek popisuje, jak vytvořit nový projekt pro zdroj dat v nástroji Konfigurace webové služby. Pokud chcete vytvořit projekt, postupujte podle těchto kroků.

1. Otevřete nástroj Konfigurace webové služby. Otevře se prázdný projekt.

   

2. Vyberte Projekt SOAP a pak vyberte Přidat.

   

3. Na další stránce zadejte následující informace a pak vyberte Další:

   • Název nové webové služby
   • Adresa (cesta WSDL) pro načtení vystavených služeb, koncových bodů a operací
   • Obor názvů
   • Režim zabezpečení (typ ověřování)

4. V této ukázce se zobrazí stránka Přihlašovací údaje s požadavky na základní režim zabezpečení (režim, který byl vybrán v předchozím kroku). Pokud byla pro režim zabezpečení zadána možnost Žádné, stránka Přihlašovací údaje se nezobrazí. Vyberte Další.

   

5. Probíhá přístup k cestě WSDL pro načtení informací o službě a zobrazí se seznam vystavených funkcí. Pokud je zadaná cesta WSDL nesprávná, konfiguračnímu nástroji se nepodaří načíst informace o službě a vyvolá chybu.

   

6. Jakmile se provede zjišťování, zobrazí se seznam koncových bodů a zjištěných operací. Vyberte Dokončit.

   

7. Kompilace se provede. Kompilace je proces kompilace sestavení kontraktu dat, což může být časově náročná operace. Uživatel je informován o všech chybách kompilace. Po provedení zjišťování nástroj zobrazí následující stránku:

   

8. Rozbalení projektu SOAP a výběr zveřejněného koncového bodu uvedené níže. Na této obrazovce jsou uvedeny operace, které jsou deklarovány v rámci koncového bodu.

   

9. Rozbalením koncového bodu se zobrazí seznam operací. Operace je funkce deklarovaná koncovým bodem. Každá operace řeší typ úlohy, kterou je možné provést v rámci služby. Tato obrazovka obsahuje seznam argumentů, které jsou deklarovány pro operaci. Tyto argumenty jsou pak definovány při použití operace při konfiguraci pracovních postupů.

   

10. Dalším krokem je definování schématu prostoru konektoru, kterého se dosáhne vytvořením typu objektu a definováním jejich typů objektů. Vyberte Typy objektů a pak vyberte Přidat. V novém okně přidejte nový typ objektu a zadejte název. Vyberte OK.

    

11. Přidání typu objektu zobrazí následující obrazovku.

    

12. Pravé podokno odpovídající typu objektu umožňuje zachovat atributy a jejich vlastnosti pro vybraný typ objektu. Vyberte Přidat. Otevře se nové okno pro přidání atributů:

    

    

13. Po přidání všech požadovaných atributů se zobrazí následující obrazovka:

    

14. Typ objektu a atributy po vytvoření poskytují prázdné pracovní postupy, které zajišťují operace prováděné v Microsoft Identity Manager 2016 (MIM).

    

Konfigurace pracovních postupů v nástroji konfigurace webové služby

Dalším krokem je konfigurace pracovních postupů pro typ objektu. Soubory pracovních postupů jsou řady aktivit, které konektor webových služeb používá za běhu. Pracovní postupy se používají k implementaci příslušné operace MIM. Nástroj pro konfiguraci webové služby vám pomůže vytvořit čtyři různé pracovní postupy:

• Import: Importuje data ze zdroje dat pro následující dva typy pracovních postupů:

  • Úplný import: Úplný import, který se dá nakonfigurovat.
  • Rozdílový import: Nástroj pro konfiguraci webové služby nepodporuje.

• Export: Exportuje data z MIM do připojeného zdroje dat. Operace podporuje následující tři akce. Tyto akce můžete nakonfigurovat na základě svých požadavků.

  • Přidání
  • Odstranit
  • Nahrazení

• Heslo: Umožňuje spravovat hesla pro uživatele (typ objektu). Pro tuto operaci jsou k dispozici dvě akce:

  • Nastavit heslo
  • Změna hesla

• Test připojení: Nakonfigurujte pracovní postup, který zkontroluje, jestli se úspěšně navázalo připojení k serveru zdroje dat.

Poznámka

Tyto pracovní postupy můžete nakonfigurovat pro svůj projekt nebo stáhnout výchozí projekt z webu Microsoft Download Center.

Návrhář postupu provádění

Pracovní Designer otevře pracovní oblast pro konfiguraci pracovního postupu podle požadavků. Pro každý typ objektu (nový /existující) poskytuje konfigurační nástroj uzly pro pracovní postupy, které nástroj podporuje.

Designer pracovního postupu se skládá z následujících prvků uživatelského rozhraní:

• Uzly v levém podokně: Umožňují vybrat, který pracovní postup chcete navrhnout.

• Centrální Designer pracovních postupů: Zde můžete aktivity pro konfiguraci pracovních postupů zrušit. K provádění různých operací MIM (export, import, správa hesel) můžete použít standardní a vlastní aktivity pracovních postupů rozhraní .NET Workflow Framework 4. Nástroj Konfigurace webové služby používá standardní a vlastní aktivity pracovního postupu. Další informace o standardních aktivitách najdete v tématu Použití návrhářů aktivit.

  • V Designer Centrální pracovní postup červené kolečko s vykřičníkem vedle jakékoli aktivity označuje, že operace byla ukončena a není definována správně a úplně. Najeďte myší na červené kolečko a zjistěte přesnou chybu. Po správném definování aktivity se červené kolečko změní na žlutou informační značku.

  • V Designer Centrální pracovní postup označuje žlutá informační značka trojúhelníku vedle jakékoli aktivity, že aktivita je definovaná, ale k dokončení aktivity můžete udělat více. Další informace zobrazíte tak, že najedete myší na žlutý trojúhelník.

• Sada nástrojů: Zabalí všechny nástroje včetně systémových a vlastních aktivit a předdefinovaných příkazů pro návrh pracovního postupu. Další informace najdete v tématu Sada nástrojů.

• Oddíly sady nástrojů: Sada nástrojů obsahuje následující oddíly a kategorie:

  • Popis: Záhlaví sady nástrojů. Jedna karta přistupuje k panelu nástrojů a vlastnostem vybrané aktivity pracovního postupu.

  • Pracovní postup importu: Vlastní aktivity pro konfiguraci pracovních postupů importu.

  • Export pracovního postupu: Vlastní aktivity pro konfiguraci pracovních postupů exportu.

  • Běžné: Vlastní aktivity pro konfiguraci libovolného pracovního postupu.

  • Ladění: Aktivity systémového pracovního postupu pro ladění definované v pracovním postupu 4. Tyto aktivity umožňují sledování problémů pro pracovní postup.

  • Příkazy: Aktivity systémového pracovního postupu definované v pracovním postupu 4. Další informace najdete v tématu Použití návrhářů aktivit.

• Vlastnosti: Karta Vlastností zobrazuje vlastnosti konkrétní aktivity pracovního postupu, která je vyřazena v oblasti návrháře a vybrána. Obrázek vlevo znázorňuje vlastnosti aktivity Přiřadit . U každé aktivity se vlastnosti liší a používají se při konfiguraci vlastního pracovního postupu. Tato karta umožňuje definovat atributy vybraného nástroje, které byly přesunuty do centrálního návrháře pracovního postupu. Další informace najdete v tématu Vlastnosti.

• Hlavní panel: Hlavní panel obsahuje tři prvky: Proměnné, Argumenty a Importy. Tyto prvky se používají společně s aktivitami pracovního postupu. Další informace najdete v tématu Úvod vývojáře do windows Workflow Foundation (WF) v .NET 4.

Konfigurace úplného pracovního postupu importu v nástroji Konfigurace webové služby

Následující kroky ukazují, jak nakonfigurovat úplné pracovní postupy importu pro protokol SOAP pomocí nástroje Konfigurace webové služby.

Upozornění

Tato ukázka vytvoří pouze pracovní postup. Může se vyžadovat úpravy pracovního postupu, například použití vlastní logiky v rozhraní API.

1. Vyberte pracovní postup úplného importu, který chcete nakonfigurovat. Argumenty a importy jsou již definované a jsou specifické pro aktivity. Další informace najdete na následujících obrazovkách.

   

   

   Po rekonfiguraci volání změňte názvy atributů, které se mění, přidejte nebo změňte obor názvů na proměnné, které odkazují na návratovou strukturu rozhraní API a typů objektů, které odkazují na starý obor názvů. Panel nástrojů v pravém podokně obsahuje všechny vlastní aktivity specifické pro pracovní postup, které jsou potřeba ke konfiguraci. Přiřaďte hodnoty proměnným, které budete používat pro logiku. Přejděte do dolní části návrháře centrálního pracovního postupu a deklarujte proměnné. Proměnné jsou deklarovány v dalším kroku.

2. Přidejte aktivitu aplikace Sequence. Přetáhněte návrháře sekvenční aktivity z panelu nástrojů a přesuňte ho na Designer plochu pracovního postupu Windows. Projděte si následující obrazovky. Aktivita Sequence obsahuje uspořádanou kolekci podřízených aktivit, které provádí v uvedeném pořadí.

   

3. Pokud chcete přidat proměnnou, vyhledejte možnost Vytvořit proměnnou. Jako Název zadejte wsResponse, vyberte rozevírací seznam Typ proměnné a pak vyberte Vyhledat typy. Zobrazí se dialogové okno. Vyberte vygenerovaná>výchozí>odpověď. Ponechte nevybrané hodnoty Obor a Výchozí . Případně můžete tyto hodnoty nastavit pomocí zobrazení Vlastnosti .

   

   

4. Teď přidejte všechny ostatní proměnné a dole je poslední obrazovka.

   

5. Přetáhněte z panelu nástrojů dalšího návrháře sekvenční aktivity v rámci již přidané aktivity sekvence.

6. Přetáhněte WebServiceCallActivity v části Běžné. Tato aktivita se používá k vyvolání operace webové služby, která je k dispozici po zjišťování. Jedná se o vlastní aktivitu, která je běžná v různých scénářích operací.

   

   Pokud chcete použít operaci webové služby, nastavte následující vlastnosti:

   • Název služby: Zadejte název webové služby.

   • Název koncového bodu: Zadejte název koncového bodu pro vybranou službu.

   • Název operace: Zadejte odpovídající operaci pro službu.

   • Argument: Vyberte Argumenty. V dalším dialogovém okně přiřaďte hodnoty argumentů, jak je znázorněno na následujícím obrázku:

     

     Důležité

     Pomocí tohoto dialogového okna neměňte název, směr nebo typ argumentu. Pokud se některá z těchto hodnot změní, aktivita se stane neplatnou. Nastavte pouze hodnotu argumentu. Jak je znázorněno na tomto obrázku, hodnota wsResponse je nastavena.

7. Přidejte aktivitu ForEach přímo pod WebServiceCallActivity. Tato aktivita se používá k iteraci všech atributů (ukotvení i nekryt) typu objektu. Při přetahování této aktivity do pracovního postupu Designer povrchu se automaticky vytvoří výčet všech názvů atributů pro objekt. Nastavte požadované hodnoty podle následující obrazovky:

   

8. Přetáhněte aktivitu CreateCSEntryChangeScope v těle forEach . Tato aktivita se používá k vytvoření instance objektu CSEntryChange v doméně pracovního postupu pro každý příslušný záznam při načítání dat z cílového zdroje dat. Přetažením této aktivity se zobrazí pod obrazovkou. Aktivity createAnchorAttribute se automaticky dědí.

   

9. Nastavte hodnotu výrazu DN na ‘string.Concat ("Employee",item.EmployeeID)’hodnotu . Nastavte AnchorValue pro EmployeeID na Convert.tostring(item. EmployeeID)'. Nastavte ObjectTypeName jako Employee. Po provedení těchto úprav se zobrazí následující obrazovka:

   

   Poznámka

   Hodnoty ukotvení a názvy objektů se liší podle vystavené webové služby. Na obrázku je příklad.

10. Přetáhněte aktivitu CreateAttributeChange pod aktivitu CreateAnchorAttribute . Počet aktivit, které se mají přetáhnout, se rovná počtu neukotvených atributů. Referenční informace najdete na následujícím obrázku.

    

11. Přetáhněte CreateValueChangeActivity v rámci aktivity CreateAttributeChange a nastavte hodnotu atributu podle níže uvedené obrazovky.

    

    Poznámka

    Pokud chcete tuto aktivitu použít, vyberte a přiřaďte příslušná pole z rozevíracího seznamu a přiřaďte hodnoty. V případě vícehodnotových atributů přetáhněte více aktivit CreateValueChangeActivity do aktivity CreateAttributeChangeActivity .

12. Pokud chcete přidat podmínky pro atribut, přidejte aktivitu If , jak je znázorněno na následujícím obrázku:

    

13. Nakonec přidejte aktivitu Assign a nastavte výraz, jak je znázorněno na následujícím obrázku:

    

14. Uložte tento projekt do umístění %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions.

    Výchozí projekty by se měly stáhnout a uložit do umístění %FIM_INSTALL_DIR\2010\Synchronization Service\Extensions v cílovém systému. Projekty se pak zobrazí v průvodci konektorem webové služby.

    Při spuštění spustitelného souboru se zobrazí výzva k zadání umístění pro instalaci. Zadejte umístění pro uložení.

    Důležité

    Soubor projektu lze uložit a otevřít z libovolného umístění (s příslušnými přístupovými oprávněními jeho exekutoru). V průvodci konektorem Synchronization Service\Extension webové služby, ke kterému se přistupuje prostřednictvím uživatelského rozhraní synchronizace MIM, je možné vybrat pouze soubory projektu, které jsou uložené do složky.

    Uživatel, který používá nástroj pro konfiguraci webové služby, vyžaduje následující oprávnění:

    • Úplné řízení do složky Rozšíření synchronizační služby
    • Přístup ke čtení ke klíči HKLM\System\CurrentControlSet\Services\FIMSynchronizationService\Parameters registru, přes který se nachází cesta ke složce Rozšíření.

Konfigurace pracovních postupů exportu v nástroji konfigurace webové služby

Následující části ukazují, jak exportovat pracovní postupy pomocí konfiguračního nástroje webové služby.

Přidání pracovních postupů

Přidejte pracovní postupy exportu pomocí těchto kroků v nástroji Konfigurace webové služby.

1. Vyberte pracovní postup exportu, který chcete nakonfigurovat. V části Exportovat vyberte Přidat. Argumenty a importy jsou již definovány a jsou specifické pro aktivity. Referenční informace najdete na následujících obrazovkách.

   

2. Přidejte aktivitu sekvence . Přetáhněte návrhář aktivity sekvence z panelu nástrojů na Designer plochu pracovního postupu Windows. Aktivita Sequence obsahuje uspořádanou kolekci podřízených aktivit, které provádí v uvedeném pořadí. Vyberte Vytvořit proměnnou. Přiřaďte hodnoty proměnným, které použijete pro logiku.

   

   Poznámka

   Postup přidání proměnné je popsaný v části věnované vytváření úplných pracovních postupů importu.

3. Přetáhněte aktivitu ForEach v rámci již přidané aktivity Sequence k iteraci hodnot atributů ukotvení.

4. Vyberte Vlastnosti a nastavte Hodnoty podle následující obrazovky. Tady je argument objectToExport .

   

5. Nastavit DisplayName jako ForEach<AnchorAttribute>

   

6. Nastavte TypeArgument na Microsoft.MetadirectoryServices.AnchorAttribute.

   

7. Do těla ForEachatributu AnchorAttribute přidejte aktivitu Switch.

   

8. Přidejte výraz podle následující obrazovky.

   

9. Vyberte Přidat nový případ a zadejte hodnotu EmployeeId. Přetáhněte aktivitu sekvence a přidejte do ní aktivitu Přiřadit .

   

10. Přiřaďte vlastnosti To a Value aktivitě Přiřadit .

    

11. Aktivita ForEach se používá pro hodnoty ukotvení. Přidejte další aktivitu ForEach, která přiřazuje hodnoty, které nejsou ukotvené. V tomto příkladu se používá kotva AttributeChange .

    

12. Přidejte aktivitu Switch do těla ForEach ukotvení AttributeChange .

    

13. Přidejte výraz podle následující obrazovky.

    

14. Vyberte Přidat nový případ a zadejte hodnotu do pole Jméno. Přetáhněte aktivitu sekvence a přidejte do ní aktivitu Přiřadit . Přiřaďte vlastnosti To a Value aktivitě Přiřadit .

    

15. Přidejte hodnoty požadovaných atributů, jako je LastName, Email atd.

    

16. V části Common přetáhněte WebServiceCallActivity a nastavte hodnoty pro jeho argumenty.

    

    Důležité

    Pomocí tohoto dialogového okna neměňte název, směr ani typ argumentu. Pokud se některá z těchto hodnot změní, aktivita se stane neplatnou. Nastavte pouze hodnotu argumentu . Jak je znázorněno na tomto obrázku, je nastavena hodnota wsResponse .

17. Nakonec přidejte aktivitu If , která zkontroluje odpovědi vrácené z operace webové služby.

Vytvoření pracovního postupu exportu pomocí operace Add je dokončené:

Uložte tento projekt do umístění %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions.

Odstranit pracovní postupy

Pracovní postupy exportu odstraňte pomocí těchto kroků v nástroji Konfigurace webové služby.

1. Vyberte pracovní postup exportu, který chcete nakonfigurovat. V části Exportovat vyberte Odstranit. Argumenty a importy jsou již definovány a jsou specifické pro aktivity. Referenční informace najdete na následujících obrazovkách.

   

2. Přidejte aktivitu sekvence . Vyberte Vytvořit proměnnou. Přiřaďte hodnoty proměnným, které použijete pro svoji logiku.

   

   Poznámka

   Postup přidání proměnné je popsaný v části věnované vytváření úplných pracovních postupů importu.

3. Přetáhněte aktivitu ForEach v rámci již přidané aktivity Sequence k iteraci hodnot atributů ukotvení.

4. Vyberte Vlastnosti a nastavte hodnoty podle obrazovky níže. Tady je argument objectToExport .

   

5. Nastavte DisplayName na ForEach\<AnchorAttribute\>:

   

6. Nastavte TypeArgument na Microsoft.MetadirectoryServices.AnchorAttribute:

   

7. Do těla ForEachatributu AnchorAttribute přidejte aktivitu Switch.

   

8. Přidejte výraz podle následující obrazovky.

   

9. Vyberte Přidat nový případ a zadejte hodnotu EmployeeId. Přetáhněte aktivitu sekvence a přidejte do ní aktivitu Přiřadit .

   

10. Přiřaďte vlastnosti To a Value aktivitě Přiřadit .

    

11. V části Common přetáhněte WebServiceCallActivity a nastavte hodnoty pro jeho argumenty.

    

    Důležité

    Pomocí tohoto dialogového okna neměňte název, směr ani typ argumentu. Pokud se některá z těchto hodnot změní, aktivita se stane neplatnou. Nastavte pouze hodnotu argumentu . Jak je znázorněno na tomto obrázku, je nastavená hodnota employeeID .

12. Nakonec přidejte aktivitu If , která zkontroluje odpovědi vrácené z operace webové služby.

Odstranění pracovního postupu exportu s operací Delete je dokončeno:

Uložte tento projekt do umístění %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions.

Nahrazení pracovních postupů

Pracovní postupy exportu nahraďte pomocí těchto kroků v nástroji Konfigurace webové služby.

1. Vyberte pracovní postup exportu, který chcete nakonfigurovat. V části Export vyberte Nahradit. Argumenty a importy jsou již definované a jsou specifické pro aktivity. Referenční informace najdete na následující obrazovce.

   

2. Přidejte aktivitu aplikace Sequence .

3. Přetáhněte aktivitu ForEach pro <AnchorAttribute>.

4. Přidejte další aktivitu ForEach<AttributeChange> pro přiřazení hodnot, které nejsou ukotvené.

5. Nakonec obrazovka vypadá jako na následujícím obrázku. Pokyny ke konfiguraci této aktivity najdete v části pro přidání pracovních postupů exportu.

   

6. V části Common přetáhněte WebServiceCallActivity a nastavte hodnoty pro její argumenty.

   

   Důležité

   Pomocí tohoto dialogového okna neměňte název, směr nebo typ argumentu. Pokud se některá z těchto hodnot změní, aktivita se stane neplatnou. Nastavte pouze hodnotu argumentu. Jak je znázorněno na tomto obrázku, je nastavená hodnota zaměstnance .

7. Nakonec přidejte aktivitu If , která zkontroluje odpovědi, které jsou vráceny z operace webové služby.

Nahrazení pracovního postupu exportu operací Nahradit je dokončeno:

Uložte tento projekt do umístění %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions.

Aktivity ladění

K dispozici jsou následující vlastní aktivity, které vám pomůžou ladit šablonu pracovního postupu.

Aktivita protokolování

Aktivita protokolu se používá k zápisu textových zpráv do souboru protokolu. Další informace najdete v tématu Protokolování.

Poznámka

Pokud pracovní postup nemůžete snadno ladit, zkuste ho ladit v produkčním prostředí.

Pokud chcete použít aktivitu protokolu , nastavte následující vlastnosti. Vlastnosti jsou viditelné, když vyberete aktivitu v pracovním postupu Designer a zobrazíte vlastnosti aktivity.

Aktivita WriteLine

Aktivita WriteLine se používá k psaní textových zpráv zapisovači poskytovatele. Pokud není k dispozici žádný zapisovač, aktivita WriteLine zapíše text do okna konzoly.

Do textového pole napište zprávu, která má být viditelná v cíli zápisu.

Důležité

Pro tuto aktivitu nelze použít okno konzoly. Pro tuto úlohu použijte zapisovač výstupu jiného okna.

Pokud chcete použít aktivitu WriteLine , nastavte následující vlastnosti. Vlastnosti jsou viditelné, když vyberete aktivitu v pracovním postupu Designer a zobrazíte vlastnosti aktivity.

• Úroveň protokolu: Určuje množství obsahu, který se má zapsat do hodnoty protokolu. Možné hodnoty jsou:

  • Vysoká: Pokud je závažnost protokolu nastavená na Vysokou, zapište zprávu LogText do souboru protokolu.
  • Podrobné: Pokud je závažnost protokolu nastavená na podrobnou, zapište zprávu LogText do souboru protokolu.
  • Zakázáno: Nezapisujte do souboru protokolu.

• LogText: Určuje textový obsah, který se má zapisovat do protokolu.

• Značka: Přidá do textu značku, která identifikuje typ obsahu, který se do protokolu zapisuje. Možné hodnoty jsou: Chyba, Trasování nebo Upozornění.

Další kroky

• Přehled obecného konektoru webové služby
• Instalace nástroje pro konfiguraci webové služby
• Průvodce nasazením protokolu SOAP
• Průvodce nasazením REST
• Konfigurace MA webové služby