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 pro konfiguraci webové služby. It opens a blank project.

   Web Service Configuration Toolnástroje pro konfiguraci webové služby

2. Select SOAP Project and then select Add.

   

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

   • Název nové webové služby
   • Address (WSDL path) to retrieve the exposed services, endpoints, and operations
   • Namespace
   • 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 vybraný v předchozím kroku). Pokud pro režim zabezpečení byla zadána hodnota Žádné, stránka s přihlašovacími údaji se nezobrazí. Vyberte Další.

   Obrazovka služby SOAP

5. Probíhá přístup k cestě WSDL za účelem načtení informací o službě a zobrazuje se seznam vystavených funkcí. Pokud je zadaná cesta WSDL nesprávná, konfigurační nástroj nenačte informace o službě a vyvolá chybu.

   obrazovka průběhu stahování webové služby

6. Po provedení zjišťování se vypíše koncový bod a zjištěné operace. Vyberte Dokončit.

   

7. Kompilace byla provedena. 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. Expanding SOAP project and selecting exposed endpoint provided below screen. Tato obrazovka obsahuje seznam operací deklarovaných v rámci koncového bodu.

   

9. Expanding endpoint displays list of operations. Operace je funkce deklarovaná koncovým bodem. Každá operace řeší typ úlohy, kterou je možné provést v rámci služby. Na této obrazovce jsou uvedeny argumenty deklarované 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 spojnice, které se dosahuje vytvořením typu objektu a definováním jejich typů objektů. Select Object Types and then select Add. V novém okně přidejte nový typ objektu a zadejte název. Vyberte OK.

    

11. Adding an object type provides below screen.

    

12. Pravé podokno odpovídající typu objektu umožňuje udržovat 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:

    typ objektu

14. Typ objektu a atributy po vytvoření poskytují prázdné pracovní postupy, které vyhovují operacím provedeným v Microsoft Identity Manageru 2016 (MIM).

    

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

Dalším krokem je konfigurace pracovních postupů pro váš typ objektu. Soubory pracovního postupu jsou řadou 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: Import dat ze zdroje dat pro následující dva typy pracovních postupů:

  • Úplný import: Úplný import, který lze nakonfigurovat.
  • Delta import: Not supported by the Web Service Configuration Tool.

• Export: Export dat z MIM do připojeného zdroje dat The following three actions are supported for the operation. Tyto akce můžete nakonfigurovat na základě vašich požadavků.

  • Přidat
  • Vymazat
  • Nahradit

• Heslo: Správa hesel pro uživatele (typ objektu) Pro tuto operaci jsou k dispozici dvě akce:

  • Nastavení hesla
  • Změnit heslo

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

Poznámka:

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

Návrhář pracovního postupu

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

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

• Uzly v levém podokně: Tyto možnosti vám pomůžou vybrat, které pracovní postupy chcete navrhnout.

• Central Workflow Designer: Tady můžete aktivity pro konfiguraci pracovních postupů vypustit. 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 Návrháři centrálního pracovního postupu červený kruh s vykřičníkem vedle jakékoli aktivity označuje, že operace se vypnula 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ý kroužek změní na žlutou informační značku.

  • V Návrháři centrálního pracovního postupu označuje žlutá informační značka trojúhelníku vedle jakékoli aktivity, že je aktivita definována, ale k dokončení aktivity můžete udělat více. Když najedete myší na žlutý trojúhelník, zobrazí se další informace.

• Panel 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. Pro více informací viz Panel nástrojů.

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

  • Popis: Záhlaví panelu nástrojů. Jedna záložka umožňuje přístup k panelu nástrojů a vlastnostem vybrané aktivity pracovního procesu.

  • Import workflow: Custom activities to configure import workflows.

  • Pracovní postup exportu: Aktivity na míru pro konfiguraci exportních pracovních postupů

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

  • Debug: System workflow activities for debugging defined in Workflow 4. Tyto aktivity umožňují sledování problémů pro pracovní postup.

  • Statements: System workflow activities defined in Workflow 4. Další informace najdete v tématu Použití návrhářů aktivit.

• Properties: The properties tab displays the properties of a particular workflow activity that is dropped in the designer area and selected. The figure on the left shows the properties of Assign activity. U každé aktivity se vlastnosti liší a používají se při konfiguraci vlastního pracovního postupu. This tab allows you to define the attributes of the selected tool that has been dropped into the central workflow designer. For more information, see Properties.

