Procedura dettagliata: creazione di un flusso di lavoro con form di associazione e di avvio

Articolo
03/05/2013

In questa procedura dettagliata viene illustrato come creare un flusso di lavoro sequenziale di base in cui è incorporato l'utilizzo di form di associazione e di avvio.Si tratta di form ASPX che consentono di aggiungere parametri a un flusso di lavoro quando viene sottoposto alla prima associazione dall'amministratore di SharePoint (form di associazione) e quando il flusso di lavoro viene avviato dall'utente (form di avvio).

In questa procedura dettagliata viene illustrato uno scenario in cui un utente desidera creare un flusso di lavoro di approvazione per le note spese con i requisiti seguenti:

Quando il flusso di lavoro è associato a un elenco, all'amministratore viene presentato un form di associazione in cui immettere un limite in dollari per le note spese.
I dipendenti caricano le note spese nell'elenco Documenti condivisi, avviano il flusso di lavoro, quindi immettono il totale della spesa nel form di avvio del flusso di lavoro.
Se il totale della nota spese di un dipendente supera il limite stabilito dall'amministratore, viene creata un'attività affinché il responsabile del dipendente approvi la nota spese.Tuttavia, se il totale della nota spese di un dipendente è minore o uguale al limite della spesa, nell'elenco della cronologia del flusso di lavoro viene scritto un messaggio approvato automaticamente.

In questa procedura dettagliata 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 una pianificazione del flusso di lavoro.
Gestione degli eventi di attività del flusso di lavoro.
Creazione di form di associazione e di avvio per il flusso di lavoro.
Associazione del flusso di lavoro.
Avvio manuale del flusso di lavoro.

[!NOTA]

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

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

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.

Creazione di un progetto Flusso di lavoro sequenziale SharePoint

Innanzitutto, creare un progetto flusso di lavoro sequenziale in Visual Studio.Un flusso di lavoro sequenziale è una serie di passaggi eseguiti in ordine fino al completamento dell'ultima attività.In questa procedura si creerà un flusso di lavoro sequenziale che verrà applicato all'elenco Documenti condivisi di SharePoint.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

Sulla barra dei menu, scegliere File, Nuova, Progetto per visualizzare la finestra di dialogo Nuovo progetto.
Espandere il nodo SharePoint in Visual C# o Visual Basicquindi selezionare il nodo 2010.
Nel riquadro Modelli, scegliere il modello di progetto Progetto SharePoint 2010.
Nella casella Nome, immettere ExpenseReport quindi scegliere il pulsante Scegliere OK.

Viene visualizzata la Personalizzazione guidata SharePoint.
Nella pagina Specificare il sito e il livello di sicurezza per il debug, scegliere il pulsante di opzione Distribuisci come soluzione farm quindi scegliere il pulsante Fine per accettare il livello di attendibilità e il sito predefinito.

Questo passaggio consente anche di impostare il livello di attendibilità per la soluzione come soluzione della farm, ovvero l'unica opzione disponibile per i progetti flusso di lavoro.
In Esplora soluzioni, selezionare il nodo del progetto.
Sulla barra dei menu, scegliere Progetto, Aggiungi nuovo elemento.
In Visual C# o Visual Basic, espandere il nodo SharePoint quindi selezionare il nodo 2010.
Nel riquadro Modelli, scegliere il modello Flusso di lavoro sequenziale (solo soluzione farm) quindi scegliere il pulsante Aggiungi.

Viene visualizzata la Personalizzazione guidata SharePoint.
Nella pagina Specificare il nome del flusso di lavoro per il debug accettare il nome predefinito (ExpenseReport - Workflow1).Mantenere il valore predefinito del tipo di modello di flusso di lavoro, ovvero Flusso di lavoro elenco.Scegliere il pulsante Avanti.
Nella pagina Associare automaticamente il flusso di lavoro in una sessione di debug deselezionare la casella che consente di associare automaticamente il modello di flusso di lavoro, se selezionata.

Questo passaggio permette di associare manualmente il flusso di lavoro all'elenco Documenti condivisi in una fase successiva e di visualizzare quindi il form di associazione.
Scegliere il pulsante Fine.

Aggiunta di un form di associazione al flusso di lavoro

