Drukuj      Otwórz Pomoc bezpośrednią w wersji PDF


Poprzedni temat

Następny temat

Wyrażenia - informacje

Wyrażenie to poprawna kombinacja jednego lub więcej operatorów, funkcji, pól i literałów, która może zostać przetworzona przez Oracle CRM On Demand. W tym temacie przedstawiono następujące informacje dotyczące wyrażeń:

  • Pola i formaty nazw pól w wyrażeniach
  • Długość wyrażenia
  • Długość literału
  • Wyrażenia warunkowe
  • Wyrażenia sprawdzające poprawność
  • Używanie w wyrażeniach pól zależnych

Pola i składnia nazw pól w wyrażeniach

Większość pól dostępnych na stronie konfiguracji pól danego typu rekordu jest również dostępna na liście pól tego typu rekordu w Expression Builder i może być używana w wyrażeniach.

UWAGA: Wyjątkiem są pola niestandardowe typu "Tekst (krótki, maskowalny)". Tych pól nie można używać w wyrażeniach w Expression Builder.

Po dodaniu pola do wyrażenia poprzez wybór nazwy pola z listy pól w Expression Builder, pole jest wprowadzane w edytorze wyrażeń w następującym formacie:

[{FieldName}]

Nazwy pól pojawiające się w edytorze wyrażeń są nazwami pól niezależnymi od języka i są używane do wewnętrznej identyfikacji pól w aplikacji Oracle CRM On Demand. Chociaż można wprowadzać nazwy pól bezpośrednio w edytorze wyrażeń używając składni [{FieldName}], zaleca się, aby zawsze wybierać pola z listy pól, aby nazwy pól w wyrażeniu były poprawne.

Nazwy pól i składnia nazw pól w wyrażeniach we wcześniejszych wydaniach - informacje

W wydaniach Oracle CRM On Demand wcześniejszych niż Wydanie 29 z dodatkiem Service Pack 1, gdy wybrało się pole z listy pól w Expression Builder, pole to było wprowadzane do edytora wyrażeń z użyciem następującej składni:

[<FieldName>]

Ponadto, w wydaniach wcześniejszych niż Wydanie 29 z dodatkiem Service Pack 1, aplikacja Expression Builder wykorzystywała nazwy pól niezależne od języka, które różniły się od nazw pól niezależnych od języka dostępnych w Expression Builder w Wydaniu 29 z dodatkiem Service Pack 1 i nowszych. Wszystkie wyrażenia zawierające składnię [<FieldName>] i odpowiednie nazwy pól, a także uznawane za prawidłowe we wcześniejszych wydaniach będą nadal poprawne w Wydaniu 29 z dodatkiem Service Pack 1 i nowszych. Można także nadal wprowadzać stare nazwy pól niezależne od języka o składni [<FieldName>] bezpośrednio do edytora wyrażeń. Zaleca się jednak, aby zawsze wybierać pola z listy "Pola" w aplikacji Expression Builder w taki sposób, aby nazwy pól i składnia nazw pól były zawsze poprawne.

Wyrażenie może zawierać mieszankę starych i nowych nazw pól, jeśli składnia [{FieldName}] jest używana dla nowych nazw pól, a składnia [<FieldName>] dla starych nazw pól.

Oracle CRM On Demand - pomoc bezpośrednia - informacje o przykładach

Niektóre przykłady wyrażeń pojawiających się w pomocy zawierają nazwy pól niezależne od języka oraz składnię nazw pól, które były używane w wydaniach wcześniejszych niż Wydanie 29 z dodatkiem Service Pack 1. Przykłady te są nadal prawidłowe. Jeśli jednak zostaną wybrane odpowiednie pola z listy pól w aplikacji Expression Builder podczas tworzenia lub aktualizacji wyrażenia w Wydaniu 29 z dodatkiem Service Pack 1 lub nowszym, nazwy pól w wyrażeniu będą inne od nazw pól z przykładów pokazanych w pomocy, a pola pojawiające się w edytorze wyrażeń będą korzystały z nowej składni.

Długość wyrażenia

W przypadku treści wiadomości e-mail konfigurowanej za pomocą czynności "Wysyłanie wiadomości e-mail" reguły procesu Workflow maksymalna obsługiwana długość wyrażenia wynosi 2000 znaków, w tym spacje. W wiadomości e-mail można wstawić znak podziału wiersza, naciskając klawisz Enter. Znak podziału wiersza jest w polu tekstowym liczony jako dwa znaki.

We wszystkich pozostałych przypadkach, w których jest używany Expression Builder, maksymalna obsługiwana długość wyrażenia to 1024 znaki, w tym spacje.

