Procedura dettagliata: Modulo 3 - Accesso alle proprietà di SharePoint da un'orchestrazione

Questa procedura dettagliata è una continuazione della procedura dettagliata: Modulo 2 - Integrazione di Office con l'adapter Windows SharePoint Services e illustra come accedere alle proprietà del contesto Windows SharePoint Services di un messaggio in arrivo in fase di esecuzione e quindi determinare la destinazione del messaggio in base a una proprietà che usa porte dinamiche in un oggetto Orchestrazione. Per un'introduzione all'adapter Windows SharePoint Services, vedere Informazioni sull'adapter Windows SharePoint Services.

Prerequisiti

Di seguito sono riportati i prerequisiti per l'esecuzione delle procedure illustrate in questo argomento:

• È necessario disporre di una distribuzione a server singolo con un'installazione completa di BizTalk Server in esecuzione in Windows Server 2008 SP2 o Windows Server 2008 R2.

• È necessario completare le procedure dettagliate seguenti: Procedura dettagliata: Modulo 1 - Invio e ricezione di messaggi con l'adapter Windows SharePoint Services e procedura dettagliata: Modulo 2 - Integrazione di Office con l'adapter Windows SharePoint Services

  Per informazioni sull'uso dell'adapter Windows SharePoint Services in una distribuzione multiserver, vedere Configurazione e distribuzione dell'adapter Windows SharePoint Services.

Modificare il progetto BizTalk

In questa procedura si modifica lo schema PurchaseOrder da Procedura dettagliata: Modulo 2 - Integrazione di Office con l'adattatore Windows SharePoint Services. In questa procedura viene illustrato come alzare di livello la proprietà di uno schema, in modo da agevolarne l'accesso in un'orchestrazione BizTalk.

Modificare lo schema PurchaseOrder.xsd

1. Avviare Microsoft Visual Studio.

2. Fare clic su File, fare clic su Apri e quindi su Progetto/Soluzione.

3. Passare al OrderProcess.sln file e quindi fare clic su Apri.

4. In Esplora soluzioni fare clic con il pulsante destro del mouse sul OrderProcessSchema.xsd file e quindi scegliere Apri.

5. In Editor BizTalk espandere PurchaseOrder.

6. Fare clic con il pulsante destro del mouse su Amount, scegliere Alza di livello, quindi fare clic su Promozione rapida.

7. Fare clic su OK.

   Nota

   Visual Studio crea uno schema di proprietà per questo nel progetto corrente.

8. Salvare PurchaseOrder.xsd.

Creare un'orchestrazione

In questa procedura verrà creata una nuova orchestrazione BizTalk. Questa procedura consente di creare l'orchestrazione che viene utilizzata per elaborare un messaggio ricevuto dall'adapter Windows Sharepoint Services.

Aggiungere un'orchestrazione BizTalk

1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul OrderProcess progetto, scegliere Aggiungi e quindi fare clic su Nuovo elemento.

2. In Categorie selezionare File di orchestrazione.

3. In Modelli selezionare Orchestrazione BizTalk.

4. Digitare MyCompanyOrderProcessing il campo Nome e quindi fare clic su Aggiungi.

Creare informazioni di ricezione

In questa procedura verranno creati un nuovo messaggio, una porta di ricezione e una forma Ricezione per l'orchestrazione. Questa procedura illustra come configurare un'orchestrazione per ricevere un messaggio da BizTalk Server.

Creare un nuovo messaggio

1. In Visualizzazione orchestrazione fare clic con il pulsante destro del mouse su Messaggi e quindi scegliere Nuovo messaggio. Verrà generato un nuovo messaggio con il nome Message_1.

2. Fare clic con il pulsante destro del mouse su Message_1, scegliere Rinominae quindi digitare Message_PO.

3. Fare clic con il pulsante destro del mouse su Message_POe quindi scegliere Finestra Proprietà.

4. Nella proprietà Message Type espandere Schemi e quindi selezionare OrderProcess.OrderProcessSchema schema.

Aggiungere una porta di ricezione all'orchestrazione

