Funzioni

<< Fare clic per visualizzazione il sommario >>

Percorso:  Il linguaggio OEL >

Funzioni

Segue l'elenco delle funzioni disponibili nel linguaggio OEL.

 

Creare gli oggetti ArrayValue e DataSetValue

List

Restituisce un ArrayValue, tipo di lista della famiglia iList, composto dagli oggetti specificati in input.

DataSet

Crea e restituisce un DataSetValue con gli elementi specificati, per es.: DataSet(chiave1, valore1, chiave2, valore2).

 

Modificare elementi in IList e IDataSet

CopyFields

Sostituisce i campi del DataSet di destinazione con i campi del DataSet di origine. Ad esempio se il DataSet di destinazione DataSet1 è costituito dai campi campo1, campo2, campo3 ed il DataSet di origine DataSet2 è costituito dai campi campo4 e campo5, a seguito dell'applicazione del metodo CopyFields il DataSet1 sarà composto dai campi campo4 e campo5. I campi campo1,campo2, campo3 non saranno più disponibili. Attenzione: se la funzione viene utilizzata per sostituire i campi aggiuntivi di un risorsa, accertarsi che la definizione della risorsa sia coerente con i nuovi campi prima di eseguire l'operazione.

CopyFieldValues

Imposta i campi del DataSet di destinazione ai valori dei campi con lo stesso nome del DataSet di origine. Se ci sono dei campi del DataSet di origine non presenti nel DataSet di destinazione si ottiene un errore. Il metodo valuta tutti i campi del Dataset di origine. Se si vogliono specificare al metodo solo alcuni dei campi del DataSet di origine è possibile utilizzare il parametro opzionale keys, utile ad indicare i campi del DataSet di origine che devono essere utilizzati per effettuare la copia.

RenameFields

Restituisce l'oggetto iDataSet ricevuto in input, dopo aver rinominato uno o più campi o inserito un prefisso e/o di un suffisso.

RemoveFromDataSet

Rimuove dal DataSet gli elementi con le chiavi specificate in input.

RemoveFromDatasetList

Restituisce una lista di elementi contenente i DataSet della lista di input che non soddisfano l'espressione di selezione.

SetListElement

Restituisce la lista in input sostituendo il valore alla posizione indicata dal parametro index con quello specificato nel parametro element.

UpdateDataSet

Restituisce il dato strutturato di destinazione, dopo aver aggiornato il valore dei suoi elementi a partire dai valori specificati nel dato strutturato sorgente.

UpdateInDatasetList

Esegue l'aggiornamento degli elementi della lista di input che soddisfano l'espressione di selezione.

 

Unire liste e dataSet

AppendList

Restituisce l'oggetto specificato come lista di destinazione dopo aver aggiunto tutti gli elementi presenti nella lista specificata come lista di origine.

MergeDataSet

Restituisce l'oggetto specificato come DataSet di destinazione, dopo aver aggiunto gli elementi dell'oggetto specificato come DataSet sorgente.

MergeInDatasetList

Applica la funzione MergeDataSet ad ogni elemento della lista di destinazione che soddisfa un'espressione di selezione.

 

Ordinare elementi di iList

SortList

Restituisce l'oggetto passato in input dopo aver ordinato gli elementi. Gli oggetti scalari sono ordinati con ordinamento ascendente.

 

Estrarre elementi da iList e iDataset

DistinctList

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

ExtractDataSet

Crea e restituisce un Dataset estraendo uno o più elementi dal Dataset di partenza, eventualmente rinominandoli.

FlattenDataset

Restituisce un Dataset contenente i campi del Dataset passato in input, riportati ad un unico livello.

GetFieldNames

Restituisce la lista dei nomi dei campi di primo livello di un iDataSet.

ProjectionList

Restituisce un ArrayValue contenente la proiezione ottenuta applicando l'espressione di proiezione indicata alla lista di partenza.

SelectionList

Restituisce un ArrayValue contenente la selezione degli elementi di una lista ottenuta applicando l'espressione di selezione indicata.

 

