Procedura dettagliata: creazione e debug di una soluzione flusso di lavoro SharePoint

Articolo
08/11/2011

In questa procedura dettagliata viene illustrato come creare un modello di base di flusso di lavoro sequenziale. Il flusso di lavoro controlla una proprietà di una raccolta documenti condivisa per determinare se un documento è stato rivisto. In caso positivo, il flusso di lavoro viene terminato.

Vengono illustrate le attività seguenti:

Creazione di un progetto flusso di lavoro sequenziale per la definizione dell'elenco di SharePoint in Visual Studio.
Creazione di attività del flusso di lavoro.
Gestione degli eventi di attività del flusso di lavoro.

Nota

Sebbene in questa procedura dettagliata venga utilizzato un progetto flusso di lavoro sequenziale, il processo è identico per un progetto flusso di lavoro macchina a stati.

Inoltre, sul computer potrebbero essere visualizzati nomi o percorsi diversi per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti. L'edizione di Visual Studio in uso e le impostazioni utilizzate determinano questi elementi. Per ulteriori informazioni, vedere Gestione delle impostazioni.

Prerequisiti

Per completare la procedura dettagliata, è necessario disporre dei componenti seguenti:

Edizioni supportate di Microsoft Windows e SharePoint. Per ulteriori informazioni, vedere Requisiti per lo sviluppo di soluzioni SharePoint.
Visual Studio 2010.

Aggiunta di proprietà alla raccolta Documenti condivisi di SharePoint

Per tenere traccia dello stato di revisione dei documenti nella raccolta Documenti condivisi, saranno create tre nuove proprietà per i documenti condivisi nel sito di SharePoint: Status, Assignee e Review Comments. Tali proprietà sono definite nella raccolta Documenti condivisi.

Per aggiungere proprietà alla raccolta Documenti condivisi di SharePoint

Aprire un sito di SharePoint, ad esempio http://<nome del sistema>/SitePages/Home.aspx, in un browser.
Nella barra Avvio veloce scegliere Documenti condivisi.
Selezionare Raccolta sulla barra multifunzione Strumenti raccolta, quindi fare clic sul pulsante Crea colonna sulla barra multifunzione per creare una nuova colonna.
Assegnare un nome alla colonna Stato documento, impostarne il tipo su Scelta (menu in cui eseguire una selezione), specificare le tre scelte seguenti, quindi scegliere OK:
- Review Needed
- Review Complete
- Changes Requested
Creare altre due colonne e denominarle Assignee e Review Comments. Impostare il tipo della colonna Assignee come singola riga di testo e il tipo della colonna Review Comments come più righe di testo.

Possibilità di modifica dei documenti senza necessità di estrazione

Il test del modello di flusso di lavoro risulta più facile quando è possibile modificare i documenti senza doverli estrarre. Nella procedura descritta di seguito, viene configurato il sito di SharePoint per consentirne l'attivazione.

Per consentire la modifica dei documenti senza estrazione

Nella barra Avvio veloce scegliere Documenti condivisi.
Selezionare Raccolta sulla barra multifunzione Strumenti raccolta, quindi fare clic sul pulsante Impostazioni raccolta per visualizzare la pagina Impostazioni raccolta documenti.
Nella sezione Impostazioni generali fare clic su Impostazioni controllo versioni per visualizzare la pagina Impostazioni controllo versioni.
Verificare che l'impostazione per Estrazione obbligatoria dei documenti prima della modifica sia No. Se non lo è, selezionare No e fare clic su OK.
Chiudere il browser.

Creazione di un progetto Flusso di lavoro sequenziale SharePoint

Un flusso di lavoro sequenziale è un set di passaggi eseguiti in ordine fino al completamento dell'ultima attività. In questa procedura si crea un flusso di lavoro sequenziale che verrà applicato all'elenco Documenti condivisi. La procedura guidata del flusso di lavoro consente di associare quest'ultimo alla definizione di sito o alla definizione di elenco, nonché di determinare quando verrà avviato.

Per creare un progetto Flusso di lavoro sequenziale SharePoint

Avviare Visual Studio e visualizzare la finestra di dialogo Nuovo progetto scegliendo Nuovo dal menu File e facendo clic su Progetto.
Espandere il nodo SharePoint sotto Visual C# o Visual Basic, quindi fare clic su 2010.
Nel riquadro Modelli selezionare Flusso di lavoro sequenziale.
Nella casella di testo Nome digitare MySharePointWorkflow, quindi fare clic su OK.

Verrà visualizzata la Personalizzazione guidata SharePoint.
Nella pagina Specificare il sito e il livello di sicurezza per il debug fare clic su Avanti per accettare il sito e il livello di attendibilità predefiniti.

