Udskriv      Åbn PDF-version af online-hjælp


Forrige emne

Næste emne

Om udtryk

Et udtryk er en gyldig kombination af en eller flere operatorer, funktioner, felter og litteraler, der kan evalueres af Oracle CRM On Demand. Dette emne indeholder oplysninger om følgende funktioner til udtryk:

  • Felter og feltnavneformater i udtryk
  • Udtrykslængde
  • Litterallængde
  • Betingede udtryk
  • Valideringsudtryk
  • Brug af afhængige felter i udtryk

Felter og feltnavnesyntaks i udtryk

De fleste af felterne, der er tilgængelige på feltopsætningssiden til en posttype, er også tilgængelige i feltlisten til den posttype i Expression Builder og kan bruges i udtryk.

BEMÆRK: Tilpassede felter af felttypen Tekst (kort - maskerbar) er en undtagelse. Du kan ikke bruge disse felter i et udtryk i Expression Builder.

Når du føjer et felt til et udtryk ved at vælge feltnavnet fra feltlisten i Expression Builder, indtastes feltnavnet i udtrykseditoren med følgende syntaks:

[{FieldName}]

Feltnavnene, der vises i udtrykseditoren, er sproguafhængige feltnavne, der bruges til at identificere felterne internt i Oracle CRM On Demand. Selv om du også kan skrive feltnavne direkte i udtrykseditoren vha. syntaksen [{FieldName}], anbefales det, at du altid vælger felterne i listen over felter, så feltnavnene i udtrykket er korrekte.

Om feltnavne og feltnavnesyntaks i udtryk i tidligere releases

I releases før Release 29 Service Pack 1 til Oracle CRM On Demand blev feltet indtastet i udtrykseditoren med følgende syntaks, når du valgte et felt i listen over felter i Expression Builder:

[<FieldName>]

Desuden brugte Expression Builder i releases før Release 29 Service Pack 1 sproguafhængige feltnavne, der er forskellige fra de sproguafhængige feltnavn, der bruges i Expression Builder i Release 29 Service Pack 1 og senere releases. Udtryk, der bruger syntaksen [<FieldName>] og de tilhørende feltnavne, og som var gyldige i tidligere releases, fortsætter imidlertid med at være gyldige i Release 29 Service Pack 1 og senere releases. Du kan også fortsætte med at skrive de gamle sproguafhængige feltnavne med syntaksen [<FieldName>] direkte i udtrykseditoren, hvis du ønsker det. Det anbefales imidlertid, at du altid vælger felterne i listen over felter i Expression Builder, så feltnavnene og feltsyntaksen altid er korrekte.

Et udtryk kan indeholde en blanding af de nye feltnavne og de gamle feltnavne, forudsat at syntaksen [{FieldName}] bruges til de nye feltnavne, og at syntaksen [<FieldName>] bruges til de gamle feltnavne.

Om eksemplerne i online-hjælp til Oracle CRM On Demand

Nogle af eksemplerne på udtryk, der vises i online-hjælpen, bruger de sproguafhængige feltnavne og feltnavnesyntaksen, der blev brugt i releases før Release 29 Service Pack 1. Disse eksempler er stadig gyldige. Hvis du vælger de tilhørende felter i listen over felter i Expression Builder, når du opretter eller opdaterer et udtryk i Release 29 Service Pack 1 eller nyere, vil feltnavnene i udtrykket imidlertidg være forskellige fra de feltnavne, der vises i eksemplerne i online-hjælpen, og felterne vil blive vist i udtrykseditoren med den nye feltsyntaks.

Udtrykslængde

Til meddelelsesteksten i en e-mail, der er konfigureret via handlingen Send·e-mail i en arbejdsgangregel, er den maksimalt understøttede længde til et udtryk 2000 tegn inkl. mellemrum. Du kan indsætte et linjeskift i e-mail-meddelelsen ved at trykke på Enter. Et linjeskift tælles som to tegn i tekstboksen.

I alle andre tilfælde, hvor Expression Builder bruges, er den maksimalt understøttede længde i et udtryk 1024 tegn, inkl. mellemrum.