Convertire

NumberToString

Converte un numero in una stringa.

ToArrayValue

Crea un ArrayValue a partire da una qualunque collezione di oggetti.

 

Creare ed elaborare oggetti iReference

CopyReference

Copia le proprietà Name, Type e Url del collegamento sorgente nelle corrispondenti proprietà del collegamento di destinazione.

Reference

Restituisce il collegamento ad una risorsa.

ReferenceUrlEncode

Codifica l'URL di un collegamento a risorsa perchè sia utilizzabile all'interno di un testo.

 

Creare ed elaborare Datetime

DateAdd

 Restituisce la data in input dopo aver aggiunto uno specifico numero di anni, mesi, giorni, ore, minuti e secondi.

DateDiff

 Restituisce la differenza tra due date nella unità di misura indicata da unit(d=giorni, h=ore, m=minuti).

DateTimeToString

Converte una data in una stringa.

DateTimeToUnixTime

Converte una data in un numero che rappresenta una data in UnixTime.

StringToDateTime

Converte una stringa in una data.

UnixTimeToDateTime

Converte un numero che rappresenta una data in UnixTime, in una data.

 

Validare

AlphabeticString

Verifica che la stringa indicata sia alfabetica.

AlphabeticStringWithoutSpace

Verifica che la stringa indicata (senza spazi) sia alfabetica.

AlphaNumericString

Verifica che la stringa indicata sia alfanumerica.

AlphaNumericStringWithoutSpace

Verifica che la stringa indicata (senza spazi) sia alfanumerica.

BelongsToAnyIdentityRepository

Verifica che l'utente indicato, appartenga ad un qualsiasi archivio di identità definito in un'Area Jamio openwork.

BelongsToGroup

Verifica che l'utente indicato, appartenga al gruppo di riferimento.

BelongsToIdentityRepository

Verifica che l'utente indicato, appartenga all'archivio di identità definito nell'Area Jamio openwork di riferimento.

BelongsToList

Verifica che l'oggetto indicato appartenga alla lista.

BelongsToListOrNull

Verifica che l'oggetto indicato appartenga alla lista, oppure che sia null.

BelongsToOrganization

Verifica che l'elemento organizzativo indicato, appartenga all'organizzazione di riferimento.

BelongsToOrganizationalBlock

Verifica che l'elemento organizzativo indicato, appartenga al blocco organizzativo di riferimento.

BelongsToOrganizationalUnit

Verifica che l'elemento organizzativo indicato, appartenga all'unità organizzativa di riferimento.

BelongsToOrganizationalUnitHierarchy

Verifica che l'elemento organizzativo indicato, appartenga alla gerarchia dell'unità organizzativa di riferimento.

Between

Verifica che l'oggetto indicato sia compreso nell'intervallo.

BossIs

Verifica che l'elemento organizzativo indicato, ha come superiore la posizione organizzativa di riferimento.

CountBetween

Verifica che la collezione di oggetti indicata abbia lunghezza compresa in un intervallo.

CountEqualsTo

Verifica che la collezione di oggetti indicata abbia lunghezza uguale ad un valore.

CountGreaterThan

Verifica che la collezione di oggetti indicata abbia lunghezza maggiore di un valore.

CountGreaterThanOrEqual

Verifica che la collezione di oggetti indicata abbia lunghezza maggiore o uguale ad un valore.

CountLessThan

Verifica che la collezione di oggetti indicata abbia lunghezza minore di un valore.

CountLessThanOrEqual

Verifica che la collezione di oggetti indicata abbia lunghezza minore o uguale ad un valore.

CustomizationIs

Verifica che la risorsa indicata, sia dello stesso tipo (customizzazione) del modello indicato dal collegamento di riferimento.

Email

Verifica che la stringa indicata sia un indirizzo email valido.

Empty

Verifica che l'oggetto indicato sia vuoto.

EqualsTo

Verifica che gli oggetti indicati siano uguali.

FirstLevelBossIs

