Arbetsflödesguide för webbtjänstanslutning för ett REST API-exempel

Den här artikeln beskriver distributionen av ett REST-exempel-API för att gå igenom konfigurationsverktyget för webbtjänsten med en REST API-webbdatakälla.

Förutsättningar

Följande krav krävs för att använda exemplet:

• Konfigurationsverktyget för webbtjänsten är installerat.
• EXEMPELtjänsten för REST-datakällor distribueras. Ladda ned och installera exemplet från (se här).

Anteckning

JSON-data måste innehålla ett enda objekt med en egenskap som innehåller en matris.

{

"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":""}

]

}

Konfigurera IDENTIFIERING av REST-projekt i konfigurationsverktyget för webbtjänsten

Följande steg visar hur du skapar ett nytt projekt för datakällan i konfigurationsverktyget för webbtjänsten.

1. Öppna konfigurationsverktyget för webbtjänsten. Ett tomt SOAP-projekt öppnas.

   

2. Välj Arkiv>Nytt>REST-projekt.

   

3. Till vänster väljer du REST-projekt och sedan Lägg till.

   

4. Ange följande information på nästa sida:

   • Det nya webbtjänstnamnet
   • Adress (REST API URL-sökväg)
   • Namnområde
   • Säkerhetsläge (autentiseringstyp)

   

   På följande skärm visas exempel på dessa värden:

   

   Ange Säkerhetsläge till Ingen. Ange Adressen till JSON-exempelservern som finns i Azure.

5. Välj OK. REST-projektet som anges i konfigurationsverktyget för webbtjänster.

   

6. Nästa steg är att definiera REST API-anropet och översätta anropet till WCF-anropen (Windows Communication Foundation).

   1. Expandera REST-projektet och välj RESTSAMPLE-tjänsten .

   2. Välj Lägg till. Du uppmanas att lägga till två värden:

      

      1. Ange Namn. Det här steget är märkt som 3 på skärmbilden.
      2. Ange adressen. Det här steget är märkt som 4 på skärmbilden.
      3. Välj OK. En REST-resurs läggs till i beskrivningen för RESTSAMPLE-tjänsten .

7. I rutan Resurser väljer du den REST-resurs som du nyss lade till. Lägg till följande metod:

   

8. Välj REST-metoden. Observera att du kan skapa flera metoder i samma resurs och definiera de frågor som skickas under körningen.

9. För getall-metoden krävs inga frågor. Lämna parametervärdena tomma. När du exporterar eller importerar REST-API:et måste du definiera exempelbegäran/eller -svaret beroende på funktion. Kopiera och klistra in JSON-returen när du navigerar till det här exemplet.

   

10. Välj Spara. Spara projektet i C:\Program Files\Microsoft Forefront Identity Manager\2010\Synchronization Service\Extensions.

Anteckning

När projektet har sparats genereras WsConfig-filen. Konfigurationsfilen innehåller flera filer som definierats tidigare i översikten över webbtjänsten.

Konfigurera objekttyper i konfigurationsverktyget för webbtjänsten

Följande steg visar hur du konfigurerar objekttyper för datakällan i konfigurationsverktyget för webbtjänsten.

1. Nästa steg är att definiera anslutningsprogrammets utrymmesschema. Detta uppnås genom att skapa objekttypen och definiera deras objekttyper. Klicka på Objekttyper i det vänstra fönstret och klicka på knappen Lägg till . När du gör det öppnas skärmen nedan. Lägg till en ny objekttyp och ange ett namn. Klicka på OK.

   

2. Om du lägger till en objekttyp visas skärmen nedan.

   

3. Med den högra rutan som motsvarar objekttypen kan du underhålla attributen och deras egenskaper för den valda objekttypen. Om du klickar på knappen Lägg till visas skärmen nedan där du kan lägga till attribut.

   

   

4. Skärmen nedan visas när du har lagt till alla obligatoriska attribut.

   

5. Objekttyp och attribut när de väl har skapats innehåller tomma arbetsflöden som hanterar de åtgärder som utförs i Microsoft Identity Manager (MIM).

Konfigurera arbetsflöden i konfigurationsverktyget för webbtjänsten

Nästa steg är att konfigurera arbetsflöden för din objekttyp. Arbetsflödesfiler är en serie aktiviteter som används av Anslutningsappen för webbtjänster vid körning. Arbetsflödena används för att implementera lämplig MIM-åtgärd. Konfigurationsverktyget för webbtjänsten hjälper dig att skapa fyra olika arbetsflöden:

• Importera: Importera data från en datakälla för följande två typer av arbetsflöden:

  • Fullständig import: En fullständig import som kan konfigureras.
  • Deltaimport: Stöds inte av konfigurationsverktyget för webbtjänsten.

• Exportera: Exportera data från MIM till en ansluten datakälla. Följande tre åtgärder stöds för åtgärden. Du kan konfigurera dessa åtgärder baserat på dina krav.

  • Lägg till
  • Ta bort
  • Ersätt

