Aggiunta di attributi di raccolta

Aggiunta di un nuovo attributo per una raccolta

Per aggiungere un nuovo attributo per una raccolta, eseguire le operazioni riportate di seguito.

1. Nella finestra Crea nuovo attributo, nella scheda Proprietà specificare quanto riportato di seguito.
   • Nome: immettere un nome per l'attributo. È possibile immettere un massimo di 80 caratteri.
   • Descrizione: immettere una descrizione. I commenti possono contenere un massimo di 255 caratteri.
   • Come tipo di attributo, selezionare l'opzione Input o Calcolato.

     Input rappresenta l'impostazione predefinita, 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 Calcolato risulta abilitata.

     Nota:

     Dopo aver selezionato Input o Calcolato e salvato l'attributo, non è possibile modificare questa impostazione dopo la creazione dell'attributo. La modifica del tipo di attributo sostituisce qualsiasi convalida o calcolo precedentemente specificato.
   • Tipo di dati: selezionare uno dei tipi di dati riportati 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 il Numero di righe, da 3 a 50. 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 è obbligatorio che il Tipo di dati contenga questo valore. Se si seleziona la casella di controllo Usa valore, il valore immesso per Numero di righe sarà applicabile per impostazione predefinita anche qui. Oltre tale valore, il testo sarà con scorrimento.

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

       Nota:

       Per questo attributo è possibile immettere solo valori numerici.
       • 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 una valuta.
       • Simbolo numeri negativi: selezionare il modo in cui si desidera visualizzare i numeri negativi.
       • Scala: scala per il numero. L'intervallo è compreso tra 1.000 e 1.000.000.000.000.
     • Testo: immettere al massimo 250 caratteri.
     • True/False
     • Sì/No
   • Obbligatorio: se l'attributo è obbligatorio, è necessario immettere il 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 si chiude.
3. Nella finestra Modifica raccolta, fare clic su Salva per salvare la raccolta.

   Nota:

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

   Viene visualizzata la finestra Modifica attributo.

5. Se è stata selezionata l'opzione Input (passaggio 1), è possibile aggiungere un'espressione condizionale nella scheda Convalide come riportato di seguito.
   1. Fare clic su Aggiungi. Viene aggiunta una riga alla tabella.
   2. Fare clic sulle colonne della prima riga per visualizzare gli elenchi a discesa, in cui è possibile selezionare l'Operatore e immettere Valore1 e Valore2 di conseguenza.
   3. Se è necessaria una seconda condizione, fare clic su Aggiungi per aggiungere un'altra riga.
   4. Fare clic sulle colonne della seconda riga per visualizzare gli elenchi a discesa, in cui è possibile selezionare la Combinazione come E oppure O.
   5. Fare clic su OK per salvare le condizioni.
6. Se è stata selezionata l'opzione Calcolato (passaggio 1), è possibile aggiungere un calcolo nella scheda Calcoli come riportato di seguito. Selezionare il Tipo di calcolo come riportato di seguito.
   • Assegna valore a elenco: selezionare l'attributo associato.
   • Condizionale: aggiungere la condizione per Definizione calcolo.
   • Con script: fornire la definizione del calcolo e 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 riportata di seguito.

   Tabella 43-2 Tipo di dati e tipo di calcolo

   Tipo di dati selezionato nella scheda Proprietà	Tipo di calcolo	Descrizione
   Tutti i tipi di dati	Selezionare Assegna valore a elenco, quindi 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.
   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 Vedere 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 è inferiore a zero, viene restituito il valore positivo del numero. Se il numero specificato è maggiore o uguale a zero, viene restituito il numero specificato.

  ABS(<Number>)

• 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 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 con il valore delle 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 nidificati in modo da supportare anche i calcoli di tipo ELSE IF.

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

  Di seguito è riportato un 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(<Value>)

  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 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 precedenti: restituisce il valore minimo nel corso di X periodi precedenti.

  MIN_PRIOR (<Value>, (<Value>, <Number oMIN_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 esponenziale di un altro.

  POWER(x,y) in cui x=BASE NUMBER e y=EXPONENT e x e y possono essere attributi o calcoli purché siano numerici.

  Esempio: POWER(3,4)=81

  Nota:

  I numeri frazionari ridurranno il numero alla sua radice. Ad esempio, POWER(27, 1/3) = 3 la radice del cubo.

  I valori negativi eseguiranno un'operazione inversa a quella del calcolo esponenziale. Ad esempio, POWER(2, -2) = 1 / (2^2) = 1 / 4 = .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 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(<Value>)

  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 riportati di seguito.

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

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

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

     INSTRING(<Value>, <Value To Search>) viene aggiunto a Definizione calcolo.

   • 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 quindi fare clic su Aggiungi.

     <Valore> viene modificato in {TextInput}.

   • Sostituire <valore da cercare> con 'tion'.

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

5. Fare clic su OK per salvare gli attributi.

Aggiunta di attributi dalla dimensione

Nella finestra Aggiungi attributo da dimensione, eseguire le operazioni riportate di seguito.

1. Selezionare una 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 si chiude e gli attributi selezionati vengono visualizzati nella finestra Modifica raccolta.

4. È possibile selezionare la casella di controllo nella colonna Rendi persistente per indicare che il valore dell'attributo deve essere reso persistente nei form a cui si fa riferimento. Se l'attributo dimensione viene aggiornato, le modifiche non vengono aggiornate nei form in cui viene fatto riferimento all'attributo. Se non si seleziona questa casella di controllo, l'attributo a cui si fa 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.