Creare un form di associazione con estensione ASPX che viene visualizzato quando l'amministratore di SharePoint associa per la prima volta il flusso di lavoro a un documento della nota spese.

Per aggiungere un form di associazione al flusso di lavoro

Scegliere il nodo Workflow1 in Esplora soluzioni.
Sulla barra dei menu, scegliere Progetto, Aggiungi nuovo elemento per visualizzare la finestra di dialogo Aggiungi nuovo elemento.
Nella visualizzazione struttura ad albero della finestra di dialogo espandere, Visual C# o Visual Basic (a seconda del linguaggio del progetto), espandere il nodo SharePoint quindi selezionare il nodo 2010.
Nell'elenco di modelli, scegliere il modello Form di associazione flusso di lavoro.
Nella casella di testo Nome, immettere ExpenseReportAssocForm.aspx.
Scegliere il pulsante Aggiungi per aggiungere il form al progetto.

Progettazione e codifica del form di associazione

In questa procedura si fornisce funzionalità al form di associazione aggiungendovi controlli e codice.

Per progettare e codificare il form di associazione

Nel form di associazione (ExpenseReportAssocForm.aspx), individuare l'elemento asp:Content con ID="Main".
Subito dopo la prima riga in questo elemento di contenuto, aggiungere il codice seguente per creare un'etichetta e una casella di testo in cui viene richiesto il limite per l'approvazione della spesa (AutoApproveLimit):
```
<asp:Label ID="lblAutoApproveLimit" Text="Auto Approval Limit:" runat="server" />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<asp:TextBox ID="AutoApproveLimit" runat="server" />
<br /><br />
```
Espandere il file ExpenseReportAssocForm.aspx in Esplora soluzioni per visualizzare i file dipendenti.

[!NOTA]

Se il progetto è in Visual Basic, è necessario scegliere il pulsante Visualizzare tutti i file per eseguire questa operazione.
Aprire il menu di scelta rapida per il file ExpenseReportAssocForm.aspx e scegliere Visualizza codice.

Sostituire il metodo GetAssociationData con:

Private Function GetAssociationData() As String
    ' TODO: Return a string that contains the association data that 
    ' will be passed to the workflow. Typically, this is in XML 
    ' format.
    Return Me.AutoApproveLimit.Text
End Function

private string GetAssociationData()
{
    // TODO: Return a string that contains the association data that 
    // will be passed to the workflow. Typically, this is in XML 
    // format.
    return this.AutoApproveLimit.Text;
}

Aggiunta di un form di avvio al flusso di lavoro

Creare il form di avvio che viene visualizzato quando gli utenti eseguono il flusso di lavoro relativo alle note spese.

Per creare un form di avvio

Scegliere il nodo Workflow1 in Esplora soluzioni.
Sulla barra dei menu, scegliere Progetto, visualizzazione Aggiungi nuovo elemento la finestra di dialogo Aggiungi nuovo elemento.
Nella visualizzazione struttura ad albero della finestra di dialogo espandere, Visual C# o Visual Basic (a seconda del linguaggio del progetto), espandere il nodo SharePoint quindi selezionare il nodo 2010.
Nell'elenco di modelli, scegliere il modello Form di avvio del flusso di lavoro.
Nella casella di testo Nome, immettere ExpenseReportInitForm.aspx.
Scegliere il pulsante Aggiungi per aggiungere il form al progetto.

Progettazione e codifica del form di avvio

Fornire funzionalità al form di avvio aggiungendovi controlli e codice.

Per codificare il form di avvio

Nel form di avvio (ExpenseReportInitForm.aspx), individuare l'elemento asp:Content contenente ID="Main".

Subito dopo la prima riga in questo elemento di contenuto, aggiungere il codice seguente per creare un'etichetta e una casella di testo in cui viene visualizzato il limite per l'approvazione della spesa (AutoApproveLimit) immesso nel form di associazione, nonché un'etichetta e una casella di testo aggiuntive per il totale della spesa (ExpenseTotal):

<asp:Label ID="lblAutoApproveLimit" Text="Auto Approval Limit:" runat="server" />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<asp:TextBox ID="AutoApproveLimit" ReadOnly="true" runat="server" />
<br /><br />
<asp:Label ID="lblExpenseTotal" Text="Expense Total:" runat="server" />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<asp:TextBox ID="ExpenseTotal" runat="server" />
<br /><br />

