|
<< Fare clic per visualizzazione il sommario >> Percorso: Il linguaggio OEL > Funzioni > RenameFields |
Restituisce l'oggetto IDataSet ricevuto in input, dopo aver rinominato uno o più campi o inserito un prefisso e/o un suffisso.
Funzione
RenameFields(IDataSet dataSet, IDataSet oldNewKeys, string prefix, string suffix)
La funzione può essere utilizzata nelle seguenti modalità:
1) IDataSet RenameFields(IDataSet dataSet, IDataSet oldNewKeys)
2) IDataSet RenameFields(IDataSet dataSet, string prefix, string suffix)
3) IDataSet RenameFields(IDataSet dataSet, IDataSet oldNewKeys, string prefix, string suffix)
Output |
||
Nome |
Descrizione |
Tipo |
returnValue |
Dato strutturato con i campi rinominati. |
|
Commenti
La funzione rinomina solo i campi di primo livello. Nella seconda e terza variante prefix e suffix vanno sempre specificati entrambi, anche se nulli.
Il metodo si comporta come segue:
Restituisce |
Condizione |
Errore |
Se DataSet non contiene tutte le chiavi (oldKey) specificate in oldNewKeys. |
Errore |
Se DataSet contiene già almeno uno dei valori (newKey) specificati in oldNewKeys. |
Errore |
Se nessuno dei parametri prefix e suffix è valorizzato |
Modalità 1)
IDataSet RenameFields(IDataSet dataSet, IDataSet oldNewKeys)
Input |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
dataSet |
Dato strutturato di cui si vuole rinominare uno o più campi |
|
|
oldNewKeys |
Dato strutturato che, per ciascuna coppia chiave-valore, riporta nella chiave il nome del campo da rinominare e nel valore il nuovo nome da assegnare al campo. Ad esempio (oldKey1, newKey1, oldKey2, newKey2, ...) |
|
|
Output |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
returnValue |
Dato strutturato con i campi rinominati. |
|
|
Esempio
Se il parametro dataSet è il dato strutturato così composto:
DataSet('key1', 'value1', 'key2', 'value2', 'key3', 'value3')
si vuole ottenere un nuovo dato strutturato con le chiavi dei campi ke1, key2 e key3, rinominate in key1, newKey2 e newKey3.
RenameFields(DataSet('key1', 'value1', 'key2', 'value2', 'key3', 'value3'), DataSet('key2', 'newKey2', 'key3', 'newKey3')) |
Modalità 2)
IDataSet RenameFields(IDataSet dataSet, string prefix, string suffix)
Input |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
dataSet |
Dato strutturato di cui si vuole rinominare uno o più campi |
|
|
prefix |
Se valorizzato viene aggiunto il prefisso al nome dei campi. E' possibile specificare valore null. |
String |
|
suffix |
Se valorizzato viene aggiunto il suffisso al nome dei campi. E' possibile specificare valore null. |
String |
|
Output |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
returnValue |
Dato strutturato con i campi rinominati. |
|
|
Commenti
La funzione è utile a rinominare i campi di un Dataset aggiungendo un prefisso e/o un suffisso ad essi.
Esempio
Se il parametro dataSet è il dato strutturato così composto:
DataSet('key1', 'value1', 'key2', 'value2', 'key3', 'value3')
si vuole ottenere un nuovo dato strutturato rinominando tutti le chiavi dei campi aggiungendo il prefisso A_ e il suffisso _Z.
RenameFields(DataSet('key1', 'value1', 'key2', 'value2', 'key3', 'value3'), 'A_', '_Z') |
Modalità 3)
IDataSet RenameFields(IDataSet dataSet, IDataSet oldNewKeys, string prefix, string suffix)
Input |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
dataSet |
Dato strutturato di cui si vuole rinominare uno o più campi |
|
|
oldNewKeys |
Dato strutturato che, per ciascuna coppia chiave-valore, riporta nella chiave il nome del campo da rinominare e nel valore il nuovo nome da assegnare al campo. Ad esempio (oldKey1, newKey1, oldKey2, newKey2, ...) |
|
|
prefix |
Se valorizzato viene aggiunto il prefisso al nome dei campi. E' possibile specificare valore null. |
String |
|
suffix |
Se valorizzato viene aggiunto il suffisso al nome dei campi. E' possibile specificare valore null. |
String |
|
Output |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
returnValue |
Dato strutturato con i campi rinominati. |
|
|
Esempio
Se il parametro dataSet è il dato strutturato così composto:
DataSet('key1', 'value1', 'key2', 'value2', 'key3', 'value3')
si vuole ottenere un nuovo dato strutturato con le chiavi dei campi ke1, key2 e key3, rinominate in A_key1_Z, A_newKey2_Z e A_newKey3_Z.
RenameFields(DataSet('key1', 'value1', 'key2', 'value2', 'key3', 'value3'), DataSet('key2', 'newKey2', 'key3', 'newKey3'), 'A_', '_Z') |