<< 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. |
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. |
|
|
Output |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
returnValue |
Lista in input restituita senza elementi duplicati e valori nulli. |
|
Modalità 2)
DistinctList(IList origin, bool includeNull)
Input |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
origin |
Lista da cui rimuovere eventuali elementi duplicati e valori nulli. |
|
|
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. |
|
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. |
|
|
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. |
|
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.