Espandere il file ExpenseReportInitForm.aspx in Esplora soluzioni per visualizzare i file dipendenti.
Aprire il menu di scelta rapida per il file ExpenseReportInitForm.aspx e scegliere Visualizza codice.

Sostituire il metodo Page_Load con l'esempio seguente:

Protected Sub Page_Load(ByVal sender As Object, ByVal e As 
  EventArgs) Handles Me.Load
    InitializeParams()
    Me.AutoApproveLimit.Text = workflowList.WorkflowAssociations(New 
      Guid(associationGuid)).AssociationData
    ' Optionally, add code here to pre-populate your form fields.
End Sub

protected void Page_Load(object sender, EventArgs e)
{
    InitializeParams();
    this.AutoApproveLimit.Text = 
      workflowList.WorkflowAssociations[new 
      Guid(associationGuid)].AssociationData;
}

Sostituire il metodo GetInitiationData con l'esempio seguente:

' This method is called when the user clicks the button to start the workflow.
Private Function GetInitiationData() As String
    Return Me.ExpenseTotal.Text
    ' TODO: Return a string that contains the initiation data that 
    ' will be passed to the workflow. Typically, this is in XML 
    ' format.
    Return String.Empty
End Function

// This method is called when the user clicks the button to start the workflow.        
private string GetInitiationData()
{
    // TODO: Return a string that contains the initiation data that 
    // will be passed to the workflow. Typically, this is in XML 
    // format.
    return this.ExpenseTotal.Text;
}

Personalizzazione del flusso di lavoro

Personalizzare il flusso di lavoro.In un secondo momento si assoceranno due form al flusso di lavoro.

Per personalizzare il flusso di lavoro

Visualizzare il flusso di lavoro in Progettazione flussi di lavoro aprendo Workflow1 nel progetto.
In Casella degli strumenti, espandere il nodo Windows Workflow v3.0 e individuare l'attività IfElse.
Aggiungere questa attività al flusso di lavoro eseguendo uno dei passaggi seguenti:
- Aprire il menu di scelta rapida per l'attività IfElse, scegliere Copia, aprire il menu di scelta rapida per la riga sotto l'attività onWorkflowActivated1 in Progettazione flussi di lavoro e quindi scegliere Incolla.
- Trascinare l'attività IfElse da Casella degli strumentie connetterla alla riga sotto l'attività onWorkflowActiviated1 in Progettazione flussi di lavoro.
Nella casella degli strumenti espandere il nodo Flusso di lavoro di SharePoint e individuare l'attività CreateTask.
Aggiungere questa attività al flusso di lavoro eseguendo uno dei passaggi seguenti:
- Aprire il menu di scelta rapida per l'attività CreateTask, scegliere Copia, aprire il menu di scelta rapida per una delle due aree Attività di trascinamento in all'interno di IfElseActivity1 in Progettazione flussi di lavoro e quindi scegliere Incolla.
- Trascinare l'attività CreateTask da Casella degli strumenti in una delle due aree Attività di trascinamento in all'interno di IfElseActivity1.
Nella finestra Proprietà immettere un valore taskToken per la proprietà CorrelationToken
Espandere la proprietà CorrelationToken scegliendo il segno più () accanto.
Scegliere la freccia a discesa sulla sottoproprietà OwnerActivityName e impostare il valore Workflow1.
Scegliere la proprietà TaskId quindi scegliere il pulsante con i puntini di sospensione () per visualizzare la finestra di dialogo proprietà di associazione.
Scegliere la scheda Associazione a un nuovo membro, scegliere il pulsante di opzione Creare un campo quindi scegliere il pulsante Scegliere OK.
scegliere la proprietà TaskProperties quindi scegliere il pulsante con i puntini di sospensione () per visualizzare la finestra di dialogo proprietà di associazione.
Scegliere la scheda Associazione a un nuovo membro, scegliere il pulsante di opzione Creare un campo quindi scegliere il pulsante Scegliere OK.
In Casella degli strumenti, espandere il nodo Flusso di lavoro di SharePoint e individuare l'attività LogToHistoryListActivity.
Aggiungere questa attività al flusso di lavoro eseguendo uno dei passaggi seguenti:
- Aprire il menu di scelta rapida per l'attività LogToHistoryListActivity, scegliere Copia, aprire il menu di scelta rapida per un'altra area Attività di trascinamento in all'interno di IfElseActivity1 in Progettazione flussi di lavoro e quindi scegliere Incolla.
- Trascinare l'attività LogToHistoryListActivity da Casella degli strumentie rilasciarla nell'altra area Attività di trascinamento in all'interno di IfElseActivity1.