1. In Orchestrazioni BizTalk nella casella degli strumenti trascinare una forma Porta nell'area di attacco. Verrà avviata la Configurazione guidata porta.

2. Nella schermata iniziale fare clic su Avanti.

3. Digitare ReceivePurchaseOrder il campo Nome e quindi fare clic su Avanti.

4. Selezionare Crea un nuovo tipo di porta.

5. Digitare PurchaseOrderPT il campo Nome tipo di porta e quindi fare clic su Avanti.

6. Nella schermata Associazione porta lasciare i valori predefiniti e quindi fare clic su Avanti.

7. Fare clic su Fine.

8. In Visualizzazione orchestrazione espandere il PurchaseOrderPT tipo di porta in Tipi di porta.

9. Fare clic con il pulsante destro del mouse su Operation_1, scegliere Rinominae quindi digitare PurchaseOrderOperation.

Aggiungere una forma Ricezione all'orchestrazione

1. In Orchestrazioni BizTalk nella casella degli strumenti trascinare una forma Receive nell'orchestrazione.

2. Fare clic con il pulsante destro del mouse sulla forma Ricezione, quindi scegliere Finestra Proprietà.

3. Impostare la proprietà Activate su True.

   Nota

   Se la proprietà Attiva è impostata su False, viene visualizzato l'errore seguente: "Errore X2214: è necessario specificare almeno un set di correlazione già inizializzato per una ricezione di non attivazione su una porta priva di correlazione automatica".

4. Digitare Receive_PO il campo Nome .

5. Nella finestra Proprietà selezionare Message_PO per la proprietà Message.

6. Selezionare ReceivePurchaseOrder.PurchaseOrderOperation.Request per la proprietà Operation . La porta verrà associata alla forma Ricezione in Progettazione orchestrazioni.

Creare informazioni di trasmissione

In questa procedura verranno creati un nuovo messaggio, porte di trasmissione e una struttura decisionale per l'orchestrazione. Questa procedura illustra come configurare un'orchestrazione con logica decisionale e come configurare un'orchestrazione per l'invio di un messaggio a una porta di trasmissione.

Creare un nuovo messaggio

1. In Visualizzazione orchestrazione fare clic con il pulsante destro del mouse su Messaggi e quindi scegliere Nuovo messaggio. Verrà generato un nuovo messaggio con il nome Message_1.

2. Fare clic con il pulsante destro del mouse su Message_1, scegliere Rinominae quindi digitare Message_Task.

3. Fare clic con il pulsante destro del mouse su Message_Taske quindi scegliere Finestra Proprietà.

4. Nella proprietà Message Type espandere Schemi e quindi selezionare OrderProcess.OrderProcessSchema schema.

Aggiungere una porta di trasmissione all'orchestrazione

1. In Orchestrazioni BizTalk nella casella degli strumenti trascinare una forma Porta nell'area di attacco. Verrà avviata la Configurazione guidata porta.

2. Nella schermata iniziale fare clic su Avanti.

3. Digitare SendPurchaseOrder il campo Nome e quindi fare clic su Avanti.

4. Selezionare Usa un tipo di porta esistente.

5. In Tipi di porta disponibili selezionare OrderProcess.PurchaseOrderPTe quindi fare clic su Avanti.

6. Nella schermata Associazione porta, in Direzione porta della comunicazione, selezionare I'll always be sending messages on this porte quindi fare clic su Avanti.

7. Fare clic su Fine.

Aggiungere una forma Trasmissione all'orchestrazione

1. In Orchestrazioni BizTalk nella casella degli strumenti trascinare una forma Invia nella Designer orchestrazione. Posizionarlo sotto la Receive_PO forma Ricezione.

2. Fare clic con il pulsante destro del mouse sulla forma Invia, quindi scegliere Finestra Proprietà.

3. Digitare Send_PO il campo Nome .

4. Selezionare Message_PO per la proprietà Message .

5. Selezionare SendPurchaseOrder.PurchaseOrderOperation.Request per la proprietà Operation . La porta verrà associata alla forma Trasmissione in Progettazione orchestrazioni.

