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

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

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

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

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

  или

  # Импортируем функции для работы с переменными 
  @prefix sln: <http://comindware.com/ontology/solution#>. 
  { 
      # Находим переменную VariableSystemName в приложении SolutionSystemName 
      # по их системным именам 
      # и возвращаем значение переменной. 
      ("SolutionSystemName" "VariableSystemName") sln:getVariableValue ?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. Сохраните переменную.