Aggiunta di codice al flusso di lavoro

Aggiungere codice al flusso di lavoro per fornirvi la funzionalità.

Per aggiungere codice al flusso di lavoro

Aprire il menu di scelta rapida per l'attività createTask1 in Progettazione flussi di lavoro e quindi scegliere Visualizza codice.

Aggiungere il seguente metodo:

Private Sub createTask1_MethodInvoking(ByVal sender As 
  System.Object, ByVal e As System.EventArgs)
    createTask1_TaskId1 = Guid.NewGuid
    createTask1_TaskProperties1.AssignedTo = "somedomain\\someuser"
    createTask1_TaskProperties1.Description = "Please approve the 
      expense report"
    createTask1_TaskProperties1.Title = "Expense Report Approval 
      Needed"
End Sub

private void createTask1_MethodInvoking(object sender, EventArgs e)
{
    createTask1_TaskId1 = Guid.NewGuid();
    createTask1_TaskProperties1.AssignedTo = "somedomain\\someuser";
    createTask1_TaskProperties1.Description = "Please approve the 
      expense report";
    createTask1_TaskProperties1.Title = "Expense Report Approval 
      Needed";
}

[!NOTA]

Nel codice sostituire somedomain\\someuser con un dominio e un nome utente per i quali verrà creata un'attività, ad esempio "Office\\JoeSch".Per il test è più semplice sfruttare l'account utilizzato per lo sviluppo.

Sotto il metodo MethodInvoking aggiungere l'esempio seguente:

Private Sub checkApprovalNeeded(ByVal sender As Object, ByVal e As 
  ConditionalEventArgs)
    Dim approval As Boolean = False
    If (Convert.ToInt32(workflowProperties.InitiationData) > 
      Convert.ToInt32(workflowProperties.AssociationData)) Then
        approval = True
    End If
    e.Result = approval
End Sub

private void checkApprovalNeeded(object sender, ConditionalEventArgs 
  e)
{
    bool approval = false;
    if (Convert.ToInt32(workflowProperties.InitiationData) > 
      Convert.ToInt32(workflowProperties.AssociationData))
    {
        approval = true;
    }
    e.Result = approval;
}

In Progettazione flussi di lavoro, scegliere l'attività ifElseBranchActivity1.
Nella finestra Proprietà, scegliere la freccia a discesa della proprietà Condizione quindi impostare il valore Code Condition.
Espandere la proprietà Condizione scegliendo il segno più () accanto a essa valore a checkApprovalNeeded.
In Progettazione flussi di lavoro, aprire il menu di scelta rapida per l'attività logToHistoryListActivity1 quindi scegliere Generare i gestori per generare un metodo vuoto per l'evento MethodInvoking.

Sostituire il codice MethodInvoking con quanto segue:

