Riferimento ai functoid cumulativi

 

Usare functoid cumulativi per eseguire vari tipi di operazioni di accumulo per i valori che si verificano più volte all'interno di un messaggio di istanza. Ad esempio, è possibile usare il functoid Somma cumulativa per fornire il totale combinato per un valore che si verifica in più record all'interno di un ambito specificato in un messaggio di istanza.

In Microsoft BizTalk Server, tutti i functoid cumulativi accettano due parametri di input, il secondo di cui è un parametro di ambito facoltativo che non è stato usato nei functoid cumulativi nelle versioni precedenti di BizTalk Server. I due parametri sono:

• Parametro 1: Valore da accumulare. Questo valore deve essere numerico per tutti i functoid cumulativi diversi dal functoid cumulativo concatenato , che prevede un valore stringa. Questo valore viene fornito creando un collegamento tra un attributo Field, un elemento Field o Record (con la relativa proprietà Mista impostata su True) che ha un tipo di dati appropriato e il functoid cumulativo .

  Nota

  Se nessuno dei nodi record del predecessore nell'albero dello schema viene ripetuto, l'uso di un functoid cumulativo è senza punti.

• Parametro 2: Ambito a cui deve essere accumulato il valore specificato come primo parametro. Questo valore numerico facoltativo indica il grado di "correlazione" che devono avere i valori specificati in un messaggio di istanza per poter partecipare all'accumulo, come illustrato di seguito:

  • Il valore predefinito zero (0) indica che il valore dell'elemento o dell'attributo, come indicato dal nome del relativo elemento o attributo, deve essere accumulato nell'intero messaggio di istanza.

  • Un valore di ambito pari a uno (1) indica che devono essere accumulati soltanto i valori di elementi o attributi che hanno lo stesso elemento padre.

  • Un valore di ambito pari a due (2) indica che devono essere accumulati soltanto i valori di elementi o attributi che hanno lo stesso elemento superiore di due livelli e così via.

Nota

Tutti i functoid cumulativi forniscono compatibilità con le versioni precedenti con Microsoft BizTalk Server 2000 e Microsoft BizTalk Server 2002, entrambi necessari un solo parametro di input. Il parametro di ambito predefinito è zero (0), ovvero un ambito dell'intero messaggio di istanza.

Per altre informazioni concettuali sui functoid cumulativi , incluso il parametro di ambito, vedere Functoid cumulativi.

La tabella seguente mostra i functoid nella categoria Cumulativa .

Functoid cumulativi	Descrizione
Media cumulativa	Calcola la media accumulata di un valore numerico che ricorre all'interno di messaggi di istanza corrispondenti.
Concatenazione cumulativa	Concatena più istanze di un valore stringa che ricorre all'interno di messaggi di istanza corrispondenti.
Massimo cumulativo	Determina il valore massimo di un valore numerico che ricorre all'interno di messaggi di istanza corrispondenti.
Minimo cumulativo	Determina il valore minimo di un valore numerico che ricorre all'interno di messaggi di istanza corrispondenti.
Somma cumulativa	Calcola la somma accumulata di un valore numerico che ricorre all'interno di messaggi di istanza corrispondenti.

Vedere anche

Come aggiungere functoid di base a una mappa