Verifica che l'elemento organizzativo indicato, ha come superiore (al primo livello) la posizione organizzativa di riferimento.

FiscalCode

Verifica che la stringa indicata sia un codice fiscale.

GreaterThan

Verifica che, tra gli oggetti indicati, il primo sia maggiore del secondo.

GreaterThanOrEqual

Verifica che, tra gli oggetti indicati, il primo sia maggiore (o uguale) del secondo.

HasField

Verifica che la risorsa indicata, contiene un campo con il nome uguale alla stringa di riferimento.

If

Verificata una condizione, restituisce il primo valore indicato, altrimenti il secondo.

InternationalPhoneNumber

Verifica che la stringa indicata sia un numero telefonico internazionale.

Interval

Restituisce un oggetto di tipo intervallo.

Is

Verifica che la risorsa (o il collegamento ad una risorsa) indicata, sia uguale al collegamento di riferimento.

IsFirstLevelBossOf

Verifica che la posizione organizzativa indicata, è il superiore (di primo livello) dell'elemento organizzativo di riferimento.

IsReferenceOf

Verifica che il collegamento indicato, sia uguale al collegamento di riferimento, o al collegamento della risorsa di riferimento.

IsSameType

Verifica che la risorsa indicata, sia dello stesso tipo (customizzazione) della risorsa di riferimento.

IsSecondLevelBossOf

Verifica che la posizione organizzativa indicata, è il superiore (di secondo livello) dell'elemento organizzativo di riferimento.

IsSet

Verifica se il tipo Status è impostato.

IsWorkingCopy

Verifica se la risorsa di tipo documento indicata è una bozza.

LessThan

Verifica che, tra gli oggetti indicati, il primo sia minore del secondo.

LessThanOrEqual

Verifica che, tra gli oggetti indicati, il primo sia minore (o uguale) del secondo.

NotEmpty

Verifica che l'oggetto indicato sia non vuoto.

NotNull

Verifica che l'oggetto indicato sia diverso da null.

Null

Verifica che l'oggetto indicato sia uguale a null.

NumericString

Verifica che la stringa indicata sia numerica.

NumericStringWithoutSpace

Verifica che la stringa indicata (senza spazi) sia numerica.

SecondLevelBossIs

Verifica che l'elemento organizzativo indicato, ha come superiore (al secondo livello) la posizione organizzativa di riferimento.

StringBeginsWith

Verifica che la stringa indicata inizi con un valore.

StringContains

Verifica che la stringa indicata contenga con un valore.

StringEndsWith

Verifica che la stringa indicata termini con un valore.

StringLengthBetween
Verifica che la lunghezza della stringa indicata sia compresa nell'intervallo.

StringLengthBetweenWithoutSpace

Verifica che la lunghezza della stringa (senza spazi) indicata sia compresa nell'intervallo.

StringLengthGreaterThan

Verifica che, tra le stringhe indicate, la prima abbia lunghezza maggiore della seconda.

StringLengthGreaterThanWithoutSpace

Verifica che, tra le stringhe indicate, la prima abbia lunghezza (senza spazi) maggiore della seconda.

StringLengthLessThan

Verifica che, tra le stringhe indicate, la prima abbia lunghezza minore della seconda.

StringLengthLessThanWithoutSpace

Verifica che, tra le stringhe indicate, la prima abbia lunghezza (senza spazi) minore della seconda.

StringRegex

Verifica che la stringa indicata sia conforme ad un'espressione regolare.

Vat

Verifica che la stringa indicata sia una partita iva.

 

Inizializzare

CatalogFilter

Costruisce un oggetto di tipo filtro da applicare su una colonna di un catalogo.

CronExpressionString

Restituisce una stringa che rappresenta una Cron Expression combinando secondi, minuti, ore, giorno del mese, mese, giorno della settimana e anno.

New

Restituisce un oggetto instanziato dal tipo indicato (e dagli eventuali parametri).

NewAcl

Restituisce la Acl di default per il tipo di risorsa specificato.

NewLine

