Только для продукта ПОЛИНОМ:MDM
Структура обменного файла
Обменный файл представляет собой электронную таблицу формата *.xls или *.xlsx, в листах которой особым образом скомпонованы данные и метаданные, подготовленные к загрузке.
Предупреждение
Крайне не рекомендуется использовать обменный файл в формате *.xls.
Для работы с файлами *.xls требуется установить драйвер Microsoft.ACE.OLEDB.12.0 с дистрибутивного диска КОМПЛЕКС РЕШЕНИЙ АСКОН: …\Support\AccessDatabaseEngine2010.
Для знакомства со структурой обменного файла воспользуйтесь файлом обмена ДЕМО-справочник.xlsx, который содержит небольшую часть справочных данных. Файл находится в архиве ExchangeFiles.zip в каталоге установки системы ПОЛИНОМ:MDM:
C:\Program Files (x86)\ASCON\Polynom\Tutorials\Examples\ExchangeFiles\ExchangeFiles.zip
Совет
Вы можете импортировать файл ДЕМО-справочник.xlsx в пустую базу данных для более глубокого понимания процесса импорта.
Листы обменного файла
Для корректного импорта данных в ПОЛИНОМ:MDM обменный файл должен содержать следующие листы:
листы со структурой данных
лист с метаданными каталогов CATALOGMETA
лист с метаданными групп GROUPMETA
лист со структурой понятий CONCEPTS
лист со структурой свойств PROPERTIES
лист со свойствами понятий CONCEPTSPROPERTIES
лист со столбцами табличных свойств PROPERTIESTABLECOLUMNS
лист со значениями ячеек табличных свойств PROPERTIESTABLEVALUES
Если данные связаны между собой, в обменном файле должны быть:
лист с описанием связей LINKSDEFINITIONS
лист с описанием условий совместимости COMPATIBILITY
лист с описанием связанных свойств PROPERTYLINKS
лист связей LINKS
Для работы с файлами, документами и представлениями необходимы:
лист документов DOCUMENTS
лист файлов FILES
лист представлений VIEWPOINTS
Для импорта формул используется лист FORMULAS.
Для импорта измеряемых величин и единиц измерения необходимы листы:
лист измеряемых величин MEASUREENTITY
лист единиц измерения MEASUREUNIT
Для импорта настроек отображения содержимого групп в виде таблицы используется лист TABLESETTINGS.
Для импорта объектов со множественной классификацией используется лист MULTIPLECLASSIFICATION.
Для импорта ограничительных перечней объектов и документов используется лист RESTRICTIVELISTS.
Предупреждение
В названиях листов запрещено использовать спецсимволы.
Осторожно
Не следует давать листам слишком длинные названия. Листы, в названии которых 32 и более символов, не открываются.
Чтобы ввести в ячейку текст, содержащий больше 255 символов, воспользуйтесь одним из способов.
На листе в первые 8 строк в любую ячейку поместите текст, который содержит больше 255 символов.
Замените с 8 на 0 значение ключа реестра TypeGuessRows, расположенного по пути:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\14.0\Access Connectivity Engine\Engines\Excel
Листы со структурой данных
| Колонка | Описание | Обязательно на листе | Обязательно для заполнения | Пояснение |
|---|---|---|---|---|
| NOTE | Колонка для заметок | Нет | Нет | |
| GUIDINTERNAL | Нет | Нет | ||
| IDEXTERNAL_OBJ | Уникальный идентификатор объекта | Нет | Нет |
Колонка IDEXTERNAL_OBJ содержит значение системного свойства "Уникальный идентификатор" элемента.
Если в процессе импорта будет найден элемент с таким идентификатором, то его свойства, связи, в том числе связи с документами и представлениями, будут обновлены информацией из файла обмена. Обновление работает в сторону дополнения данных, т.е. удаление свойств или связей объекта, которых нет в файле обмена, не производится. Если объекта с таким идентификатором не существует, то он будет создан. Формат поля должен строго соответствовать формату <PREFIX:guid>. |
| REFERENCE | Наименование справочника | Да | Да |
Колонка должна существовать на листе в единственном экземпляре.
Наименование справочника должно быть уникально. |
| CATALOGS | Наименование каталогов | Да | Да |
Колонка должна существовать на листе в единственном экземпляре.
Наименования каталогов на разных листах данных должны быть уникальными. |
| IDEXTERNAL_CATALOGS | Идентификатор каталога | Нет | Нет |
Колонка содержит значение идентификатора (id) каталога.
Если в процессе импорта будет найдет каталог с таким идентификатором, то его имя, понятия, принадлежность к областям типов связей, а также назначенные вычисляемые свойства будут обновлены информацией из файла обмена. Обновление работает в сторону дополнения данных, т.е. удаление понятий каталога, которых нет в файле обмена, не производится. Если каталога с таким идентификатором не существует, то он будет создан. Формат поля должен строго соответствовать формату <guid>. |
| CATALOGCONCEPT | Понятия каталога | Нет | Нет |
Колонка CATALOGCONCEPT предназначена для назначения понятия каталогу (аналогична колонке CONCEPTS, но существует в едином экземпляре).
Если необходимо указать, что понятие каталога будет наследоваться вложенными группами и/или будет обязательным для объектов, входящих в группу, то следует добавить к коду понятия следующую конструкцию: Код_понятия#$#1#1 |
| CATALOGTABLESETTINGS | Настройки таблицы для каталогов | Нет | Нет |
Колонка CATALOGTABLESETTINGS предназначена для добавления настроек таблицы каталогу. Заполняется значениями из колонки CODE листа TABLESETTINGS.
Колонка должна существовать на листе в единственном экземпляре. Если требуется указать несколько настроек (несколько значений CODE листа TABLESETTINGS), значения задаются через перенос строки. Указанные настройки автоматически распространяются на все группы каталога. |
| GROUPS | Наименования групп | Да | Да |
Для формирования иерархической структуры групп со множественным вложением необходимо после первой колонки GROUPS создать еще одну колонку GROUPS и в ней задавать значения для подгрупп.
Первая колонка GROUPS должна быть заполнена полностью, т. к. в системе ПОЛИНОМ:MDM объекты можно добавлять только в группы (добавление объектов в каталоги технически запрещено). |
| IDEXTERNAL_GROUPS | Идентификатор группы | Нет | Нет |
Колонка IDEXTERNAL_GROUPS содержит значение идентификатора (id) группы.
Количество колонок IDEXTERNAL_GROUPS должно совпадать с количеством колонок GROUPS либо их не должно быть совсем. Заполнение данной колонки обязательно для одноименных групп (у которых совпадают значения в колонке GROUPS). Если в процессе импорта будет найдена группа с таким идентификатором, то ее имя, свойства, понятия, принадлежность к областям типов связей, связи с документами, а также назначенные вычисляемые свойства будут обновлены информацией из файла обмена. Обновление работает в сторону дополнения данных, т.е. удаление свойств или понятий группы, которых нет в файле обмена, не производится. Если группы с таким идентификатором не существует, то она будет создана. Формат поля должен строго соответствовать формату <guid>. |
| CONCEPTS | Понятия группы | Нет | Нет |
Колонка CONCEPTS предназначена для назначения понятия группе. Коды понятий указываются через перенос строки.
Количество колонок CONCEPTS должно совпадать с количеством колонок GROUPS либо их не должно быть совсем. Колонка CONCEPTS (с соответствующими понятиями) необходима при использовании одного и того же свойства на разных листах данных. Чтобы указать значения опций "Применить для вложенных групп", "Сопоставить объектам группы", "Отключить наследование" добавьте к коду понятия следующую конструкцию: Код_понятия#$#1#1#1 #$# - разделитель между кодом понятия и значением опции. Первая единица - понятие в группе является наследуемым на нижележащие группы ("Применить для вложенных групп"). Вторая единица - понятие является обязательным для объектов группы ("Сопоставить объектам группы"). Третья единица - унаследованное понятие на этой группе отключено ("Отключить наследование"). Если она установлена, то остальные опции не применяются. Опции могут принимать значение нуль или единица. Единицы соответствуют включенным опциям, нули - отключенным. |
| OWNCONCEPTS | Собственные понятия текущего объекта | Нет | Нет |
Колонка OWNCONCEPTS предназначена для назначения собственных понятий объекту. Коды понятий указываются через перенос строки.
Колонка OWNCONCEPTS существует в единственном экземпляре. Если для объекта в строке ниже колонка не заполнена, собственные понятия этому объекту назначены не будут. |
| CONCEPTSINHERITANCE | Опция "Наследовать значения свойств" | Нет | Нет | Колонка CONCEPTSINHERITANCE предназначена для включения опции наследования значений по иерархии понятий. Коды понятий указываются через перенос строки. |
| TABLESETTINGS | Настройки таблицы для групп | Нет | Нет |
Колонка TABLESETTINGS предназначена для добавления группе настроек отображения таблицы.
Количество колонок TABLESETTINGS должно совпадать с количеством колонок GROUPS либо их не должно быть совсем. Заполняется значениями из колонки CODE листа TABLESETTINGS. Если требуется указать несколько настроек (несколько значений CODE листа TABLESETTINGS), значения задаются через перенос строки. При добавлении кода настройки в колонку TABLESETTINGS для группы перекрывается умолчательное наследование настроек от каталога. Если необходимо указать, что настройка будет наследоваться вложенными группами, то следует добавить к коду настройки конструкцию #$#: Код_настройки#$# Если для группы перекрыто наследование настроек от каталога и в столбцах таблицы нет свойств, то следует добавить конструкцию: #^# Если для группы перекрыто наследование настроек от каталога, в столбцах таблицы нет свойств и при этом настройки будут наследоваться вложенными группами, то следует добавить конструкцию: #^##$# |
| CODE | Код объекта | Да | Нет |
Колонка CODE предназначена для задания внутреннего кода объекта, который используется для установки связей между объектами и определения связанных свойств.
Колонка должна существовать на листе в единственном экземпляре. Код объекта должен быть уникальным. Значения в данной колонке являются регистронезависимыми. То есть значения "Bolt2DPresentation" и "Bolt2dPresentation" НЕ являются уникальными. |
| NAME | Наименование объекта | Да | Нет |
Колонка должна существовать на листе в единственном экземпляре.
Если колонка NAME не заполнена, но заполнена колонка IDEXTERNAL_OBJ:
|
| DESCRIPTION | Описание объекта | Нет | Нет | |
| LINK_END | Конец связи | Нет | Нет | Колонка LINK_END предназначена для указания кода конца типа связи, который задается на листе типов связей. По этому коду будет выбираться тип связи, а также использоваться тот конец связи, которому принадлежит код из колонки LINK_END. Чтобы явно указать тип связи и конец связи, необходимо использовать разделитель #$#, например, <Код типа связи>#$#<Код конца связи>. |
| LINK_OBJECTS | Коды связываемых объектов | Нет | Нет | Колонка LINK_OBJECTS предназначена для того, чтобы можно было задать коды объектов, с которыми будет связан текущий объект. Для связи текущего объекта с несколькими необходимо заполнить колонку LINK_OBJECTS кодами через перенос строки. У текущего объекта тоже должен быть код. |
| PROPERTY_ | Значения свойств понятий объектов | Нет | Нет |
Чтобы задать значения свойств объектов, необходимо создать колонки с именем PROPERTY_{code}, где {code} — код свойства понятия, указанный на листе свойств понятий. Если описываемые объекты находятся в одной группе и имеют разный набор свойств, необходимо
создать отдельный лист структуры данных.
Чтобы задать значение табличного свойства, необходимо указать код значения свойства — значение из колонки TABLEVALUECODE листа PROPERTIESTABLEVALUES. |
| OWNPROPERTY_ | Значения собственных свойств объектов | Нет | Нет |
Чтобы задать значения собственных свойств объектов, необходимо создать колонки с именем OWNPROPERTY_{code}, где {code} — код свойства понятия, указанный на листе свойств понятий.
На листе свойств понятий собственные свойства сопоставляются только с понятием @Own, т.е. в колонке CONCEPT_CODE на листе свойств понятий для собственных свойств должно быть значение @Own. Чтобы задать значение табличного свойства, необходимо указать код значения свойства — значение из колонки TABLEVALUECODE листа PROPERTIESTABLEVALUES. |
| UNIT_ | Коды единиц измерения | Нет | Нет | Чтобы указать единицу измерения, необходимо создать колонку UNIT_{code}, где {code} — код свойства понятия, указанный на листе свойств понятий. Содержимое колонки заполняется кодом из справочника Единицы измерения. |
| PROPERTYLINK_ | Связанные свойства | Нет | Нет |
Чтобы использовать связанные свойства, необходимо создать колонку PROPERTYLINK_{code}, где {code} — код связанного свойства с листа описаний связанных свойств.
Колонка заполняется:
|
| LINKPROPERTY_ | Свойства связи | Нет | Нет | Чтобы использовать свойства связи, необходимо создать колонку LINKPROPERTY_{code}, где {code} — код свойства с листа свойств понятий(CODE). Данная колонка заполняется кодом объекта, с которым будет связан текущий. |
| RESTRICTIVELISTS | Коды ограничительных перечней | Нет | Да | Колонка заполняется кодами ограничительных перечней через перенос строки (значения из колонки CODE на листе RESTRICTIVELISTS). Если ограничительного перечня с таким кодом не существует, система возьмет следующий код. |
CATALOGMETA – метаданные каталогов
| Колонка | Описание | Обязательно на листе | Обязательно для заполнения | Пояснение |
|---|---|---|---|---|
| CATALOGS | Имя каталога | Да | Нет | |
| IDEXTERNAL_CATALOGS | Идентификатор каталога | Нет | Нет | |
| DESCRIPTION | Описание | Да | Нет | |
| ENTRY | Точка входа | Да | Нет |
Чтобы включить опцию "Быстрый доступ" для каталога,
необходимо в колонке ENTRY ввести цифру 1.
Чтобы выключить опцию "Быстрый доступ" для каталога, необходимо оставить колонку ENTRY незаполненной или ввести цифру 0. |
| CLASSID | Идентификатор класса | Нет | Нет |
GROUPMETA – метаданные групп
| Колонка | Описание | Обязательно на листе | Обязательно для заполнения | Пояснение |
|---|---|---|---|---|
| GROUPS | Расположение группы | Да | Нет |
В колонке GROUPS указывается путь до конечной группы (без указания справочника и каталога) через разделитель #$#
Например, имеется такая структура: Справочник Каталог Группа 1 Подгруппа 1 Подгруппа 2 Группа 2 Тогда в колонке GROUPS для описания метаданных группы с именем «Подгруппа 1» должна быть запись: Группа 1#$#Подгруппа 1 |
| IDEXTERNAL_GROUPS | Идентификатор группы | Нет | Нет |
Колонка IDEXTERNAL_GROUPS служит явным указателем на группу с листа структуры данных, для которой применяются метаданные. Содержит значение идентификатора (id) группы.
Если в колонке присутствуют дубли значений, будет применено первое. Заполнение данной колонки обязательно для одноименных групп (у которых совпадают значения в колонке GROUPS). |
| DESCRIPTION | Описание группы | Да | Нет | |
| ENTRY | Точка входа | Да | Нет |
Чтобы включить опцию "Быстрый доступ" для группы, необходимо в колонке ENTRY ввести цифру 1.
Чтобы выключить опцию "Быстрый доступ" для группы, необходимо оставить колонку ENTRY незаполненной или ввести цифру 0. |
| CLASSID | Идентификатор класса | Нет | Нет | |
| PROPERTY_ | Значения свойств понятий групп | Нет | Нет |
Чтобы задать значения свойствам понятия группы, необходимо создать колонки с именем PROPERTY_{code}, где {code} — код свойства понятия, указанный на листе свойств понятий.
Чтобы задать значение табличного свойства, необходимо указать код значения свойства — значение из колонки TABLEVALUECODE листа PROPERTIESTABLEVALUES. |
| OWNPROPERTY_ | Значения собственных свойств групп | Нет | Нет |
Чтобы задать значения собственных свойств для групп, необходимо создать колонки с именем OWNPROPERTY_{code}, где {code} — код свойства понятия, указанный на листе свойств понятий.
На листе свойств понятий собственные свойства сопоставляются только с понятием @Own, т.е. в колонке CONCEPT_CODE на листе свойств понятий для собственных свойств должно быть значение @Own. Чтобы задать значение табличного свойства, необходимо указать код значения свойства — значение из колонки TABLEVALUECODE листа PROPERTIESTABLEVALUES. |
| ISREVERSEORDER | Порядок отображения понятий | Нет | Нет |
Чтобы сначала отображались собственные понятия группы,
необходимо в колонке ISREVERSEORDER ввести цифру 1.
Чтобы сначала отображались унаследованные понятия группы, необходимо оставить колонку ISREVERSEORDER незаполненной или ввести цифру 0. |
CONCEPTS – структура понятий
| Колонка | Описание | Обязательно на листе | Обязательно для заполнения |
|---|---|---|---|
| CONCEPT | Наименование понятия | Да | Да |
| SUPERCONCEPT_CODE | Код родительского понятия | Да | Нет |
| CODE | Код понятия | Да | Да |
| DESCRIPTION | Описание понятия | Нет | Нет |
Пример иерархии и соответствующего ей листа понятий:
| CONCEPT | SUPERCONCEPT_CODE | CODE | DESCRIPTION |
|---|---|---|---|
| Аптека | PharmacyConcept | ||
| Лекарственные товары | PharmacyConcept | MedicinalProductsConcept | |
| Таблетки | MedicinalProductsConcept | PillsConcept | |
| Кремы | MedicinalProductsConcept | CreamsConcept | |
| Прочие товары | PharmacyConcept | OtherProductsConcept |
PROPERTIES – структура свойств
| Колонка | Описание | Обязательно на листе | Обязательно для заполнения | Пояснение |
|---|---|---|---|---|
| NAME | Наименование свойства | Да | Да | |
| CODE | Код свойства | Да | Да | |
| TYPE | Тип свойства | Да | Да | |
| MEASUREENTITY | Код единицы измерения | Нет | Нет |
Применяется только с типом double.
Код измеряемой величины берется из справочника Единицы измерения. |
| LOV | Список значений (для типов enum, enum string, enum int, enum double, enum boolean, set) | Нет | Нет | Колонка заполняется значениями через перенос строки. |
| DESCRIPTION | Описание свойства | Нет | Нет | |
| FOLDER | Расположение свойства | Да | Нет |
Значения колонки FOLDER задаются в следующем виде:
Свойства аптеки/Лекарственные товары/Таблетки |
Типы свойств
| Тип | Описание | Пояснение |
|---|---|---|
| string | Строка | |
| int | Целое число | |
| double | Число с плавающей точкой |
Можно указывать число, диапазон и число с допуском.
Диапазон: запись должна иметь вид: 3..7 Число с допуском: запись должна иметь вид: 5:3..7 Число в диапазоне: запись должна иметь вид: 5%3..7 |
| boolean | Логический тип | Доступные значения: true или false (1 или 0) |
| image | Изображение | Путь до изображения, например:
- относительный путь: images\image.jpg - абсолютный путь: D:\images\image.jpg |
| binary | Файл | Путь до файла, например:
- относительный путь: files\file.doc - абсолютный путь: D:\files\file.doc |
| color | Цвет | Можно задать 16-тиричным HEX-кодом или RGB, например:
#ff0011dd 255,12,42 |
| datetime | Дата/время |
Задается в форматах:
DD.MM.YYYY DD.MM.YY HH:MM DD.MM.YYYY HH:MM:SS |
| enum | Перечислимое |
На листе
PROPERTIES в колонке
LOV задаются значения через перенос строки.
Порядок значений в свойстве будет соответствовать порядку значений в колонке LOV. При этом необходимо внимательно проверить соответствие данных в списке LOV и на листе DATA, где в поле должно быть одно значение, выбранное из списка на листе PROPERTIES . |
| enum string | Перечислимое с описанием. Тип значения – строка |
На листе
PROPERTIES в колонке
LOV задаются значения через перенос строки.
Порядок значений в свойстве будет соответствовать порядку значений в колонке LOV. Разделитель значения и описания – #$#. Значения должны быть уникальными. |
| enum int | Перечислимое с описанием. Тип значения – целое число |
|
| enum double | Перечислимое с описанием. Тип значения – число с плавающей точкой |
|
| enum boolean | Перечислимое с описанием. Тип значения – логическое |
На листе
PROPERTIES в колонке
LOV задаются значения через перенос строки.
Порядок значений в свойстве будет соответствовать порядку значений в колонке LOV. Разделитель значения и описания - #$#. Значения должны быть уникальными. Для данного типа допустимы значения:
|
| set | Множество | На листе PROPERTIES в колонке LOV задаются значения через перенос строки. |
| guid | Глобальный идентификатор | Формат:
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx} |
| optics | Оптика | Ключевые данные: Ambient – общий свет; Diffusion – диффузия; Emission – излучение; Shininess – блеск; Specularity – зеркальность; Transparency – прозрачность. Указываются в одной ячейке через перенос строки без пробелов. Формат: Ambient:10 Diffusion:17 Emission:88 Shininess:25 Specularity:36 Transparency:12 Указываются целые числа в диапазоне от 0 до 100 (неуказанное значение соответствует нулю). |
| rtf | RTF-текст |
Для корректного импорта значений рекомендуется использовать файл обмена в формате
*.xlsx.
Для системного свойства Описание у объекта, документа, представления или группы:
|
| table | Таблица | Столбцом таблицы может быть любое свойство ПОЛИНОМ:MDM за исключением самого табличного свойства. |
CONCEPTSPROPERTIES – свойства понятий
| Колонка | Описание | Обязательно на листе | Обязательно для заполнения | Пояснение |
|---|---|---|---|---|
| CONCEPT_CODE | Код понятия | Да | Да | Указывается значение колонки CODE листа CONCEPTS |
| PROPERTY_CODE | Код свойства | Да | Да | Указывается значение колонки CODE листа PROPERTIES |
| CODE | Код для листа со структурой данных | Да | Да |
Значение в колонке должно быть уникальным.
Колонка является регистронезависимой. |
| DEFAULTVALUE | Значение по умолчанию | Нет | Нет | |
| DEFAULTUNIT | Единица измерения по умолчанию | Нет | Нет | |
| NAMEINCONCEPT | Имя свойства в понятии | Нет | Нет | |
| PDEFAULTIFEMPTY | Для неназначенных значений будет выводиться значение по умолчанию | Нет | Нет |
Для колонок PDEFAULTIFEMPTY, PSPECIAL, PHIDDEN, PMANDATORY, PUNIQUE,
PADDITIONAL, PINDEXABLE, PSHOWFORSELECTION, PSETBEFOREAPPLYING,
PPROTECTED, PPUBLIC и PISUSEDINPFGENERATION
значения задаются в следующем виде:
0 или пустая ячейка — нет (false) 1 — да (true) Если свойство понятия уже существует, то значения опций будут изменены на значения, указанные в файле обмена. |
| PSPECIAL | Специальное свойство | Нет | Нет | |
| PHIDDEN | Скрытое свойство | Нет | Нет | |
| PMANDATORY | Обязательное свойство | Нет | Нет | |
| PUNIQUE | Уникальное свойство | Нет | Нет | |
| PINDEXABLE | Индексируемое свойство | Нет | Нет | |
| PADDITIONAL | Дополнительное свойство | Нет | Нет | |
| PSHOWFORSELECTION | Отображать для выбора | Нет | Нет | |
| PSETBEFOREAPPLYING | Задать перед применением | Нет | Нет | |
| PROTECTED | Запретить изменение | Нет | Нет | |
| PPUBLIC | Публичное свойство | Нет | Нет | |
| PISUSEDINPFGENERATION | Используется в семействах моделей по умолчанию | Нет | Нет |
Примечание
Для табличного свойства заполняются только колонки CONCEPT_CODE, PROPERTY_CODE, CODE, PHIDDEN, PADDITIONAL, PPROTECTED.
Для корректного импорта свойств, наследуемых по иерархии понятий, необходимо соблюдать порядок заполнения строк на листе.
Заполните строку родительского понятия и наследуемого свойства.
Заполните строку дочернего понятия и унаследованного свойства.
Пример:
Родительское понятие Наименование и описание имеет свойство Наименование, которое наследуется дочерним понятием Элемент классификации. В этом случае строки листа CONCEPTSPROPERTIES должны быть заполнены следующим образом:
| CONCEPT_CODE | PROPERTY_CODE | CODE |
|---|---|---|
| c:@NameAndDescription | @Name | 418ca52a-6e2a-464b-b777-abc00149ac36 |
| c:@NameAndDescription::c:@ClassificationItem | @Name | 15f37cb4-1a24-4bcc-95ca-abc00149ac4d |
PROPERTIESTABLECOLUMNS – столбцы табличных свойств
| Колонка | Описание | Обязательно на листе | Обязательно для заполнения | Пояснение |
|---|---|---|---|---|
| TABLE_CODE | Код табличного свойства | Да | Да | |
| PROPERTY_CODE | Код свойства-столбца | Да | Да | Код свойства, которое будет добавлено в таблицу в качестве столбца. |
| CODE | Код столбца таблицы для листа PROPERTIESTABLEVALUES | Да | Да | Значение в колонке должно быть уникальным. Колонка является регистронезависимой. |
| DEFAULTVALUE | Значение по умолчанию | Нет | Нет | |
| DEFAULTUNIT | Единица измерения по умолчанию | Нет | Нет | |
| NAMEINTABLE | Имя свойства-столбца в таблице | Нет | Нет | |
| PDEFAULTIFEMPTY | Значение по умолчанию | Нет | Нет |
Для колонок PDEFAULTIFEMPTY, PHIDDEN, PMANDATORY, PUNIQUE, PINDEXABLE, PADDITIONAL, PPROTECTED, PUNIQUEINTABLE, PPUBLIC и PISUSEDINPFGENERATION значения задаются в следующем виде:
0 или пустая ячейка — нет (false) 1 — да (true) Если столбец с таким свойством уже существует в таблице, то значения опций будут взяты из файла обмена. |
| PHIDDEN | Скрытый столбец | Нет | Нет | |
| PMANDATORY | Значения в столбце обязательны для заполнения | Нет | Нет | |
| PUNIQUE | Значения в столбце не могут повторяться в пределах хранилища | Нет | Нет | |
| PINDEXABLE | Индексируемый столбец | Нет | Нет | |
| PADDITIONAL | Дополнительный столбец | Нет | Нет | |
| PPROTECTED | Запретить изменение | Нет | Нет | |
| PUNIQUEINTABLE | Значения в столбце не могут повторяться в пределах таблицы | Нет | Нет | |
| PPUBLIC | Публичное свойство | Нет | Нет | |
| PISUSEDINPFGENERATION | Используется в семействах моделей по умолчанию | Нет | Нет |
PROPERTIESTABLEVALUES – значения ячеек табличных свойств
| Колонка | Описание | Обязательно на листе | Обязательно для заполнения | Пояснение |
|---|---|---|---|---|
| TABLEVALUECODE | Код значения табличного свойства | Да | Да | Используется на листе со структурой данных. |
| COLUMN1, COLUMN2, ..., COLUMNn | Столбцы табличного свойства | Нет | Нет |
Колонки заполняются двумя значениями.
1. В первой строке указывается код столбца таблицы в формате: COLUMN_{code} где {code} – значение колонки CODE листа PROPERTIESTABLECOLUMNS. При помощи разделителя #$# можно дополнительно задать: - ширину столбца в таблице, - единицу измерения, отличную от заданной по умолчанию. Код столбца таблицы будет иметь вид: COLUMN_{code}#$#Width={x}#$#MeasureUnit={unitCode} где {x} – ширина в пикселях, {unitCode} – код единицы измерения в справочнике Единицы измерения. 2. Во второй строке указывается значение ячейки. При помощи разделителя #$# можно задать единицу измерения конкретной ячейке табличного свойства в формате: {value}#$#{unitCode} где {value} – значение ячейки, {unitCode} – код единицы измерения в справочнике Единицы измерения. Если единица измерения в ячейке со значением будет отличаться от единицы измерения столбца, то значение при импорте файла обмена будет конвертировано в единицу измерения столбца. |
Пример заполнения листа:
TABLEVALUECODE |
COLUMN1 |
COLUMN2 |
e16cdde3-3955-4198-98ac-ade100ab3c8a |
COLUMN_c26e3557-422c-4f90-91f6-ade100aa5230 |
COLUMN_21e1b555-333e-416a-8ddd-ade100aa5249#S#Width= 140#S#MeasureUnit=V11DFD660A7D1472B8EBDD5D95E10F75C |
11#$#VB97F99E6AF9A41F7B2A315B1BD0F83AF |
12 |
|
b00f2a51-80f0-4ed8-bc21-ade100ab3cd1 |
COLUMN_7119f3da-77a2-42c5-9891-ade100aa62ff |
LUMN_5b9c3efa-ae50-4827-8e7f-ade100aa6316 |
21 |
22 |
LINKSDEFINITIONS – описание типов связей
| Колонка | Описание | Обязательно на листе | Обязательно для заполнения | Пояснение |
|---|---|---|---|---|
| NAME | Название типа связи | Да | Да | |
| CODE | Код типа связи | Да | Да | |
| DESCRIPTION | Описание типа связи | Нет | Нет | |
| FOLDER | Расположение типа связи в справочнике | Да | Да | |
| SOURCENAME | Название первого конца связи | Да | Да | |
| SOURCERELATION | Отношение первого конца связи | Нет | Нет | Значение поля "Относится как". Например, "Связан с ...", "Состоит из ..." и т.д. |
| SOURCEDESCRIPTION | Описание первого конца связи | Нет | Нет | |
| SOURCE_END_CODE | Код первого конца связи | Да | Да | Колонка обязательна для заполнения. Значение в ней должно быть уникальным. |
| SOURCEMULTIPLICITY | Множественность первого конца связи | Да | Да |
Множественность задается одним из ключевых слов:
|
| SOURCEAGGREGATION | Направление связи | Нет | Нет |
|
| SOURCESCOPE | Первая область выбора объектов | Да | Да |
Область выбора задается ключевым словом.
Возможно задать следующие типы областей:
Ключевое_слово#Код_понятия Пример: CONCEPT#c:@Materials Код понятия берется из колонки CODE листа CONCEPTS Ключевое_слово#Код_свойства_понятия или Ключевое_слово#Код_свойства Операция сравнения всегда "Равно" Примеры: PROPERTY#c:@NameAndDescription::pd:@Name PROPERTY#pd:@Name Код свойства понятия берется из колонки CODE листа CONCEPTSPROPERTIES. Код свойства берется из колонки CODE листа PROPERTIES. Ключевое_слово#Имя_каталога или Ключевое_слово#Идентификатор_каталога Пример: CATALOG#11905927-d9e5-4ffa-ba45-973ce1a461eb Имя каталога берется из колонки CATALOGS листа DATA. Идентификатор каталога указывается в формате guid. Ключевое_слово#Идентификатор_группы Пример: GROUP#42cac354-c484-4d93-a804-39006fd5c766 Идентификатор группы указывается в формате guid. Область в виде каталога создается только тогда, когда она будет задействована, то есть на листе с данными будут связаны объекты или созданы связанные свойства. |
| SOURCESCOPEPROPERTY | Значения свойств первой области выбора объектов | Нет | Нет |
Значения свойств задаются через разделитель # и ключевое слово Value.
Можно задавать значения свойств понятий, а также собственных и связанных свойств:
Код_свойства1#Value=Значение1#$#Код_свойства2#Value=Значение2 Единица измерения указывается через разделитель # и ключевое слово MeasureUnit: Код_свойства#Value=значение#MeasureUnit=Код_единицы_измерения Примеры для типов свойств, значение которых задается через перенос строки (множество, оптическое и т.д.): Код_свойства_типа_множество#Value=Значение1 Значение2 Значение3 Код_свойства_типа_оптическое#Value=Ambient:10 Diffusion:17 Emission:88 Shininess:25 Specularity:36 Transparency:12 Пример для нескольких свойств: Код_свойства_типа_множество#Value=Значение1 Значение2#$#Код_свойства#Value=Значение |
| SOURCEOPTIONS | Опция "Объект удовлетворяет всем значениям свойств" у первой области выбора объектов | Нет | Нет |
Значения задаются в следующем виде:
|
| DESTINATIONNAME | Название второго конца связи | Да | Да | |
| DESTINATIONRELATION | Отношение второго конца связи | Нет | Нет | Значение поля "Относится как". Например, "Связан с ...", "входит в ..." и т.д. |
| DESTINATIONDESCRIPTION | Описание второго конца связи | Нет | Нет | |
| DESTINATION_END_CODE | Код второго конца связи | Да | Да | Колонка обязательна для заполнения. Значение в ней должно быть уникальным. |
| DESTINATIONMULTIPLICITY | Множественность второго конца связи | Да | Да | Порядок заполнения аналогичен колонке SOURCEMULTIPLICITY |
| DESTINATIONAGGREGATION | Направление связи | Нет | Нет |
|
| DESTINATIONSCOPE | Вторая область выбора объектов | Да | Да | Порядок заполнения аналогичен колонке SOURCESCOPE |
| DESTINATIONSCOPEPROPERTY | Значения свойств второй области выбора объектов | Нет | Нет | Порядок заполнения аналогичен колонке SOURCESCOPEPROPERTY |
| DESTINATIONOPTIONS | Опция "Объект удовлетворяет всем значениям свойств" у второй области выбора объектов | Нет | Нет | Порядок заполнения аналогичен колонке SOURCEOPTIONS |
| CONCEPTS | Понятия типа связи | Нет | Нет |
COMPATIBILITY – описание условий совместимости
Примечание
При экспорте в файл обмена лист COMPATIBILITY создается только при наличии связи между объектами. В этом случае сначала будет создан лист LINKSDEFINITIONS, а затем лист COMPATIBILITY.
Если у одного типа связи несколько условий совместимости, то колонка LINK_CODE заполняется один раз.
| Колонка | Описание | Обязательно на листе | Обязательно для заполнения | Пояснение |
|---|---|---|---|---|
| LINK_CODE | Код типа связи | Да | Да | Полный код типа связи, для которого будет добавлено условие совместимости |
| NAME | Название условия совместимости | Да | Да | |
| CODE | Код условия совместимости | Да | Да | |
| SOURCEPROPERTIES | Свойства в области слева | Да | Нет |
Колонка заполняется кодами свойств через перенос строки.
Код свойства понятия берется из колонки CODE листа CONCEPTSPROPERTIES. Код свойства берется из колонки CODE листа PROPERTIES. Код связанного свойства берется из колонки CODE листа PROPERTYLINKS. |
| COMPARISONOPERATION | Операция сравнения | Да | Да |
Обозначение операции зависит от типа свойства:
|
| COMPARISONOPERATIONOPTIONS | Опции* "Учитывать регистр"/"Ближайшее значение", "Частичное вхождение" | Нет | Нет |
0 - все опции выключены
1 - включена опция* "Учитывать регистр"/"Ближайшее значение" 2 - включена опция "Частичное вхождение" 3 - все опции включены * Включаемая опция зависит от типа свойства. Для текстовых свойств будет включена опция "Учитывать регистр". Для числовых свойств - "Ближайшее значение". |
| DESTINATIONPROPERTIES | Свойства в области справа | Да | Нет | Порядок заполнения аналогичен колонке SOURCEPROPERTIES |
| MANDATORY | Опция "Обязательное" | Нет | Нет |
0 или пустая ячейка - опция выключена
1 - опция включена |
PROPERTYLINKS – описание связанные свойства
| Колонка | Описание | Обязательно на листе | Обязательно для заполнения | Пояснение |
|---|---|---|---|---|
| NAME | Наименование связанного свойства | Да | Нет |
Наименование связанного свойства.
Если колонка не заполнена, наименование связанного свойства будет вычисляться автоматически. |
| LINK_END_CODE | Код конца связи | Да | Да |
Задается в формате
Код_типа_связи#$#Код_конца_связи
Код типа связи берется из колонки CODE листа LINKSDEFINITIONS. Код конца связи берется из колонки SOURCE_END_CODE или DESTINATION_END_CODE листа LINKSDEFINITIONS. |
| CP_CODE | Код свойства понятия | Да | Да |
Код свойства понятия источника.
Код должен быть уникальным. Не должен совпадать с кодами свойств объектов — со значениями {code} из поля PROPERTY_{code} листа со структурой данных и со значениями колонки CODE листа со свойствами понятий CONCEPTSPROPERTIES. |
| CONCEPT | Понятие | Да | Да | Указывается код понятия, в котором создается связанное свойство. |
| CODE | Код связанного свойства | Да | Да | Значение данной колонки может быть использовано на листах с данными. |
| PHIDDEN | Скрытое свойство | Нет | Нет |
Значения задаются в следующем виде:
0 или пустая ячейка — нет (false) 1 — да (true) Если свойство понятия уже существует, то значения опций будут обновлены. |
| PMANDATORY | Обязательное свойство | Нет | Нет | |
| PADDITIONAL | Дополнительное свойство | Нет | Нет | |
| PSHOWFORSELECTION | Отображать для выбора | Нет | Нет | |
| PSETBEFOREAPPLYING | Задать перед применением | Нет | Нет | |
| PPROTECTED | Запретить изменение | Нет | Нет | |
| PPUBLIC | Публичное свойство | Нет | Нет | |
| PISUSEDINPFGENERATION | Используется в семействах моделей по умолчанию | Нет | Нет |
LINKS – связи
| Колонка | Описание | Обязательно на листе | Обязательно для заполнения |
|---|---|---|---|
| IDEXTERNAL_OBJ1 | Значение системного свойства "Уникальный идентификатор" первого связываемого объекта. | Да | Да |
| CODE_OBJ1 | Код первого объекта в обменном файле (поле CODE на листе структуры данных). Используется если не заполнен IDEXTERNAL_OBJ1. | Да | Нет |
| LINK_END_OBJ1 | Полный код конца связи, на котором будет находиться первый связываемый объект. Заполняется в формате <Код типа связи>#$#<Код конца связи>. | Да | Да |
| IDEXTERNAL_OBJ2 | Значение системного свойства "Уникальный идентификатор" второго связываемого объекта | Да | Да |
| CODE_OBJ2 | Код второго объекта в обменном файле (поле CODE на листе структуры данных). Используется если не заполнен IDEXTERNAL_OBJ2. | Да | Нет |
| LINKPROPERTY_ | Значение свойства связи.
Чтобы задать значение табличного свойства, необходимо указать код значения свойства — значение из колонки TABLEVALUECODE листа PROPERTIESTABLEVALUES. |
Нет | Нет |
| OWNPROPERTY_ | Значение собственного свойства связи.
Чтобы задать значение табличного свойства, необходимо указать код значения свойства — значение из колонки TABLEVALUECODE листа PROPERTIESTABLEVALUES. |
Нет | Нет |
| OWNCONCEPTS | Собственные понятия текущего экземпляра связи. | Нет | Нет |
| CONCEPTSINHERITANCE | Колонка CONCEPTSINHERITANCE предназначена для включения опции наследования значений по иерархии понятий. Коды понятий указываются через перенос строки. | Нет | Нет |
Лист предназначен для:
связывания объектов между собой – позволяет связывать как объекты, которые есть только в обменном файле, так и объекты, существующие в хранилище на момент загрузки файла;
добавления свойств связей связываемых объектов.
Если требуется связать объект, существующий в хранилище, то следует заполнить IDEXTERNAL_OBJ1. Если связывается объект из обменного файла, то указывается CODE_OBJ1. Если заполнены оба поля, алгоритм будет использовать IDEXTERNAL_OBJ1. Аналогично и для второго объекта.
Чтобы добавить свойства связи, необходимо:
для свойств понятий создать колонку LINKPROPERTY_{code}, где {code} — код свойства с листа свойств понятий(CODE). Также понятия должны быть добавлены на листе типов связей LINKSDEFINITIONS в колонке CONCEPTS;
для свойств собственных понятий создать колонку OWNCONCEPTS, где {code} — код свойства с листа свойств понятий(CODE).
для собственных свойств создать колонку OWNPROPERTY_{code}, где {code} — код свойства с листа свойств понятий(CODE).
DOCUMENTS – документы
| Колонка | Описание | Обязательно на листе | Обязательно для заполнения | Пояснение |
|---|---|---|---|---|
| CODE | Уникальный код элемента | Да | Да | Уникальный код документа. Служит указателем на документ для файлов. |
| IDEXTERNAL_OBJ | Уникальный идентификатор документа | Нет | Нет |
Колонка IDEXTERNAL_OBJ содержит значение системного свойства "Уникальный идентификатор" документа.
Если в процессе импорта будет найден документ с таким идентификатором, то его свойства, а также связи с объектами будут обновлены информацией из файла обмена. Обновление работает в сторону дополнения данных, т.е. удаление свойств или связей с объектами, которых нет в файле обмена, не производится. Если документа с таким идентификатором не существует, то он будет создан. Формат поля должен строго соответствовать формату <PREFIX:guid>. |
| REFERENCE | Наименование справочника, в котором будет создан документ | Да | Да | В данной колонке указывается справочник, в котором будет создан документ. |
| CATALOGCONCEPT | Понятия каталога Документы | Нет | Нет | Колонка CATALOGCONCEPT предназначена для назначения понятия каталогу Документы (аналогична колонке CONCEPT, но существует в едином экземпляре). |
| ELEMENTS | Список кодов объектов или идентификаторов групп | Да | Нет |
Колонка ELEMENTS заполняется:
|
| GROUPS | Наименование группы, в каталоге Документы | Да | Да | Для формирования иерархической структуры групп со множественным вложением необходимо после первой колонки GROUPS создать еще одну колонку GROUPS и в ней задавать значения для подгрупп. |
| IDEXTERNAL_GROUPS | Идентификатор группы документов | Нет | Нет |
Колонка IDEXTERNAL_GROUPS содержит значение идентификатора (id) группы.
Количество колонок IDEXTERNAL_GROUPS должно совпадать с количеством колонок GROUPS либо их не должно быть совсем. Если в процессе импорта будет найдена группа с таким идентификатором, то ее имя, свойства, понятия, принадлежность к областям типов связей, связи с документами, а также назначенные вычисляемые свойства будут обновлены информацией из файла обмена. Обновление работает в сторону дополнения данных, т.е. удаление свойств или понятий группы, которых нет в файле обмена, не производится. Если группы с таким идентификатором не существует, то она будет создана. Формат поля должен строго соответствовать формату <guid>. |
| CONCEPTS | Понятия группы документов | Нет | Нет |
Если документу необходимы свойства, то в колонку CONCEPTS вписываются через перенос строки понятия, которые будут у данного документа, а в колонках PROPERTY_ вписываются значения свойств понятий.
Опции "Применить для вложенных групп" и "Сопоставить объектам группы": если необходимо указать, что понятие в группе является наследуемым на нижележащие группы и/или обязательным для объектов группы, то следует добавить к коду понятия следующую конструкцию: Код_понятия#$#1#1 где #$# является разделителем между кодом понятия и опциями, первая единица (или нуль) указывает на то, что понятие в группе будет является (не является) наследуемым, вторая единица (или нуль) указывает на то, что понятие будет (не будет) обязательным для объектов группы. |
| OWNCONCEPTS | Собственные понятия документа | Нет | Нет |
Колонка OWNCONCEPTS предназначена для назначения собственных понятий документу. Коды понятий указываются через перенос строки.
Колонка OWNCONCEPTS существует в единственном экземпляре. Если для документа в строке ниже колонка не заполнена, собственные понятия этому документу назначены не будут. |
| CONCEPTSINHERITANCE | Опция "Наследовать значения свойств" | Нет | Нет | Колонка CONCEPTSINHERITANCE предназначена для включения опции наследования значений по иерархии понятий. Коды понятий указываются через перенос строки. |
| NAME | Наименование документа | Да | Да | |
| DESCRIPTION | Описание документа | Нет | Нет | |
| DESIGNATION | Обозначение документа | Нет | Нет | |
| CREATEDATE | Дата создания документа | Да | Нет | |
| PROPERTY_ | Необходима для значений свойств объектов | Нет | Нет | Чтобы задать значение табличного свойства, необходимо указать код значения свойства — значение из колонки TABLEVALUECODE листа PROPERTIESTABLEVALUES. |
| OWNPROPERTY_ | Значения собственных свойств документов | Нет | Нет |
Чтобы задать значения собственных свойств документов, необходимо создать колонки с именем OWNPROPERTY_{code}, где {code} — код свойства понятия, указанный на листе свойств понятий.
На листе свойств понятий собственные свойства сопоставляются только с понятием @Own, т.е. в колонке CONCEPT_CODE на листе свойств понятий для собственных свойств должно быть значение @Own. Чтобы задать значение табличного свойства, необходимо указать код значения свойства — значение из колонки TABLEVALUECODE листа PROPERTIESTABLEVALUES. |
Максимальное количество колонок листа – 2000.
FILES – файлы
| Колонка | Описание | Обязательно на листе | Обязательно для заполнения | Пояснение |
|---|---|---|---|---|
| DOCUMENT | Код документа | Да | Да | В данной колонке указывается код документа (из колонки CODE листа DOCUMENTS), в который необходимо поместить файл. |
| DESCRIPTION | Описание файла | Нет | Нет | |
| CREATEDATE | Дата создания файла | Нет | Нет | |
| PATH | Путь к файлу | Да | Да |
Путь до файла. Например:
Относительный путь: files\file.doc Абсолютный путь: D:\files\file.doc Если указанный файл не найден или он не был загружен, то в лог-файле будет зафиксирована ошибка. |
VIEWPOINTS – представления
| Колонка | Описание | Обязательно на листе | Обязательно для заполнения | Пояснение |
|---|---|---|---|---|
| CODE | Уникальный код представления | Да | Да | |
| IDEXTERNAL_OBJ | Уникальный идентификатор представления | Нет | Нет |
Колонка IDEXTERNAL_OBJ содержит значение системного свойства Уникальный идентификатор представления.
Если в процессе импорта будет найдено представление с таким идентификатором, то его свойства, а также связи с объектами будут обновлены информацией из файла обмена. Обновление работает в сторону дополнения данных, т.е. удаление свойств или связей с объектами, которых нет в файле обмена, не производится. Если представления с таким идентификатором не существует, то оно будет создано. Формат поля должен строго соответствовать формату <PREFIX:guid>. |
| REFERENCE | Наименование справочника | Да | Да | Наименование справочника, в котором будет создано представление. |
| CATALOGCONCEPT | Понятия каталога "Представления" | Нет | Нет | Колонка CATALOGCONCEPT предназначена для назначения понятий каталогу (аналогична колонке CONCEPTS, но существует в единственном экземпляре). |
| ELEMENTS | Список кодов объектов | Да | Нет |
Колонка ELEMENTS заполняется:
|
| GROUPS | Наименование группы в каталоге Представления | Да | Да | Для формирования иерархической структуры групп со множественным вложением необходимо после первой колонки GROUPS создать еще одну колонку GROUPS и в ней задавать значения для подгрупп. |
| IDEXTERNAL_GROUPS | Идентификатор группы представлений | Нет | Нет |
Колонка IDEXTERNAL_GROUPS содержит значение идентификатора (id) группы.
Количество колонок IDEXTERNAL_GROUPS должно совпадать с количеством колонок GROUPS либо их не должно быть совсем. Если в процессе импорта будет найдена группа с таким идентификатором, то ее имя, понятия, а также назначенные вычисляемые свойства будут обновлены информацией из файла обмена. Обновление работает в сторону дополнения данных, т.е. удаление свойств или понятий группы, которых нет в файле обмена, не производится. Если группы с таким идентификатором не существует, то она будет создана. Формат поля должен строго соответствовать формату <guid>. |
| CONCEPTS | Понятия группы представлений | Нет | Нет |
Если представлению необходимы свойства, то в колонку CONCEPTS вписываются через перенос строки понятия, которые будут у данного представления, а в колонках PROPERTY_ вписываются значения свойств понятий.
Опции Применить для вложенных групп и Сопоставить объектам группы: если необходимо указать, что понятие в группе является наследуемым на нижележащие группы и/или обязательным для объектов группы, то следует добавить к коду понятия следующую конструкцию: Код_понятия#$#1#1 где #$# является разделителем между кодом понятия и опциями, первая единица (или нуль) указывает на то, что понятие в группе является (не является) наследуемым, вторая единица (или нуль) указывает на то, что понятие является (не является) обязательным для объектов группы. |
| OWNCONCEPTS | Собственные понятия представлений | Нет | Нет |
Колонка OWNCONCEPTS предназначена для назначения собственных понятий представлению. Коды понятий указываются через перенос строки.
Колонка OWNCONCEPTS существует в единственном экземпляре. Если для представления в строке ниже колонка не заполнена, собственные понятия этому представлению назначены не будут. |
| CONCEPTSINHERITANCE | Опция "Наследовать значения свойств" | Нет | Нет | Колонка CONCEPTSINHERITANCE предназначена для включения опции наследования значений по иерархии понятий. Коды понятий указываются через перенос строки. |
| NAME | Наименование представления | Да | Да | |
| DESCRIPTION | Описание представления | Нет | Нет | |
| FILE | Путь к файлу представления | Нет | Нет |
Колонка предназначена для копирования пользовательского файла представления в Библиотеку компонентов.
|
| PROPERTY_ | Необходима для значений свойств представлений | Нет | Нет | Чтобы задать значение табличного свойства, необходимо указать код значения свойства — значение из колонки TABLEVALUECODE листа PROPERTIESTABLEVALUES. |
| OWNPROPERTY_ | Значения собственных свойств представлений | Нет | Нет |
Чтобы задать значения собственных свойств представлений, необходимо создать колонки с именем OWNPROPERTY_{code}, где {code} — код свойства понятия, указанный на листе свойств понятий.
На листе свойств понятий собственные свойства сопоставляются только с понятием @Own, т.е. в колонке CONCEPT_CODE на листе свойств понятий для собственных свойств должно быть значение @Own. Чтобы задать значение табличного свойства, необходимо указать код значения свойства — значение из колонки TABLEVALUECODE листа PROPERTIESTABLEVALUES. |
Максимальное количество колонок листа – 2000.
FORMULAS – формулы
| Колонка | Описание | Обязательно на листе | Обязательно для заполнения | Пояснение |
|---|---|---|---|---|
| CONCEPTSPROPERTYCODES | Коды свойств понятий | Нет | Нет |
В данной колонке указываются коды свойств понятий, к которым будет привязана формула.
Коды указываются через перенос строки. Рекомендуется вместо данной колонки использовать колонку ELEMENTSCONCEPTSPROPERTIES. |
| ELEMENTS | Список кодов элементов | Нет | Нет |
Значения в колонке (коды элементов справочника) могут быть неуникальными. Например, если у объекта и представления значение в колонке CODE равно 01, то формула будет добавлена и объекту, и представлению.
Чтобы добавить формулу вычисляемому свойству понятия, необходимо выполнить одно из следующих действий: 1. указать в колонке код объекта, документа или представления; 2. добавить к коду объекта, документа или представления конструкцию #$#0 Если необходимо задать "Вычисление группы", то следует добавить к коду объекта\документа\представления следующую конструкцию: #$#1 Если необходимо задать "Вычисление каталога", то следует добавить к коду объекта\документа\представления следующую конструкцию: #$#2 Рекомендуется вместо данной колонки использовать колонку ELEMENTSCONCEPTSPROPERTIES. Если не заполнена колонка ELEMENTS или CONCEPTSPROPERTYCODES, то формула будет импортирована в список формул, но не будет применена к объектам. |
| ELEMENTSCONCEPTSPROPERTIES | Список уникальных идентификаторов элементов | Нет | Нет |
В данной колонке могут использоваться следующие конструкции:
|
| FOLDER | Путь к группе через разделитель «/» | Да | Да | |
| NAME | Имя формулы | Да | Да | |
| DESCRIPTION | Описание формулы | Нет | Нет | |
| CODE | Код формулы | Да | Да | |
| BODY | Текст формулы | Да | Нет | |
| PARAMETERS | Параметры формулы, через разделитель «Ctrl+Enter» | Нет | Нет |
Параметры формулы указываются через перенос строки ("Ctrl+Enter").
Разделителем между наименованием параметра и телом параметра является знак равенства "=". Наименование параметра пишется БЕЗ квадратных скобок. Например, Сортамент=GetPropertyValue(....) |
MEASUREENTITY – измеряемые величины
| Колонка | Описание | Обязательно на листе | Обязательно для заполнения |
|---|---|---|---|
| NAME | Имя измеряемой величины | Да | Да |
| CODE | Код измеряемой величины | Да | Да |
| DESCRIPTION | Описание измеряемой величины | Нет | Нет |
MEASUREUNIT – единицы измерения
| Колонка | Описание | Обязательно на листе | Обязательно для заполнения | Пояснение |
|---|---|---|---|---|
| NAME | Имя единицы измерения | Да | Да | |
| DESIGNATION | Обозначение единицы измерения | Да | Да | |
| CODE | Код измеряемой величины | Да | Да | |
| DESCRIPTION | Описание | Нет | Нет | |
| ISBASIC | Признак того, что единица измерения является базовой | Да | Нет |
Значения задаются в следующем виде:
Базовая единица измерения может быть только одна в пределах измеряемой величины |
| FROMBASICFACTOR | Переменная k | Да | Нет | Переменная формулы преобразования от базовой величины |
| FROMBASICOFFSET | Переменная b | Да | Нет | Переменная формулы преобразования от базовой величины |
| CODEOKEI | Код по ОКЕИ | Да | Нет | |
| INTERNATIONALDESIGNATIONOKEI | Международное обозначение по ОКЕИ | Да | Нет | |
| LITERALDESIGNATION | Национальное буквенное обозначение | Да | Нет | |
| INTERNATIONALLITERALDESIGNATION | Международное буквенное обозначение | Да | Нет | |
| MEASUREENTITY_CODE | Код измеряемой величины, к которой относится единица измерения | Да | Да | Указывается значение колонки CODE листа MEASUREENTITY |
TABLESETTINGS – настройки таблиц групп
| Колонка | Описание | Обязательно на листе | Обязательно для заполнения | Пояснение |
|---|---|---|---|---|
| CONCEPTSPROPERTYCODES | Коды свойств понятий | Да | Нет | Понятия/свойства, которые будут отображаться в таблице. |
| CODE | Коды настроек таблицы | Да | Нет | |
| UNIT | Коды единиц измерения | Нет | Нет | Если для типа double не указан код единицы измерения, то при импорте файла обмена будет взята умолчательная единица измерения, при условии, что на листе PROPERTIES указана измеряемая величина. |
MULTIPLECLASSIFICATION – множественная классификация
| Колонка | Описание | Обязательно на листе | Обязательно для заполнения | Пояснение |
|---|---|---|---|---|
| IDEXTERNAL_OBJ | Уникальный идентификатор объекта или документа | Да | Нет |
Колонка IDEXTERNAL_OBJ содержит значение системного свойства
"Уникальный идентификатор" объекта или документа.
Колонка может содержать только один "Уникальный идентификатор". Если в колонке IDEXTERNAL_OBJ указан объект, а в колонке IDEXTERNAL_GROUPS — группа документов, данная группа будет пропущена для объекта при импорте файла обмена. Если в IDEXTERNAL_OBJ указан документ, а в колонке IDEXTERNAL_GROUPS — группа объектов, данная группа будет пропущена для документа при импорте файла обмена. |
| IDEXTERNAL_GROUPS | Внутренние идентификаторы групп | Да | Нет |
Колонка IDEXTERNAL_GROUPS содержит значения идентификаторов групп,
в которые классифицированы объекты или документы.
Если в колонке есть группы, идентификаторы которых отсутствуют в хранилище или на листе DATA, то объекты или документы, указанные в IDEXTERNAL_OBJ, в данные группы классифицированы не будут. |
RESTRICTIVELISTS – ограничительные перечни
Примечание
Роли пользователей, сопоставленные ограничительному перечню не экспортируются в файл обмена. При импорте список ролей не обновляется.
| Колонка | Описание | Обязательно на листе | Обязательно для заполнения | Пояснение |
|---|---|---|---|---|
| NAME | Имя ограничительного перечня | Да | Да | |
| CODE | Код ограничительного перечня | Да | Да |
Если ограничительный перечень с кодом, указанным в колонке CODE обменного файла:
|
| DESCRIPTION | Описание ограничительного перечня | Нет | Нет | |
| MANDATORY | Опция "Обязательный" | Нет | Нет |
|