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

Articolo
08/11/2011

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 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.

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

Visualizzare la finestra di dialogo Nuovo progetto selezionando Nuovo nel menu File, quindi fare clic su Nuovo 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 Nome digitare ExpenseReport, quindi fare clic su OK.

Viene visualizzata la Personalizzazione guidata SharePoint.
Nella pagina Selezionare il sito locale da utilizzare per il debug fare clic su Avanti per accettare 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.
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 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 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 da Esplora soluzioni.
Fare clic su Aggiungi nuovo elemento nel menu Progetto 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 fare clic su 2010.
Nell'elenco di modelli selezionare Form di associazione flusso di lavoro.
Nella casella di testo Nome digitare ExpenseReportAssocForm.aspx.
Fare clic sul 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 fare clic sul pulsante Mostra tutti i file per effettuare questo passaggio.
Fare clic con il pulsante destro del mouse sul file ExpenseReportAssocForm.aspx, quindi selezionare 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 da Esplora soluzioni.
Fare clic su Aggiungi nuovo elemento nel menu Progetto 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 fare clic su 2010.
Nell'elenco di modelli selezionare Form di avvio del flusso di lavoro.
Nella casella di testo Nome digitare ExpenseReportInitForm.aspx.
Fare clic sul 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 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 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.
Fare clic con il pulsante destro del mouse sul file ExpenseReportInitForm.aspx, quindi selezionare 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 facendo doppio clic su Workflow1 nel progetto.
Nella casella degli strumenti espandere il nodo Windows Workflow v3.0 e individuare l'attività IfElse.
Aggiungere questa attività al flusso di lavoro trascinandola nella finestra di progettazione e rilasciandola solo sotto l'attività onWorkflowActivated1 nel flusso di lavoro. In questo modo, nella finestra di progettazione viene creata un'attività denominata IfElseActivity1.
Nella casella degli strumenti espandere il nodo Flusso di lavoro di SharePoint e individuare l'attività CreateTask.
Aggiungere questa attività al flusso di lavoro trascinandola in una delle due aree Rilascia attività qui all'interno di IfElseActivity1.
Nella finestra Proprietà immettere un valore taskToken per la proprietà CorrelationToken
Espandere la proprietà CorrelationToken facendo clic sul segno più () accanto a essa.
Fare clic sulla freccia a discesa sulla sottoproprietà OwnerActivityName e selezionare Workflow1.
Fare clic sulla proprietà TaskId, quindi sul pulsante con i puntini di sospensione () per visualizzare la finestra di dialogo Associa proprietà.
Fare clic sulla scheda Associa a un nuovo membro, selezionare Crea campo, quindi OK.
Fare clic sulla proprietà TaskProperties, quindi sul pulsante con i puntini di sospensione () per visualizzare la finestra di dialogo Associa proprietà.
Fare clic sulla scheda Associa a un nuovo membro, selezionare Crea campo, quindi OK.
Nella casella degli strumenti espandere il nodo Flusso di lavoro di SharePoint e individuare l'attività LogToHistoryListActivity.
Aggiungere questa attività al flusso di lavoro trascinandola nell'altra area Rilascia attività qui 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

Fare doppio clic sull'attività createTask1 in Progettazione flussi di lavoro per generare un metodo vuoto per l'evento MethodInvoking.

Sostituire il metodo MethodInvoking con:

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 fare clic sull'attività ifElseBranchActivity1.
Nella finestra Proprietà fare clic sulla freccia a discesa della proprietà Condition e selezionare Code Condition.
Espandere la proprietà Condition facendo clic sul segno più () accanto a essa, quindi impostarne il valore su checkApprovalNeeded.
In Progettazione flussi di lavoro fare clic con il pulsante destro del mouse sull'attività logToHistoryListActivity1 e selezionare Genera 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;
}

Premere 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 Documenti condivisi sul sito di SharePoint.

Per associare il flusso di lavoro

Scegliere Documenti condivisi dalla barra Avvio veloce.
Selezionare Raccolta sulla scheda della barra multifunzione Strumenti raccolta, quindi fare clic sul pulsante della barra multifunzione Impostazioni raccolta.
Nella sezione Autorizzazioni e gestione fare clic sul collegamento Impostazioni flusso di lavoro, quindi selezionare il collegamento Aggiungi flusso di lavoro nella pagina Flussi di lavoro.
Nell'elenco di primo livello nella pagina delle impostazioni del flusso di lavoro selezionare il modello ExpenseReport - Workflow1.
Nel campo successivo digitare ExpenseReportWorkflow, quindi fare clic sul 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 Auto Approval Limit digitare 1200, quindi fare clic sul 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 SharePoint fare clic sul pulsante Pagina iniziale, quindi visualizzare l'elenco Documenti condivisi sul sito di SharePoint facendo clic sul collegamento Documenti condivisi della barra Avvio veloce.
Caricare un nuovo documento nell'elenco Documenti condivisi facendo clic sul collegamento Documenti nella scheda Strumenti raccolta nella parte superiore della pagina e selezionando il pulsante Carica documento sulla barra multifunzione.
Spostare il mouse sul documento caricato per visualizzare una freccia a discesa. Fare clic su quest'ultima e selezionare Flussi di lavoro.
Fare clic sull'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 Expense Total digitare 1600, quindi fare clic su 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.
Fare clic sulla freccia a discesa accanto al documento caricato, quindi selezionare Flussi di lavoro per visualizzare la pagina dello stato del flusso di lavoro. Scegliere il valore Completato sotto Flussi di lavoro completati. L'attività viene elencata sotto la sezione Attività.
Fare clic sul titolo dell'attività per visualizzarne i dettagli.
Tornare all'elenco Documenti condivisi e riavviare il flusso di lavoro utilizzando lo stesso documento o uno diverso.
Nella pagina di avvio immettere un importo minore 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