Restituisce la stringa della nuova riga definita per l'ambiente (al momento dell'esecuzione).

NewTimeSpan

Restituisce un oggetto TimeSpan (intervallo temporale) dati giorni, ore, minuti e secondi.

SearchParameters

Crea un oggetto di tipo Searchparameters.

 

Elaborare

Avg

Restituisce la media dei valori forniti tramite lista.

CalculateHash

Restituisce una stringa che rappresenta il valore di hash calcolato con il metodo specificato da un insieme di valori.

ConcatenateString

Restituisce un testo ottenuto dalla concatenazione di una lista di elementi.

Convert

Restituisce un oggetto risultante dalla conversione nel tipo indicato da un oggetto.

Count

Restituisce il numero di elementi di una lista.

Day

Restituisce il giorno della data specificata. E' possibile specificare un fuso orario di origine ed uno di destinazione per ottenere l'indicazione del giorno in un fuso orario specifico.

Escalation

Restituisce un oggetto di tipo Escalation.

FilterAnd

Restituisce un FilterGroup con l'operatore di confronto uguale a And.

FilterOr

Restituisce un FilterGroup con l'operatore di confronto uguale a Or.

GetDays

Restituisce la componente 'giorni' dell'intervallo temporale specificato.

GetExplorationReference

   Restituisce il collegamento al catalogo che consente di esplorare una risorsa di tipo fascicolo, organizzazione, posizione organizzativa o unità organizzativa fornita in input.

GetHours

Restituisce la componente 'ore' dell'intervallo temporale specificato.

GetMinutes

Restituisce la componente 'minuti' dell'intervallo temporale specificato.

GetPermissionFilter

Restituisce il filtro corrispondente al permesso specificato nella ACL fornita.

GetSeconds

Restituisce la componente 'secondi' dell'intervallo temporale specificato.

GetReferenceListFromFilter

Estrae la lista di collegamenti di riferimento da un filtro organizzativo semplice.

GetReferenceProperties

Restituisce le proprietà di una risorsa a partire dal suo collegamento.

Hour

Restituisce l'ora della data specificata. E' possibile specificare un fuso orario di origine ed uno di destinazione per ottenere l'indicazione dell'ora in un fuso orario specifico.

LowerCase

Converte una stringa in minuscolo.

Max

Restituisce il valore massimo tra gli elementi di una lista.

Min

Restituisce il valore minimo tra gli elementi di una lista.

Minute

Restituisce i minuti della data specificata. E' possibile specificare un fuso orario di origine ed uno di destinazione per ottenere l'indicazione dei minuti in un fuso orario specifico.

Month

Restituisce il mese della data specificata. E' possibile specificare un fuso orario di origine ed uno di destinazione per ottenere l'indicazione del mese in un fuso orario specifico.

Now