• panel úloh: Panel úkolů obsahuje tři prvky: Proměnné, argumentya Import. Tyto prvky se používají společně s aktivitami pracovního postupu. Další informace najdete v tématu Úvod pro vývojáře do Windows Workflow Foundation (WF) (.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 SOAP pomocí nástroje konfigurace webové služby.

Výstraha

Tato ukázka vytvoří pouze pracovní postup. Můžou být vyžadovány ú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ž definovány a jsou specifické pro aktivity. Další informace najdete na následujících obrazovkách.

   

   

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

2. Add a Sequence activity. Přetáhněte návrháře aktivity Sequence z panelu nástrojů a umístěte jej na plochu Návrháře pracovního postupu systému Windows. Projděte si následující obrazovky. The Sequence activity contains an ordered collection of child activities that it executes in order.

   

3. Chcete-li přidat proměnnou, vyhledejte Vytvořit proměnnou. Type wsResponse for the Name, select the Variable type drop-down, and then select Browse for Types. Zobrazí se dialogové okno. Select generated>default>Response. Keep the Scope and Default values unselected. Případně tyto hodnoty nastavte pomocí zobrazení Vlastnosti.

   

   

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

   

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. Jedná se o vlastní aktivitu, která je běžná v různých scénářích operací.

   

   Chcete-li 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 příslušnou operaci pro službu.

   • Argument: Select Arguments. 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é

     Do not change the Name, Direction, or Type for an argument by using this dialog. Pokud se některá z těchto hodnot změní, aktivita bude neplatná. Pro argument nastavte hodnotu pouze . Jak je znázorněno na tomto obrázku, je nastavena hodnota wsResponse.

7. Add a ForEach activity just below WebServiceCallActivity. This activity is used to iterate over all attributes (both anchors and non-anchors) of object type. Při přetahování této aktivity na plochu Návrháře pracovního postupu automaticky vytvoří výčet všech názvů atributů pro objekt. Nastavte požadované hodnoty podle následující obrazovky:

   

8. Drag a CreateCSEntryChangeScope activity within ForEach body. Tato aktivita slouží 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. Dragging this activity provides below screen. CreateAnchorAttribute activities are automatically inherited.

   

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

   

   Poznámka:

   Anchor values and object names vary according to the exposed web service. Obrázek znázorňuje příklad.

10. Přetáhněte aktivitu CreateAttributeChange pod aktivitu CreateAnchorAttribute. The number of activities to drag is equal to the number of non-anchor attributes. Referenční informace najdete na následujícím obrázku.

    

11. Přetáhněte CreateValueChangeActivity do aktivity CreateAttributeChange a nastavte hodnotu atributu dle 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. U atributů s více hodnotami vyřaďte více aktivit CreateValueChangeActivity uvnitř aktivity CreateAttributeChangeActivity.

12. To add conditions for an attribute, add an If activity as shown in the following figure:

    

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

    

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. The projects are then visible in the web service connector wizard.

    Při spuštění spustitelného souboru se zobrazí výzva k zadání umístění instalace. 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 svého exekutoru). V průvodci konektorem webové služby, ke kterým se přistupuje prostřednictvím uživatelského rozhraní synchronizace MIM, je možné vybrat pouze soubory projektu uložené do složky Synchronization Service\Extension.

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

    • Úplný přístup ke složce Rozšíření synchronizační služby.
    • Read access to the registry key HKLM\System\CurrentControlSet\Services\FIMSynchronizationService\Parameters through which, the Extension folder path is located.

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

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

Přidání pracovních postupů

Pomocí následujícího postupu v nástroji konfigurace webové služby přidejte pracovní postupy exportu.

1. Vyberte pracovní postup exportu, který chcete nakonfigurovat. Under Export, select Add. Argumenty a importy jsou již definovány a jsou specifické pro aktivity. Referenční informace najdete na následujících obrazovkách.

   

2. Add a Sequence activity. Přetáhněte návrháře aktivity Sequence z panelu nástrojů a umístěte jej na plochu Návrháře pracovního postupu systému Windows. The Sequence activity contains an ordered collection of child activities that it executes in order. Vyberte Vytvořit proměnnou. Přiřaďte hodnoty proměnným, které použijete pro svoji logiku.

   

   Poznámka:

   Kroky pro přidání proměnné jsou popsány v části pro vytváření úplných pracovních postupů importu.

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. Nastavte TypeArgument jako Microsoft.MetadirectoryServices.AnchorAttribute.

   

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

   