Questo passaggio consente di impostare il livello di attendibilità per la soluzione come soluzione della farm, ovvero l'unica opzione disponibile per i progetti flusso di lavoro. Per ulteriori informazioni, vedere Considerazioni sulle soluzioni create mediante sandbox.
Nella pagina Specificare il nome del flusso di lavoro per il debug accettare il nome predefinito (MySharePointWorkflow - Workflow1). Mantenere il valore predefinito del tipo di modello di flusso di lavoro, Flusso di lavoro elenco, quindi fare clic su Avanti.
Nella pagina Associare automaticamente il flusso di lavoro in una sessione di debug fare clic su Avanti per accettare tutte le impostazioni predefinite.

Questo passaggio consente di associare automaticamente il flusso di lavoro alla raccolta Documenti condivisi.
Nella pagina Specificare le condizioni relative alla modalità di avvio del flusso di lavoro lasciare le opzioni predefinite selezionate nella sezione Selezionare la modalità di avvio del flusso di lavoro e scegliere Fine.

Questa pagina consente di specificare quando viene avviato il flusso di lavoro. Per impostazione predefinita, il flusso di lavoro si avvia quando un utente lo avvia manualmente in SharePoint o quando viene creato un elemento al quale è associato il flusso di lavoro.

Creazione di attività del flusso di lavoro

Nei flussi di lavoro sono contenute una o più attività che rappresentano le azioni da effettuare. Utilizzare Progettazione flussi di lavoro per organizzare le attività per un flusso di lavoro. In questa procedura verranno aggiunte due attività al flusso di lavoro: HandleExternalEventActivity e OnWorkFlowItemChanged. Queste attività consentono di monitorare lo stato di revisione dei documenti nell'elenco Documenti condivisi

Per creare attività del flusso di lavoro

Il flusso di lavoro deve essere visualizzato in Progettazione flussi di lavoro. In caso contrario, fare doppio clic su Workflow1.cs o Workflow1.vb in Esplora soluzioni per aprirlo.
Nella finestra di progettazione fare clic sull'attività OnWorkflowActivated1 per selezionarla.
Nella finestra Proprietà digitare onWorkflowActivated accanto alla proprietà Invoked, quindi premere INVIO.

Viene aperto l'editor del codice e un metodo per la gestione eventi denominato onWorkflowActivated viene aggiunto al file di codice Workflow1.
Tornare a Progettazione flussi di lavoro, aprire la casella degli strumenti, quindi espandere il nodo Windows Workflow v3.0.
Trascinare un'attività While dal nodo Windows Workflow v3.0 della Casella degli strumenti e connetterla alla riga sotto l'attività onWorkflowActivated1.
Fare clic sull'attività WhileActivity1 per selezionarla.
Nella finestra Proprietà impostare Condition sulla condizione relativa al codice.
Espandere la proprietà Condition e digitare isWorkflowPending accanto alla proprietà Condition figlio, quindi premere INVIO.

Viene aperto l'editor di codice e un metodo denominato isWorkflowPending viene aggiunto al file di codice Workflow1.
Tornare a Progettazione flussi di lavoro, aprire la casella degli strumenti, quindi espandere il nodo Flusso di lavoro di SharePoint.
Trascinare un'attività OnWorkflowItemChanged dal nodo Flusso di lavoro di SharePoint della Casella degli strumenti e collegarla alla riga all'interno dell'attività whileActivity1.
Fare clic sull'attività onWorkflowItemChanged1 per selezionarla.
Nella finestra Proprietà impostare le proprietà come mostrato nella tabella riportata di seguito.

Proprietà

Valore

CorrelationToken

workflowToken

Invoked

onWorkflowItemChanged

Proprietà	Valore
CorrelationToken	workflowToken
Invoked	onWorkflowItemChanged

Gestione degli eventi di attività

Infine, controllare lo stato del documento di ogni attività. Se il documento è stato rivisto, il flusso di lavoro è terminato.

Per gestire gli eventi di attività

