Werkstroomhandleiding voor webserviceconnector voor een REST API-voorbeeld

In dit artikel wordt de implementatie van een REST API-voorbeeld beschreven om het hulpprogramma webserviceconfiguratie te doorlopen met een REST API-webgegevensbron.

Vereiste voorwaarden

De volgende vereisten zijn vereist voor het gebruik van het voorbeeld:

• Het configuratieprogramma voor webservices is geïnstalleerd.
• REST-gegevensbronvoorbeeldservice is uitgevoerd. Download en installeer het voorbeeld van (zie hier).

{

"EmployeeList":[

{"id":"1","employee_name":"Albano","employee_salary":"22213","employee_age":"37","profile_image":""},{"id":"2","employee_name":"Albano","employee_salary":"22213","employee_age":"37","profile_image":""}

]

}

REST-projectdetectie configureren in het configuratieprogramma voor webservices

In de volgende stappen ziet u hoe u een nieuw project maakt voor uw gegevensbron in het webserviceconfiguratieprogramma.

1. Open het hulpprogramma voor webserviceconfiguratie. Er wordt een leeg SOAP-project geopend.

   

2. Selecteer Bestand>Nieuw>REST-project.

   

3. Selecteer aan de linkerkant REST Project en selecteer vervolgens Toevoegen.

   

4. Geef op de volgende pagina de volgende informatie op:

   • De naam van de nieuwe webservice
   • Adres (REST API URL-pad)
   • Namespace
   • Beveiligingsmodus (verificatietype)

   

   In het volgende scherm ziet u voorbeelden voor deze waarden:

   

   Stel de beveiligingsmodus in op Geen. Stel het adres in op de voorbeeld-JSON-server die wordt gehost in Azure.

5. Kies OK. Het REST-project dat wordt vermeld in het configuratieprogramma voor webservices.

   

6. De volgende stap is het definiëren van de REST API-aanroep en het omzetten van de aanroep naar de WCF-aanroepen (Windows Communication Foundation).

   1. Vouw het REST-project uit en selecteer de RESTSAMPLE-service .

   2. Selecteer Toevoegen. U wordt gevraagd om twee waarden toe te voegen:

      

      1. Voer de naam in. Deze stap is gelabeld als 3 in de schermopname.
      2. Voer het adres in. Deze stap is gelabeld als 4 in de schermopname.
      3. Kies OK. Er wordt een REST-resource toegevoegd aan de beschrijving voor de RESTSAMPLE-service .

7. Selecteer in het vak Resources de REST-resource die u zojuist hebt toegevoegd. Voeg de volgende methode toe:

   

8. Selecteer de REST-methode. U ziet dat u meerdere methoden in dezelfde resource kunt maken en de query's definieert die tijdens de uitvoering zijn doorgegeven.

9. Voor de GETALL-methode zijn er geen query's vereist. Laat de parameterwaarden leeg. Wanneer u de REST API exporteert of importeert, moet u de voorbeeldaanvraag /of het antwoord definiëren, afhankelijk van de functie. Kopieer en plak de JSON-retour wanneer u naar dit voorbeeld navigeert.

   

10. Selecteer Opslaan. Sla het project op in C:\Program Files\Microsoft Forefront Identity Manager\2010\Synchronization Service\Extensions.

Objecttypen configureren in het hulpprogramma voor webserviceconfiguratie

In de volgende stappen ziet u hoe u objecttypen configureert voor uw gegevensbron in het webserviceconfiguratieprogramma.

1. De volgende stap is het definiëren van het connectorruimteschema. Dit wordt bereikt door het objecttype te maken en de objecttypen te definiëren. Klik op Objecttypen in het linkerdeelvenster en klik op de knop Toevoegen . Als u dit doet, wordt het onderstaande scherm geopend. Voeg een nieuw objecttype toe en geef een naam op. Klik op de knop OK.

   

2. Als u een objecttype toevoegt, ziet u het onderstaande scherm.

   

3. Met het rechterdeelvenster dat overeenkomt met het objecttype, kunt u de kenmerken en de bijbehorende eigenschappen voor het geselecteerde objecttype behouden. Als u op de knop Toevoegen klikt, ziet u het onderstaande scherm waarin u kenmerken kunt toevoegen.

   

   

