DistinctList

<< Fare clic per visualizzazione il sommario >>

Percorso:  Il linguaggio OEL > Funzioni >

DistinctList

Restituisce la lista in input, dopo aver eliminato eventuali elementi duplicati. E' possibile specificare se eliminare, oltre agli elementi duplicati, anche quelli con valore null.

 

Funzione

DistinctList(iList origin, bool includeNull, bool returnNew)

 

La funzione può essere utilizzata nelle seguenti modalità:

1) DistinctList(iList origin)

2) DistinctList(iList origin, bool includeNull)

3) DistinctList(iList origin, bool includeNull, bool returnNew)

 

Output

Nome

Descrizione

Tipo

returnValue

Lista in input restituita senza elementi duplicati e valori nulli.

iList

 

Commenti

Il metodo è applicabile alle liste di valori. Se si vuole utilizzare il metodo con una lista di oggetti, bisogna individuare un valore identificativo dei singoli oggetti per poter effettuare il confronto tra gli stessi. Ad esempio, nel caso si voglia confrontare gli elementi di una lista di collegamenti, si può passare al metodo la lista delle rispettive Url.

La stringa vuota contenuta in una lista di stringhe viene elaborata dal metodo analogamente al valore null.

 

Modalità 1)

DistinctList(IList origin)

 

Input

Nome

Descrizione

Tipo

Opzionale

origin

Lista da cui rimuovere eventuali elementi duplicati e valori nulli.

iList

 

Output

Nome

Descrizione

Tipo

Opzionale

returnValue

Lista in input restituita senza elementi duplicati e valori nulli.

iList

 

 

Modalità 2)

DistinctList(IList origin, bool includeNull)

 

Input

Nome

Descrizione

Tipo

Opzionale

origin

Lista da cui rimuovere eventuali elementi duplicati e valori nulli.

iList

 

includeNull

True se gli elementi con valore null o le stringhe vuote non devono essere rimossi dalla lista. Il valore di default è False.

Boolean

 

Output

Nome

Descrizione

Tipo

Opzionale

returnValue

Lista in input restituita senza elementi duplicati.

iList

 

 

Commenti

Se il parametro includeNull assume valore True e il parametro list contiene una lista in cui ci sono sia elementi nulli che stringhe vuote, la lista restituita conterrà un solo elemento con valore null.

 

Esempio

Esigenza: Data una lista di stringhe, si vuole eliminare da essa eventuali elementi duplicati e valori nulli.

 

Descrizione: In una soluzione Jamio openwork è definito un processo nel quale, data in input una lista di elementi di tipo testo breve, un'attività di tipo regola di business deve restituire in output la stessa lista, priva di eventuali elementi duplicati ed elementi nulli. La parte sinistra della regola di business sarà valorizzata con la lista da restituire in output, il predicato sarà assume il valore di e la parte destra, inserita con la modalità espressione, riporterà la funzione DistincList per ottenere la lista priva di elementi duplicati e nulli.

 

DistinctList(#activityInput.Fields['listaStringheInput'],false)

 

 

 

Modalità 3)

DistinctList(IList origin, bool includeNull, bool returnNew)

 

Input

Nome

Descrizione

Tipo

Opzionale

origin

Lista da cui rimuovere eventuali elementi duplicati e nulli.

iList

 

includeNull

True se gli elementi con valore null o le stringhe vuote non devono essere rimossi dalla lista. Il valore di default è False.

Boolean

 

returnNew

True se la lista passata al parametro origin deve restare inalterata e il risultato deve essere restituito in una lista che contiene gli stessi elementi di quella passata al parametro origin, privata degli elementi duplicati e nulli (se includeNull=False).

Il valore di default è False.

Boolean

 

Output

Nome

Descrizione

Tipo

Opzionale

returnValue

Lista in input restituita senza elementi duplicati.

iList

 

 

Commenti

Se il parametro includeNull assume valore True e il parametro list contiene una lista in cui ci sono sia elementi nulli che stringhe vuote, la lista restituita conterrà un solo elemento con valore null.