Переменные приложения. Просмотр списка, настройка и использование

Использование переменных приложения в выражениях N3 и C#-скриптах

• Чтобы получить значение переменной приложения с помощью N3, используйте следующее выражение:

  По системному имени переменной

  # Импортируем функции для работы с переменными
  @prefix globalvariable: <http://comindware.com/ontology/variable#>.
  
  {
      # Находим переменную VariableSystemName в приложении SolutionSystemName
      # по их системным именам
      # и возвращаем значение переменной.
      ("SolutionSystemName" "VariableSystemName") globalvariable:getValueByAlias ?value.
  }

  По ID переменной

  # Импортируем функции для работы с переменными
  @prefix globalvariable: <http://comindware.com/ontology/variable#>.
  
  {
      # Получаем значение переменной приложения
      # по её ID (svar.1) и возвращаем её значение.
      "svar.1" globalvariable:getValueById ?value.
  }

• Чтобы присвоить атрибуту значение переменной приложения с помощью C#-скрипта в сценарии, используйте действие «Изменить значения скриптом» со следующими свойствами:

  • Атрибут: укажите атрибут, которому требуется присвоить значение переменной приложения.
  • Операция со значениями: заменить

  • Значение:

    public class Script {
        // Задайте тип метода Main(),
        // соответствующий типу атрибута и переменной приложения:
        // string — Текст, int, decimal — Число, dateTime — Дата и время,
        // bool — Логический, TimeSpan — Длительность,
        // IEnumerable<string> — Список значений.
        // ObjectID — переменная, в которой хранится
        // ID экземпляра шаблона записи,
        // в контексте которого выполняется скрипт.
        // Чтобы просмотреть доступные методы
        // в пространстве имён Comindware,
        // введите Comindware и точку
    
        public static decimal Main(string ObjectID) {
            var result = (decimal)Api.Solution.SolutionVariableService.GetValue("svar.1");
            return result;
        }
    }

• Чтобы использовать значение переменной приложения в Задаче-вызове сценария используйте образец C#-скрипта из статьи «Автонумерация записей с помощью формулы, C#-скрипта или выражения N3».

Просмотр списка и настройка переменных приложения

1. На странице «Администрирование» приложения выберите пункт «Переменные» ‌.

2. Отобразится список переменных приложения со свойствами переменных:

   • ID — уникальный идентификатор переменной, который используется для обращения к ней.
   • Название — наименование переменной.
   • Системное имя — уникальное имя переменной.
   • Тип — тип значения переменной: Текст — текстовая строка;
     • Число — числовое значение;
     • Длительность — длительность в днях, часах, минутах, секундах;
     • Дата и время — дата по календарю и время в днях, часах, минутах, секундах;
     • Логический — true или false.
   • Описание — комментарий относительно назначения переменной.

3. Нажмите кнопку «Создать» или дважды нажмите строку переменной в списке.
4. Настройте свойства переменной приложения.
5. Сохраните переменную.