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