Du skal også sørge for, at det samlede antal tegn i det felt, hvor du gemmer udtrykket, ikke overskrider grænsen til feltet. I følgende arbejdsgangfelter anbringes tre procenttegn (%%%) før og efter funktioner og feltnavne:

  • Felterne Emne og Meddelelsestekst i en e-mail konfigureres via handlingen Send·e-mail
  • Felterne Emne og Beskrivelse i en opgave konfigureres via handlinen Opret opgave

Procenttegnene angiver, at funktionen eller feltnavnet skal konverteres til en tekstværdi. Hvert procenttegn tælles som ét tegn i det felt, hvor udtrykket er gemt.

Hvis du skriver en funktion eller et feltnavn direkte i feltet, skal du skrive tre procenttegn før og efter funktionen eller feltnavnet. Hvis du bruger Expression Builder til at integrere en funktion eller et feltnavn, tilføjes procenttegnene automatisk.

Hvis du f.eks. bruger Expression Builder til at indsætte følgende feltnavn i meddelelsesteksten til en e-mail i en handling til arbejdsgang:

[{Name}]

Expression Builder indsætter følgende (i alt 14 tegn) i e-mailens meddelelsesbrødtekst på arbejdsganghandlingen:

%%%[{Name}]%%%

Litterallængde

Når du overfører en streng eller numerisk litteral til en funktion i Expression Builder, må litteralen ikke indeholde mere end 75 tegn inkl. mellemrum. Hvis en litteral overskrider 75 tegn, anser Expression Builder litteralen for at være en syntaksfejl. Når du overfører en streng til en funktion ved at referere til et feltnavn, gælder grænse på 75 tegn ikke for længden på værdien i det felt, der overføres til litteralen.

Når du opretter et udtryk for at sætte en standardværdi til et felt, gælder grænsen på 75 tegn for enhver streng eller numerisk litteral, der overføres til en funktion i udtrykket. Desuden må antallet af tegn i resultatet af udtrykket ikke overskride det maksimalt tilladte antal tegn i feltet.

Betingede udtryk

Et betinget udtryk er et udtryk, som altid returnerer en boolsk værdi, så som True eller False, når det evalueres af applikationen.

BEMÆRK: Yes, No, Y og N er ikke boolske værdier. Hvis du angiver True eller False som returværdier til funktioner, så som funktionen IIf, returneres True og False som strenge og ikke som boolske værdier. Brug af forkerte boolske værdier i betingede udtryk kan medføre utilsigtet virkemåde.

Et udtryk, der bruges i en af følgende kontekster, skal være et betinget udtryk:

  • For at angive en feltvalideringsregel
  • For at angive en betingelse i en arbejdsgangregel
  • Som den første parameter i en IIf-funktion

Valideringsudtryk

Valideringsudtryk bruges til at sikre, at data, der er indtastet i felter, er gyldige. Et valideringsudtryk skal være et betinget udtryk.

Et valideringsudtryk til et felt evalueres, hver gang feltet opdateres på en ny eller eksisterende post. Et valideringsudtryk evalueres imidlertid ikke under følgende omstændigheder:

  • Feltet efterlades tomt, når posten oprettes eller ændres. Feltvalidering gennemtvinger ikke, at en værdi skal være påkrævet.
  • Feltet har en eksisterende værdi, enten gyldig eller ugyldig, og værdien ændres ikke, når posten opdateres.

Hvis et valideringsudtryk ikke evalueres, eller hvis et valideringsudtryk evalueres til NULL, genereres ingen fejlmeddelelse. En fejlmeddelelse genereres kun, når valideringsudtrykket fejler (dvs. udtrykket evalueres til FALSE).

Et valideringsudtryk er forskelligt fra andre typer udtryk i og med, at det kan begynde med en betinget operator. Hvis f.eks. Kontonavn er det felt, der valideres af udtrykket, kan udtrykket begynde med:

= 'Acme Hospital'

Selv om det ikke er veludformet, vil dette udtryk gennemgå en syntakskontrol, da Oracle CRM On Demand indsætter navnet på det felt, der valideres før udtrykket, hvis det ikke finder et feltnavn i begyndelsen af udtrykket. Du kan også indtaste valideringsudtrykket, som følger:

[<AccountName>]= 'Acme Hospital'

hvor [<AccountName>] er det felt, der valideres.

Hvis udtrykket kræver, at andre felter evalueres ud over det felt, der valideres, er det standardpraksis, at den første sammenligning i udtrykket udføres på det felt, der valideres.

Valideringsudtryk bruges kun i tekstboksen Feltvalidering i avanceret feltstyring i Oracle CRM On Demand.

Eksempler på valideringsudtryk

Eksempel 1: En forretningsproces kræver, at en salgsmuligheds lukkedato skal ligge efter salgsmulighedens oprettelsesdato.

Opret et valideringsudtryk til feltet Lukkedato (på siden Feltopsætning til salgsmuligheder) for at implementere denne proces:

> [<CreatedDate>]

Alternativt kan du bruge følgende eksempel, men bemærk, at det felt, der evalueres (Lukkdato) skal være det første felt i udtrykket:

[<CloseDate>] > [<CreatedDate>]

Se Oprettelse og redigering af felter for at få oplysninger om oprettelse og redigering af felter.

Eksempel 2: En forretningsproces kræver, at en salgsmuligheds omsætning skal være en værdi, der ikke er nul, når salgsmulighedens sandsynlighed er 50% eller mere.

Forretningsreglen angiver, at afhængigheden er på begge felter og kan genangives, som følger:

Til en salgsmulighed kan omsætning ikke være nul, når sandsynligheden er større end eller lig med 40. Omvendt kan sandsynligheden ikke være større end eller lig med 40, hvis omsætningen er nul.

Et valideringsudtryk til et felt evalueres, når posten oprettes, og hver gang feltet opdateres af en bruger. Da en opdatering af enten feltet Sandsynlighed eller feltet Omsætning kan påvirke begge felter, skal du have valideringsregler på både feltet Sandsynlighed og feltet Omsætning for at implementere forretningsreglen korrekt. (Se Oprettelse og redigering af felter for at få oplysninger om oprettelse og redigering af felter).

Følgende trin kræves for at implementere dette eksempel:

  1. Konfigurer følgende valideringsregel til feltet Sandsynlighed:

    < 40 OR ([<Sandsynlighed>]>= 40 AND [<Omsætning>]> 0)

    Bemærk, at du ikke bruger procenttegnet (%).

  2. Tilføj en valideringsfejlmeddelelse, så som følgende, til feltet Sandsynlighed:

    Omsætning skal være større end 0, når sandsynlighed er større end eller lig med 40%.

  3. Konfigurer følgende valideringsregel til feltet Omsætning:

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

  4. Tilføj en valideringsfejlmeddelelse, så som følgende, til feltet Omsætning:

    Omsætning skal være større end 0, når sandsynlighed er større end eller lig med 40%.

Brug af afhængige felter i udtryk

Et afhængigt felt er et sammenføjet felt, hvis værdier afhænger af en fremmednøgle. Et sammenføjet felt er et felt i en posttype, der bruger en fremmednøgle til at referere til et felt i en anden posttype. Et eksempel på et uafhængigt felt er feltet AccountName på posttypen Salgsmulighed. Feltet AccountName på posttypen Salgsmulighed er et sammenføjet felt, hvis værdier afhænger af fremmednøglefeltet AccountId, som refererer til posttypen Konto.

Hvis udtrykket skal fastlægge værdien i et uafhængigt felt, anbefales det, at du bruger funktionen JoinFieldValue og henter den seneste værdi af feltet ved at referere til Id-feltet, dvs. fremmednøglefeltet. Ellers kan resultaterne af udtrykket være forkerte, og udfaldet af udtryksværdien kan være ugyldig. Se JoinFieldValue for at få flere oplysninger om sammenføjede felter og funktionen JoinFieldValue.

Relaterede emner

Se følgende emner for relaterede oplysninger om Expression Builder:


Publiceret August 2018 Copyright © 2005, 2018, Oracle. Alle rettigheder forbeholdes. Legal Notices