8. Přidejte výraz podle zobrazeného příkladu.

   

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. Aktivita ForEach se používá pro kotvové hodnoty. Add another ForEach activity to assign non-anchor values. In this example, the AttributeChange anchor is used.

    

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

    

13. Přidejte výraz podle zobrazeného příkladu.

    

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. Přidejte hodnoty požadovaných atributů, například příjmení, e-mailovéatd.

    

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

    

    Důležité

    Do not change the Name, Direction, or Type for an argument by using this dialog. Pokud se některá z těchto hodnot změní, aktivita bude neplatná. Pro argument nastavte hodnotu pouze . Jak je znázorněno na tomto obrázku, je nastavena hodnota wsResponse.

17. Finally, add an If activity to check responses that are returned from the web service operation.

Vytvoření pracovního postupu exportu pomocí operace Přidat je dokončeno:

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

Odstranění pracovních postupů

Pomocí těchto kroků v nástroji konfigurace webové služby odstraňte pracovní postupy exportu.

1. Vyberte pracovní postup exportu, který chcete nakonfigurovat. Under Export, select Delete. Argumenty a importy jsou již definovány a jsou specifické pro aktivity. Referenční informace najdete na následujících obrazovkách.

   

2. Add a Sequence activity. Vyberte Vytvořit proměnnou. Přiřaďte hodnoty proměnným, které budete pro logiku používat.

   sekvenční aktivitu

   Poznámka:

   Kroky pro přidání proměnné jsou popsány v části pro vytváření úplných pracovních postupů importu.

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. Nastavte DisplayName jako ForEach\<AnchorAttribute\>:

   

6. Set the TypeArgument as Microsoft.MetadirectoryServices.AnchorAttribute:

   

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

   

8. Přidejte výraz podle zobrazeného příkladu.

   

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.

    

    Důležité

    Do not change the Name, Direction, or Type for an argument by using this dialog. Pokud se některá z těchto hodnot změní, aktivita bude neplatná. Pro argument nastavte hodnotu pouze . Jak je znázorněno na tomto obrázku, je nastavena hodnota employeeID.

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

Odstranění pracovního postupu exportu pomocí operace Odstranit je dokončené:

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. Under Export, select Replace. Argumenty a importy jsou již definovány a jsou specifické pro aktivity. See below screen for reference.

   

2. Add a Sequence activity.

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

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

5. Nakonec obrazovka vypadá jako na následujícím obrázku. The instructions for configuring this activity are provided in the section for adding export workflows.

   

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

   

   Důležité

   Do not change the Name, Direction, or Type for an argument by using this dialog. Pokud se některá z těchto hodnot změní, aktivita bude neplatná. Pro argument nastavte hodnotu pouze . As shown in this figure, the value employee is set.

7. Nakonec přidejte aktivitu typu If a zkontrolujte odpovědi vrácené z operace webové služby.

Replacement of the export workflow with the Replace operation is complete:

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

Debug activities

The following custom activities are available to help debug the workflow template.

Aktivita protokolu

Aktivita protokolu slouží k zápisu textových zpráv do souboru protokolu. For more information, see Logging.

Poznámka:

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

Chcete-li použít aktivitu protokolu, nastavte následující vlastnosti. Vlastnosti jsou viditelné, když vyberete aktivitu v Návrháři pracovního postupu a zobrazíte Vlastnosti aktivity.

WriteLine activity

The WriteLine activity is used to write text messages to a provider's writer. Pokud není k dispozici žádný zapisovač, aktivita WriteLine zapíše text do okna konzoly.

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

Důležité

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

Chcete-li použít aktivitu WriteLine, nastavte následující vlastnosti. Vlastnosti jsou viditelné, když vyberete aktivitu v Návrháři pracovního postupu a zobrazíte Vlastnosti aktivity.

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

  • High: Write the LogText message to the log file if the log severity is set to High.
  • Verbose: Write the LogText message to the log file if the log severity is set to Verbose.
  • Zakázáno: Nezapisujte do souboru protokolu.

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

• Značka: Přidá značku k textu, který identifikuje typ obsahu, který se zapisuje do protokolu. The possible values are: Error, Trace, or Warning.

Další kroky

• Přehled obecného konektoru webových služeb
• Nainstalovat nástroj pro konfiguraci webové služby
• průvodce nasazením protokolu SOAP
• průvodce nasazením REST
• Web Service MA configuration