4. Hieronder wordt het scherm weergegeven nadat u alle vereiste kenmerken hebt toegevoegd.

   

5. Objecttype en kenmerken bieden, nadat ze zijn gemaakt, lege werkstromen die afgestemd zijn op de bewerkingen die worden uitgevoerd in Microsoft Identity Manager (MIM).

Werkstromen configureren in het hulpprogramma voor webserviceconfiguratie

De volgende stap is het configureren van de werkstromen voor uw objecttype. Werkstroombestanden zijn een verzameling activiteiten die door de Web Services Connector tijdens runtime worden gebruikt. De werkstromen worden gebruikt om de juiste MIM-bewerking te implementeren. Het hulpprogramma voor webserviceconfiguratie helpt u bij het maken van vier verschillende werkstromen:

• Importeren: Gegevens importeren uit een gegevensbron voor de volgende twee typen werkstromen:

  • Volledige import: een volledige import die kan worden geconfigureerd.
  • Delta-import: niet ondersteund door het hulpprogramma voor webserviceconfiguratie.

• Exporteren: gegevens exporteren van MIM naar een verbonden gegevensbron. De volgende drie acties worden ondersteund voor de bewerking. U kunt deze acties configureren op basis van uw vereisten.

  • Toevoegen
  • Verwijderen
  • Vervangen

• Wachtwoord: wachtwoordbeheer uitvoeren voor de gebruiker (objecttype). Er zijn twee acties beschikbaar voor deze bewerking:

  • Wachtwoord instellen
  • Wachtwoord wijzigen

• Testverbinding: configureer een werkstroom om te controleren of de verbinding met de gegevensbronserver tot stand is gebracht.

Werkstroomontwerper

Werkstroomontwerper opent het werkgebied om de werkstroom te configureren op basis van de vereiste. Voor elk objecttype (nieuw/bestaand) biedt het configuratiehulpprogramma de knooppunten voor werkstromen die worden ondersteund door het hulpprogramma.

De werkstroomontwerper bestaat uit de volgende elementen van de gebruikersinterface:

• Knooppunten in het linkerdeelvenster: deze helpen u te selecteren welke werkstroom u wilt ontwerpen.

• Central Workflow Designer: hier kunt u de activiteiten voor het configureren van de werkstromen verwijderen. Als u verschillende MIM-bewerkingen (Exporteren, Importeren, Wachtwoordbeheer) wilt uitvoeren, kunt u de standaard- en aangepaste werkstroomactiviteiten van .NET Workflow Framework 4 gebruiken. Het hulpprogramma webserviceconfiguratie maakt gebruik van standaard- en aangepaste werkstroomactiviteiten. Zie Activiteitsontwerpers gebruikenvoor meer informatie over standaardactiviteiten.

  • In de Central Workflow Designer geeft een rode cirkel met uitroepteken naast een activiteit aan dat de bewerking is verwijderd en niet juist en volledig is gedefinieerd. Beweeg de muisaanwijzer over de rode cirkel om de exacte fout te achterhalen. Nadat de activiteit correct is gedefinieerd, verandert de rode cirkel in de gele informatiemarkering.

  • In central workflow Designer geeft een gele driehoekinformatiemarkering naast een activiteit aan dat de activiteit is gedefinieerd, maar er is meer dat u kunt doen om de activiteit te voltooien. Beweeg de muisaanwijzer over de gele driehoek om meer informatie te zien.

• Werkset: verpakt alle hulpprogramma's, inclusief systeem- en aangepaste activiteiten en vooraf gedefinieerde instructies om de werkstroom te ontwerpen. Zie Toolboxvoor meer informatie.

