Відомості про базові форми
Базові форми можна настроювати в студії дизайну Power Pages. Додаткові відомості див. в розділі Додавання форми.
Налаштування метаданих базової форми
Керована даними конфігурація дозволяє кінцевим користувачам додавати форми для збирання даних на вебсайті без необхідності для розробників демонструвати форму на вебсайті. Форми Dataverse створюються в робочому середовищі «Дані», а потім використовуються для створення компонентів базової форми, яку можна розмістити на весторінках або використовувати в поєднанні з вкладеними сітками та списками сутностей для створення повноцінних вебпрограм. Додаткові відомості: Про списки.
Додавання форми до вебсайту
Базова форма містить зв'язки з вебсторінками та іншими властивостями з метою керування ініціалізацією форми на порталі. Зв’язки з веб-сторінками дозволяють динамічно відтворювати визначення форми для даного вузла сторінки в рамках веб-сайту.
Щоб переглянути наявні базові форми або створити нові базові форми, відкрийте програму «Керування порталом» і виберіть Вміст>Базові форми.
Коли ви створюєте нову базову форму, першим кроком є вибір назви таблиці Dataverse та форми, які ви візуалізуєте, на додаток до режиму: Вставка, Редагування або Лише читання. Вибраний режим визначає, чи створюєте ви новий запис на порталі, редагуєте наявний запис або просто відображаєте інформацію про запис на порталі.
Нотатка
Перед продовженням обов’язково перегляньте міркування щодо базових форм.
Веб-сторінки, пов'язані із базовою формою можна переглянути, вибравши Веб-сторінки, вказані у навігаційні посиланнях Пов’язане в крайньому меню ліворуч.
Під час створення або редагування веб-сторінки базову форму можна вказати в полі підстановки у формі веб-сторінки.
Додавання базової форми за допомогою Liquid
Також можна додати базову форму до вебсайту, додавши тег Liquid {% entityform name: '<<basic form name>>' %} до області вмісту, як-от поле Копія сторінки на вебсторінці, або до вебшаблону.
Захистіть ваші форми
Нотатка
Цей метод захисту форм незабаром буде вилучено. Тому його не слід використовувати. Використовуйте відповідні дозволи таблиці, а також настройки веб-ролі, щоб натомість надати користувачам доступ до будь-яких даних. Додаткові відомості: Змінення дозволів таблиці для форм і списків на нових порталах
Щоб захистити ваші форми, потрібно створити дозволи таблиць, які визначають доступ і власників записів, відповідно до веб-ролей. Якщо користувач потрапляє на базову форму і не має дозволів, він отримує повідомлення про помилку. Крім того, ви також бачите попередження, коли форму настроєно з не ввімкненими дозволами для таблиць:
«Дозволи для таблиці має бути увімкнуто для цього запису, інакше переглядати дані зможе будь-який користувач в Інтернеті.»
Щоб увімкнути дозволи для базової форми, установіть прапорець Увімкнути дозволи таблиць. Додаткові відомості: Створення вебролей.
Атрибути і зв’язки базових форм
| Ім'я | Опис |
|---|---|
| Унікальне ім'я | Описове ім’я запису. Це поле обов’язкове. |
| Назва таблиці | Ім’я таблиці, з якої завантажується форма. Це поле обов’язкове. |
| Ім’я форми | Ім'я форми у цільовій таблиці, яку потрібно відобразити. Це обов’язкове поле. |
| Ім’я вкладки | Необов'язкове ім'я вкладки у формі для вказаної таблиці, яку потрібно відобразити. |
| Режим | Одне з поданих нижче значень:
|
| Тип джерела запису | Одне з поданих нижче значень:
Вибрана опція Поточний користувач порталу відновлює на порталі запис користувача для поточного автентифікованого користувача. Опція Запис пов'язаний з поточним користувачем порталу отримує запис користувача порталу для поточного автентифікованого користувача, а потім отримує запис для певного зв'язку, зазначеного в полі «Ім'я зв'язку». |
| Ім’я параметра ідентифікатора запису | Ім'я параметра, надане в рядку запиту URL-адреси на веб-сторінку, яка містить цю базову Форму. |
| Назва зв’язку | Потрібно, коли для типу джерела запису встановлене значення «Запис, пов'язаний з поточним користувачем порталу». Логічне ім'я зв’язку між поточним записом користувача порталу і цільовим записом. Це має повернути той самий тип таблиці, що вказаний в полі «Ім'я таблиці». |
| Дозволити створити, якщо дорівнює нулю | Додаткове логічне значення доступне, коли тип джерела запису має значення «Запис, пов'язаний з поточним користувачем порталу». Вказує на те, що якщо пов’язаний запис відсутній, користувач може створити його вперше, інакше виняток запуску ігноруватиметься, якщо запис ще не створений, оскільки форма потребує запис для прив’язки до нього даних. ПРИМІТКА. Ця функція недоступна в багатокрокових формах. |
| Увімкнути дозволи для таблиці | Змушує форму поважати дозволи таблиць. Значення за замовчуванням "Хибність" з міркувань зворотної сумісності. Якщо встановити значення "Істина", для будь-якого користувача, який хоче отримати доступ до форми, ПОТРІБНІ точні дозволи. ПРИМІТКА: цей метод захисту форм незабаром буде вилучено. Тому його не слід використовувати. Використовуйте відповідні дозволи таблиці, а також настройки веб-ролі, щоб натомість надати користувачам доступ до будь-яких даних. Додаткові відомості: Змінення дозволів таблиці для форм і списків на нових порталах |
Параметри форми
| Ім'я | Опис |
|---|---|
| Додати контрольне зображення | Показує капчу. |
| Показувати контрольне зображення для автентифікованих користувачів | Показує контрольне зображення для автентифікованих користувачів. |
| Група перевірки | Назва групи призначена для введення елементів керування для оцінки припустимих значень імен групи. |
| Автоматично генерувати етапи із вкладок | Вказує на те, що кілька вкладок у базовій формі відображаються з кожною вкладкою як послідовний крок, починаючи з першої вкладки, і продовжується, доки не буде перейдено до всіх вкладок, а після остаточного надсилання буде вставлено запис. За замовчуванням цей пункт не вибрано. Значення за замовчуванням вказує, що тільки одна вкладка або форма, може передаватися на цьому етапі. Якщо ім’я вкладки не вказано, відображається перша вкладка. |
| Відображати веб-ресурси без вбудованого фрейму | Усуває елемент iFrame, що включає в себе веб-ресурс у базовій формі. |
| Підказки включено | Підказки задаються за допомогою опису атрибуту у цільовій таблиці. |
| Показати поля, що не підтримуються | Показ або приховування імен стовпців із типами стовпців, які Dataverse не підтримуються. |
| Налаштувати рекомендовані поля як обов’язкові | Робить обов’язковими всі атрибути, які мають встановлений рівень обов'язковості поля «Рекомендований бізнес-об’єкт». |
| Зробити всі поля обов'язковими | Робить обов’язковими всі поля, незалежно від рівня обов'язковості поля. |
| Клас CSS резюме перевірки | Ім'я класу CSS призначене для резюме перевірки. Значенням за замовчуванням є "сповіщення перевірка-резюме сповіщення-помилка сповіщення-блокування" |
| Включити посилання на резюме перевірки | Логічне значення "Істина" або "Хибність", яке вказує, чи якірне посилання слід відтворити в резюме перевірки, щоб прокрутити до поля, яке містить помилку. Значення за замовчуванням – "Істина". |
| Текст посилання на резюме перевірки | Мітка, призначена для посилання на резюме перевірки. Значення за замовчуванням – "натисніть тут". |
| Текст заголовка резюме перевірки | Мітка, призначена для заголовок на резюме перевірки. |
| Інструкції | Інструкції для роботи з формою. |
| Повідомлення про те, що запис не знайдено | Повідомлення, яке відображається, коли запис не знайдено. |
Настройки при успішному виконанні
| Ім'я | Опис |
|---|---|
| У разі успіху | Одне з поданих нижче значень:
|
| Приховати форму в разі успіху | "Вимагати в разі успіху" встановлено у значення "Відображати повідомлення про успіх". Якщо вибрано, форми прихована в разі успішного надсилання. |
| Повідомлення про успішне виконання | "Вимагати в разі успіху" встановлено у значення "Відображати повідомлення про успіх". Повідомлення, що відображається користувачам в разі успішного подання. Якщо його не вказано, відображається повідомлення за замовчуванням (Надсилання успішно завершено). Для кожного мовного пакета, інстальованого та ввімкненого для організації, доступне поле для введення повідомлення пов’язаною мовою. |
| Зовнішня URL-адреса | Вимагає параметрів, що в разі успішного виконання запускатимуть переспрямування. Укажіть URL-адресу на зовнішній веб-ресурс. |
| або веб-сторінка | Вимагає параметрів, що в разі успішного виконання запускатимуть переспрямування. Виберіть веб-сторінку з поточної веб-сторінки. |
| Додати існуючий рядок запиту | Вимагає параметрів, що в разі успішного виконання запускатимуть переспрямування. Якщо вибрано, наявні параметри рядка запиту додаються до цільової URL-адреси перед переспрямуванням. |
| Додавання ідентифікатора запису до рядка запиту | Вимагає параметрів, що в разі успішного виконання запускатимуть переспрямування. Коли вибрано, створений ідентифікатор запису додається до рядка запиту URL-адреси, на яку він переспрямовується. |
| Ім’я параметра ідентифікатора запису | Вимагає параметрів, що в разі успішного виконання запускатимуть переспрямування. Ім'я параметра ідентифікатора у рядку запиту URL-адреси, на яку робиться переспрямування. |
| Додати користувацький рядок запиту | Вимагає параметрів, що в разі успішного виконання запускатимуть переспрямування. Користувацький рядок, який може додаватися рядку наявного рядка запиту URL-адреси переспрямування. |
| Додати значення атрибута до рядка запиту - ім’я параметра | Вимагає параметрів, що в разі успішного виконання запускатимуть переспрямування. Ім'я, яке потрібно надати параметру, який відповідає значенню атрибута в цільовій таблиці, що додається до рядка запиту URL-адреси переадресації. |
| Додати значення атрибута до рядка запиту - логічне ім’я атрибута | Вимагає параметрів, що в разі успішного виконання запускатимуть переспрямування. Логічне ім'я атрибута в цільовій таблиці має отримати значення, що додається до рядка запиту URL-адреси переадресації. |
Додаткові настройки
| Ім’я | Опис |
|---|---|
| Зв'язати з поточним користувачем порталу | Вказує на те, що запис користувача, який увійшов, має бути пов'язаний з цільовим записом таблиці. |
| Стовпець підстановки користувачів порталу | Логічне ім'я атрибута у цільовій таблиці, яка зберігає користувача порталу. |
| Є учасником справи | Логічне значення, що вказує на те, чи має стовпець підстановки користувача порталу тип «Учасник справи». |
| Вкладення файлу | Виберіть, щоб включити до нижньої частини форми елемент керування для надсилання файлу і дати змогу додавати файли до запису. Примітка: Портали з версією 9.2.2.x і новішими не потребують увімкнення параметра Увімкнути дозволи на таблицю в базовій формі для вкладення файлів. Однак, якщо ви виберете його, ви повинні переконатися, що відповідні привілеї надані в батьківській таблиці та таблиці анотацій, щоб відобразити кнопку «Вкласти файл » у формі. У таблиці зауважень мають бути принаймні права Створення і Додавання, і батьківська таблиця повинна мати відповідне право AppendTo («Додати до»). Залежно від того, чи є у вас форма створення або оновлення, вам також можуть знадобитися права створення, ** читання та запису , щоб завершити сценарій форми. Щоб показати передані файли, увімкніть елемент керування часовою шкалою. Для додаткової інформації див. Налаштування нотаток. |
| Місцезнаходження вкладеного файлу | Параметри: вкладення примітки, сховище BLOB-об'єктів Azure. Якщо в організації налаштовано сховище Azure Storage, можна зберігати там файли, передані для цієї базової форми. В іншому разі файли зберігаються як вкладення примітки. |
| Дозволити кілька файлів | Логічне значення, яке вказує, чи може користувач завантажити більше одного файлу. |
| Прийняти | Атрибут прийняття визначає, які типи файлів MIME сервер приймає через завантаження файлу. Щоб вказати кілька значень, розділіть значення комами (наприклад, аудіо/,відео/,зображення/*). |
| Надпис | Текст, що відображається поруч із контролем завантаження файлу. Для кожного мовного пакета, інстальованого та ввімкненого для організації, доступне поле для введення повідомлення пов’язаною мовою. |
| Треба вкласти файл | Робить вкладення файлу обов’язковим для продовження. |
| Повідомлення про помилку в обов'язковому полі | Повідомлення відображається під час перевірки форми, якщо «Обов’язково» має значення «Істина» та користувач не вклав файл. Для кожного мовного пакета, інстальованого та ввімкненого для організації, доступне поле для введення повідомлення пов’язаною мовою. |
| Обмежити типи прийнятних файлів | Вимагає перевірки у полі "Прийняти". Якщо цей параметр не вибрано, атрибут «Прийняти» використовується лише як пропозиція для діалогового вікна завантаження файлу. |
| Повідомлення про неналежний тип файлу | Повідомлення, яке відображається під час перевірки форми, якщо параметр «Обмежити файли допустимими типами» відповідає дійсності, і користувач намагається завантажити файл недійсного типу. Для кожного мовного пакета, інстальованого та ввімкненого для організації, доступне поле для введення повідомлення пов’язаною мовою. |
| Максимальний розмір файлу (КБ) | Змушує перевіряти максимально припустимі завантажені файли. |
| Повідомлення про неналежний розмір файлу | Повідомлення відображається під час перевірки формі, якщо значення "Максимальний розмір файлу (у кілобайтах)" має значення true, а користувач намагається передати надто великий файл. Для кожного мовного пакета, інстальованого та ввімкненого для організації, доступне поле для введення повідомлення пов’язаною мовою. |
| Користувацький JavaScript | Кастомний блок JavaScript додається внизу сторінки безпосередньо перед закриваючим елементом тегу форми. Ввідний ідентифікатор HTML поля таблиці вказується як логічне ім’я атрибута. Це дає змогу легко вибрати поле, налаштувати значення або зробити інші дії зі сторони клієнта за допомогою jQuery.$(document).ready(function() { $("#address1_stateorprovince").val("Saskatchewan");}); |
Пов’язане посилання на таблицю
Наступні параметри стосуються задання пов'язаного посилання на таблицю під час збереження форми.
Це забезпечує спосіб зв'язку поточного запису, що створюється або оновлюється формою, з іншим цільовим записом. Це корисно, якщо ви маєте кілька кроків з декількома типами таблиць, і хочете зв'язати отримані записи, або якщо на сторінку передається рядок запиту із ідентифікатором запису, який ви хотіли б пов'язати. Наприклад, у нас є кар’єрна сторінка, на якій перераховані оголошення про вакансії, кожне з яких містить посилання на заявку на вакансію, яка містить ідентифікатор оголошення про вакансію до форми заявки, щоб під час створення заявки оголошення про вакансію було пов’язане із записом.
| Унікальне ім'я | Опис |
|---|---|
| Налаштувати посилання на таблицю під час зберігання | Так або ні. Значення yes вказує на те, що пов’язане посилання на таблицю має бути призначене під час збереження форми, інакше його не встановлено. |
| Назва зв’язку | Ім'я визначення зв'язку для даного зв'язку між двома типами таблиць. |
| Логічне ім’я таблиці | Логічне ім'я таблиці посилань. |
| Логічне ім’я цільового атрибута підстановки | Логічне ім'я атрибуту підстановки у цільовій таблиці, яка створюється або оновлюється. |
| Поле підстановки заповнення | Якщо пошук щодо довідкової таблиці міститься у формі, перевірка цього значення заповнює поле форми значенням, отриманим за допомогою наведених нижче параметрів. |
| Тип джерела | Одне з поданих нижче значень:
|
| Крок таблиці посилань | Запис «Крок багатокрокової форми» на попередньому кроці має отримати таблицю, що створена або відредагована на тому кроці, щоб пов’язати запис із поточним кроком. |
| Ім’я рядка запиту | Ім'я параметра, надане в рядку запиту URL-адреси на веб-сторінку, яка містить цю багатокрокову форму. |
| Рядок запиту є основним ключем | «Так» вказує на те, що значення «Рядок запиту» є значенням первинного ключа. «Ні» вказує, що значенням рядка запиту є інший тип атрибуту, а не первинний ключ. |
| Логічне ім’я атрибута запиту | Логічне ім'я атрибута для запиту про запис. |
| Показати подробиці «Тільки для читання» | Вказує на те, що форма повинна відтворюватися у верхній частині сторінки, що відображає інформацію тільки для читання, яка належить до запису посилання. Вимагає Ім'я форми. |
| Ім’я форми | Ім'я форми у таблиці посилання, яку слід використовувати для відображення відомостей тільки для читання. |
Конфігурація дії базової форми
За промовчанням базова форма дозволяє читати або оновлювати наявний запис, а також вставляти новий запис. Однак ви також можете легко ввімкнути та налаштувати інші дії для записів у базовій формі (Видалити, Активувати, Деактивувати тощо). Також можна змінити стандартні мітки, розміри та інші атрибути, які з’являються, якщо ввімкнено дії.
Ці налаштування можна знайти в розділі Додаткові параметри базової форми. За замовчуванням, відображаються лише Основні параметри. Можна вибрати Додаткові настройки, щоб відобразити додаткові настройки.
Можна додати кнопки дій для дій, які застосовуються до окремого запису та відображаються для кожного рядка сітки за умови, що відповідні привілеї надаються дозволами таблиці. Доступні такі дії:
- 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.
Виберіть відповідний запис веб-сайту.
Введіть значення істинно. За замовчуванням значення параметра є хибно, що дозволяє перевіряти запити.
Введіть відповідний опис.
Виберіть Зберегти та закрити.
Увага!
Коли запит на перевірку вимкнуто, вміст можна надсилати до сторінки. Ви повинні переконатися в тому, що вміст належним чином зашифровано або оброблено.
Фактори, які необхідно враховувати
- Базова форма має бути пов'язана з веб-сторінкою певного веб-сайту, оскільки форма має переглядатися на сайті.
- Вкладені сітки таблиці «Підключення» не підтримуються в базових формах. Якщо ви додасте вкладену сітку таблиці «Підключення» до форми за допомогою конструктора форм, під час відображення форми на порталі та використання таблиці «Підключення» відображаються повідомлення про помилку.
- Повторювані поля, поля «Список сторін» та бізнес-правила не підтримуються в базових формах.
- Компоненти коду на рівні поля можна додавати до форм. Докладніші відомості див. у розділі: Використання компонентів коду
- Бізнес-правила та клієнтський API можуть активувати заблоковані поля у формі лише для читання.
- У разі створення базової форми в режимі Вставлення не можна змінити вирівнювання кнопки або поставити кнопку дії над базовою формою.
- Якщо елемент керування підстановкою відображається у формі як розкривний список, фільтр пов’язаних записів не працюватиме.
- Зведені стовпці у формах іноді можуть відображатися як придатні для редагування, хоча призначені лише для читання. Щоб забезпечити доступність цих стовпців лише для читання, позначте відповідний стовпець як Лише для читання у формі Dataverse.