Атрибут типа «Список значений»

Получение данных из атрибута с помощью формулы

С помощью формулы для атрибута типа «Список значений» можно получить:

• ID текущего значения атрибута:

  $EnumAttributeSystemName—>cmw.variantName 
  

• системное имя значения атрибута:

  $EnumAttributeSystemName—>cmw.variantAlias 
  

• код значка значения атрибута:

  $EnumAttributeSystemName—>cmw.variantIcon 
  

• цвет значения атрибута в десятичном формате:

  $EnumAttributeSystemName—>cmw.color 
  

Установка значения атрибута с помощью формулы

Чтобы c помощю формулы задать значение атрибута типа «Список значений» (например, для вычисляемого атрибута или правила на форме), необходимо:

• вернуть ID требуемого значения атрибута, указав системные имена атрибута и требуемого значения:

  ID(ENUMVALUE("EnumAttributeSystemName", "EnumValueSystemName")) 
  

Сравнение значения атрибута с помощью формулы

С помощью формулы сравнить значение атрибута типа «Список значений» с требуемым можно по системному имени значения следующими способами:

• равенство

  $EnumAttributeSystemName == EnumValueSystemName 
  

  или

  EQUALS($EnumAttributeSystemName->cmw.variantAlias, "EnumValueSystemName") 
  

  или

  EQUALS($EnumAttributeSystemName, ENUMVALUE("EnumAttributeSystemName", "EnumValueSystemName")) 
  

• неравенство

  $EnumAttributeSystemName !== EnumValueSystemName 
  

  или

  NOT(EQUALS($EnumAttributeSystemName->cmw.variantAlias, "EnumValueSystemName")) 
  

  или

  NOT(EQUALS($EnumAttributeSystemName, ENUMVALUE("EnumAttributeSystemName", "EnumValueSystemName"))) 
  

Префиксы N3 для работы с атрибутом

Для работы с атрибутом типа «Список значений» в выражениях на N3 (например, в сценариях) могут потребоваться следующие префиксы:

@prefix object: <http://comindware.com/ontology/object#>. 
@prefix cmw: <http://comindware.com/logics#>. 
@prefix l10n: <http://comindware.com/ontology/l10n#>. 
@prefix cmwentity: <http://comindware.com/ontology/entity#>. 
@prefix string: <http://www.w3.org/2000/10/swap/string#>. 
@prefix convert: <http://comindware.com/logics/convertions#>. 

Получение данных из атрибута с помощью N3

С помощью N3 для атрибута типа «Список значений» можно получить:

• ID определённого значения:

  ("EnumAttributeSystemName" "enumValueSystemName") convert:enumValue ?enumValueId. 
  

• объект с атрибутом:

  ("TemplateSystemName" "EnumAttributeSystemName") object:findProperty ?enumAttribute. 
  

• из объекта с атрибутом — массив возможных значений атрибута в текущей записи:

  ?item ?enumAttribute ?enumAttributeValues. 
  

  Из этого массива можно получить:

  • ID текущего значения атрибута:

    ?enumAttributeValues cmw:variantName ?enumValueId. 
    

  • системное имя значения атрибута:

    ?enumAttributeValues cmw:variantAlias ?enumValueSystemName. 
    

  • код значка значения атрибута:

    ?enumAttributeValues cmw:variantIcon ?enumValueIcon. 
    

  • цвет значения атрибута в десятичном формате:

    ?enumAttributeValues cmw:color ?enumValueColor. 
    

Получение значения атрибута на определённом языке с помощью N3

С помощью N3 для атрибута типа «Список значений» можно получить названия значения атрибута на английском, русском и немецком языках:

# Находим атрибут EnumAttributeSystemName в шаблоне TemplateSystemName. 
("TemplateSystemName" "EnumAttributeSystemName") object:findProperty ?enumAttribute. 
# Присваиваем переменной ?enumAttributeValues 
# объект со списком значений атрибута. 
?item ?enumAttribute ?enumAttributeValues. 
# Присваиваем переменной ?enumValueId 
# объект с выбранным значением атрибута. 
?enumAttributeValues cmw:variantName ?enumValueId. 
# Присваиваем переменной ?enumAttributeValues массив объектов 
# с заполненными названиями значения атрибута на всех языках. 
?enumValueId l10n:text ?enumValueLanguageVersions. 
# Начинаем цикл по ?enumValueLanguageVersions 
    # Присваиваем переменной ?langCodeStr код языка 
    # названия значения атрибута на текущей итерации цикла. 
    ?enumValueLanguageVersions l10n:lang ?langCode. 
    ("{0}" ?langCode) string:format ?langCodeStr. 
    # Сравниваем код языка для значения атрибута с желаемым. 
    # "ru" — код русского языка, "en" — английского, "de" — немецкого. 
    ?langCodeStr cmwentity:contains "ru". 
        # Если предыдущее предложение возвращает true, 
        # записываем значение на русском языке в вычисляемый атрибут. 
        ?names l10n:data ?value. 