Restituisce un oggetto rappresentate la data-ora attuale (al momento dell'esecuzione).

Outcome

Restituisce un oggetto di tipo Outcome.

RandomNumericString

   Restituisce una stringa composta da un certo numero di caratteri di tipo numerico.

RandomAlphaNumericString

   Restituisce una stringa composta da un certo numero di caratteri di tipo alfanumerico.

ReplacePlaceholders

Restituisce una stringa in cui tutti i placeholder nel formato ##NomePlaceHolder## vengono sostituiti dal corrispondente elemento di nome NomePlaceHolder riportato in un dato strutturato.

ReplaceString

Restituisce un oggetto in cui una stringa è sostituita con una nuova stringa .

Second

Restituisce i secondi della data specificata.

SetPermissionFilter

Restituisce un Acl modificando il filtro corrispondente al permesso specificato.

Split

Restituisce una lista di testi ottenuti dalla suddivisione di un testo in base ad un carattere separatore.

StringLength

Restituisce la lunghezza della stringa indicata.

StringLeft

Restituisce un oggetto contenente un numero specificato di caratteri a partire dal lato sinistro di una stringa.

StringRight

Restituisce un oggetto contenente un numero specificato di caratteri a partire dalla destra di una stringa.

Substring

Restituisce un oggetto contenente un numero specificato di caratteri a partire da una posizione specifica di una stringa.

Sum

Restituisce la somma numerica dei valori di una lista.

TypeFromString

Restituisce il tipo dell'oggetto indicato da una stringa.

TypeOf

Restituisce il tipo dell'oggetto indicato.

UrlEncode

Codifica un URL perchè sia utilizzabile all'interno di un testo.

UrlDecode

Decodifica un URL precedentemente codificato con la funzione UrlEncode.

UpperCase

Converte una stringa in maiuscolo.

Year

Restituisce l'anno della data specificata. E' possibile specificare un fuso orario di origine ed uno di destinazione per ottenere l'indicazione dell'anno in un fuso orario specifico.

 

Metodi a supporto di chiamate ad API esterne

BuildQueryString

Converte una raccolta di coppie chiave/valore di parametri nell'equivalente query string.

CsvToList

Converte una stringa CSV in una lista.

DatasetToJson

Converte un oggetto IDataSet in una stringa contenente l'equivalente in formato JSON.

DatasetToXml

Converte un oggetto IDataSet in una stringa contenente l'equivalente in formato Xml.

GetStructure

Restituisce la struttura di un DataSet.

JsonToDataset

Converte una stringa in formato Json in un DataSetValue.

ProjectionDataSet

Proietta una lista di DataSet in un DataSetValue.

ReplaceStrings

Restituisce la stringa di input o la lista di stringhe (ArrayValue) dopo aver sostituito le precedenti stringhe specificate con i nuovi valori corrispondenti.

XmlToDataset

Converte una stringa in formato Xml in un DataSetValue.

 

Metodi deprecati dalla versione MARIMBA 4.5R2

I seguenti metodi sono dichiarati deprecati a partire alla versione Jamio openwork Marimba 4.5R2:

AddToList

Aggiunge uno o più elementi ad una lista.Utilizzare il metodo AppendList.

AddToFields

Restituisce una collezione di campi (Fields) alla quale, da una collezione di partenza, è stato aggiunto un elemento.Utilizzare il metodo MergeDataSet.

Dictionary

Restituisce un dizionario composto dagli elementi indicati.

Distinct

Restituisce i soli valori distinti da una lista di elementi. Utilizzare il metodo DistinctList.

KeyValueProjection

Restituisce la proiezione (dizionario) applicando, alla lista di partenza, le espressioni di proiezione indicate.

Item

Restituisce un elemento di un dizionario.

MergeList

Restituisce una lista contenente gli elementi di due liste: quelli della seconda lista accodati agli elementi della prima. Utilizzare il metodo AppendList.

Projection

Restituisce un ArrayValue contenente la proiezione ottenuta applicando l'espressione di proiezione indicata alla lista di partenza.Utilizzare il metodo ProjectionList.

SetFields

Restituisce una risorsa alla quale, da una risorsa di partenza (contenente una collezione di campi), è stata impostata la collezione di campi indicata (Fields). Utilizzare il metodo CopyFieldValues.

SetInList

Imposta un elemento di una lista. Utilizzare il metodo SetListElement.

Selection

Restituisce un ArrayValue contenente la selezione degli elementi di una lista ottenuta applicando l'espressione di selezione indicata.Utilizzare il metodo SelectionList.

Sort

Restituisce una lista ordinata a partire da una lista di elementi. Utilizzare il metodo SortList.

 

Metodi deprecati dalla versione HARP 4.6R1

I seguenti metodi sono dichiarati deprecati a partire alla versione Jamio openwork HARP 4.6R1:

Date

Restituisce un oggetto di tipo data-ora. Utilizzare il metodo StringToDateTime.

 

Metodi deprecati dalla versione HARP 4.6R4

I seguenti metodi sono dichiarati deprecati a partire alla versione Jamio openwork HARP 4.6R4:

GreatherThanOrEqual

Verifica se un oggetto è maggiore o uguale di un altro. Utilizzare il metodo GreaterThanOrEqual.