Private Sub logToHistoryListActivity1_MethodInvoking(ByVal sender As 
  System.Object, ByVal e As System.EventArgs)
    Me.logToHistoryListActivity1.HistoryOutcome = ("Expense was auto 
      approved for " + workflowProperties.InitiationData)
End Sub

private void logToHistoryListActivity1_MethodInvoking(object sender, 
  EventArgs e)
{
    this.logToHistoryListActivity1.HistoryOutcome = "Expense was 
      auto approved for " + workflowProperties.InitiationData;
}

Scegliere il tasto F5 per eseguire il debug del programma.

In questo modo l'applicazione viene compilata, assemblata, distribuita e ne vengono attivate le funzionalità; inoltre viene riciclato il pool di applicazioni IIS, quindi avviato il browser nel percorso specificato nella proprietà URL sito.

Associazione del flusso di lavoro all'elenco documenti

Visualizzare il form di associazione del flusso di lavoro associando il flusso di lavoro all'elenco Documenticondivisi sul sito di SharePoint.

Per associare il flusso di lavoro

Scegliere il collegamento Documenti condivisi nella barra avvio veloce.
Scegliere il collegamento Libreria nella scheda Strumenti raccolte quindi scegliere il pulsante della barra multifunzione Impostazioni di libreria.
Nella sezione autorizzazioni e gestione, scegliere il collegamento Impostazioni del flusso di lavoro quindi scegliere il collegamento Aggiungi flusso di lavoro nella pagina Flussi di lavoro.
Nell'elenco di primo livello nel flusso di lavoro delle impostazioni, scegliere il modello ExpenseReport - Workflow1.
Nel campo successivo, immettere ExpenseReportWorkflow quindi scegliere il pulsante Avanti.

In questo modo il flusso di lavoro viene associato all'elenco Documenti condivisi e viene visualizzato il form di associazione del flusso di lavoro.
Nella casella di testo Limite per l'approvazione automatica, immettere 1200 e quindi scegliere il pulsante Associa flusso di lavoro.

Avvio del flusso di lavoro

Associare il flusso di lavoro a uno dei documenti dell'elenco Documenti condivisi per visualizzare il form di avvio del flusso di lavoro.

Per avviare il flusso di lavoro

Nella pagina di SharePoint, scegliere il pulsante Pagina iniziale.
Scegliere il collegamento Documenti condivisi nella barra avvio veloce per visualizzare l'elenco Documenti condivisi.
Scegliere il collegamento Documenti nella scheda Strumenti raccolte parte superiore della pagina e quindi scegliere il pulsante Carica documento sulla barra multifunzione per caricare un nuovo documento nell'elenco Documenti condivisi.
Nella finestra di dialogo Carica documento, scegliere il pulsante Sfoglia, selezionare qualsiasi file di documento, scegliere il pulsante Aperto quindi scegliere il pulsante Scegliere OK.

È possibile modificare le impostazioni del documento nella finestra di dialogo, mentre per mantenere i valori predefiniti scegliendo il pulsante Salva.
Scegliere il documento caricato, scegliere la freccia a discesa visualizzata quindi selezionare l'elemento Flussi di lavoro.
Selezionare l'immagine accanto a ExpenseReportWorkflow.

In questo modo viene visualizzato il form di avvio del flusso di lavoro.Notare che il valore visualizzato nella casella Auto Approval Limit è di sola lettura poiché è stato immesso nel form di associazione.
Nella casella di testo Totale della spesa, immettere 1600 e quindi scegliere il pulsante Avvia flusso di lavoro.

In questo modo viene visualizzato nuovamente l'elenco Documenti condivisi.Una nuova colonna denominata ExpenseReportWorkflow con il valore Completato viene aggiunta all'elemento appena avviato dal flusso di lavoro.
Scegliere la freccia a discesa accanto al documento caricato e quindi selezionare l'elemento Flussi di lavoro per visualizzare la pagina dello stato del flusso di lavoro.Scegliere il valore Completata in flussi di lavoro completati.L'attività viene elencata sotto la sezione Attività.
Scegliere il titolo dell'attività per visualizzarne i dettagli.
Tornare all'elenco Documenticondivisi e riavviare il flusso di lavoro utilizzando lo stesso documento o uno diverso.
Immettere una quantità la pagina di avvio inferiore o uguale a quello immesso nella pagina di associazione (1200).

In tal caso, nell'elenco della cronologia viene creata una voce anziché un'attività.La voce viene visualizzata nella sezione Cronologia flusso di lavoro della pagina dello stato del flusso di lavoro.Notare il messaggio nella colonna Risultato dell'evento di cronologia.È contenuto il testo immesso nell'evento logToHistoryListActivity1.MethodInvoking in cui è incluso l'importo che è stato approvato automaticamente.

Passaggi successivi

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

Per ulteriori informazioni sui flussi di lavoro di SharePoint, vedere l'articolo relativo ai flussi di lavoro in Windows SharePoint Services (la pagina potrebbe essere in inglese).

Vedere anche

Attività

Procedura dettagliata: aggiungere una pagina dell'applicazione a un flusso di lavoro

Altre risorse

Creazione di soluzioni flusso di lavoro SharePoint

Condividi tramite