Неявные переменные
Неявные переменные - это переменные, которые вы не задаете. Эти переменные автоматически предоставляются механизмом. Некоторые неявные переменные допустимы только при связывании с объявленной переменной, но есть и такие, которые не связаны с другими переменными.
В дополнение к неявным переменным в каждом сценарии можно использовать бизнес-объект Maximo (MBO). Для ссылки на текущий бизнес-объект используется зарезервированное слово mbo.
Неявные переменные, не связанные с другими переменными, задаются в сценарии и на эти переменные можно ссылаться непосредственно по имени. Например, app или mbo не связаны с другими переменными.
Переменные, перечисленные в следующей таблице, не связаны с другими переменными.
| Неявная переменная | Тип | Область действия | Описание |
|---|---|---|---|
| действие | String | Точка запуска действия | Указывает имя действия, которое генерируется в точке запуска действия. |
| app | String | Все точки запуска | Указывает имя прикладной программы, для которой выполняется сценарий. Переменная app передается в сценарий. |
| domainid | String | Используйте эту переменную только в том случае, когда точка запуска атрибута реализует событие получения списка. | Задает домен для предоставления списка значений, показанных для точки запуска атрибута. |
| errorgroup | String | Все точки запуска | Выбирает идентификатор группы сообщений, заданный в программе Конфигурация базы данных. Переменная errorgroup задается в сценарии. Вместе с переменной errorkey переменная errorgroup определяет сообщение об ошибке, объявленное в репозитории сообщений. |
| errorkey | String | Все точки запуска | Дает авторам сценария возможность задать сообщение об ошибке из сценария в бизнес-объект. Код сценария выбирает идентификатор ключа сообщения, заданный в программе Конфигурация базы данных. Переменная errorkey работает в сочетании с неявными переменными errorgroup и params. Преимущество использования сообщений об ошибках из репозитория сообщений состоит в том, что автоматически извлекаются переведенные сообщения. Код сценария задает группу ошибки, сконфигурированную в прикладной программе Конфигурация баз данных. Переменная errorkey задается в сценарии. |
| evalresult | Логический | Точка запуска по условию | Задано в сценарии. Сценарии проверки условий техпроцесса и условий защиты возвращают значения true или false. |
| interactive | Логический | Все точки запуска | Указывает, работает ли сценарий в активном сеансе пользователя или в не пользовательском фоновом сеансе (например, обработка транзакции интеграции). |
| launchPoint | String | Все точки запуска | Указывает имя точки запуска, для которой выполняется сценарий. |
| listErrorGroup | String | Используйте эту переменную только в том случае, когда точка запуска атрибута реализует событие получения списка. Совместно укажите переменные listErrorGroup и listErrorKey и используйте возможность сообщений в прикладной программе Конфигурация базы данных для выбора сообщения, хранимого в таблице MAXMESSAGES. | Определяет ID группы для сообщения, которое видит пользователь, когда событие получения списка завершается неудачно. |
| listErrorKey | String | Используйте эту переменную только в том случае, когда точка запуска атрибута реализует событие получения списка. Совместно укажите переменные listErrorGroup и listErrorKey и используйте возможность сообщений в прикладной программе Конфигурация базы данных для выбора сообщения, хранимого в таблице MAXMESSAGES. | Определяет ID ключа сообщения, которое видит пользователь, когда событие получения списка завершается неудачно. |
| listOrder | String | Используйте эту переменную только в том случае, когда точка запуска атрибута реализует событие получения списка. | Задается для любых имен атрибута ORDER BY, используемых для упорядочивания результатов события получения списка. |
| listWhere | String | Используйте эту переменную только в том случае, когда точка запуска атрибута реализует событие получения списка. | Устанавливает, какой набор данных результатов будет выводиться и какой фильтр задается перед показом этих результатов. Задайте переменную listWhere для условия WHERE, использующего соответствующий бизнес-объект Maximo (Maximo Business Object, MBO). |
| mbo | psdi.mbo.Mbo | Все точки запуска | Указывает MBO, с которым выполняется работа. |
| mboset | psdi.mbo.MboSet | Точки запуска объектов типа Разрешить создание | Указывает набор MBO, к которому будет добавлен новый MBO. |
| mboname | String | Все точки запуска | Указывает имя текущего MBO в контексте выполняемого сценария. |
| mbovalue | psdi.security.UseriInfo | Все события точки запуска атрибута | Экземпляр атрибута MBO для точки запуска атрибута. |
| onadd | Логический | Все точки запуска. Лучше всего использовать с точками запуска объектов, в которых сценарий применяется к нескольким типам событий (например, добавление, изменение и удаление). | Указывает, вставляется ли или создается ли бизнес-объект, для которого выполняется сценарий. Переменную onadd можно использовать для выполнения условных действий или проверок на основе состояния MBO. |
| ondelete | Логический | Все точки запуска | Указывает, удаляется ли бизнес-объект, для которого выполняется сценарий. |
| onupdate | Логический | Все точки запуска | Указывает, изменяется ли бизнес-объект, для которого выполняется сценарий. |
| params | String[] | Все точки запуска | Сохраняет окончательно разрешенные параметры для применения в сообщении об ошибке, которое передается из сценария. Неявная переменная params - это массив. В сообщение, объявленном в репозитории, могут быть заданы параметры. Контент сообщения полностью разрешается только во время выполнения в контексте кода сценария. Переменная params используется в сочетании с переменными errogroup и errorkey для подготовки передачи сообщения об ошибке из кода сценария. Переменная params задается в сценарии. |
| relationObject | String | Используйте эту переменную только в том случае, когда точка запуска атрибута реализует событие получения списка. Обычно используется с неявными переменными srcKeys и targetKeys. | Применяется к соответствующему MBO, который разыскивается из текущего MBO. |
| relationWhere | String | Используйте эту переменную только в том случае, когда точка запуска атрибута реализует событие получения списка. Обычно используется с неявными переменными srcKeys и targetKeys. | Устанавливает критерий, по которому выполняется событие получения списка. Задается для условия WHERE, запрашивающего соответствующий MBO. |
| scriptHome | psdi.mbo.Mbo | Точка запуска действия | Указывает MBO, с которым выполняется работа. Предпочтительный способ реализации сценариев - использование в коде сценария ключевого слова mbo. |
| scriptName | String | Все точки запуска | Задает имя выполняемого сценария. |
| service | com.ibm.tivoli.maximo. script.ScriptService | Все точки запуска | Добавляется в сценарий каркасом сценариев во время выполнения. |
| srcKeys | String[] | Когда точка запуска атрибута реализует событие получения списка | Применяется, чтобы задать имена атрибутов из текущего MBO, используемых для поиска соответствующей записи в другом связанном MBO или в MBO назначения. Например, набор имен атрибутов из текущего MBO может использоваться для поиска нужного поля FAILURECODES из бизнес-объекта ASSET. |
| thisvalue | Атрибут MBO для точки запуска атрибута | Используйте эту переменную как значение инициализации и ограничение доступа к инициализации для точек запуска атрибутов | Представляет текущий атрибут. Например, thisvalue="abc" задает в качестве текущего значения abc. |
| targetKeys | String[] | Когда точка запуска атрибута реализует событие получения списка | Применяется, чтобы задать имена атрибутов в MBO назначения, разыскиваемого из текущего MBO, для которого определена точка запуска атрибута. |
| user | String | Все точки запуска | Задает ID текущего зарегистрированного пользователя. Переменная user передается в сценарий; задать ее в коде нельзя. |
| userInfo | psdi.security.UserInfo | Все точки запуска | Предоставляет объект для текущего контекста. |
| wfinstance | psdi.workflow. WFInstance | Точка запуска действия, если действие запускается из техпроцесса. | Указывает экземпляр техпроцесса, из которого запускается текущее действие. |
Некоторые неявные переменные допустимы, только если они связаны с переменной, объявленной вами. Формат этих неявных переменных: имя объявленной переменной,
символ подчеркивания и имя неявной переменной. Например, если для сценария задана переменная
siteid, то строка кода siteid_readonly=True делает связанный атрибут бизнес-объекта
siteid атрибутом только для чтения.
Этот тип неявных переменных недоступен для переменных, привязанных к типам привязки MAXVAR, SYSPROP или LITERAL.
В следующей таблице var - это имя переменной, которая явным образом задана в программе Сценарии автоматизации. После знака подчеркивания идет имя неявной переменной, которая связана с основной объявленной переменной.
| Неявная переменная | Тип | Область действия | Описание |
|---|---|---|---|
| var_hidden | Логический | Все точки запуска | Извлекает или задает флаг скрытости для атрибута бизнес-объекта. Если тип основной переменной - OUT или INOUT, то сценарий может изменять переменную var_hidden. |
| var_initial | Тип атрибута MBO, к которому привязана переменная. | Все точки запуска | Задает предыдущее значение для атрибута, полученного из MBO. Переменная var_initial передается в сценарий. Сценарий не может изменять переменную var_initial. |
| var_internal | Тип атрибута MBO, к которому привязана переменная. | Все точки запуска | Задает внутреннее значение для записи SYNONYMDOMAIN. Если основная переменная связана с атрибутом MBO, который связан с доменом синонимов, то неявная переменная var_internal предоставляет соответствующее внутреннее значение для атрибута. Переменная var_internal передается в сценарий. Сценарий не может изменять переменную var_internal. |
| var_modified | Логический | Все точки запуска | Задает флаг, указывающий, было ли изменено значение для атрибута. Переменная var_modified передается в сценарий. Сценарий не может изменять переменную var_modified. |
| var_previous | Тип атрибута MBO, к которому привязана переменная. | Точки запуска атрибутов, но только для атрибутов, которые генерируют события. | Задает предыдущее значение для атрибута, полученного из MBO. Переменная var_previous передается в сценарий. Сценарий не может изменять переменную var_previous. |
| var_readonly | Логический | Все точки запуска | Извлекает или задает флаг только для чтения для атрибута бизнес-объекта. Если тип основной переменной - OUT или INOUT, то сценарий может изменять переменную var_readonly. |
| var_required | Логический | Все точки запуска | Извлекает или задает флаг обязательности для атрибута бизнес-объекта. Если тип основной переменной - OUT или INOUT, то сценарий может изменять переменную var_required. |