In Workflow1.cs o Workflow1.vb aggiungere il campo seguente nella parte superiore della classe Workflow1. Questo campo viene utilizzato in un'attività per determinare se il flusso di lavoro è terminato.
```
Dim workflowPending As Boolean = True
```
```
Boolean workflowPending = true;
```
Aggiungere il seguente metodo alla classe Workflow1. Questo metodo controlla il valore della proprietà Document Status dell'elenco Documenti per determinare se il documento è stato rivisto. Se la proprietà Document Status è impostata su Review Complete, il metodo checkStatus imposta il campo workflowPending su false per indicare che il flusso di lavoro è pronto per essere terminato.
```
Private Sub checkStatus()
    If CStr(workflowProperties.Item("Document Status")) = "Review Complete" Then
        workflowPending = False
    End If
End Sub 
```
```
private void checkStatus()
{
    if ((string)workflowProperties.Item["Document Status"] == "Review Complete")
    workflowPending = false;
}
```
Aggiungere il codice riportato di seguito ai metodi onWorkflowActivated e onWorkflowItemChanged per chiamare il metodo checkStatus. Quando viene avviato il flusso di lavoro, il metodo onWorkflowActivated chiama il metodo checkStatus per determinare se il documento è già stato rivisto. In caso negativo, il flusso di lavoro continua. Quando il documento viene salvato, il metodo onWorkflowItemChanged chiama nuovamente il metodo checkStatus per determinare se il documento è stato rivisto. Finché il campo workflowPending è impostato su true, l'esecuzione del flusso di lavoro continua.
```
Private Sub onWorkflowActivated(ByVal sender As System.Object, ByVal e As System.Workflow.Activities.ExternalDataEventArgs)
    checkStatus()
End Sub

Private Sub onWorkflowItemChanged(ByVal sender As System.Object, ByVal e As System.Workflow.Activities.ExternalDataEventArgs)
    checkStatus()
End Sub
```
```
private void onWorkflowActivated(object sender, ExternalDataEventArgs e)
{
    // Check the status.
    checkStatus();
}

private void onWorkflowItemChanged(object sender, ExternalDataEventArgs e)
{
    // Check the status.
    checkStatus();
}
```
Aggiungere il codice riportato di seguito al metodo isWorkflowPending per controllare lo stato della proprietà workflowPending. Ogni volta che il documento viene salvato, l'attività whileActivity1 chiama il metodo isWorkflowPending. Questo metodo esamina la proprietà Result dell'oggetto ConditionalEventArgs per determinare se l'attività WhileActivity1 deve continuare o essere terminata. Se la proprietà è impostata su true, l'attività continua. In caso contrario, l'attività e il flusso di lavoro vengono terminati.
```
Private Sub isWorkflowPending(ByVal sender As System.Object, ByVal e As System.Workflow.Activities.ConditionalEventArgs)
    e.Result = workflowPending
End Sub
```
```
private void isWorkflowPending(object sender, ConditionalEventArgs e)
{
    e.Result = workflowPending;
}
```
Salvare il progetto.

Test del modello di flusso di lavoro SharePoint

Quando si avvia il debugger, Visual Studio consente la distribuzione del modello di flusso di lavoro al server SharePoint e di associare il flusso di lavoro all'elenco Documenti condivisi. Per testare il flusso di lavoro, avviare una relativa istanza da un documento dell'elenco Documenti condivisi.

Per testare il modello di flusso di lavoro SharePoint

In Workflow1.cs o Workflow1.vb impostare un punto di interruzione accanto al metodo onWorkflowActivated.
Premere F5 per compilare ed eseguire la soluzione.

Verrà aperto il sito di SharePoint.
Nel riquadro di navigazione di SharePoint fare clic su Documenti condivisi.
Nella pagina Documenti condivisi fare clic su Documenti nella scheda Strumenti raccolta, quindi fare clic sul pulsante Carica documento per caricare un documento.
Nella finestra di dialogo Carica documento fare clic sul pulsante Sfoglia, selezionare qualsiasi file di documento, fare clic su Apri, quindi su OK.

In questo modo viene caricato il documento selezionato nell'elenco Documenti condivisi e avviato il flusso di lavoro.
In Visual Studio verificare che l'esecuzione del debugger venga interrotta in corrispondenza del punto di interruzione accanto al metodo onWorkflowActivated.
Premere F5 per continuare l'esecuzione.
In questa fase è possibile modificare le impostazioni per il documento, tuttavia per il momento mantenere i valori predefiniti facendo clic su Salva.

In questo modo si torna alla pagina Documenti condivisi del sito Web predefinito di SharePoint.
Nella pagina Documenti condivisi verificare che il valore al di sotto della colonna MySharePointWorkflow sia impostato su In corso. Questa impostazione indica che il flusso di lavoro è in corso e che il documento è in attesa di revisione.
Nella pagina Documenti condivisi puntare al documento, fare clic sulla freccia in giù, quindi su Modifica proprietà.
Impostare Document Status su Revisione completata, quindi scegliere Salva.

In questo modo si torna alla pagina Documenti condivisi del sito Web predefinito di SharePoint.
Nella pagina Documenti condivisi verificare che il valore al di sotto della colonna MySharePointWorkflow sia impostato su Revisione completata. Questa impostazione indica che il flusso di lavoro è stato completato e che il documento è stato rivisto.

Passaggi successivi

Per ulteriori informazioni su come creare modelli di flusso di lavoro, vedere i seguenti argomenti:

Per ulteriori informazioni sulle attività di flusso di lavoro di SharePoint, vedere l'argomento relativo alle attività di flusso di lavoro per SharePoint Foundation (la pagina potrebbe essere in inglese).
Per ulteriori informazioni sulle attività di Windows Workflow Foundation, vedere l'argomento relativo allo spazio dei nomi System.Workflow.Activities (la pagina potrebbe essere in inglese).

Vedere anche

Altre risorse

Creazione di soluzioni flusso di lavoro SharePoint

Modelli di progetto e di elementi di progetto SharePoint

Compilazione e debug delle soluzioni SharePoint

Condividi tramite