Trzeba także zapewnić, aby łączna liczba znaków w polu, w którym jest zapisywane wyrażenie, nie przekraczała limitu tego pola. W następujących polach procesu Workflow zarówno przed nazwami funkcji i pól, jak i po nich są umieszczane trzy znaki procentu (%%%):

  • Pola "Temat" i "Treść wiadomości" wiadomości e-mail konfigurowanej przez czynność "Wysyłanie wiadomości e-mail".
  • Pola "Temat" i "Opis" zadania konfigurowanego poprzez czynność "Tworzenie zadania".

Znaki procentu sygnalizują, że funkcja lub nazwa pola ma zostać przekonwertowana na wartość tekstową. Każdy znak procentu jest w polu, w którym jest zapisywany wyrażenie, liczony jako jeden znak.

Wpisując bezpośrednio w polu nazwę funkcji lub nazwę pola, trzeba przed nazwą i po nazwie wpisać trzy znaki procentu. Jeśli do wstawienia nazwy funkcji lub nazwy pola jest używane narzędzie Expression Builder, znaki procentu są dodawane automatycznie.

Na przykład, jeśli Expression Builder zostanie użyty do wstawienia następującego pola do treści wiadomości e-mail wynikającej z czynności procesu Workflow:

[{Name}]

Expression Builder wstawi do treści tej wiadomości e-mail w czynności procesu Workflow następujący tekst (łącznie do 14 znaków):

%%%[{Name}]%%%

Długość literału

Podczas przekazywania literału znakowego lub liczbowego do funkcji w narzędziu Expression Builder literał nie może zawierać więcej niż 75 znaków ze spacjami. Jeśli długość literału przekracza 75 znaków, Expression Builder uznaje go za błąd składni. Podczas przekazywania ciągu znaków do funkcji przy użyciu odwołania do nazwy pola, limit 75 znaków nie dotyczy długości wartości w polu przekazywanym do literału.

Podczas tworzenia wyrażenia w celu ustawienia domyślnej wartości pola, limit 75 znaków dotyczy wszystkich literałów znakowych i liczbowych przekazywanych do dowolnej funkcji w wyrażeniu. Ponadto, liczba znaków w wyniku wyrażenia nie może przekraczać maksymalnej liczby znaków dozwolonej w polu.

Wyrażenia warunkowe

Wyrażenie warunkowe jest wyrażeniem, które po obliczeniu przez aplikację zawsze zwraca wartość logiczną, taką jak True lub False.

UWAGA: Yes, No, Y i N nie są wartościami logicznymi. Jeśli wartości True lub False zostaną określone jako wartości zwracane przez funkcje, takie jak IIf, to wartości True i False będą zwracane nie jako wartości logiczne, lecz jako wartości napisowe. Użycie niepoprawnych wartości logicznych w wyrażeniach warunkować może być przyczyną nieprzewidzianego działania.

Wyrażenie musi być wyrażeniem warunkowym, jeśli zostanie użyte w którymkolwiek z następujących kontekstów:

  • Określanie reguły sprawdzania poprawności pola.
  • Określanie warunku w regule procesu Workflow.
  • Jako pierwszy parametr funkcji IIf.

Wyrażenia sprawdzające poprawność

Wyrażenia sprawdzające poprawność są używane do zapewnienia poprawności danych wprowadzanych do pól. Wyrażenie sprawdzające poprawność musi być wyrażeniem warunkowym.

Wyrażenie sprawdzające poprawność pola jest obliczane w chwili tworzenia rekordu oraz przy każdej aktualizacji pola przez użytkownika, z wyjątkiem następujących sytuacji:

  • Podczas tworzenia rekordu pole jest pozostawiane puste. Funkcja sprawdzania poprawności pól nie wymaga wprowadzania wartości.
  • W polu już istnieje niepoprawna wartość, która nie jest zmieniana podczas aktualizacji.

Jeśli wyrażenie sprawdzania poprawności nie zostanie obliczone lub jeśli da w wyniku wartość NULL, to nie zostanie wygenerowany żaden komunikat o błędzie. Komunikat o błędzie jest generowany tylko wtedy, gdy wyrażenie sprawdzania poprawności da wynik negatywny, tj. da w wyniku wartość FALSE.

Wyrażenie sprawdzające poprawność różni się od innych typów wyrażeń tym, że może się zaczynać operatorem warunkowym. Na przykład, jeśli wyrażenie sprawdza poprawność pola "Nazwa podmiotu", to może się zaczynać w następujący sposób:

= 'Acme Hospital'

Wyrażenie to, mimo że nie ma poprawnej postaci, przejdzie pozytywnie przez proces sprawdzania składni, ponieważ Oracle CRM On Demand, jeśli na początku wyrażenia nie znajdzie nazwy pola, wstawi nazwę weryfikowanego pola. Wyrażenie sprawdzające poprawność pola można również wprowadzić w formie:

[<AccountName>]= 'Acme Hospital'

gdzie [<AccountName>] jest weryfikowanym polem.

Jeśli wyrażenie wymaga, aby zostały wykonane obliczenia także dla innych pól innych niż weryfikowane, to standardową praktyką jest dokonywanie pierwszego porównania dla pola weryfikowanego.

Wyrażenia sprawdzające poprawność są używane tylko w polu "Sprawdzanie poprawności pola", na stronie zaawansowanego zarządzania polami w Oracle CRM On Demand.

Przykłady wyrażeń sprawdzających poprawność

Przykład 1. Proces biznesowy wymaga, aby data zamknięcia możliwości była późniejsza niż data utworzenia możliwości.

W celu implementacji tego procesu należy utworzyć wyrażenie sprawdzania poprawności pola "Data zamknięcia" (na stronie "Konfiguracja pól" dla możliwości) w następujący sposób:

> [<CreatedDate>]

Alternatywnie można użyć następującego przykładu (trzeba przy tym pamiętać, że weryfikowane pole "Data zamknięcia" musi być pierwszym polem w wyrażeniu):

[<CloseDate>] > [<CreatedDate>]

Informacje o tworzeniu i edytowaniu pól są dostępne pod hasłem Tworzenie i edytowanie pól.

Przykład 2. Proces biznesowy wymaga, aby przychód z możliwości był wartością niezerową, gdy prawdopodobieństwo możliwości jest równe lub większe niż 40%.

Z tej reguły biznesowej wynika, że zależność występuje w odniesieniu do obu pól; regułę tę można wyrazić w inny sposób:

Dla możliwości przychód nie może być równy zero, gdy prawdopodobieństwo jest równe lub większe niż 40. I odwrotnie: prawdopodobieństwo nie może być równe ani większe niż 40, jeśli przychód jest równy zero.

Wyrażenie sprawdzające poprawność pola jest obliczane w chwili tworzenia rekordu oraz przy każdej aktualizacji pola przez użytkownika. Ponieważ aktualizacja któregokolwiek z pól "Prawdopodobieństwo" i "Przychód" może mieć wpływ na oba pola, trzeba — w celu właściwej implementacji reguły biznesowej — wprowadzić reguły sprawdzania poprawności obu tych pól. (Informacje o tworzeniu i edytowaniu pól są dostępne pod hasłem Tworzenie i edytowanie pól.)

Kroki prowadzące do implementacji tej przykładowej reguły są następujące:

  1. Skonfigurować następującą regułę sprawdzania poprawności pola "Prawdopodobieństwo":

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

    Należy zwrócić uwagę, że nie jest tu używany znak procentu (%).

  2. Dodać do pola "Prawdopodobieństwo" komunikat o błędzie wykrytym podczas sprawdzania poprawności, na przykład:

    Przychód musi być większy niż 0, jeśli prawdopodobieństwo jest równe lub większe niż 40%.

  3. Skonfigurować dla pola "Przychód" następującą regułę sprawdzania poprawności:

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

  4. Dodać do pola "Przychód" komunikat o błędzie wykrytym podczas sprawdzania poprawności, na przykład:

    Przychód musi być większy niż 0, jeśli prawdopodobieństwo jest równe lub większe niż 40%.

Używanie pól zależnych w wyrażeniach

Pole zależne to pole złączenia, którego wartości zależą od klucza obcego. Pole złączenia jest to pole z typu rekordu stanowiące klucz obcy, używany w celu odwołania się do pola w innym typie rekordu. Przykładem pola zależnego jest pole "AccountName" w typie rekordu "Opportunity". Pole "AccountName" w typie rekordu "Opportunity" jest polem złączenia, którego wartości są zależne od pola klucza obcego "AccountId", odwołującego się do typu rekordu "Account".

Jeśli celem wyrażenia jest ustalenie wartości pola zależnego, zaleca się użycie funkcji "JoinFieldValue" i pobranie ostatniej wartości pola poprzez odwołanie do pola "ID", czyli pola klucza obcego. W przeciwnym razie wyniki wyrażenia mogą być nieprawidłowe i nieprawidłowy może być rezultat w postaci wartości wyrażenia. Więcej informacji o polach złączenia oraz funkcji "JoinFieldValue" można znaleźć pod hasłem JoinFieldValue.

Tematy pokrewne

Pokrewne informacje dotyczące narzędzia Expression Builder są zawarte w następujących tematach:


Opublikowano: Wrzesień 2017 Copyright © 2005, 2017, Oracle. Wszelkie prawa zastrzeżone. Legal Notices.