Aggiunta di attributi di raccolta

Aggiunta di un nuovo attributo per una raccolta

Per aggiungere un nuovo attributo per una raccolta, procedere come segue.

1. Nella finestra Crea nuovo attributo, specificare quanto segue nella scheda Proprietà.
   • Nome: immettere un nome per l'attributo. I commenti possono contenere un massimo di 255 caratteri.
   • Descrizione: immettere una descrizione. I commenti possono contenere un massimo di 255 caratteri.
   • Selezionare l'opzione Input o Calcolato come tipo di attributo.

     Input rappresenta l'impostazione predefinita e la scheda Convalide è abilitata. La regola di convalida modificata non si applica ai periodi aperti e per i quali sono state create istanze di form. Le modifiche apportate vengono applicate solo alle nuove istanze di form.

     Se si seleziona Calcolato, la scheda Calcoli risulta abilitata.

     Nota:

     Dopo aver selezionato Input o Calcolato e aver salvato l'attributo, non è possibile modificare questa impostazione dopo la creazione dell'attributo. La modifica del tipo di attributo elimina qualsiasi convalida o calcolo precedentemente specificato.
   • Tipo di dati: selezionare uno dei tipi di dati elencati di seguito. Dopo aver selezionato il tipo di dati, è anche possibile selezionare le opzioni Obbligatorio e/o Usa valore.
     • Data
     • Data e ora
     • Numero intero
     • Elenco: fare clic su Aggiungi e immettere i valori per l'attributo. L'elenco è un elemento locale per la raccolta e non è condivisibile con altre raccolte.
     • Testo su più righe: se si seleziona questa opzione, specificare un valore compreso fra 3 e 50 per il campo Numero di linee. Il valore predefinito è 3. Il campo Testo su più righe determina il numero di righe di testo visibili nel form senza scorrimento nelle finestre di dialogo Azioni. La lunghezza massima deve essere di 2000 caratteri. La larghezza dell'area di testo rimane comunque fissa.

       Selezionare la casella di controllo Obbligatorio se è necessario che il campo Tipo di dati contenga tale valore. Se si seleziona la casella di controllo Usa valore, qui sarà applicabile anche il valore immesso per Numero di linee. Oltre tale valore, il testo sarà con scorrimento.

     • Numero: selezionare questa opzione per specificare le opzioni di formattazione. In questo modo, si sostituiranno le impostazioni predefinite nella sezione Preferenze della finestra Impostazioni di sistema.

       Nota:

       Si possono immettere solo valori numerici per questo attributo.
       • Posizioni decimali: immettere il numero di posizioni decimali da visualizzare.
       • Visualizza come percentuale: visualizza un simbolo di percentuale.
       • Usa separatore migliaia: visualizza un separatore delle migliaia (ad esempio, 1.000,00). Il simbolo del separatore delle migliaia viene visualizzato in base alle impostazioni nazionali dell'utente.
       • Valuta: selezionare la valuta.
       • Formato numero negativo: selezionare il modo in cui si desidera visualizzare i numeri negativi.
       • Scala: selezionare come scalare il numero. L'intervallo va da 1000 a 1000000000000.
     • Testo: immettere al massimo 255 caratteri.
     • True/False
     • Sì/No
   • Obbligatorio: se l'attributo è obbligatorio, è necessario immettere un valore in questo campo durante l'immissione dei dati.
   • Usa valore: se si specifica questo valore, il sistema applica il valore immesso dallo sviluppatore per qualsiasi record creato dall'utente. È possibile modificare il valore predefinito durante l'immissione dei dati.
2. Fare clic su OK per salvare l'attributo. La finestra Crea nuovo attributo viene chiusa.
3. Nella finestra Modifica raccolta, fare clic su Salva per salvare la raccolta.

   Nota:

   È necessario salvare il nuovo attributo e la raccolta. Solo dopo tale operazione, sarà possibile accedere alla scheda Convalide o Calcolo per l'attributo.
4. Selezionare l'attributo creato e fare clic sull'icona Modifica.

   Viene visualizzata la finestra Modifica attributo.