# переходим к следующей итерации по ?enumValueLanguageVersions. 

Установка значения атрибута с помощью N3

Чтобы c помощю N3 задать значение атрибута типа «Список значений» (например, для вычисляемого атрибута или правила на форме), необходимо:

• получить ID требуемого значения атрибута:

  ("EnumAttributeSystemName" "ValueSystemName") convert:enumValue ?enumValueId. 
  

• вернуть полученный ID:

  ?enumIdOverdue -> ?value. 
  

Сравнение значения атрибута с помощью N3

С помощью N3 для атрибута типа «Список значений» можно выполнять сравнение по системному имени его значения:

• Сравнение значения атрибута с требуемым:

  @prefix object: <http://comindware.com/ontology/object#>. 
  @prefix cmw: <http://comindware.com/logics#>. 
  { 
      # Получаем атрибут типа «Список значений» из шаблона по системному имени. 
      ("TemplateSystemName" "EnumAttributeSystemName") object:findProperty ?enumAttribute. 
      # Получаем коллекцию возможных значений атрибута. 
      ?item ?enumAttribute ?enumAttributeValues. 
      # Получаем системное имя значения атрибута в текущей записи. 
      ?enumAttributeValues cmw:variantAlias ?enumValueSystemName. 
      # Сравниваем системное имя значения атрибута с требуемым 
      # и возвращаем результат. 
      if 
      { 
          ?enumValueSystemName == "targetValueSystemName". 
      } 
      then 
      { 
          true -> ?value. 
      } 
      else 
      { 
          false -> ?value. 
      } 
  } 
  

Фильтрация значения атрибута с помощью N3

С помощью N3 для атрибута типа «Список значений» можно выполнять фильтрацию по системному имени его значения:

• Фильтрация (в таблице шаблона) записей с требуемым значением атрибута:

  @prefix convert: <http://comindware.com/logics/convertions#>. 
  @prefix object: <http://comindware.com/ontology/object#>. 
  { 
      # Получаем атрибут типа «Список значений» из шаблона по системному имени. 
      ("TemplateSystemName" "EnumAttributeSystemName") object:findProperty ?enumAttribute. 
      # Получаем ID значения атрибута по системному имени. 
      ("EnumAttributeSystemName" "enumValueSystemName") convert:enumValue ?enumValueId. 
      # Возвращаем записи, у которых атрибут имеет значение "enumValueSystemName". 
      ?item ?enumAttribute ?enumValueId. 
  } 
  

• Фильтрация добавляемых записей (в таблице на форме или раскрывающемся списке на форме) записей с требуемым значением атрибута:

  @prefix convert: <http://comindware.com/logics/convertions#>. 
  @prefix object: <http://comindware.com/ontology/object#>. 
  { 
      # Получаем атрибут типа «Список значений» из шаблона по системному имени. 
      ("TemplateSystemName" "EnumAttributeSystemName") object:findProperty ?enumAttribute. 
      # Получаем ID значения атрибута по системному имени. 
      ("EnumAttributeSystemName" "enumValueSystemName") convert:enumValue ?enumValueId. 
      # Фильтруем и возвращаем записи,  
      # у которых атрибут имеет значение "enumValueSystemName". 
      ?filteredRecordIds ?enumAttribute ?enumValueId. 
      ?filteredRecordIds -> ?value. 
  } 
  

• Фильтрация отображаемых записей (в таблице на форме, раскрывающемся списке на форме, вычисляемом атрибуте или правиле для формы) записей с требуемым значением атрибута:

  @prefix convert: <http://comindware.com/logics/convertions#>. 
  @prefix object: <http://comindware.com/ontology/object#>. 
  { 
      # Получаем атрибут типа «Запись» из шаблона с коллекцией записей. 
      ("ParentTemplateSystemName" "RecordAttributeSystemName") object:findProperty ?RecordAttribute. 
      # Получаем атрибут типа «Список значений» из связанного шаблона по системному имени. 
      ("LinkedTemplateSystemName" "EnumAttributeSystemName") object:findProperty ?enumAttribute. 
      # Получаем ID значения атрибута по системному имени. 
      ("EnumAttributeSystemName" "enumValueSystemName") convert:enumValue ?enumValueId. 
      # Получаем коллекцию записей из атрибута RecordAttribute. 
      ?item ?RecordAttribute ?filteredRecordIds. 
      # Фильтруем и возвращаем записи, 
      # у которых атрибут имеет значение "enumValueSystemName". 
      ?filteredRecordIds ?enumAttribute ?enumValueId. 
      ?filteredRecordIds -> ?value. 
  }