Aggiungere una forma Decisione all'orchestrazione

1. In Orchestrazioni BizTalk nella casella degli strumenti trascinare una forma Decide nella Designer orchestrazione. Posizionarlo sotto la Send_PO forma Invia.

2. Fare clic con il pulsante destro del mouse sulla forma Decide e quindi scegliere Finestra Proprietà.

3. Digitare NeedsApproval il campo Nome .

4. In Orchestrazione Designer fare clic su Rule_1 sulla forma Decide.

5. In Proprietà Windows digitare ApprovalRequired per la proprietà Name .

6. Fare clic sul campo proprietà Espressione e quindi sul pulsante con i puntini di sospensione (...).

7. Nell'Editor espressioni BizTalk digitare o copiare quanto segue:

   Message_PO(OrderProcess.PropertySchema.Amount) > 1000  
   

8. Fare clic su OK.

Aggiungere un'altra porta di trasmissione all'orchestrazione

1. In Orchestrazioni BizTalk nella casella degli strumenti trascinare una forma Porta nell'area di attacco. Verrà avviata la Configurazione guidata porta.

2. Nella schermata iniziale fare clic su Avanti.

3. Digitare SendToTasksList il campo Nome e quindi fare clic su Avanti.

4. Selezionare Usa un tipo di porta esistente.

5. In Tipi di porta disponibili selezionare OrderProcess.PurchaseOrderPTe quindi fare clic su Avanti.

6. Nella schermata Associazione porta, in Direzione porta della comunicazione, selezionare I'll always be sending messages on this port.

7. In Associazione porta selezionare Dynamice quindi fare clic su Avanti.

8. Fare clic su Fine.

Aggiungere una forma Trasmissione alla forma Decisione

1. In Orchestrazioni BizTalk nella casella degli strumenti trascinare una forma Invia nella Designer orchestrazione. Posizionarlo sotto la ApprovalRequired forma.

2. Fare clic con il pulsante destro del mouse sulla forma Invia, quindi scegliere Finestra Proprietà

3. Digitare CreateApprovalTask il campo Nome .

4. Selezionare Message_Task per la proprietà Message .

5. Selezionare SendToTasksList.PurchaseOrderOperation.Request per la proprietà Operation . La porta verrà associata alla forma Trasmissione in Progettazione orchestrazioni.

Creare un'espressione

In questa procedura verrà aggiunta una forma Espressione alla soluzione per assegnare il valore di percorso Attività a una variabile. Questa procedura illustra come aggiungere logica a un'orchestrazione per modificare le proprietà di una porta di trasmissione dinamica.

Creare una nuova espressione

1. In Orchestrazioni BizTalk nella casella degli strumenti trascinare una forma Espressione prima della CreateApprovalTask forma Invia.

2. Fare clic con il pulsante destro del mouse sulla forma Espressione, quindi scegliere Finestra Proprietà.

3. Digitare SetPortDestination il campo Nome .

4. Fare clic sul campo proprietà Espressione e quindi sul pulsante con i puntini di sospensione (...).

5. Nell'Editor espressioni BizTalk digitare quanto segue:

   SendToTasksList(Microsoft.XLANGs.BaseTypes.Address) = "wss://localhost/sites/WSSAdapterWalkthrough/Lists/Tasks/";  
   

6. Fare clic su OK.

Costruire un nuovo messaggio

In questa procedura verrà aggiunta una forma Costrutto alla soluzione per costruire una nuova istanza di un tipo di messaggio all'interno dell'orchestrazione. Questa procedura illustra come creare un nuovo messaggio che sia una copia del messaggio in ingresso, quindi modificare le proprietà di contenuto del nuovo messaggio. Questo passaggio è necessario poiché i messaggi non sono modificabili in BizTalk, ovvero dopo avere costruito un messaggio non sarà possibile modificare l'originale.

Aggiungere una forma Costrutto

1. In Orchestrazioni BizTalk nella casella degli strumenti trascinare una forma Costrutto messaggio prima della SetPortDestination forma Espressione.