• Lösenord: Utför lösenordshantering för användaren (objekttyp). Två åtgärder är tillgängliga för den här åtgärden:

  • Ange lösenord
  • Ändra lösenord

• Testanslutning: Konfigurera ett arbetsflöde för att kontrollera om anslutningen till datakällservern har upprättats.

Anteckning

Du kan konfigurera dessa arbetsflöden för projektet eller ladda ned standardprojektet från Microsoft Download Center.

Arbetsflödesdesigner

Arbetsflödesdesignern öppnar arbetsytan för att konfigurera arbetsflödet enligt behov. För varje objekttyp (ny /befintlig) tillhandahåller konfigurationsverktyget noderna för arbetsflöden som stöds av verktyget.

Arbetsflödesdesignern består av följande gränssnittselement:

• Noder i det vänstra fönstret: Dessa hjälper dig att välja vilket arbetsflöde du vill utforma.

• Central arbetsflödesdesigner: Här kan du ta bort aktiviteterna för att konfigurera arbetsflödena. Om du vill utföra olika MIM-åtgärder (export, import, lösenordshantering) kan du använda standard- och anpassade arbetsflödesaktiviteter i .NET Workflow Framework 4. Konfigurationsverktyget för webbtjänsten använder standardaktiviteter och anpassade arbetsflödesaktiviteter. Mer information om standardaktiviteter finns i Använda aktivitetsdesigners.

  • I den centrala arbetsflödesdesignern indikerar en röd cirkel med utropstecken bredvid en aktivitet att åtgärden har släppts och inte har definierats korrekt och fullständigt. Hovra över den röda cirkeln för att ta reda på det exakta felet. När aktiviteten har definierats korrekt ändras den röda cirkeln till det gula informationsmärket.

  • I den centrala arbetsflödesdesignern anger en gul triangelinformationsmarkering bredvid alla aktiviteter att aktiviteten har definierats, men det finns mer du kan göra för att slutföra aktiviteten. Hovra över den gula triangeln om du vill se mer information.

• Verktygslåda: Paketar alla verktyg, inklusive systemaktiviteter och anpassade aktiviteter och fördefinierade instruktioner för att utforma arbetsflödet. Mer information finns i Verktygslåda.

• Verktygslådeavsnitt: Verktygslådan innehåller följande avsnitt och kategorier:

  • Beskrivning: Sidhuvudet i verktygslådan. En flik öppnar verktygslådan och egenskaperna för den valda arbetsflödesaktiviteten.

  • Importera arbetsflöde: Anpassade aktiviteter för att konfigurera importarbetsflöden.

  • Exportera arbetsflöde: Anpassade aktiviteter för att konfigurera exportarbetsflöden.

  • Vanliga: Anpassade aktiviteter för att konfigurera alla arbetsflöden.

  • Felsökning: Systemarbetsflödesaktiviteter för felsökning som definierats i arbetsflöde 4. De här aktiviteterna gör det möjligt att spåra problem för ett arbetsflöde.

  • Instruktioner: Systemarbetsflödesaktiviteter som definierats i arbetsflöde 4. Mer information finns i Använda aktivitetsdesigners.

• Egenskaper: Fliken Egenskaper visar egenskaperna för en viss arbetsflödesaktivitet som tas bort i designerområdet och har valts. Bilden till vänster visar egenskaperna för Tilldela aktivitet. För varje aktivitet skiljer sig egenskaperna åt och används när du konfigurerar det anpassade arbetsflödet. På den här fliken kan du definiera attributen för det valda verktyget som har släppts i den centrala arbetsflödesdesignern. Mer information finns i Egenskaper.

• Aktivitetsfält: Aktivitetsfältet innehåller tre element: Variabler, Argument och Importer. Dessa element används tillsammans med arbetsflödesaktiviteter. Mer information finns i En utvecklares introduktion till Windows Workflow Foundation (WF) i .NET 4.

Konfigurera ett fullständigt importarbetsflöde i konfigurationsverktyget för webbtjänsten

Följande steg visar hur du konfigurerar fullständiga importarbetsflöden för REST-API:et med hjälp av konfigurationsverktyget för webbtjänsten.

Varning

Det här exemplet skapar bara ett arbetsflöde. Ändringar i arbetsflödet, till exempel att använda anpassad logik i API:et, kan krävas.

1. Välj det arbetsflöde för fullständig import som ska konfigureras. Argumenten och importerna har redan definierats och är specifika för aktiviteterna. Mer information finns på följande skärmar.

   

   

   Efter omkonfigurationen av anropen måste du ändra namnen på attributen som ändrar eller lägga till namnområdet i variabler som refererar till returstrukturen för API:et och objekttyperna som refererar till det gamla namnområdet. Verktygslådan i den högra rutan innehåller alla anpassade arbetsflödesspecifika aktiviteter som du behöver för konfigurationen. Tilldela värdena till de variabler som du ska använda för din logik. Gå till det nedre avsnittet i den centrala arbetsflödesdesignern och deklarera variablerna. Variabler deklareras i nästa steg.