5. Se è stata selezionata l'opzione Input (passo 1), è possibile aggiungere un'espressione condizionale nella scheda Convalide.
   1. Fare clic su Aggiungi. Alla tabella viene aggiunta una riga.
   2. Fare clic sulle colonne all'interno della prima riga per visualizzare gli elenchi a discesa da cui è possibile selezionare l'Operatore e specificare di conseguenza Valore1 e Valore2.
   3. Se è necessaria una seconda condizione, fare clic su Aggiungi per aggiungere un'altra riga.
   4. Fare clic sulle colonne all'interno della seconda riga per visualizzare gli elenchi a discesa da cui è possibile selezionare la Combinazione, ad esempio And oppure Or.
   5. Fare clic su OK per salvare le condizioni.
6. Se è stata selezionata l'opzione Calcolato (passo 1), è possibile aggiungere un calcolo nella scheda Calcoli. Selezionare il Tipo di calcolo.
   • Assegna valore a elenco: selezionare il valore Attributo associato.
   • Condizionale: aggiungere la condizione per Definizione calcolo.
   • Con script: specificare la Definizione calcolo, quindi selezionare l'attributo e la funzione.
7. Per aggiungere un'espressione di calcolo, specificare il tipo di dati e il tipo di calcolo come descritto nella tabella seguente.

   Tabella 25-3 Tipo di dati e tipo di calcolo

   Tipo di dati selezionato nella scheda Proprietà	Tipo di calcolo	Descrizione
   Per tutti i tipi di dati	Selezionare Assegna valore a elenco, quindi selezionare il valore Attributo. È necessario aver salvato valori dell'elenco di attributi.	Restituisce un valore di attributo in base all'assegnazione a un membro dell'elenco.
   Per tutti i tipi di dati	Condizionale	Per un determinato attributo, viene restituito un valore di attributo A se le condizioni specificate sono state soddisfatte. Se le condizioni non sono state soddisfatte, viene restituito il valore di attributo B.
   Elenco	Assegna elenco a valore	In base al valore di un attributo, viene restituito il membro correlato dall'elenco.
   Numero intero, Numero e Testo	Con script Fare riferimento alla sezione Funzioni con script	Un calcolo con script in formato libero. Il valore Con script è disponibile per attributi di tipo Numero intero, Testo su più righe, Numero o Testo.

8. Fare clic su OK per salvare l'attributo.

   Nota:

   Le modifiche apportate agli attributi verranno applicate solo ai periodi di raccolta dei dati successivi.

Funzioni con script

• Valore assoluto: restituisce il valore assoluto di un numero specificato. Se un numero è minore di zero, viene restituito il valore positivo del numero. Se il numero specificato è uguale o maggiore di zero, viene restituito il valore specificato.

  ABS(<Numero>)

• Aggiungi mese: restituisce una data con un offset di un numero specificato di mesi rispetto alla data iniziale. La data rientrerà sempre nell'offset mese specificato. Se la data iniziale ha un valore giorno che supera il mese di offset, viene utilizzato l'ultimo giorno del mese di offset. Ad esempio, EDate (31-gen-2017, 1) restituisce (28-feb-2017). Per Mesi, immettere il numero di mesi prima o dopo la data iniziale. Un valore positivo per i mesi restituisce una data futura. Un valore negativo restituisce una data passata.

  ADD_MONTH(<Data inizio>, <Mesi>, <Durata>)

  Esempio: ADD_MONTH(DATE(2017, 2, 15) 3)

