Gestione di dati complessi in un flusso di lavoro

Data di pubblicazione: luglio 2016

DynamicValue consente di creare, archiviare e usare strutture di dati. I dati possono essere ricorsivi. In altri termini, un'istanza di DynamicValue può contenere altre istanze di DynamicValues. Le regole di composizione di DynamicValue sono molto semplici: le relative proprietà possono infatti essere primitive, matrici o altre istanze di DynamicValues, in modo analogo a un contenitore di proprietà ricorsivo o un formato di serializzazione JSON.DynamicValue fornisce un meccanismo di contenimento e manipolazione per dati composti con superficie di binding avanzata per WF.

Modalità di archiviazione dei dati di DynamicValue

È possibile considerare DynamicValue come un elenco ricorsivo di coppie chiave-valore. Nella tabella seguente viene rappresentata un'istanza semplice di DynamicValue.

Nella tabella precedente DynamicValue ha due proprietà: Age con valore 42 e Name con valore John Doe. Il nome di una proprietà di DynamicValue è costituito da una stringa e il valore può essere uno dei tipi elencati di seguito oppure null (Nothing in Visual Basic). Per qualsiasi altro tipo passato a DynamicValue viene generata un'eccezione.

• String

• Int32

• Double

• Guid

• Boolean

• DateTime

• TimeSpan

• IList<T>, dove T è uno dei tipi nell'elenco

• IDictionary<string, T>, dove T è uno dei tipi nell'elenco

• DynamicValue

Si noti che DynamicValue è incluso nell'elenco dei tipi supportati. Questo significa che il valore di un'istanza di DynamicValue può essere un'altra istanza di DynamicValue, come illustrato nella tabella seguente.

Customer contiene come valore un'istanza di DynamicValue e tale istanza di DynamicValue contiene Age e Name. Per fare riferimento al valore di Name è possibile usare Customer/Name. Se è presente un riferimento a Customer/Name ma tale valore non è stato ancora creato, verrà aggiunto automaticamente. Questo meccanismo è definito upsert.

DynamicValue supporta anche la nozione di matrice. Per matrice si intende un set di valori primitivi contenuti come valore per un'istanza di DynamicValue. La differenza principale tra un'istanza di DynamicValue di tipo matrice e un'istanza di DynamicValue nidificata consiste nel fatto che gli elementi della matrice non hanno un nome e sono accessibili in base a un indice. Si noti che le matrici possono contenere tipi differenti. Nel valore di matrice per Numbers, i tipi sono Int32 e Double. Nel valore di matrice per Items, i valori sono di tipo DynamicValue nidificato e Int32.

Indirizzamento dei valori in un'istanza di DynamicValue

I valori vengono impostati e recuperati da un'istanza di DynamicValue in base a una notazione di percorso. I percorsi sono stringhe simili a Uri che puntano a una determinata proprietà, in modo analogo alla rappresentazione bidimensionale di una struttura. I percorsi sono composti dal nome di una proprietà, costituito da una stringa, o da un indice relativo a un elemento all'interno di un valore di tipo matrice, costituito da un numero tra parentesi.

Nella sezione precedente sono stati illustrati alcuni esempi di DynamicValue. Il primo esempio si riferisce a un'istanza di DynamicValue con due valori, come illustrato nella tabella seguente.

Per l'accesso al primo valore, viene usato un percorso costituito dalla proprietà Age che restituisce il valore 42. Per il secondo valore, viene invece usato il percorso Name, che restituisce John Doe.

Nel secondo esempio della sezione precedente sono stati inclusi alcuni valori nidificati, come illustrato nella tabella seguente.

Il percorso costituito dalla proprietà Customer restituisce un'istanza di DynamicValue contenente a sua volta due valori. Il percorso costituito dalla proprietà Company restituisce il valore Contoso Corporation. Per l'accesso ai valori nidificati, viene usato il simbolo / per delineare le proprietà. Mediante questa notazione, il percorso Customer/Age restituisce il valore 42 e il percorso Customer/Name restituisce John Doe.

Per l'accesso ai valori inclusi in una matrice, nel percorso vengono usati gli indici. Nella tabella seguente viene rappresentata l'istanza di DynamicValue della sezione precedente, contenente istanze di DynamicValues di tipo matrice e nidificate.

Nell'istanza di DynamicValue illustrata nella tabella precedente, il percorso Numbers restituisce la prima matrice. Le matrici di DynamicValue sono in base zero. Di conseguenza, Numbers(0) restituisce il primo elemento della matrice, mentre Numbers(3) restituisce il quarto elemento.Items restituisce la seconda matrice e Items(0) restituisce il primo elemento della matrice, che corrisponde a un'istanza di DynamicValue. Per l'accesso ai valori in questa istanza nidificata di DynamicArray, i nomi di proprietà vengono combinati con il percorso che genera la matrice.Items(0)/First restituisce 4 e Items(0)/Second restituisce 5.

È possibile usare i percorsi per creare in modo dichiarativo una struttura di dati composta. I valori possono essere esplicitati in fase di progettazione oppure associati dinamicamente in fase di esecuzione. Nell'esempio seguente viene illustrato un set di percorsi e valori che rappresentano una composizione di un cliente con un indirizzo.

I percorsi e i valori nella tabella precedente creeranno l'istanza di DynamicValue rappresentata dalla tabella seguente.

Il tipo DynamicValue fornisce un metodo Parse per analizzare una stringa JSON e convertirla in un'istanza di DynamicValue. È inoltre disponibile un'attività ParseDynamicValue che può essere usata nei flussi di lavoro per analizzare una stringa JSON e convertirla in un'istanza di DynamicValue.

DynamicValue può essere riconosciuto anche dalle attività HTTP. Se si assegna un'istanza di DynamicValue alla risposta di un'attività HTTP*, come risultato viene generata una stringa JSON, in base alla quale viene creata un'istanza di DynamicValue. Se si passa un'istanza di DynamicValue al corpo della richiesta o si usa tale istanza come contenuto della risposta, vengono aggiunte le intestazioni appropriate per indicare l'utilizzo di JSON.

Utilizzo di DynamicValue nei flussi di lavoro

Oltre al tipo DynamicValue, Progettazione flussi di lavoro 1.0 fornisce anche attività per la creazione e l'utilizzo di DynamicValue nei flussi di lavoro.

Utilizzo di DynamicValue

DynamicValue e le relative attività di supporto consentono la rappresentazione e la manipolazione dei dati in una modalità indipendente dall'host. Di conseguenza, DynamicValue è una funzionalità per flussi di lavoro che può essere usata con qualsiasi host del flusso di lavoro e non è quindi limitata a Progettazione flussi di lavoro 1.0. È infatti possibile usarla con qualsiasi altro host del flusso di lavoro esistente, ad esempio WorkflowInvoker, WorkflowApplication e WorkflowServiceHost.

L'esempio di codice relativo alla gestione di dati complessi in un flusso di lavoro mediante DynamicValue illustra la modalità di utilizzo di questa funzionalità con WorkflowApplication. Alcuni degli altri esempi di No text is specified for bookmark or legacy link '89435d1b-f316-4e02-84a9-971a32bb797d#BKMK_DynamicValueSamples'. illustrano come usare DynamicValue nei flussi di lavoro di Progettazione flussi di lavoro 1.0. L'utilizzo di DynamicValue è indipendente dall'host. Per ogni host varia soltanto la modalità di caricamento dei dati nell'istanza di DynamicValue. Ad esempio, in Progettazione flussi di lavoro 1.0 l'istanza di DynamicValue viene in genere creata come risultato di un'operazione HTTP mediante attività HTTP.