• Werksetsecties: De werkset bevat de volgende secties en categorieën:

  • Beschrijving: De koptekst van de Toolbox. Een tabblad heeft toegang tot de werkset en de eigenschappen van de geselecteerde werkstroomactiviteit.

  • Importwerkstroom: Aangepaste activiteiten om importwerkstromen te configureren.

  • Exportwerkstroom: Aangepaste activiteiten om exportwerkstromen te configureren.

  • Algemene: Aangepaste activiteiten om een werkstroom te configureren.

  • Foutopsporing: Systeemwerkstroomactiviteiten voor foutopsporing die is gedefinieerd in Werkstroom 4. Met deze activiteiten kunnen problemen worden bijgehouden in een workflow.

  • verklaringen: systeemworkflow-activiteiten gedefinieerd in Werkstroom 4. Voor meer informatie, zie Het gebruik van activiteitsontwerpers.

• Eigenschappen: op het tabblad Eigenschappen worden de eigenschappen weergegeven van een bepaalde werkstroomactiviteit die in het ontwerpgebied is geplaatst en geselecteerd. In de afbeelding aan de linkerkant ziet u de eigenschappen van de activiteit toewijzen. Voor elke activiteit verschillen de eigenschappen en worden ze gebruikt tijdens het configureren van de aangepaste werkstroom. Op dit tabblad kunt u de kenmerken definiëren van het geselecteerde hulpprogramma dat is verwijderd in de centrale werkstroomontwerper. Zie Eigenschappenvoor meer informatie.

• taakbalk: De taakbalk bevat drie elementen: variabelen, argumentenen importeert. Deze elementen worden samen met werkstroomactiviteiten gebruikt. Zie voor meer informatie Een ontwikkelaarsintroductie tot Windows Workflow Foundation (WF) in .NET 4.

Een volledige importwerkstroom configureren in het configuratieprogramma voor webservices

De volgende stappen laten zien hoe u volledige importwerkstromen voor de REST API configureert met behulp van het hulpprogramma voor webserviceconfiguratie.

1. Kies de werkstroom "Volledig importeren" om te configureren. De argumenten en Import zijn al gedefinieerd en zijn specifiek voor de activiteiten. Zie de volgende schermen voor meer informatie.

   

   

   Na de herconfiguratie van de aanroepen moet u de namen wijzigen van de kenmerken die de naamruimte wijzigen of toevoegen aan variabelen die verwijzen naar de retourstructuur van de API en objecttypen die verwijzen naar de oude naamruimte. De gereedschapskist in het rechterdeelvenster bevat alle aangepaste activiteiten die specifiek zijn voor werkstromen die u nodig hebt voor configuratie. Wijs de waarden toe aan de variabelen die u gaat gebruiken voor uw logica. Ga naar het onderste gedeelte van de centrale werkstroomontwerper en declareer de variabelen. Variabelen worden gedeclareerd in de volgende stap.

2. Voeg een Sequentie-activiteit toe. Sleep de Sequence-activiteitsontwerper van de hulpmiddelenkist en zet deze neer op het oppervlak van de Windows Workflow Designer. Raadpleeg de volgende schermen. De Sequentie-activiteit bevat een geordende reeks van onderliggende activiteiten die in volgorde worden uitgevoerd.

   

3. Als u een variabele wilt toevoegen, zoekt u Variabele maken. Typ wsResponse- voor de naam, selecteer het variabeletype- dropdown en selecteer vervolgens Bladeren naar typen. Er wordt een dialoogvenster weergegeven. Selecteer gegenereerd>GETALL-antwoord>. Houd het Bereik en Standaardwaarden niet geselecteerd. U kunt deze waarden ook instellen met behulp van de weergave Eigenschappen.

   

4. Sleep nog een Sequence activiteitontwerper uit de Toolbox binnen de reeds toegevoegde Sequence-activiteit.

5. Sleep een WebServiceCallActivity naar het gedeelte onder Common. Deze activiteit wordt gebruikt om een webservice-operatie aan te roepen die beschikbaar is na Discovery. Dit is een aangepaste activiteit en is gebruikelijk in verschillende bewerkingsscenario's.

   

   Als u de webservicebewerking wilt gebruiken, stelt u de volgende eigenschappen in:

   • servicenaam: voer een naam in voor de webservice.

   • Endpoint Name: Geef een eindpuntnaam op voor de geselecteerde service.

   • bewerkingsnaam: geef de respectieve bewerking voor de service op.

   • Argument: Selecteer argumenten. Wijs in het volgende dialoogvenster de argumentwaarden toe, zoals wordt weergegeven in de volgende afbeelding:

     

     Belangrijk

     Wijzig niet de naam, richtingof type voor een argument met behulp van dit dialoog. Als een van deze waarden wordt gewijzigd, wordt de activiteit ongeldig. Stel alleen de waarde in voor het argument. Zoals in deze afbeelding wordt weergegeven, is de waarde wsResponse- ingesteld.