• Media nei periodi precedenti : calcola un importo numerico medio nel corso di X periodi precedenti.

  AVERAGE_PRIOR(<Valore>, <Numero di periodi>, <Valuta di destinazione*>

  Esempio: AVERAGE_PRIOR( {Balance (Reporting)}, '2', 'EUR'

• Data: restituisce un valore di data basato sui valori interi specificati per l'anno, il mese e il giorno.

  DATE(<Anno>, <Mese>, <Giorno>)

• Differenza di data:: restituisce la differenza in giorni, ore, minuti o secondi tra due date. Per DATE 1 e DATE 2, si possono utilizzare i valori TODAY e NOW, a indicare rispettivamente la data corrente (senza il componente orario) e la data/ora.

  DATE_DIFF(<Data1>, <Data2>, <Tipo)

  Esempio: DATE_DIFF('TODAY', {Preparer End Date}, 'DAYS') or DATE_DIFF({Preparer End Date}, 'NOW', 'HOURS')

• DAY: restituisce il valore del giorno di una data sotto forma di numero intero

  DAY(<DATE>)

• Estrai testo: restituisce la sottostringa all'interno del valore, dalle posizioni specificate.

  SUBSTRING(<Valore>, <Posizione>, <Lunghezza>)

  Esempio: SUBSTRING( {Name} , 5, 10)

• If Then Else: consente all'utente di inserire un calcolo condizionale nel calcolo con script. I calcoli IF_THEN_ELSE possono essere anche nidificati in modo da supportare i calcoli di tipo "ELSE IF".

  IF_THEN_ELSE(<Condizione>, <Valore1>, <Valore2>)

  Esempio:

  IF_THEN_ELSE( {Risk Rating} = 'Low', 'Good',
  IF_THEN_ELSE( {Risk Rating} = 'Medium', 'Better',
  IF_THEN_ELSE({Risk Rating} = 'High', 'Best','Bad')))
  

• Length: accetta un valore di testo come parametro e restituisce un numero intero che indica il numero di caratteri nel testo. Se il valore è vuoto o nullo, il calcolo restituirà 0.

  Length ({<attribute>})

  Esempio: LENGTH('Value') restituirebbe 5, mentre LENGTH({Name}) restituirebbe il numero di caratteri nel nome dell'oggetto.

  Utilizzare il calcolo con SUBSTRING per estrarre gli ultimi quattro caratteri di un valore di testo.

  SUBSTRING( {MyString}, LENGTH ({MyString}) - 4

• Minuscolo: restituisce il valore in minuscolo.

  LOWERCASE(<Valore>)

  Esempio: LOWERCASE( {Description} )

• Massimo: restituisce il valore massimo da un elenco di attributi. Può esservi un numero qualsiasi di parametri.

  MAX(<Valore1>, <Valore2>,<ValoreN>)

  Esempio: MAX( TRANSLATE( {Source System Balance (Entered)}, 'USD', 'Accounting'), TRANSLATE( {Source System Balance (Functional)}, 'USD', 'Accounting'), TRANSLATE( {Source System Balance (Reporting)}, 'USD', 'Accounting') )

• Massimo nei periodi precedenti: restituisce il valore massimo nel corso di X periodi precedenti.

  MAX_PRIOR (<Valore>, <Numero di periodi>)

  Esempio: MAX_PRIOR( {Balance (Functional)}, '6', 'CAD', 'REC')

• Minimo: restituisce il valore minimo da un elenco di attributi. Può esservi un numero qualsiasi di parametri.

  MIN(<Valore1>, <Valore2>,<ValoreN>)

  Esempio: MIN( TRANSLATE( { Balance (Entered)}, 'CAD', 'REC'), TRANSLATE( {Balance (Functional)}, 'CAD', 'REC'), TRANSLATE( {Balance (Reporting)}, 'CAD', 'REC') )

• Minimo nei periodi precedenti: restituisce il valore minimo nel corso di X periodi precedenti.

  MIN_PRIOR (<Valore>, (<Valore>, <Numero di periodi>)

  Esempio: MIN_PRIOR( {Source System Balance (Functional)}, '6', 'EUR', 'Simplified')

• Mese: restituisce il valore del mese di una data sotto forma di numero intero (1-12)

  MONTH (<DATE>)

• Potenza: eleva un numero alla potenza di un altro numero.

  POWER(x,y) dove x=NUMERO BASE e y=ESPONENTE; x e y possono essere attributi o calcoli, ma devono necessariamente essere valori numerici.

  Esempio: POWER(3,4)=81

  Nota:

  I valori frazionari riducono il numero alla radice. Ad esempio, POWER(27, 1/3) = 3 la radice al cubo.

  I valori negativi eseguono un calcolo inverso a quello esponenziale. Ad esempio, POWER(2, -2) = 1 / (2^2) = 1 / 4 = 0,25.

• Precedente: restituisce il valore del periodo precedente specificato.

  PRIOR(<Valore>, <Numero di periodi precedenti>)

  Esempio: PRIOR( {Source System Balance (Entered)}, '1', 'EUR')

• Arrotonda: restituisce il valore arrotondato al numero specificato di posizioni decimali.

  ROUND(<Valore>, <Posizioni decimali>)

  Esempio: ROUND( ({Scripted Translate} /7), 4)

• Somma nei periodi precedenti: restituisce la somma di un valore nel corso di X periodi precedenti.

  SUM_PRIOR(<Valore>, <Numero di periodi>)

  Esempio: SUM_PRIOR( {Balance (Reporting)}, '3', 'EUR')

• Posizione testo: restituisce la posizione della sottostringa all'interno del valore di attributo, partendo da 1 come prima posizione.

  INSTRING(<Valore>, <Valore da cercare>)

  Esempio: INSTRING( UPPERCASE( {Name} ), 'TAX' )

• Traduci: traduce un attributo di valuta in un attributo numerico utilizzando il tipo di tasso specificato.

  TRANSLATE(<Valore>, <Valuta di destinazione>, <Tipo di tasso>)

  Esempio: TRANSLATE( {Balance (Entered)}, 'EUR', 'Acct')

• Maiuscolo: restituisce il valore in maiuscolo.

  UPPERCASE(<Valore>)

  Esempio: UPPERCASE( {Name} )

• Anno: restituisce il valore dell'anno di una data sotto forma di numero intero.

  YEAR (<DATE>)

Esempio di aggiunta di un attributo di calcolo

1. Creare una raccolta con gli attributi descritti di seguito.

   Int1: Input come tipo di attributo e Tipo di dati Numero intero. Fare clic su OK e in Modifica raccolta selezionare Int1 come Identificativo chiave.

   TextInput: Input come tipo di attributo e Tipo di dati Testo.

2. Salvare i dati.
3. Creare un attributo denominato TextCalc con tipo di attributo Calcolato e Tipo di dati Testo.
4. Nella scheda Calcoli, specificare quanto segue.
   • Tipo di calcolo: selezionare Con script.
   • Aggiungi funzione: selezionare TextLocation, quindi fare clic su Aggiungi.

     Alla definizione calcolo viene aggiunto INSTRING(<Value>, <Value To Search>).

   • Fare clic su <Valore> e immettere un valore (racchiuso tra virgolette singole e rispettando maiuscole e minuscole) oppure, in Aggiungi attributo, selezionare l'attributo TextInput e fare clic su Aggiungi.

     <Value> diventa {TextInput}.

   • Sostituire <Value to Search> con 'tion'.

     Nota: ricordarsi di sostituire <xxx> con gli apici: 'xxx'. Ad esempio, INSTRING({TextInput}, 'tion')

5. Fare clic su OK per salvare gli attributi.

Aggiunta di attributi da una dimensione

Nella finestra Aggiungi attributo da dimensione, procedere come segue.

1. Selezionare una dimensione in Dimensione.
2. Selezionare gli attributi dall'elenco Attributi disponibili e spostarli nell'elenco Attributo selezionato.

   Il sistema include l'attributo chiave della dimensione come attributo selezionato. Non è possibile deselezionare l'attributo chiave.

3. Fare clic su OK.

   La finestra Aggiungi attributo da dimensione viene chiusa e gli attributi selezionati vengono visualizzati nella finestra Modifica raccolta.

4. È possibile selezionare la casella di controllo nella colonna Persistente per indicare che il valore dell'attributo deve essere salvato in modo permanente nei form a cui viene fatto riferimento. Se l'attributo di dimensione viene aggiornato, le modifiche non vengono apportate nei form in cui viene fatto riferimento all'attributo. Se non si seleziona questa casella di controllo, l'attributo a cui viene fatto riferimento viene aggiornato con le ultime modifiche. Dopo aver salvato la raccolta, non è possibile modificare questa impostazione.
5. Fare clic su Salva o Salva e chiudi.