Guida al flusso di lavoro di Web Service Connector per un esempio di API REST

Questo articolo illustra la distribuzione di un'API REST di esempio per esaminare lo strumento di configurazione del servizio Web con un'origine dati Web API REST.

Prerequisiti

Per usare l'esempio sono necessari i prerequisiti seguenti:

• Lo strumento di configurazione del servizio Web è installato.
• Viene distribuito il servizio di esempio dell'origine dati REST. Scaricare e installare l'esempio da (vedere qui).

Nota

I dati JSON devono contenere un singolo oggetto con una proprietà contenente una matrice.

{

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

]

}

Configurare l'individuazione del progetto REST nello strumento di configurazione del servizio Web

I passaggi seguenti illustrano come creare un nuovo progetto per l'origine dati nello strumento di configurazione del servizio Web.

1. Aprire lo strumento di configurazione del servizio Web. Apre un progetto SOAP vuoto.

   

2. Selezionare File>Nuovo>progetto REST.

   

3. A sinistra selezionare Progetto REST e quindi Aggiungi.

   

4. Nella pagina successiva specificare le informazioni seguenti:

   • Nuovo nome del servizio Web
   • Indirizzo (percorso URL API REST)
   • Spazio dei nomi
   • Modalità di sicurezza (tipo di autenticazione)

   

   La schermata seguente mostra esempi per questi valori:

   

   Impostare la modalità di sicurezza su Nessuno. Impostare l'indirizzo sul server JSON di esempio ospitato in Azure.

5. Selezionare OK. Il progetto REST elencato nello strumento di configurazione dei servizi Web.

   

6. Il passaggio successivo consiste nel definire la chiamata api REST e tradurre la chiamata alle chiamate windows Communication Foundation (WCF).

   1. Espandere il progetto REST e selezionare il servizio RESTSAMPLE .

   2. Selezionare Aggiungi. Viene richiesto di aggiungere due valori:

      

      1. Immettere il nome. Questo passaggio viene etichettato come 3 nello screenshot.
      2. Immettere l'indirizzo. Questo passaggio viene etichettato come 4 nello screenshot.
      3. Selezionare OK. Una risorsa REST viene aggiunta alla descrizione del servizio RESTSAMPLE .

7. Nella casella Risorse selezionare la risorsa REST appena aggiunta. Aggiungere il metodo seguente:

   

8. Selezionare il metodo REST. Si noti che è possibile creare più metodi nella stessa risorsa e definire le query passate durante l'esecuzione.

9. Per il metodo GETALL, non sono necessarie query. Lasciare vuoti i valori dei parametri. Quando si esporta o importa l'API REST, è necessario definire la richiesta di esempio /o risposta a seconda della funzione. Copiare e incollare il codice JSON restituito quando si passa a questo esempio.

   

10. Selezionare Salva. Salvare il progetto in C:\Program Files\Microsoft Forefront Identity Manager\2010\Synchronization Service\Extensions.

Nota

Dopo il salvataggio del progetto, viene generato il file WsConfig. Il file di configurazione contiene più file definiti in precedenza nella panoramica del servizio Web.

Configurare i tipi di oggetto nello strumento di configurazione del servizio Web

La procedura seguente illustra come configurare i tipi di oggetti per l'origine dati nello strumento di configurazione del servizio Web.

1. Il passaggio successivo consiste nel definire lo schema dello spazio del connettore. Ciò viene ottenuto creando il tipo di oggetto e definendo i tipi di oggetto. Fare clic su Tipi di oggetto nel riquadro sinistro e fare clic sul pulsante Aggiungi . In questo modo viene visualizzata la schermata seguente. Aggiungere un nuovo tipo di oggetto e specificare un nome. Fare clic sul pulsante OK .

   

2. L'aggiunta di un tipo di oggetto fornisce la schermata seguente.

   

3. Il riquadro destro corrispondente al tipo di oggetto consente di mantenere gli attributi e le relative proprietà per il tipo di oggetto selezionato. Facendo clic sul pulsante Aggiungi viene visualizzata la schermata seguente in cui è possibile aggiungere attributi.

   

   

