Stampa      Aprire la Guida in linea in versione PDF


Argomento precedente

Argomento successivo

Informazioni sulle espressioni

Un'espressione è una combinazione valida di uno o più operatori, funzioni, campi e valori letterali che possono essere valutati da Oracle CRM On Demand. In questo argomento vengono fornite informazioni sulle seguenti caratteristiche delle espressioni:

  • Formati dei campi e del nome dei campi nelle espressioni
  • Lunghezza delle espressioni
  • Lunghezza dei valori
  • Espressioni condizionali
  • Espressioni di convalida
  • Uso di campi dipendenti nelle espressioni

Campi e sintassi FieldName nelle espressioni

La maggior parte dei campi disponibili nella pagina di impostazione del campo per un tipo di record sono presenti anche nell'elenco dei campi per quel determinato tipo di record in Expression Builder e possono essere utilizzati nelle espressioni.

NOTA: fanno eccezione i tipi di campo Testo (breve - mascherabile) personalizzati. Non è possibile utilizzare questi campi in un'espressione in Expression Builder.

Quando si aggiunge un campo a un'espressione selezionando il nome del campo dall'elenco dei campi in Expression Builder, il campo viene immesso nell'editor di espressioni con la sintassi seguente:

[{FieldName}]

I nomi dei campi che appaiono nell'editor di espressioni sono indipendenti dalla lingua e vengono utilizzati per identificare internamente i campi in Oracle CRM On Demand. Sebbene sia anche possibile digitare i nomi dei campi direttamente nell'editor di espressioni utilizzando la sintassi [{FieldName}], si consiglia di selezionare sempre i campi dall'elenco dei campi per essere sicuri che i nomi dei campi nell'espressione siano corretti.

Informazioni sui nomi dei campi e sulla sintassi FileName nelle espressioni nelle release precedenti

Nelle release precedenti alla Release 29 Service Pack 1 di Oracle CRM On Demand, quando si selezionava un campo dall'elenco dei campi in Expression Builder, il campo veniva immesso nell'editor di espressioni con la sintassi seguente:

[<FieldName>]

Inoltre, nelle release precedenti alla Release 29 Service Pack 1, Expression Builder utilizzava nomi di campo indipendenti dalla lingua diversi da quelli utilizzati in Expression Builder nella Release 29 Service Pack 1 e nelle release successive. Tutte le espressioni che utilizzano la sintassi [<FieldName>] e i nomi dei campi corrispondenti, e che erano valide nelle release precedenti, continuano tuttavia a essere valide nella Release 29 Service Pack 1 e nelle release successive. Se lo si desidera, è inoltre possibile continuare a digitare i vecchi nomi dei campi indipendenti dalla lingua con la sintassi [<FieldName>] direttamente nell'editor di espressioni. Si consiglia tuttavia di selezionare sempre i campi dall'elenco dei campi in Expression Builder, in modo che i nomi e la sintassi dei campi siano sempre corretti.

Un'espressione può contenere combinazioni di nomi di campo vecchi e nuovi, a condizione che si utilizzi la sintassi [{FieldName}] per i nuovi nomi di campo e la sintassi [<FieldName>] per i vecchi nomi di campo.

Informazioni sugli esempi della Guida in linea di Oracle CRM On Demand

In alcuni degli esempi di espressioni disponibili nella Guida in linea vengono utilizzati nomi di campo indipendenti dalla lingua e la sintassi FieldName utilizzati nelle release precedenti alla Release 29 Service Pack 1. Questi esempi sono ancora validi. Se tuttavia si selezionano i campi corrispondenti dall'elenco dei campi in Expression Builder quando si crea o aggiorna un'espressione nella Release 29 Service Pack 1 o in una release successiva, i nomi dei campi nell'espressione saranno diversi da quelli mostrati negli esempi della Guida in linea e i campi verranno visualizzati nell'editor di espressioni con la nuova sintassi.

Lunghezza delle espressioni

Per il testo del messaggio di un'e-mail configurata mediante l'azione Invia e-mail in una regola di workflow, la lunghezza massima supportata di un'espressione è 2000 caratteri, inclusi gli spazi. È possibile inserire un'interruzione di riga nel messaggio e-mail premendo Invio. Nelle caselle di testo un'interruzione di riga viene considerata come due caratteri.