2. Fare clic con il pulsante destro del mouse sulla forma Costruisci messaggio, quindi scegliere Finestra Proprietà.

3. Digitare ConstructTaskMessageil campo Nome .

4. Selezionare la proprietà Messages Constructed .Select Message_Task for the Messages Constructed property.

5. In Orchestrazioni BizTalk nella casella degli strumenti trascinare una forma Assegnazione messaggi nella ConstructTaskMessage forma Costrutto messaggio.

6. Nella finestra Proprietà digitare InitTaskMessage nel campo Nome .

7. Fare clic sul campo proprietà Espressione e quindi sul pulsante con i puntini di sospensione (...).

8. Nell'Editor espressioni BizTalk digitare o copiare quanto segue:

   Message_Task = Message_PO;  
   Message_Task(WSS.ConfigOverwrite) = "no";  
   Message_Task(WSS.ConfigNamespaceAliases)= "orchns='http://OrderProcess.PurchaseOrder'";  
   Message_Task(WSS.ConfigPropertiesXml) = "<ConfigPropertiesXml><PropertyName1>Title</PropertyName1><PropertySource1>Approve %XPATH=//orchns:PurchaseOrder/orchns:PurchaseOrderID%</PropertySource1><PropertyName3>Status</PropertyName3><PropertySource3>Not Started</PropertySource3><PropertyName4>Priority</PropertyName4><PropertySource4>(1) High</PropertySource4></ConfigPropertiesXml>";  
   

   Importante

   Per questi valori forniti per queste proprietà di contesto è rilevante la distinzione tra maiuscole e minuscole. Quando si impostano i valori di configurazione per la porta dinamica con proprietà di contesto, è necessario verificare che venga applicata la distinzione tra maiuscole e minuscole. In caso contrario, si verificherà un errore quando BizTalk tenta di instradare il documento verso la porta di trasmissione designata.

9. Fare clic su OK.

10. Fare clic su File, quindi su Salva tutto.

Creare il progetto BizTalk

In questa procedura verrà generato e distribuito il progetto BizTalk. Questo passaggio è necessario per creare e distribuire l'assembly che BizTalk Server usa in fase di esecuzione.

Compilare e distribuire la soluzione

1. Fare clic su Compila e quindi su Compila OrderProcess.

2. Fare clic su Compila e quindi su Distribuisci OrderProcess.

3. Chiudere Microsoft Visual Studio.

Modificare l'indirizzo di ricezione e la porta di trasmissione

In questa procedura vengono modificati l'indirizzo di ricezione e la porta di trasmissione esistenti, in modo da utilizzare l'elaborazione XML per le pipeline. La pipeline XML di ricezione rende persistenti le proprietà dei messaggi utilizzate durante l'elaborazione dell'orchestrazione e la pipeline XML di trasmissione rende persistenti le proprietà dei messaggi applicate all'orchestrazione, che vengono utilizzate successivamente per il routing dei messaggi.

Modificare l'indirizzo di ricezione

1. Fare clic sul pulsante Start, scegliere Tutti i programmi, MicrosoftBizTalk Server, quindi fare clic su amministrazione BizTalk Server.

2. Espandere MicrosoftBizTalk ServerAdministration SnapIn, espandere Gruppo BizTalk, applicazioni, espandere Applicazione BizTalk 1 e quindi fare clic sul nodo Percorsi di ricezione.

3. Fare clic con il pulsante destro del mouse su SourceLocatione quindi scegliere Proprietà.

4. Nella finestra di dialogo Proprietà località di ricezione , in Generale, selezionare XMLReceive per la proprietà Receive pipeline .

5. Fare clic su OK.

Modificare la porta di trasmissione

1. Fare clic sul nodo Porte di trasmissione .

2. Fare clic con il pulsante destro del mouse su SendToDestinatione quindi scegliere Proprietà.

3. Nella finestra di dialogo Proprietà porta di trasmissione, in Generale, selezionare XMLTransmit per la proprietà Invia pipeline .

4. Selezionare la scheda Filtri .

5. Selezionare la condizione esistente, premere CANC e quindi fare clic su OK.

Avviare una nuova porta di trasmissione