4. La schermata seguente viene visualizzata dopo l'aggiunta di tutti gli attributi necessari.

   

5. Tipo di oggetto e attributi dopo la creazione, fornisce flussi di lavoro vuoti che soddisfano le operazioni eseguite in Microsoft Identity Manager (MIM).

Configurare i flussi di lavoro nello strumento di configurazione del servizio Web

Il passaggio successivo consiste nel configurare i flussi di lavoro per il tipo di oggetto. I file del flusso di lavoro sono una serie di attività usate dal connettore servizi Web in fase di esecuzione. I flussi di lavoro vengono usati per implementare l'operazione MIM appropriata. Lo strumento di configurazione del servizio Web consente di creare quattro flussi di lavoro diversi:

• Importazione: Importare dati da un'origine dati per i due tipi di flussi di lavoro seguenti:

  • Importazione completa: importazione completa che può essere configurata.
  • Importazione differenziale: non supportata dallo strumento di configurazione del servizio Web.

• Esportazione: esportare dati da MIM a un'origine dati connessa. Le tre azioni seguenti sono supportate per l'operazione. È possibile configurare queste azioni in base ai requisiti.

  • Add
  • Elimina
  • Sostituisci

• Password: eseguire la gestione delle password per l'utente (tipo di oggetto). Per questa operazione sono disponibili due azioni:

  • Impostare la password
  • Cambia password

• Connessione di test: configurare un flusso di lavoro per verificare se la connessione con il server di origine dati è stata stabilita correttamente.

Nota

È possibile configurare questi flussi di lavoro per il progetto o scaricare il progetto predefinito dall'Area download Microsoft.

Progettazione flussi di lavoro

Progettazione flussi di lavoro apre l'area di lavoro per configurare il flusso di lavoro in base alle esigenze. Per ogni tipo di oggetto (nuovo /esistente), lo strumento di configurazione fornisce i nodi per i flussi di lavoro supportati dallo strumento.

Progettazione flussi di lavoro è costituito dagli elementi dell'interfaccia utente seguenti:

• Nodi nel riquadro sinistro: consentono di selezionare quale flusso di lavoro si vuole progettare.

• Progettazione flusso di lavoro centrale: qui è possibile eliminare le attività per la configurazione dei flussi di lavoro. Per eseguire varie operazioni MIM (Export, Import, Password Management), è possibile usare le attività di flusso di lavoro standard e personalizzate di .NET Workflow Framework 4. Lo strumento Di configurazione del servizio Web usa attività di flusso di lavoro standard e personalizzate. Per altre informazioni sulle attività standard, vedere Uso di progettazione attività.

  • In Progettazione flussi di lavoro centrale, un cerchio rosso con punto esclamativo accanto a qualsiasi attività indica che l'operazione è stata eliminata e non è definita correttamente e completamente. Passare il mouse sul cerchio rosso per scoprire l'errore esatto. Dopo aver definito correttamente l'attività, il cerchio rosso viene modificato nel segno delle informazioni gialle.

  • In Progettazione flusso di lavoro centrale, un segno di informazioni sul triangolo giallo accanto a qualsiasi attività indica che l'attività è definita, ma è possibile eseguire altre operazioni per completare l'attività. Passare il puntatore del mouse sul triangolo giallo per visualizzare altre informazioni.

• Casella degli strumenti: consente di creare pacchetti di tutti gli strumenti, inclusi le attività di sistema e le attività personalizzate e le istruzioni predefinite per progettare il flusso di lavoro. Per altre informazioni, vedere Casella degli strumenti.

