Дизайнер ELMA > Внешние источники / Получение данных из внешнего источника

Получение данных из внешнего источника

Если подключение к внешнему источнику прошло успешно, в ELMA4 будут переданы все данные, которые хранятся в нем. Вы можете указать, с какими данными нужно работать в ELMA4. Для этого в таблице со списком соединений наведите курсор на кнопку process-metrics-2 справа от нужного соединения и нажмите Изменить конфигурацию.

Вы увидите список всех объектов источника и их свойства. Чтобы перейти к свойствам, нажмите на значокproperty-icon. В скобках для каждого свойства указывается тип данных, которые могут в нем храниться: Строка, Уникальный идентификатор, Число, Дата, Логическое значение или Двоичные данные.

Выберите объекты, с которыми нужно работать в ELMA4. Один объект сохраняется как отдельный справочник. Если вам нужно выбрать сразу все объекты, установите флажок Выделить все. Если вы хотите, чтобы при выборе объекта добавлялись и все его свойства, установите флажок Выделять реквизиты автоматически.

начало внимание

Не рекомендуется импортировать все объекты. Это может повлиять на производительность системы.

конец внимание

По умолчанию данные из внешних источников доступны пользователям только для просмотра. Вы можете задать возможность редактировать эти данные, включив опцию Изменение данных в источнике.

В процессе настройки конфигурации могут возникнуть ошибки. Они отображаются на вкладке Ошибки.

Для каждого справочника можно задать настройки. Для этого нажмите на его название в списке. Справа появится блок Настройки справочника.

external-sources-3

В блоке вы увидите название справочника, которое формируется автоматически.

В поле Тип таблицы выберите тип объекта. Он может использоваться в ELMA4 как справочник, таблица связи для других справочников или блок.

Рассмотрим настройки для каждого типа.

Справочник

Отображаемое имя — название справочника, которое будет отображаться при работе с ним в ELMA4.

Описание — дополнительная информация о справочнике.

Имя справочника — уникальное имя справочника, которое будет использоваться при работе со сценариями. Имя можно изменить. Рекомендуется указывать понятное название на английском языке. Вы можете использовать только буквы латинского алфавита и знак подчеркивания.

Если разрешено изменение данных в источнике, в настройках появляется флажок Только для чтения. Установите его, чтобы данные этого справочника нельзя было редактировать.

Настройки свойства справочника

Вы можете указать настройки для каждого свойства справочника, нажав на его название в списке. Справа появится блок Настройки свойства. Их набор зависит от типа данных. Рассмотрим настройки, которые отображаются для любого типа данных.

В блоке вы увидите название свойства, которое формируется автоматически.

Отображаемое имя — название поля, которое будет отображаться при работе со справочником в системе.

Описание — дополнительная информация о свойстве справочника.

Имя свойства — уникальное имя свойства, которое используется при работе со сценариями. Имя можно изменить. Рекомендуется указывать понятное название на английском языке. Вы можете использовать только буквы латинского алфавита и знак подчеркивания.

Сортируемое поле — возможность сортировать записи справочника по этой колонке в таблице. Подробнее читайте в статье «Таблица данных».

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

Показывать на форме — отображение свойства на форме просмотра записей справочника.

Если вы разрешили изменение данных в источнике, появляется возможность указать, что нельзя редактировать данные в этом поле. Для этого установите флажок Только для чтения. Кроме того, можно указать, что это поле обязательно для заполнения, установив флажок Обязательное.

Рассмотрим дополнительные настройки для каждого типа данных.

  1. Дата

Показывать время — в этом поле пользователь может просматривать и указывать дату.

Показывать дату — в этом поле пользователь может просматривать и указывать время.

  1. Число

Точность — количество знаков после запятой у дробного числа. Округление осуществляется по математическим правилам.

  1. Строка

Является наименованием — свойство станет ключевым свойством‑наименованием.

Участвует в быстром поиске — пользователь сможет осуществлять быстрый поиск по этому свойству.

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

Для каждого справочника задается идентификатор. Он определяется автоматически при получении данных из внешнего источника. Идентификатор можно изменить. В качестве идентификатора можно указывать свойства типа Строка, Число и Уникальный идентификатор. Для этого в настройках установите флажок Является идентификатором. У справочника может быть только один идентификатор.

Если вы выбираете справочник для публикации, идентификатор выделяется автоматически. Если вы не указали идентификатор, отображается уведомление об ошибке.

начало внимание

Название или тип идентификатора могут измениться во внешнем источнике. В таком случае нужно настроить идентификатор справочника повторно и сохранить новую конфигурацию внешнего источника. Если данные этого источника используются в сценариях или в объектах ELMA, при работе с ними могут возникнуть ошибки. Поэтому нужно внести изменения в сценарии и настроить объекты ELMA повторно. При этом ссылки на внешний источник будут утеряны.

конец внимание

Вы можете создать свойство, в котором будут храниться данные другого справочник из текущего источника данных. Для этого в настройках установите флажок Ссылка на объект. Такая возможность доступна для свойств типа Строка, Число и Уникальный идентификатор.

