О базовых формах
Базовые формы можно настроить в студии дизайна Power Pages. Дополнительные сведения см. в статье Добавление формы.
Конфигурация метаданных базовой формы
Формы Dataverse — это управляемая данными конфигурация, которая позволяет пользователям добавлять формы для сбора данных на веб-сайт без привлечения разработчика. Такие формы создаются в рабочей области "Данные" и затем используются для создания базовых компонентов-форм, которые можно размещать на веб-страница на веб-сайте или использовать в сочетании со вложенными сетками и списками для разработки комплексных веб-приложений. Дополнительные сведения: О списках.
Добавление формы на веб-сайт
Базовая форма содержит связи с веб-страницами и другие свойства для управления инициализацией формы на портале. Отношения с веб-страницами обеспечивают динамическое извлечение определения формы для указанного узла страницы на веб-сайте.
Чтобы просмотреть существующие базовые формы или создать новые базовые формы, откройте приложение управления порталом и перейдите в раздел Содержимое>Базовые формы.
Когда вы создаете новую базовую форму, на первом шаге требуется выбрать Таблица и Имя формы Dataverse, которые будут представляться, а также режим: Вставить, Изменить или Только чтение. Выбранный режим определяет, создается ли новая запись из портала, изменяется существующая запись или только отображаются сведения о записи на портале.
Заметка
Прежде чем продолжить, обязательно ознакомьтесь с соображения для базовых форм.
Веб-страницы, связанные с базовой формой, можно просмотреть, выбрав ссылку Веб-страницы, имеющуюся в ссылках навигации В отношении в самом левом меню.
При создании или изменении веб-страницы можно указать пункт Базовая форма в поле поиска, предусмотренном на форме "Веб-страница".
Добавлените базовой формы с помощью Liquid
Базовую форму также можно добавить на веб-сайт, добавив тег Liquid. {% entityform name: '<<basic form name>>' %} в область содержимого, такую как поле Копия страницы веб-страницы или в веб-шаблон.
Защита форм
Заметка
Этот метод защиты форм скоро станет устаревшим. Следовательно, его не следует использовать. Вместо этого используйте правильные разрешения для таблиц и настройку веб-роли, чтобы предоставить пользователям доступ к любым данным. Больше информации: Изменения разрешений таблиц для форм и списков на новых порталах
Чтобы защитить свои формы, необходимо создать разрешения таблицы, которые определяют доступ и права собственности для записей в соответствии с веб-ролями. Если пользователь перешел на базовую форму и не имеет разрешений, он получит сообщение об ошибке. Кроме того, вы также видите предупреждение, когда форма настроена с отключенными разрешениями для таблиц:
"Для этой записи должны быть включены разрешения таблицы, иначе любой пользователь Интернета сможет просматривать данные".
Чтобы включить разрешения для базовой формы, установите флажок Включить разрешения для таблиц. Дополнительные сведения см. в статье Создание веб-ролей.
Атрибуты и отношения базовой формы
| Полное имя | Описание: |
|---|---|
| имени | Описательное имя записи. Это обязательное поле. |
| Имя таблицы | Имя таблицы, из которой загружается форма. Это обязательное поле. |
| Имя формы | Имя формы в целевой таблице, которую требуется обработать. Это обязательное поле. |
| Имя вкладки | Необязательное имя вкладки на форме для указанной таблицы, которую требуется обработать. |
| Режим | Одно из следующих значений:
|
| Тип источника записи | Одно из следующих значений:
При выборе варианта Текущий пользователь портала извлекается запись пользователя портала для текущего пользователя, прошедшего аутентификацию. При выборе варианта Запись, связанная с текущим пользователем портала извлекается запись пользователя портала для текущего пользователя, прошедшего проверку подлинности, и затем извлекается запись для определенного отношения, указанного в поле "Имя отношения". |
| Имя параметра ИД записи | Имя параметра, указанное в строке запроса URL-адреса веб-страницы, содержащей эту базовую форму. |
| Название отношения | Обязательно, если тип источника записи имеет значение "Запись, связанная с текущим пользователем портала". Логическое имя отношения между записью текущего пользователя портала и целевой записью. Должно возвращать тот же тип таблицы, что и указанный полем "Имя таблицы". |
| Разрешить создание, если значение равно Null | Необязательное логического значения, доступное, если параметр "Тип источника записи" имеет значение "Запись, связанная с текущим пользователем портала". Указывает, что если связанная запись отсутствует, пользователю разрешено создать ее в первый раз; в противном случае создается исключение, если запись еще не существует, так как форме требуется запись для связывания с ней данных. ПРИМЕЧАНИЕ. Эта функция недоступна в многошаговых формах. |
| Включить разрешения таблицы | Форма учитывает разрешения таблицы. В целях обратной совместимости значение по умолчанию — false. Если выбрано значение "истина", НЕОБХОДИМЫ явные разрешения для любого пользователя, который хочет получить доступ к форме. ПРИМЕЧАНИЕ. Этот метод защиты форм скоро станет устаревшим. Следовательно, его не следует использовать. Вместо этого используйте правильные разрешения для таблиц и настройку веб-роли, чтобы предоставить пользователям доступ к любым данным. Больше информации: Изменения разрешений таблиц для форм и списков на новых порталах |
Параметры формы
| Имя | Описание |
|---|---|
| Добавить Captcha | Отображает код Captcha. |
| Показать Captcha для пользователей, прошедших проверку подлинности | Показывает код Captcha для пользователей, прошедших проверку подлинности. |
| Группа проверки | Название группы, назначенное элементам управления ввода для оценки допустимого ввода именованных групп. |
| Автоматическое создание шагов из вкладок | Указывает, что несколько вкладок на базовой форме отображаются с каждой вкладкой в виде последовательного шага, начиная с первой вкладки и далее, пока не будет выполнен переход на все вкладки; после отправки запись будет вставлена. По умолчанию не выбрано. Значение по умолчанию означает, что только одна вкладка или форма обрабатывается для текущего шага. Если имя вкладки не указано, отображается первая вкладка. |
| Отображать веб-ресурсы встроенным способом | Исключает кадр iFrame, содержащий веб-ресурс в базовой форме. |
| Подсказки включены | Подсказка устанавливается с помощью описания атрибута на целевой таблицы. |
| Показать неподдерживаемые поля | Показать или скрыть имена столбцов с неподдерживаемыми типами столбцов Dataverse. |
| Установить рекомендованные поля как обязательные | Делает все атрибуты обязательными, у которых для уровня требований поля установлено значение "Бизнес-рекомендация". |
| Сделать все поля обязательными | Делает все поля обязательными независимо от уровня требований поля. |
| Класс CSS сводки проверки | Имя класса CSS, назначенное сводке проверки. По умолчанию «validation-summary alert alert-error alert-block» |
| Включить ссылки на сводки проверки | Логическое значение (истина или ложь), которое указывает, следует ли ссылки привязки обрабатывать в сводке проверки для прокрутки к полю, содержащему ошибку. Значение по умолчанию — «истина». |
| Текст ссылки на сводку проверки | Метка, назначенная ссылкам сводки проверки. Значение по умолчанию — «нажмите здесь». |
| Текст заголовка сводки проверки | Метка, назначенная заголовку сводки проверки. |
| Инструкции | Инструкции для работы с формой. |
| Сообщение "Запись не найдена" | Сообщение, которое должно выводиться, если запись не найдена. |
Параметры при успешном завершении
| Полное имя | Description |
|---|---|
| При успешном завершении | Одно из следующих значений:
|
| Скрыть форму при успешном завершении | Требуется, чтобы для параметра "При успешном завершении" было задано значение "Показать сообщение об успехе". Если выбрано, форма скрывается после успешной отправки формы. |
| Сообщение об успехе | Требуется, чтобы для параметра "При успешном завершении" было задано значение "Показать сообщение об успехе". Сообщение, отображаемое пользователю после успешной отправки. Если оно не указано, отображается сообщение по умолчанию ("Отправка успешно выполнена"). Для каждого установленного и включенного языкового пакета для организации доступно поле для ввода сообщения на соответствующем языке. |
| Внешний URL-адрес | Требуется, чтобы для параметра "При успешном завершении" было задано значение "Перенаправить". Укажите URL-адрес внешнего ресурса в Интернете. |
| или веб-страница | Требуется, чтобы для параметра "При успешном завершении" было задано значение "Перенаправить". Выберите веб-страницу на текущем веб-сайте. |
| Добавить существующую строку запроса | Требуется, чтобы для параметра "При успешном завершении" было задано значение "Перенаправить". Если выбрано, существующие параметры строки запроса добавляются к целевому URL-адресу перед перенаправлением. |
| Добавить код записи в строку запроса | Требуется, чтобы для параметра "При успешном завершении" было задано значение "Перенаправить". Если выбрано, код созданной записи добавляется к строке запроса URL-адреса, на который производится перенаправление. |
| Имя параметра ИД записи | Требуется, чтобы для параметра "При успешном завершении" было задано значение "Перенаправить". Имя параметра кода в строке запроса URL-адреса, на который производится перенаправление. |
| Добавить пользовательскую строку запроса | Требуется, чтобы для параметра "При успешном завершении" было задано значение "Перенаправить". Настраиваемая строка, которую можно добавить к существующей строке запроса URL-адреса перенаправления. |
| Добавить значение атрибута в строку запроса — имя параметра | Требуется, чтобы для параметра "При успешном завершении" было задано значение "Перенаправить". Имя, присваиваемое параметры, который коррелирует со значением атрибута в целевой таблице, которое добавляется к строке запроса URL-адреса перенаправления. |
| Добавить значение атрибута в строку запроса — логическое имя атрибута | Требуется, чтобы для параметра "При успешном завершении" было задано значение "Перенаправить". Логическое имя атрибута в целевой таблице для получения значения, которое добавляется к строке запроса URL-адреса перенаправления. |
Дополнительные параметры
| Имя | Описание |
|---|---|
| Связать текущего пользователя портала | Указывает, что запись текущего выполнившего вход пользователя должна быть связана с записью целевой таблицы. |
| Столбец подстановки пользователей портала | Логическое имя атрибута в целевой таблице, в котором хранится пользователь портала. |
| Является стороной действия | Логическое значение, указывающее, является ли столбец подстановки пользователя портала типом "Сторона действия". |
| Вкладывание файла | Выберите, чтобы форма включала элемент управления передачей файла в нижней части формы, позволяя прикрепить файл к записи. Примечание. Порталы с версией 9.2.2.x и выше не требуют включения Включить разрешения таблицы в базовой форме для прикрепления файлов. Однако, если вы выбрали его, вы должны убедиться, что соответствующие права предоставлены в родительской таблице и таблице аннотаций для отображения кнопки Прикрепить файл на форме. В таблице аннотаций должны быть по крайней мере привилегии Создание и Добавление, и родительская таблица должна иметь соответствующую привилегию AppendTo. В зависимости от того, есть ли у вас форма для создания или обновления, вам также может понадобиться привилегии Создать, **Чтение и Запись для завершения сценария формы. Отправленные в систему файлы можно отобразить, включив элемент управления "Временная шкала". Дополнительные сведения см. в статье Настройка заметок. |
| Вложить файл — расположение хранилища | Параметры: Вложенное примечание, Хранилище больших двоичных объектов Azure. Если организация настроена для использования хранилища Azure, можно выбрать хранение незагруженных файлов для этой базовой формы там. В противном случае файлы будут храниться как вложенное примечание. |
| Разрешить несколько файлов | Логического значение, указывающее, может ли пользователь отправлять несколько файлов. |
| Принять | Атрибут принятия указывает типы MIME файлов, которые сервер принимает путем отправки файла. Чтобы указать несколько значений, разделяйте значения запятой (например, audio/,video/,image/*). |
| Label | Текст, отображаемый рядом с элементом управления отправкой файла. Для каждого установленного и включенного языкового пакета для организации доступно поле для ввода сообщения на соответствующем языке. |
| Вложить файл — обязательно | Для продолжения необходим вложенный файл. |
| Обязательное сообщение об ошибке | Сообщение, выводимое во время проверки форм, если в поле "Обязательно" задано значение "Истина" и пользователь не вложил файл. Для каждого установленного и включенного языкового пакета для организации доступно поле для ввода сообщения на соответствующем языке. |
| Ограничить файлы допустимыми типами | Принудительная проверка по полю "Принять". Если не выбрано, атрибут принятия используется только как предложение для диалога отправки файла. |
| Сообщение об ошибке типа файла | Сообщение, отображаемое в ходе проверки формы, если параметр "Ограничить файлы допустимыми типами" имеет значение "true" и пользователь пытается отправить файл недопустимого типа. Для каждого установленного и включенного языкового пакета для организации доступно поле для ввода сообщения на соответствующем языке. |
| Максимальный размер файла (в килобайтах) | Задает принудительную проверку максимально допустимого размера отправленного файла. |
| Сообщение об ошибке размера файла | Сообщение, отображаемое в ходе проверки формы, если параметр "Максимальный размер файла (в килобайтах)" имеет значение "true" и пользователь попытался отправить файл слишком большого размера. Для каждого установленного и включенного языкового пакета для организации доступно поле для ввода сообщения на соответствующем языке. |
| Пользовательский код JavaScript | Пользовательский блок кода JavaScript, который добавляется в нижнюю часть страницы непосредственно перед закрывающим элементом тега формы. Идентификатор ввода HTML поля таблицы установлен на логическое имя атрибута. Это упрощает выбор поля, задание значений и другие операции на стороне клиента с помощью jQuery.$(document).ready(function() { $("#address1_stateorprovince").val("Saskatchewan");}); |
Ссылка на связанную таблицу
Следующие параметры относятся к настройке ссылки связанной таблицы при сохранении формы.
Это дает возможность связывать текущую запись, создаваемую или обновляемую формой, с другой целевой записью. Это полезно, если имеется несколько шагов с несколькими типами таблиц и требуется связать получившиеся записи или если странице передана строка запроса идентификатора записи, которую требуется связать. Например, имеется страница карьеры, на которой перечислены объявления о должности, каждое со ссылкой на заявление на должность, содержащее идентификатор объявления о должности для формы заявления, чтобы при создании заявления с записью связывалось объявление о должности.
| имени | Описание |
|---|---|
| Задать ссылку на таблицу при сохранении | "Да" или "Нет". Значение "Да" указывает, что ссылка связанной таблицы должна быть назначена при сохранении формы, в противном случае ссылка не задается. |
| Название отношения | Имя определения отношения для определенного отношения между двумя типами таблиц. |
| Логическое имя таблицы | Логическое имя ссылочной таблицы. |
| Логическое имя атрибута поиска целевого объекта | Логическое имя атрибута поиска в создаваемой или обновляемой целевой таблицы. |
| Заполнить поле поиска | Если в форме имеется подстановка, связанная со ссылочной таблицей, при установке этого флажка поле в форме заполняется значением, извлеченным с указанной ниже настройкой. |
| Тип источника | Одно из следующих значений:
|
| Шаг справочной таблицы | Запись шага многошаговой формы предыдущего шага для извлечения таблицы, созданной или отредактированной на этом шаге, чтобы связать ее с записью для этого текущего шага. |
| Имя строки запроса | Имя параметра, указанное в строке запроса URL-адреса веб-страницы, содержащей эту многошаговую форму. |
| Строка запроса является основным ключом | "Да" означает, что значение строки запроса является значением основного ключа. "Нет" означает, что значение строки запроса имеет тип атрибута, отличный от основного ключа. |
| Логическое имя атрибута запроса | Логическое имя атрибута для запроса записи. |
| Показать сведения о ReadOnly | Указывает, что форма должна отображаться в верхней части страницы и содержать сведения только для чтения, относящиеся к ссылочной записи. Требуется имя формы. |
| Имя формы | Имя формы на ссылочной таблицы, которая должна использоваться для отображения сведений только для чтения. |
Конфигурация действия базовой формы
По умолчанию базовая форма разрешает чтение или обновление существующей записи, или вставку новой записи. Тем не менее вы можете легко включить и настроить дополнительные действия для записей в базовой форме (такие как удаление, активация, деактивация и т. д.). Также можно переопределить подписи, размеры и другие атрибуты по умолчанию, которые отображаются, если имеются включенные действия.
Эти параметры находятся в разделе Дополнительные параметры базовой формы. По умолчанию отображаются только Основные параметры. Можно выбрать Дополнительные параметры для отображения дополнительных параметров.
Можно добавить кнопки действий для действий, применимых для отдельных записей, которые отображаются для каждой строки в сетке, если соответствующая привилегия была предоставлена в разрешениях таблицы. Возможны следующие действия:
- DELETE
- Бизнес-процесс
- Создать связанную запись
- Активация
- Деактивация
При нажатии на одном из этих параметров отображается область конфигурации для этого действия. Более того, некоторые таблицы имеют особенные действия, которые доступны им для каждой отдельной таблицы:
- Вычисление значения возможной сделки (возможная сделка)
- Действие отмены обращение (инцидент)
- Действие закрытия (разрешения) обращения (инцидент)
- Преобразование предложения в заказ (предложение с расценками)
- Преобразование заказа в счет (заказ на продажу)
- Создать предложение с расценками из возможной сделки (возможная сделка)
- Действие при упущенной возможной сделке (возможная сделка)
- Действие при реализованной возможной сделке (возможная сделка)
- Действие повторного открытия обращения (инцидент)
- Перевести возможную сделку в отложенное состояние (возможная сделка)
Заметка
Рекомендует создать рабочий процесс вместо добавления кнопок Активировать или Деактивировать для готовых таблиц, определив конкретные значения состояние и код состояния, которые требуются для их бизнес-процессов. Например, Инцидент (параметры состояния), Возможная сделка (параметры состояния), Объем обслуживания (параметры состояния).
Конфигурация географического положения для базовых форм
Форму можно настроить для отображения элемента управления картой для отображения существующего положения в виде булавки на карте или для предоставления пользователям возможности указывать положение. См. раздел Добавление географического положения.
Элемент управления картой формы требует дополнительной конфигурации для указания того, что идентификаторы различных полей находятся в порядке для назначения их значений или извлечения значений из них. Запись базовой формы имеет раздел конфигурации, в котором определены эти сопоставления полей, которые необходимо указать. Имена полей меняются в зависимости от созданной схемы.
Заметка
- Поле адреса в доступной только для чтения базовой форме заменяется картой, если включен параметр географического положения.
- Карта будет отображаться только при отображении формы в модальном окне.
- Раздел "Географическое положение" не будет отображаться в среде государственного облака в Германии. Если пользователь включил географическое положение, используя другую форму, оно не будет отображаться при отрисовке портала.
Проверка запроса
Проверка запроса — это особенность ASP.NET с версии 1.1, которая запрещает серверу принимать контент, содержащий незакодированный код HTML. Эта функция предназначена для предотвращения некоторых атак с использованием вставки сценариев, в результате чего код клиентского сценария или HTML может быть незаметно отправлен на сервер, сохранен, а затем представлен другим пользователям. Мы по-прежнему настоятельно рекомендуем проверять все входные данные и кодировать их HTML, когда это необходимо.
По умолчанию проверка запроса включена на портале, что приводит к следующей общей ошибке, если вы вводите код сценария без кодировки HTML в поля базовой формы:
Found field(s) submitted with potentially dangerous value(s) such as HTML, or script. Please review the field value(s) and try again.
Заметка
Чтобы предотвратить выполнение любого вредоносного кода, включая блоки скриптов, вы можете обновить настройку сайта Site/DisableFormDataSafeHtmlValidation на false. По умолчанию этот параметр имеет значение true, и проверяется только блок сценариев.
Чтобы отключить проверку запросов, выполните следующие действия.
Откройте Приложение управления порталом.
Перейдите к разделу Параметры сайта.
Выберите Создать.
Введите имя как DisableValidationWebTemplate.
Выберите соответствующую запись на веб-сайте.
Введите значение true. По умолчанию настройка false, что разрешает проверку запросов.
Введите соответствующее описание.
Выберите Сохранить и закрыть.
Внимание
Когда проверка запросов отключена, контент может быть отправлен на страницу. Вы должны убедиться, что контент правильно закодирован или обработан.
Рекомендации
- Базовая форма должна быть связана с веб-страницей для определенного веб-сайта, чтобы эта форма была видна на этом сайте.
- Вложенные сетки таблицы подключений не поддерживаются в базовых формах. Если добавить вложенную сетку таблицы подключения в форму с помощью конструктора формы, сообщения об ошибке отображаются при отрисовке формы на портале и использования таблицы соединения.
- Дублирующиеся поля, поля списка участников и бизнес-правила не поддерживаются в базовых формах.
- Компоненты кода уровня поля могут быть добавлены в формы. Дополнительные сведения: Использование компонентов кода
- Бизнес-правила и клиентский API могут открыть доступ к заблокированным полям в доступной только для чтения форме.
- При создании базовой формы в режиме Вставка невозможно изменить выравнивание кнопки или вставить кнопку действия над базовой формой.
- Если элемент управления подстановки отображается в форме как раскрывающийся список, фильтр связанных записей не работает.
- Столбцы свертки в формах могут иногда отображаться как редактируемые, хотя они предназначены только для чтения. Чтобы эти столбцы оставались доступными только для чтения, пометьте столбец как Только чтение в форме Dataverse.