• Sezioni della casella degli strumenti: la casella degli strumenti include le sezioni e le categorie seguenti:

  • Descrizione: intestazione della casella degli strumenti. Una scheda accede alla casella degli strumenti e alle proprietà dell'attività del flusso di lavoro selezionata.

  • Importa flusso di lavoro: attività personalizzate per configurare i flussi di lavoro di importazione.

  • Esporta flusso di lavoro: attività personalizzate per configurare i flussi di lavoro di esportazione.

  • Comune: attività personalizzate per configurare qualsiasi flusso di lavoro.

  • Debug: attività del flusso di lavoro di sistema per il debug definito nel flusso di lavoro 4. Queste attività consentono il rilevamento dei problemi per un flusso di lavoro.

  • Istruzioni: attività del flusso di lavoro di sistema definite nel flusso di lavoro 4. Per altre informazioni, vedere Uso di activity designer.

• Proprietà: la scheda proprietà visualizza le proprietà di un'attività del flusso di lavoro specifica eliminata nell'area di progettazione e selezionata. La figura a sinistra mostra le proprietà dell'attività Assegna . Per ogni attività, le proprietà differiscono e vengono usate durante la configurazione del flusso di lavoro personalizzato. Questa scheda consente di definire gli attributi dello strumento selezionato eliminato nella finestra di progettazione del flusso di lavoro centrale. Per ulteriori informazioni, vedi Proprietà.

• Barra delle attività: La barra delle attività include tre elementi: variabili, argomenti e importazioni. Questi elementi vengono usati insieme alle attività del flusso di lavoro. Per altre informazioni, vedere Introduzione di uno sviluppatore a Windows Workflow Foundation (WF) in .NET 4.

Configurare un flusso di lavoro di importazione completo nello strumento di configurazione del servizio Web

La procedura seguente illustra come configurare flussi di lavoro di importazione completi per l'API REST usando lo strumento di configurazione del servizio Web.

Avviso

Questo esempio crea solo un flusso di lavoro. È possibile che siano necessarie modifiche al flusso di lavoro, ad esempio per usare la logica personalizzata nell'API.

1. Selezionare il flusso di lavoro Di importazione completo da configurare. Gli argomenti e le importazioni sono già definiti e sono specifici delle attività. Per altre informazioni, vedere le schermate seguenti.

   

   

   Dopo la riconfigurazione delle chiamate è necessario modificare i nomi degli attributi che cambiano o aggiungono lo spazio dei nomi alle variabili che fanno riferimento alla struttura restituita dei tipi di API e di oggetti che fanno riferimento al vecchio spazio dei nomi. La casella degli strumenti nel riquadro destro contiene tutte le attività specifiche del flusso di lavoro personalizzate necessarie per la configurazione. Assegnare i valori alle variabili che verranno usate per la logica. Passare alla sezione inferiore della finestra di progettazione del flusso di lavoro centrale e dichiarare le variabili. Le variabili vengono dichiarate nel passaggio successivo.

2. Aggiungere un'attività Sequenza. Trascinare la finestra di progettazione attività sequenza dalla casella degli strumenti e rilasciarla nell'area Progettazione flussi di lavoro di Windows. Vedere le schermate seguenti. L'attività Sequence contiene una raccolta ordinata di attività figlio eseguite in ordine.

   

3. Per aggiungere una variabile, individuare Crea variabile. Digitare wsResponse per nome, selezionare l'elenco a discesa Tipo di variabile e quindi selezionare Sfoglia tipi. Viene visualizzata una finestra di dialogo. Selezionare larispostaGETALL>generata>. Mantenere deselezionati i valori Ambito e Impostazione predefinita . In alternativa, impostare questi valori usando la visualizzazione Proprietà .

   

4. Trascinare uno più Progettazione attività sequenza dalla casella degli strumenti all'interno dell'attività Sequenza già aggiunta.