В поле Тип ссылки укажите справочник, данные из которого будут отображаться в поле. Вы можете указать справочник только из текущего источника данных. После этого в списке для свойства в скобках будет указан этот объект. Справочники можно выбрать, только если тип свойства, которое вы настраиваете, совпадает с типом идентификатора справочника.

При этом в списке свойств выбранного справочника автоматически появится свойство с типом связи Множественная (1-N). Его название задается в формате <Название родительского справочника.Название внешнего ключа>. В скобках указывается родительский объект этого свойства и обозначается *.

Чтобы перейти к настройкам свойства, нажмите на его название. Вы увидите название свойства, которое формируется автоматически. В начале отображается символ &. Как и для других свойств, можно указать отображаемое имя, описание, имя свойства, а также включить опции Показывать в таблице, Показывать на форме, Только для чтения и Обязательное. Изменить выбранный справочник в поле Тип ссылки нельзя.

Таблица связи

Между двумя справочниками можно настроить связь Многие ко многим. Для этого выберите справочник, при помощи которого будут связаны два других справочника, и в поле Тип таблицы выберите Таблица связи. После этого вам нужно выбрать два свойства этого справочника. Они будут внешними ключами. Перейдите к настройкам свойства, нажав на его название. Справа появится блок Настройки связи.

external-sources-4

В поле Тип ссылки укажите один из двух связываемых справочников.

При этом свойство появится в списке свойств выбранного справочника автоматически. Его название задается в формате <Название справочника, который выбран как таблица связи.Название внешнего ключа>. В скобках указывается родительский объект этого свойства и обозначается *.

Чтобы перейти к настройкам свойства, нажмите на его название. Вы увидите название свойства, которое формируется автоматически. В начале отображается символ &. Как и для других свойств, можно указать отображаемое имя, описание, имя свойства, а также включить опции Показывать в таблице, Показывать на форме, Только для чтения и Обязательное. Изменить выбранный справочник в поле Тип ссылки нельзя.

Табличные данные

Вы можете настроить отображение информации из справочника в виде блока. Подробнее о работе с блоком можно прочитать в статьях «Свойство типа Блок» и «Отображение свойства объекта типа Блок».

При работе с базами данных блок нужно настраивать самостоятельно.

Если вы используете источник данных OData, информация о табличных данных предоставляется автоматически. Вам нужно только выбрать для публикации свойство, которое выступает в качестве блока. Изменить заданные настройки нельзя. Но вы можете настроить вручную дополнительный блок.

Для этого выберите справочник, данные из которого нужно отобразить в виде блока, и в поле Тип таблицы укажите Табличные данные.

get-data-from-external-source-3

Вы можете изменить имя справочника, которое используется в сценариях.

В поле Ссылка на родителя выберите свойство, в котором будет содержаться набор других свойств, объединенных в таблицу. После этого оно обозначается как родительский объект. В качестве родительского объекта можно указать свойство типа Строка, Число или Уникальный идентификатор. В настройках свойств таких типов доступна опция Ссылка на родителя.

Если разрешено изменение данных в источнике, появляется флажок Только для чтения. Установите его, чтобы данные в этом блоке нельзя было редактировать.

Чтобы перейти к настройкам свойства, нажмите на его название. Свойства настраиваются так же, как и при работе с обычными справочниками.

начало примечание

Примечание

При работе с табличными данными задавать идентификатор требуется, если в блоке содержится вложенный блок. В других случаях указывать его необязательно.

конец примечание

Если вы установите флажок Ссылка на родителя, будет доступно поле Тип ссылки. В нем нужно выбрать справочник, в котором будут отображаться данные в виде блока. Справочники можно выбрать, только если тип свойства, которое вы настраиваете, совпадает с типом идентификаторов справочников.

При этом свойство появится в списке свойств выбранного справочника автоматически. Его название отображается в формате <Название справочника, который выбран как табличные данные.Название настраиваемого в нем свойства>. В настройках в названии такого свойства появляется символ &. Как и для других свойств, вы можете указать отображаемое имя, описание, имя свойства, а также включить опции Показывать в таблице, Показывать на форме, Только для чтения и Обязательное. Изменить выбранный справочник в поле Тип ссылки нельзя.

Если для табличных данных указан идентификатор, в настройках такого свойства можно задать, что его значение будет вычисляться автоматически без обращения к внешнему источнику данных. Например, если требуется вычислить порядковый номер записи в блоке. Для этого установите флажок Счетчик. Некоторые источники данных не могут возвращать автоматически созданный идентификатор. В таких случаях добавление новых записей блока или элементов списка невозможно.

Чтобы сохранить и опубликовать выбранные справочники в ELMA4, нажмите Сохранить и перезапустите сервер. Подробнее о том, как это сделать, читайте в статье «Публикация».

Нашли опечатку? Выделите текст, нажмите ctrl + enter и оповестите нас