In tutti gli altri casi in cui è utilizzato il Expression Builder, la lunghezza massima supportata di un'espressione è di 1024 caratteri inclusi gli spazi.

È inoltre necessario assicurarsi che il numero totale di caratteri nel campo in cui si sta salvando l'espressione non superi il limite stabilito per quel campo. Nei campi del workflow riportati di seguito, tre simboli di percentuale (%%%) sono posizionati prima e dopo i nomi delle funzioni e dei campi:

  • Campi Oggetto e Testo messaggio in un'e-mail configurata tramite l'azione Invia e-mail
  • Campi Oggetto e Descrizione in un task configurato tramite l'azione Crea task

I simboli di percentuale indicano che il nome del campo o della funzione deve essere convertito in un valore testo. Ogni simbolo di percentuale viene considerato un solo carattere nel campo in cui viene salvata l'espressione.

Se si digita un nome di funzione o di campo direttamente nel campo, è necessario digitare tre simboli di percentuale prima e dopo il nome. Se si utilizza Expression Builder per incorporare una funzione o un nome campo, i simboli di percentuale vengono aggiunti automaticamente.

Se ad esempio si utilizza il Expression Builder per inserire il nome di campo seguente nel corpo del messaggio di un'e-mail in un'azione di workflow:

[{Name}]

Expression Builder inserisce quanto riportato di seguito (per un totale di 14 caratteri) nel corpo del messaggio dell'e-mail nell'azione del workflow:

%%%[{Name}]%%%

Lunghezza dei valori

Quando si passa una stringa o un valore numerico a una funzione del Expression Builder, il valore non deve contenere più di 75 caratteri, spazi compresi. Se il valore supera il limite di 75 caratteri, il Expression Builder lo considera come un errore di sintassi. Quando si passa una stringa a una funzione mediante il riferimento a un nome campo, il limite di 75 caratteri non viene applicato alla lunghezza del valore nel campo passato al valore.

Quando si crea un'espressione per impostare il valore predefinito di un campo, il limite di 75 caratteri si applica a qualsiasi stringa o valore numerico passato a tutte le funzioni dell'espressione. Inoltre, il numero di caratteri nel risultato dell'espressione non deve superare il numero massimo di caratteri consentito per il campo.

Espressioni condizionali

Un'espressione condizionale è un'espressione che, quando viene valutata dall'applicazione, restituisce sempre un valore booleano quale True o False.

NOTA: Yes, No, Y e N non sono valori booleani. Se si specifica True o False come valori restituiti per funzioni quali IIf, True e False sono restituiti come stringhe e non come valori booleani. L'uso di valori booleani non corretti nelle espressioni condizionali può avere come risultato un comportamento imprevisto.

Un'espressione utilizzata in uno qualsiasi dei contesti seguenti deve essere un'espressione condizionale:

  • Per specificare un valore di convalida dei campi
  • Per specificare una condizione in una regola del workflow
  • Come primo parametro in una funzione IIf

Espressioni di convalida

Le espressioni di convalida vengono utilizzate per assicurarsi che i dati immessi nei campi siano validi. Un'espressione di convalida deve essere un'espressione condizionale.

Un'espressione di convalida per un campo viene valutata quando viene creato un record e ogni volta che un record viene aggiornato da un utente, con l'eccezione delle circostanze riportate di seguito.

  • Un campo viene lasciato vuoto durante la creazione del record. La convalida del campo non implica l'inserimento forzato di un valore.
  • Un campo contiene un valore preesistente non valido e non viene modificato durante l'aggiornamento.

Se un'espressione di convalida non viene valutata o se un'espressione di convalida restituisce NULL, non viene generato alcun messaggio di errore. Un messaggio di errore viene generato solo quando l'espressione di convalida non riesce, ovvero l'espressione restituisce FALSE.

Un'espressione di convalida differisce dagli altri tipi di espressioni in quando può iniziare con un operatore condizionale. Ad esempio se Nome cliente è il campo che deve essere convalidato dall'espressione, l'espressione può iniziare con:

= 'Acme Hospital'

Questa espressione, sebbene non sia costruita in modo corretto, supererà una verifica della sintassi, poiché Oracle CRM On Demand inserisce il nome del campo da convalidare prima dell'espressione se non trova un nome di campo all'inizio dell'espressione. È anche possibile immettere l'espressione di convalida nel modo descritto di seguito:

[<AccountName>]= 'Acme Hospital'

dove [<AccountName>] è il campo da convalidare.

Se l'espressione richiede la convalida di altri campi oltre al campo da convalidare, la procedura standard prevede che il primo confronto nell'espressione venga eseguita nel campo da convalidare.

Le espressioni di convalida vengono utilizzate solo nella casella di testo Convalida campo nella gestione dei campi avanzata di Oracle CRM On Demand.

Esempi di espressioni di convalida

Esempio 1: un processo aziendale richiede che la data di chiusura di un'opportunità debba essere successiva alla data di creazione dell'opportunità.

Per implementare questo processo, creare un'espressione di convalida per il campo Data di chiusura nella pagina Impostazione campo per le opportunità nel modo seguente:

> [<CreatedDate>]

In alternativa, è possibile utilizzare l'esempio seguente, ma tenere presente che il campo da valutare (Data di chiusura) deve essere il primo campo dell'espressione:

[<CloseDate>] > [<CreatedDate>]

Per informazioni sulla creazione e la modifica dei campi, vedere Creazione e modifica di campi.

Esempio 2: un processo aziendale richiede che il fatturato per un'opportunità debba essere un valore diverso da zero quando la probabilità dell'opportunità è pari al 40% o superiore.

La regola aziendale indica che la dipendenza si applica a entrambi i campi e può essere ridefinita nel modo seguente.

Per un'opportunità, il fatturato può essere pari a zero se l'opportunità è maggiore o uguale a 40. Al contrario, la probabilità non può essere maggiore o uguale a 40 se il fatturato è pari a zero.

Un'espressione di convalida per un campo viene valutata quando viene creato un record e ogni volta che il campo viene aggiornato da un utente. Poiché un aggiornamento del campo Probabilità o del campo Fatturato può influenzare entrambi i campi, è necessario disporre di regole di convalida su entrambi i campi Probabilità e Fatturato per implementare correttamente la regola aziendale. Per informazioni sulla creazione e la modifica dei campi, vedere Creazione e modifica di campi.

Di seguito sono indicati i passi necessari per implementare questo esempio.

  1. Configurare la regola di convalida seguente per il campo Probabilità:

    < 40 OR ([<Probability>]>= 40 AND [<Revenue>]> 0)

    Tenere presente che il segno di percentuale (%) non viene utilizzato.

  2. Aggiungere un messaggio di errore di convalida simile al seguente nel campo Probabilità:

    Il fatturato deve essere maggiore di 0 quando la probabilità è maggiore o uguale a 40%.

  3. Configurare la regola di convalida seguente per il campo Fatturato:

    (> 0 AND [<Probability>]>= 40) OR [<Probability>]< 40

  4. Aggiungere un messaggio di errore di convalida simile al seguente nel campo Fatturato:

    Il fatturato deve essere maggiore di 0 quando la probabilità è maggiore o uguale a 40%.

Uso di campi dipendenti nelle espressioni

Per campo dipendente si intende un campo unito i cui valori dipendono da una chiave esterna. Un campo unito è un campo di un tipo di record che utilizza una chiave esterna per fare riferimento a un campo di un altro tipo di record. Un esempio di campo dipendente è dato dal campo Nome cliente del tipo di record Opportunità. Il campo Nome cliente del tipo di record Opportunità è un campo unito i cui valori dipendono dal campo di chiave esterna ID cliente, che fa riferimento al tipo di record Cliente.

Se l'espressione deve determinare il valore di un campo dipendente, si consiglia di usare la funzione JoinFieldValue e di ottenere il valore più recente del campo facendo riferimento al campo ID, ovvero al campo della chiave esterna. In caso contrario, il risultato dell'espressione potrebbe essere errato e il valore risultato potrebbe non essere valido. Per ulteriori informazioni sui campi uniti e la funzione JoinFieldValue, vedere JoinFieldValue.

Argomenti correlati

Gli argomenti riportati di seguito contengono informazioni relative al Expression Builder.


Data di pubblicazione : ottobre 2016 Copyright © 2005, 2016, Oracle. Tutti i diritti riservati. Legal Notices.