6. Voeg een ForEach activiteit toe, net onder WebServiceCallActivity. Deze activiteit wordt gebruikt om alle kenmerken (zowel ankers als niet-ankers) van het objecttype te herhalen. Tijdens het slepen van deze activiteit naar het werkstroomontwerpoppervlak, worden automatisch alle kenmerknamen voor uw object opgesomd. Stel de vereiste waarden in op basis van het volgende scherm:

   

7. In sommige gevallen moet u mogelijk de generated.dll openen die zich in het WsConfig-bestand bevindt. Kopieer dit WsConfig-bestand en wijzig de naam ervan met de extensie .zip. Open en extraheer de generated.dll met behulp van uw favoriete .NET reflector tool.

   

8. Identificeer de openbare naamruimte voor de EmployeeList:

   

   Voeg vervolgens deze terugkeer toe aan de werkstroom ForEach:

   

9. Sleep een CreateCSEntryChangeScope activiteit binnen het ForEach- lichaam. Deze activiteit wordt gebruikt voor het maken van een exemplaar van een CSEntryChange-object in het werkstroomdomein voor elke respectieve record tijdens het ophalen van gegevens uit de doelgegevensbron. Het slepen van deze activiteit toont het onderstaande scherm. CreateAnchorAttribute-activiteiten worden automatisch overgenomen. Werk de DN-waarde bij naar de domeinnaam van uw voorkeur.

   

   Notitie

   Ankerwaarden en objectnamen variëren afhankelijk van de weergegeven webservice. In de afbeelding ziet u een voorbeeld.

10. Sleep een CreateAttributeChange-activiteit onder de CreateAnchorAttribute-activiteit. Het aantal activiteiten dat moet worden gesleept, is gelijk aan het aantal niet-verankerende kenmerken. Zie de volgende afbeelding voor naslaginformatie.

    maken

    Notitie

    Als u deze activiteit wilt gebruiken, kiest u de relevante velden uit de vervolgkeuzelijst en kent u de waarden toe. Voor kenmerken met meerdere waarden verwijdert u meerdere CreateValueChangeActivity activiteiten binnen een CreateAttributeChangeActivity-activiteit.

11. Sla dit project op op locatie %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions. Configureer vervolgens de beheeragent zoals beschreven in de webservice-MA-configuratie.

    

    Standaardprojecten moeten worden gedownload en opgeslagen op de locatie %FIM_INSTALL_DIR\2010\Synchronization Service\Extensions op het doelsysteem. De projecten zijn vervolgens zichtbaar in de wizard voor de webservice-connector.

    Wanneer u het uitvoerbare bestand uitvoert, wordt u gevraagd de locatie voor de installatie op te geven. Voer de opslaglocatie in.

    Belangrijk

    Het projectbestand kan worden opgeslagen en geopend vanaf elke locatie (met de juiste toegangsbevoegdheden van de uitvoerder). Alleen projectbestanden die zijn opgeslagen in de map Synchronization Service\Extension kunnen worden geselecteerd in de wizard Webserviceconnector die toegankelijk is via de gebruikersinterface voor MIM-synchronisatie.

    Voor de gebruiker die het hulpprogramma Webserviceconfiguratie uitvoert, zijn de volgende bevoegdheden vereist:

    • Volledige controle voor de map Synchronization Service Extension.
    • Leestoegang tot de registersleutel HKLM\System\CurrentControlSet\Services\FIMSynchronizationService\Parameters door middel waarvan het pad naar de extensiemap wordt gelokaliseerd.

Volgende stappen

• Overzicht van de algemene Web Service Connector
• het hulpprogramma voor webserviceconfiguratie installeren
• SOAP-implementatiehandleiding
• REST-implementatiehandleiding
• Webdienst MA-configuratie