![]() |
|
О выраженияхВыражение представляет собой допустимую комбинацию одного или нескольких операторов, функций, полей и литералов, которая может быть вычислена в Oracle CRM On Demand. В этом разделе приведена информация о следующих функциях выражений.
Поля и синтаксис имен полей в выраженияхБольшинство полей, доступных на странице настройки полей для типа записи, также доступны и в списке полей для этого типа записи в Expression Builder и могут использоваться в выражениях. ПРИМЕЧАНИЕ. Пользовательские поля типа "Текст (сокращенный - маскируемый)" составляют исключение. Эти поля не могут использоваться в выражениях Expression Builder. Если добавить поле в выражение, выбрав имя поля в списке полей в Expression Builder, это поле вводится в редактор выражений со следующим синтаксисом: [{FieldName}] Имена полей, отображающиеся в редакторе выражений, являются независимыми от языка именами полей, которые используются для внутренней идентификации полей в Oracle CRM On Demand. Несмотря на то, что также можно ввести имена полей непосредственно в редакторе выражений, используя синтаксис [{FieldName}], рекомендуется всегда выбирать поля в списке полей, чтобы имена полей в выражении были правильными. Имена полей и синтаксис имен полей в выражениях в предыдущих версияхПри выборе поля в списке полей в Expression Builder в версиях Oracle CRM On Demand, предшествующих выпуску 29 с пакетом обновлений 1, поле вводилось в редактор выражений со следующим синтаксисом: [<FieldName>] Кроме того, в версиях до выпуска 29 с пакетом обновлений 1 в Expression Builder использовались независимые от языка имена полей, которые отличались от независимых от языка имен полей, используемых в Expression Builder в выпуске 29 с пакетом обновления 1 и последующих версиях. Однако любые выражения, использующие синтаксис [<FieldName>] и соответствующие имена полей, которые были допустимыми в предыдущих версиях, остаются допустимыми в выпуске 29 с пакетом обновлений 1 и последующих версиях. Также при желании можно по-прежнему вводить прежние независимые от языка имена полей с синтаксисом [<FieldName>] непосредственно в редакторе выражений. Однако рекомендуется выбирать поля в списке полей в Expression Builder, чтобы имена полей и синтаксис полей всегда были правильными. Выражение может содержать и новые, и старые имена полей одновременно при условии, что для новых имен полей используется синтаксис [{FieldName}], а для старых - синтаксис [<FieldName>]. Примеры в интерактивной справке Oracle CRM On DemandВ некоторых примерах выражений, представленных в интерактивной справке, используются независимые от языка имена полей и синтаксис имен полей, которые использовались в версиях до выпуска 29 с пакетом обновлений 1. Эти примеры по-прежнему являются допустимыми. Однако если выбрать соответствующие поля в списке полей в Expression Builder при создании или обновлении выражения в выпуске 29 с пакетом обновлений 1 или последующих версиях, то имена полей в выражении будут отличаться от имен полей, приведенных в примерах в интерактивной справке, а в редакторе выражений поля будут выводиться с использованием нового синтаксиса полей. Длина выраженияМаксимальная поддерживаемая длина выражения для текста сообщения электронной почты, настроенного в правиле потока операций с использованием действия "Отправка электронной почты", составляет 2000 символов, включая пробелы. В сообщение электронной почты можно вставить разрыв строки, нажав клавишу Enter. Разрыв строки учитывается в текстовом поле как два символа. Во всех остальных случаях при использовании Expression Builder максимальная поддерживаемая длина выражения составляет 1024 символа, включая пробелы. Необходимо также убедиться в том, что общее количество символов в поле, в котором сохраняется выражение, не превосходит предельной величины для этого поля. В указанных ниже полях потоков операций перед функциями и именами полей и после них вставляются по три знака процентов (%%%).
Знаки процентов указывают на то, что функция или имя поля будут преобразованы в текстовое значение. В поле, в котором сохраняется выражение, каждый знак процентов учитывается как один символ. При вводе функций и имен полей непосредственно в полях необходимо вводить перед ними и после них по три знака процентов. При вводе функции или имени поля с помощью инструмента Expression Builder знаки процентов добавляются автоматически. Например, если Expression Builder используется для вставки следующего имени поля в текст сообщения электронной почты, связанного с действием потока операций: [{Имя}] При выполнении действия потока операций в текст сообщения электронной почты Expression Builder вставляет следующий фрагмент (всего 14 символов): %%%[{Имя}]%%% Длина литералаЕсли в функцию Expression Builder передается строковый или числовой литерал, он должен содержать не более 75 символов, включая пробелы. Если длина литерала превышает 75 символов, Expression Builder считает это синтаксической ошибкой. Если в функцию передается строка в виде ссылки на имя поля, к длине значения этого поля ограничение в 75 символов не применяется. При создании выражения, задающего значение по умолчанию для поля, ограничение в 75 символов применяется к каждому строковому или числовому литералу, передаваемому в любую функцию в составе выражения. Кроме того, число символов в результирующем значении выражения не должно превышать числа символов, разрешенного для поля. Условные выраженияУсловными являются выражения, при вычислении которых в приложении всегда возвращается логическое значение: "истина" или "ложь". ПРИМЕЧАНИЕ. "Да", "Нет", "Y" и "N" не являются логическими значениями. Если в качестве возвращаемых значений функций, например, функции IIf, заданы значения "True" или "False", они возвращаются как строковые, а не логические значения. Употребление неверных логических значений в условных выражениях может привести к непредсказуемым результатам. Выражение, используемое в указанных ниже ситуациях, должно быть условным.
Выражения для проверкиВыражения для проверки позволяют убедиться в том, что в полях введены допустимые данные. Выражение для проверки должно быть условным. Выражение для проверки поля вычисляется при создании записи, а также каждый раз при обновлении поля пользователем, за исключением следующих ситуаций.
Если значение выражения проверки не вычисляется или если значение выражения проверки равно NULL, сообщение об ошибке не генерируется. Сообщение об ошибке генерируется только в том случае, когда значение выражения проверки равно FALSE. В отличие от выражений других типов, условное выражение может начинаться с условного оператора. Например, выражение для проверки поля "Имя субъекта" может начинаться со следующего фрагмента: = "Acme Hospital" Хотя это выражение некорректно, оно проходит проверку синтаксиса, так как при отсутствии имени поля в начале выражения средствами Oracle CRM On Demand автоматически вставляется имя проверяемого поля. Можно также ввести выражение для проверки следующим образом: [<AccountName>]= "Acme Hospital" Здесь [<AccountName>] - проверяемое поле. Если для выражения требуется вычисление других полей, помимо проверяемого поля, согласно общепринятой практике первый оператор сравнения в выражении применяется к проверяемому полю. Выражения для проверки вводятся только в текстовое поле "Проверка полей" при работе с расширенными функциями управления полями в Oracle CRM On Demand. Примеры выражений для проверкиПример 1. В рамках коммерческой деятельности требуется, чтобы дата закрытия бизнес-возможности была позднее даты ее создания. В этом случае можно создать следующее выражение для проверки поля "Дата закрытия" (на странице "Настройка полей" для бизнес-возможностей): > [<CreatedDate>] Можно также воспользоваться следующим выражением, учитывая, что проверяемое поле ("Дата закрытия") должно быть первым полем в выражении: [<CloseDate>] > [<CreatedDate>] О создании и редактировании полей см. раздел Создание и редактирование полей. Пример 2. В рамках коммерческой деятельности требуется, чтобы при вероятности реализации бизнес-возможности, не меньшей 40%, выручка от этой бизнес-возможности была ненулевым значением. Бизнес-правило определяет зависимость для обоих полей и может быть переформулировано следующим образом. Выручка от бизнес-возможности не может быть равна нулю, если вероятность ее реализации больше или равна 40. Другими словами, вероятность не может быть больше или равна 40, если выручка равна нулю. Выражение для проверки поля вычисляется при создании записи, а также каждый раз при ее обновлении пользователем. Поскольку обновление в поле "Вероятность" или "Выручка" может повлиять на оба поля, для надлежащей реализации бизнес-правила необходимо задать правила проверки как для поля "Вероятность", так и для поля "Выручка". (О создании и редактировании полей см. в разделе Создание и редактирование полей.) Для реализации правила, рассматриваемого в этом примере, можно выполнить следующие действия.
Использование зависимых полей в выраженияхЗависимое поле - это объединенное поле, значения которого зависят от внешнего ключа. Присоединенное поле - это поле в записи определенного типа, связанное с полем в записи другого типа через внешний ключ. Примером зависимого поля является поле AccountName для типа записи "Возможная сделка". Поле AccountName для типа записи " Возможная сделка" - это объединенное поле, значения которого зависят от поля внешнего ключа AccountId, которое, в свою очередь, ссылается на тип записи Account. Если выражение должно определять значение зависимого поля, рекомендуется использовать функцию JoinFieldValue для получения последнего значения поля путем ссылки на поле ID, то есть поле внешнего ключа. В противном случае результаты выражения могут оказаться неправильными, и выходные данные значения выражения будут недопустимыми. Дополнительные сведения об объединенных полях и функции JoinFieldValue см. в разделе JoinFieldValue. Связанные разделыИнформацию об инструменте Expression Builder, связанную с данной темой, см. в следующих разделах. |
Опубликовано в Сентябрь 2017 | Copyright © Oracle, 2005, 2017 гг. Все права защищены.Legal Notices. |