2. Lägg till en sekvensaktivitet. Dra aktivitetsdesignern Sekvens från verktygslådan och släpp den på Windows Workflow Designer-ytan. Se följande skärmar. Sekvensaktiviteten innehåller en ordnad samling underordnade aktiviteter som körs i ordning.

   

3. Om du vill lägga till en variabel letar du upp Skapa variabel. Skriv wsResponse som Namn, välj listrutan Variabeltyp och välj sedan Bläddra efter typer. En dialogruta visas. Välj genererat>GETALL-svar>. Behåll värdena Omfång och Standard avmarkerade. Du kan också ange dessa värden med hjälp av vyn Egenskaper .

   

4. Dra ytterligare en sekvensaktivitetsdesigner från verktygslådan i den redan tillagda sekvensaktiviteten.

5. Dra en WebServiceCallActivity som visas under Vanliga. Den här aktiviteten används för att anropa webbtjänståtgärd som är tillgänglig efter identifiering. Det här är en anpassad aktivitet som är vanlig i olika åtgärdsscenarier.

   

   Om du vill använda webbtjänståtgärden anger du följande egenskaper:

   • Tjänstnamn: Ange ett namn för webbtjänsten.

   • Slutpunktsnamn: Ange ett slutpunktsnamn för den valda tjänsten.

   • Åtgärdsnamn: Ange respektive åtgärd för tjänsten.

   • Argument: Välj Argument. I nästa dialogruta tilldelar du argumentvärdena enligt följande bild:

     

     Viktigt

     Ändra inte namn, riktning eller typ för ett argument med hjälp av den här dialogrutan. Om något av dessa värden ändras blir aktiviteten ogiltig. Ange endast värdet för argumentet . Som du ser i den här bilden anges värdet wsResponse .

6. Lägg till en ForEach-aktivitet strax under WebServiceCallActivity. Den här aktiviteten används för att iterera över alla attribut (både fästpunkter och icke-fästpunkter) av objekttypen. När du drar den här aktiviteten till arbetsflödesdesignerytan räknas automatiskt alla attributnamn upp för objektet. Ange nödvändiga värden enligt följande skärm:

   

7. I vissa fall kan du behöva öppna generated.dll som finns i WsConfig-filen. Kopiera den här WsConfig-filen och byt namn på den med tillägget .zip. Öppna och extrahera generated.dll med hjälp av önskat .NET-reflektorverktyg.

   

8. Identifiera det offentliga namnområdet för EmployeeList:

   

   Lägg sedan till den här returen i arbetsflödet ForEach:

   

9. Dra en CreateCSEntryChangeScope-aktivitet i ForEach-brödtexten . Den här aktiviteten används för att skapa en instans av CSEntryChange-objektet i arbetsflödesdomänen för varje respektive post när data hämtas från måldatakällan. Om du drar den här aktiviteten visas nedanstående skärm. CreateAnchorAttribute-aktiviteter ärvs automatiskt. Uppdatera DN-värdet till önskat domännamn.

   

   Anteckning

   Fästpunktsvärden och objektnamn varierar beroende på den exponerade webbtjänsten. Bilden visar ett exempel.

10. Dra en CreateAttributeChange-aktivitet under aktiviteten CreateAnchorAttribute . Antalet aktiviteter som ska dras är lika med antalet icke-fästpunktsattribut. Se följande bild som referens.

    

    Anteckning

    Om du vill använda den här aktiviteten väljer du och tilldelar respektive fält i listrutan och tilldelar värdena. För flervärdesattribut släpper du flera CreateValueChangeActivity-aktiviteter i en CreateAttributeChangeActivity-aktivitet .

11. Spara projektet på platsen %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions. Konfigurera sedan hanteringsagenten enligt beskrivningen i Ma-konfigurationen för webbtjänsten.

    

    Standardprojekt ska laddas ned och sparas på platsen %FIM_INSTALL_DIR\2010\Synchronization Service\Extensions i målsystemet. Projekten visas sedan i guiden anslutningsapp för webbtjänster.

    När du kör den körbara filen uppmanas du att ange platsen för installationen. Ange platsen för att spara.

    Viktigt

    Projektfilen kan sparas och öppnas från valfri plats (med lämplig åtkomstbehörighet för dess utförare). Endast projektfiler som sparas i Synchronization Service\Extension mappen kan väljas i guiden Anslutningsapp för webbtjänster som nås via användargränssnittet för MIM-synkronisering.

    Den användare som kör konfigurationsverktyget för webbtjänsten kräver följande behörigheter:

    • Fullständig kontroll till mappen För synkroniseringstjänsttillägg.
    • Läsbehörighet till registernyckeln HKLM\System\CurrentControlSet\Services\FIMSynchronizationService\Parameters genom vilken sökvägen till mappen Extension finns.

Nästa steg

• Översikt över allmänt anslutningsprogram för webbtjänster
• Installera konfigurationsverktyget för webbtjänsten
• SOAP-distributionsguide
• REST-distributionsguide
• Ma-konfiguration för webbtjänst