5. Trascinare un oggetto WebServiceCallActivity visualizzato in Common. Questa attività viene usata per richiamare l'operazione del servizio Web disponibile dopo l'individuazione. Si tratta di un'attività personalizzata ed è comune in diversi scenari operativi.

   

   Per usare l'operazione del servizio Web, impostare le proprietà seguenti:

   • Nome servizio: immettere un nome per il servizio Web.

   • Nome endpoint: specificare un nome endpoint per il servizio selezionato.

   • Nome operazione: specificare il rispettivo funzionamento per il servizio.

   • Argomento: selezionare argomenti. Nella finestra di dialogo successiva assegnare i valori degli argomenti, come illustrato nella figura seguente:

     

     Importante

     Non modificare nome, direzione o tipo per un argomento usando questa finestra di dialogo. Se uno di questi valori viene modificato, l'attività diventa non valida. Imposta solo valore per l'argomento. Come illustrato in questa figura, il valore wsResponse è impostato.

6. Aggiungere un'attività ForEach appena sotto WebServiceCallActivity. Questa attività viene usata per eseguire l'iterazione di tutti gli attributi (ancoraggi e non ancoraggi) di tipo di oggetto. Durante il trascinamento di questa attività nell'area progettazione flussi di lavoro, enumera automaticamente tutti i nomi di attributo per l'oggetto. Impostare i valori obbligatori in base alla schermata seguente:

   

7. In alcuni casi, potrebbe essere necessario aprire il generated.dll all'interno del file WsConfig. Copiare questo file WsConfig e rinominarlo con l'estensione .zip. Aprire ed estrarre la generated.dll usando lo strumento di riflettente .NET preferito.

   

8. Identificare lo spazio dei nomi pubblico per EmployeeList:

   

   Aggiungere quindi questa restituzione al flusso di lavoro ForEach:

   

9. Trascinare un'attività CreateCSEntryChangeScope all'interno del corpo forEach . Questa attività viene usata per creare un'istanza dell'oggetto CSEntryChange nel dominio del flusso di lavoro per ogni record rispettivo durante il recupero dei dati dall'origine dati di destinazione. Trascinando questa attività viene visualizzata la schermata seguente. Le attività CreateAnchorAttribute vengono ereditate automaticamente. Aggiornare il valore DN al nome di dominio preferito.

   

   Nota

   I valori di ancoraggio e i nomi degli oggetti variano in base al servizio Web esposto. La figura mostra un esempio.

10. Trascinare un'attività CreateAttributeChange sotto l'attività CreateAnchorAttribute . Il numero di attività da trascinare è uguale al numero di attributi non ancoraggi. Per informazioni di riferimento, vedere la figura seguente.

    

    Nota

    Per usare questa attività, selezionare e assegnare i rispettivi campi dall'elenco a discesa e assegnare i valori. Per gli attributi multivalore, eliminare più attività CreateValueChangeActivity all'interno di un'attività CreateAttributeChangeActivity .

11. Salvare questo progetto nel percorso %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions. Configurare quindi l'agente di gestione come descritto nella configurazione ma del servizio Web.

    

    I progetti predefiniti devono essere scaricati e salvati nel percorso %FIM_INSTALL_DIR\2010\Synchronization Service\Extensions del sistema di destinazione. I progetti sono quindi visibili nella procedura guidata del connettore del servizio Web.

    Quando si esegue il file eseguibile, viene richiesto di specificare il percorso per l'installazione. Immettere il percorso di salvataggio.

    Importante

    Il file di progetto può essere salvato e aperto da qualsiasi posizione (con i privilegi di accesso appropriati del relativo executor). È possibile selezionare solo i file di progetto salvati nella Synchronization Service\Extension cartella nella procedura guidata del connettore del servizio Web a cui si accede tramite l'interfaccia utente di sincronizzazione MIM.

    L'utente che esegue lo strumento Configurazione servizio Web richiede i privilegi seguenti:

    • Controllo completo nella cartella Estensione del servizio di sincronizzazione.
    • Leggere l'accesso alla chiave HKLM\System\CurrentControlSet\Services\FIMSynchronizationService\Parameters del Registro di sistema tramite cui si trova il percorso della cartella Estensione.

Passaggi successivi

• Panoramica di Generic Web Service Connector
• Installare lo strumento di configurazione del servizio Web
• Guida alla distribuzione SOAP
• Guida alla distribuzione REST
• Configurazione ma del servizio Web