Gestione dell'istanza sospesa

  • Articolo

L'esempio SuspendedInstanceManagement illustra come gestire le istanze del flusso di lavoro che sono state sospese. L'azione predefinita per l'oggetto WorkflowUnhandledExceptionBehavior è AbandonAndSuspend. Pertanto, per impostazione predefinita, le eccezioni non gestite generate da un'istanza del flusso di lavoro ospitata nell'oggetto WorkflowServiceHost comporteranno l'eliminazione dell'istanza dalla memoria (abbandonata) e la versione durevole/persistente dell'istanza sarà contrassegnata come sospesa. Non sarà possibile eseguire un'istanza del flusso di lavoro sospesa finché non viene annullata la sospensione.

Nell'esempio viene illustrata l'implementazione di un'utilità della riga di comando per eseguire query per le istanze sospese e viene mostrato come consentire all'utente di riprendere o terminare l'istanza. In questo esempio, un servizio flusso di lavoro genera intenzionalmente un'eccezione, comportandone la sospensione. L'utilità della riga di comando può essere quindi usata per eseguire query per l'istanza e, successivamente, per riprendere o terminare l'istanza.

Dimostra

WorkflowServiceHost con WorkflowUnhandledExceptionBehavior e WorkflowControlEndpoint in Windows Workflow Foundation.

Discussione

L'utilità della riga di comando implementata in questo esempio è specifica per l'implementazione dell'archivio di istanze SQL fornito con .NET Framework 4.6.1. Se si dispone di un'implementazione personalizzata dell'archivio di istanze, è possibile adattare questa utilità sostituendo le implementazioni WorkflowInstanceCommand dell'esempio con le implementazioni specifiche dell'archivio di istanze.

L'implementazione fornita esegue direttamente i comandi SQL nell'archivio di istanze SQL per elencare le istanze sospese e si basa su un oggetto WorkflowControlEndpoint aggiunto all'oggetto WorkflowServiceHost per riprendere o terminare le istanze.

Per impostare, compilare ed eseguire l'esempio

  1. Per questo esempio è necessario aver abilitato i seguenti componenti di Windows:

    1. Microsoft Message Queue (MSMQ) Server

    2. SQL Server Express

  2. Impostare il database SQL Server.

    1. Da un prompt dei comandi di Visual Studio eseguire "setup.cmd" dalla directory di esempio SuspendedInstanceManagement al fine di:

      1. Creare un database di persistenza tramite SQL Server Express. Se il database di persistenza è già presente, viene eliminato e ricreato

      2. Impostare il database per la persistenza.

      3. Aggiungere IIS APPPOOL\DefaultAppPool e NT AUTHORITY\Network Service al ruolo InstanceStoreUsers definito durante l'impostazione del database per la persistenza.

  3. Impostare la coda del servizio.

    1. In Visual Studio fare clic con il pulsante destro del mouse sul progetto SampleWorkflowApp e scegliere Imposta come progetto di avvio.

    2. Compilare ed eseguire SampleWorkflowApp premendo F5. In questo modo verrà creata la coda richiesta.

    3. Premere INVIO per arrestare SampleWorkflowApp.

    4. Aprire la console Gestione computer eseguendo Compmgmt.msc da un prompt dei comandi.

    5. Espandere Servizi e applicazioni, Accodamento messaggi, Code private.

    6. Fare clic con il pulsante destro del mouse sulla coda ReceiveTx e scegliere Proprietà.

    7. Selezionare la scheda Sicurezza e assegnare a Tutti le autorizzazioni relative a Ricevi messaggio, Visualizza messaggio e Invia messaggio.

  4. A questo punto, eseguire l'esempio.

    1. In Visual Studio eseguire di nuovo il progetto SampleWorkflowApp senza debug premendo CTRL+F5. Nella finestra della console saranno stampati due indirizzi endpoint: uno per l'endpoint dell'applicazione e l'altro per l'oggetto WorkflowControlEndpoint. Viene quindi creata un'istanza del flusso di lavoro e i record di rilevamento per tale istanza saranno visualizzati nella finestra della console. L'istanza del flusso di lavoro genererà un'eccezione che comporterà la sospensione e l'interruzione dell'istanza.

    2. L'utilità della riga di comando può essere quindi usata per eseguire ulteriori azioni in qualsiasi istanza. Di seguito è riportata la sintassi per gli argomenti della riga di comando:

      SuspendedInstanceManagement -Command:[CommandName] -Server:[ServerName] -Database:[DatabaseName] -InstanceId:[InstanceId]

      I comandi supportati sono: Query, Resume e Terminate. L'opzione InstanceId è richiesta solo per le operazioni Resume e Terminate.

Per eseguire la pulizia (facoltativo)

  1. Aprire la console Gestione computer eseguendo Compmgmt.msc.

  2. Espandere Servizi e applicazioni, Accodamento messaggi, Code private.

  3. Eliminare la coda ReceiveTx.

  4. Per rimuovere il database di persistenza, eseguire cleanup.cmd.