1. Fare clic sul nodo Porte di trasmissione .

2. Fare clic con il pulsante destro del mouse su OrderProcess_1.0.0.0_OrderProcess.MyCompanyOrderProcess_SendToTasksList_<GUID>e quindi scegliere Avvia.

Nota

Se non è visibile, potrebbe essere necessario aggiornare la console.

Associazione dell'orchestrazione

In questa procedura verrà eseguito il binding dell'orchestrazione alle porte specificate. Questa procedura è necessaria per associare le porte fisiche all'orchestrazione generata e distribuita.

Associazione dell'orchestrazione

1. Nella console di amministrazione di BizTalk Server fare clic sul nodo Orchestrazioni.

2. Fare clic con il pulsante destro del mouse sull'orchestrazione OrderProcess.MyCompanyOrderProcessing e quindi scegliere Proprietà.

3. Selezionare la scheda Associazioni .

4. In Host selezionare BizTalkServerApplication nel campo Host .

5. In Associazioni selezionare FromSource la ReceivePurchaseOrder porta logica in ingresso.

6. In Associazioni selezionare SendToDestination la SendPurchaseOrder porta logica in uscita.

7. Fare clic su OK.

8. Fare clic con il pulsante destro del mouse sull'orchestrazione OrderProcess.MyCompanyOrderProcessing e quindi scegliere Avvia.

Inviare un messaggio tramite il sistema

In questa procedura verrà creato un modulo di InfoPath che sarà quindi caricato nel sito Web di Windows SharePoint Services. L'adapter Windows SharePoint Services riceverà il messaggio, lo archivierà nella Raccolta documenti di archiviazione e lo invierà alla Raccolta documenti di destinazione. Durante l'elaborazione di questo messaggio, viene effettuato l'accesso alle proprietà di contesto di Windows SharePoint Services al fine di determinare la destinazione.

Creare un modulo di InfoPath per l'invio tramite il sistema

1. Aprire un Web browser e passare all'URL del sito creato, Ad esempio: http://<server_name>/sites/WSSAdapterWalkthrough.

2. Nel menu Avvio rapido fare clic su InfoPathSolutions.

3. Fare clic sul PurchaseOrder file per visualizzare la finestra di dialogo Download file e quindi fare clic su Apri. Il modulo verrà caricato in InfoPath.

4. Nel campo Purchase Order ID (ID ordine di acquisto ) digitare 1003.

5. Nel campo Fattura a digitare John Doe.

6. Nel campo Amount digitare 1750.

7. Nel campo Data ordine acquisto digitare 1/3/2005.

8. Fare clic su Save (Salva).

9. Nella finestra di dialogo Salva con nome digitare http://<server_name>/sites/WSSAdapterWalkthrough/Sourcenel campo nome file e quindi premere INVIO.

10. Digitare PurchaseOrder3.xml il campo nome file e quindi fare clic su Salva.

11. Chiudere InfoPath.

12. Nel Web browser fare clic su Documenti ed elenchi.

13. In Raccolte documenti fare clic su Destinazione.

14. Nella raccolta documenti di destinazione verrà ora visualizzato il messaggio presente in questa raccolta. Una copia del messaggio sarà inoltre disponibile nella raccolta documenti di archiviazione.

15. Fare clic su Home.

16. In Elenchi fare clic su Attività.

17. Nell'elenco attività verrà visualizzata l'attività di approvazione appena creata.

Nota

Poiché l'importo dell'ordine di acquisto è superiore a $1.000,00, l'attività è stata creata.

Riepilogo

In questa procedura guidata è stato illustrato come accedere alle proprietà di contesto di Windows SharePoint Services e come determinare la destinazione di messaggi che attraversano porte dinamiche.

Passaggi successivi

Continuare a esaminare la parte rimanente della sezione relativa all'adapter Windows SharePoint Services. Per ulteriori informazioni, vedere gli argomenti disponibili in Vedere anche.

Vedere anche

Informazioni sull'adapter Windows SharePoint Services
Procedure dettagliate relative all'adapter Windows SharePoint Services