Создание полей ввода для использования в формах и управление ими

Важно

Эта статья применима только к исходящий маркетинг, который будет удален из продукта 30 июня 2025 года. Чтобы избежать перерывов, перейдите на поездки в режиме реального времени до этой даты. Дополнительная информация: Обзор перехода

Каждое поле, которое отображается в маркетинговой форме, должно быть однозначно сопоставлено с полем контакта или интереса в базе данных Dynamics 365, в которой будут храниться значения, указанные в этом поле. При разработке формы на вкладке Панель инструментов списков конструктора отображается элемент дизайна для каждого уже настроенного поля, поэтому для добавления этого поля нужно просто перетащить соответствующий элемент поля в форму (см. также Разработка своего цифрового содержимого). Наиболее часто используемые поля (например, имя, адрес и электронная почта) настроены по умолчанию; но если требуется использовать дополнительные поля, необходимо сначала настроить их. Ознакомьтесь с этим разделом, чтобы узнать, как создавать и управлять полями для использования в маркетинговых формах.

Внимание

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

Создание или изменение поля маркетинговой формы

Для создания нового поля маркетинговой формы выполните одно из следующих действий:

• Выберите Шаблоны Customer Insights - Journeys>Поля форм для отображения полного списка всех полей, доступных в данный момент для вашей организации, затем выберите +Создать на панели команд. При этом создается новое пустое сопоставление полей, которое открывается для редактирования.

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

Чтобы изменить существующее поле, откройте Маркетинговые шаблоны>Поля форм для просмотра полного списка всех полей, в настоящее время доступных в вашем экземпляре. Просматривайте, производите поиск, сортируйте и выполняйте фильтрацию списка, чтобы найти поле, которое требуется изменить, затем выберите его, чтобы открыть.

Конфигурация поля маркетинговой формы

В следующей таблице описываются все параметры конфигурации, доступные для полей маркетинговой формы. Все параметры доступны при работе с записью самого поля; форма быстрого создания, предусмотренная при создании поля из конструктора форм, содержит наиболее важные из этих настроек, но не все из них.

Параметр	Описание
Подпись	Имя записи поля формы. Оно становится именем элемента, предусмотренного в конструкторе для размещения этого поля. Оно почти всегда должно соответствовать имени поля.
Тип поля	Тип данных, например текст, число или дата, принимаемых этим полем. Подробнее: Параметры типа и формата полей
Сопоставление контактов	Выберите поле контакта для сопоставления с этим полем маркетинговой формы. Оставьте этот параметр пустым, чтобы отключить сопоставление контактов для этого поля. Необходимо указать значение полей Сопоставление поля контакта, Сопоставление поля интереса или обоих; вы не сможете сохранить сопоставление полей без значения по крайней мере в одном из этих полей.
Сопоставление интересов	Выберите поле интереса для сопоставления с этим полем маркетинговой формы. Оставьте этот параметр пустым, чтобы отключить сопоставление интересов для этого поля. Необходимо указать значение полей Сопоставление поля контакта, Сопоставление поля интереса или обоих; вы не сможете сохранить сопоставление полей без значения по крайней мере в одном из этих полей.
Заполнитель	Определяет "теневой текст", который отображается в поле, пока в него не будет введено значение; обычно отображается серым цветом. Используется для указания типа значения, которое требуется ввести. Если пользователь не заменит теневой текст введенным значением, это поле отправляется как пустое.
Значение по умолчанию	Подпись по умолчанию, отображаемая для поля при добавлении в форму. Для любой конкретной формы это значение по умолчанию можно переопределить, настроив элемент поля, который создает поле ввода для этой формы; это может потребоваться для перевода формы на другой язык. Подробнее: Элемент формы для маркетинговых страниц
Обязательный	Выберите, должно ли поле содержать значение до того, как форма может быть отправлена. Обязательные поля имеют красную звездочку, расположенную рядом с подписью поля.
Обязательное об ошибке в обязательном поле	Создайте пользовательское сообщение об ошибке, которое появляется, когда пользователь не ввел информацию в обязательное поле.
Положение подписи	Выберите, должна ли подпись поля находиться сверху, слева или справа от поля.
Ширина символа	Установите пользовательскую ширину для символов, введенных в поле.
Максимальное количество знаков	Определите максимальное количество символов, которые могут быть введены в поле.
Скрыть поле	Переключайте этот переключатель, чтобы скрыть поле. Скрытые поля не отображаются для получателей формы.
Предварительное заполнение	Заполняет в форме для возвращающихся контактов ранее введенную ими информацию (например, имя и адрес электронной почты). Подробнее: Включение предварительного заполнения форм

Параметры типа и формата полей

Тип	Формат	Элемент управления отображением	Описание
Одна строка текста	Электронная почта	Ввод сообщения электронной почты Текстовое поле	Создает простое поле ввода, которое принимает значения, похожие на адрес электронной почты.
Одна строка текста	Текст	Текстовое поле	Создает простое поле ввода, которое принимает текстовые значения всех типов.
Одна строка текста	Область текста	Область текста	Создает поле ввода области текста, которое принимает текстовые значения всех типов.
Одна строка текста	URL-адрес	ВводURL-адреса	Создает простое поле ввода, которое принимает значения, похожие на URL-адрес.
Одна строка текста	Телефон	Ввод телефона	Создает простое поле ввода, которое принимает значения, похожие на номер телефона.
Одна строка текста	н/д	Область текста	Создает область текста высотой в несколько строк для ввода большого объема текста.
Набор параметров	н/д	Переключатели	Сопоставляет поле с ограниченным числом заранее заданных значений (определенных в базе данных). Создает набор переключателей, по одной кнопке для каждого значения.
Набор параметров	н/д	Раскрывающийся список	Сопоставляет поле с ограниченным числом заранее заданных значений (определенных в базе данных). Создает раскрывающийся список для выбора значения.
Два параметра	н/д	Флажок	Сопоставляется полю логического значения, которое принимает значение True или False. Создает флажок, который установлен для значения True и снят для значения False.
Два параметра	н/д	Раскрывающийся список	Сопоставляется с полем, которое принимает одно из двух возможных значений (обычно это True или False). Создается раскрывающийся список с двумя записями, отображаемый текст для которых определен в базе данных.
Два параметра	н/д	Переключатели	Сопоставляется с полем, которое принимает одно из двух возможных значений (обычно это True или False). Создает пару переключателей с отображаемым текстом, определенным в базе данных.
Целое число	н/д	Ввод числа	Создает простое поле ввода, которое принимает целые числа (без десятичных знаков).
Число с плавающей запятой	н/д	Ввод числа	Создает простое поле ввода, которое принимает числа с плавающей запятой (десятичные числа). Поддерживается точность до 5 десятичных знаков после запятой; диапазон может составлять от -100 000 000 000 до 100 000 000 000.
Десятичное число	н/д	Ввод числа	Создает простое поле ввода, которое принимает числа с плавающей запятой (десятичные числа). Поддерживается точность до 10 десятичных знаков после запятой; диапазон может составлять от -100 000 000 000 до 100 000 000 000.
Дата и время	Только дата	Средство выбора даты	Создает средство выбора даты, которое позволяет посетителям выбрать дату из всплывающего календаря. Не принимает время.
Дата и время	Дата и время	Средство выбора даты и времени	Создает средство выбора даты и времени, которое позволяет посетителям выбирать дату из всплывающего календаря и время из раскрывающегося списка.
Поле подстановки	н/д	Подстановка	Создает поле, связанное с определенным типом сущности, что позволяет создать раскрывающийся список параметров, которые были созданы заранее. Например, можно использовать поле подстановки для создания списка всех учетных записей. Дополнительная информация: Добавление полей подстановки. Поля подстановки не поддерживаются при интеграции внешней страницы формы с помощью метода захвата формы. Вместо этого следует использовать встроенную маркетинговую форму. Дополнительная информация: Внедрение форм во внешние веб-сайты.

При публикации маркетинговой страницы Customer Insights - Journeys размещает ее с использованием своей функции порталов по общедоступному URL-адресу, который можно сообщить своим потенциальным клиентами. При первом создании страницы Customer Insights - Journeys автоматически создает для нее новую запись веб-сайта, на которую можно перейти для анализа трафика и эффективности. Подробнее: Регистрация переходов по ссылкам и посещений веб-сайтов

Каскадные поля форм

Каскадные поля позволяют создавать иерархию отношений между двумя полями параметров в маркетинговой форме. Каскадные поля можно использовать для создания родительско-дочерних отношений для фильтрации наборов параметров из родительского поля. Фильтрация покажет пользователям меньше вариантов из дочернего набора, если пользователь выберет параметр из родительского уровня. Дочерний набор параметров остается скрытым до тех пор, пока не будет сделан выбор в родительском наборе параметров. Поддерживаемые поля данных для создания каскадных полей включают наборы параметров, наборы с двумя параметрами и с несколькими параметрами.

Для создания каскадного поля:

1. Добавьте в форму два поля с несколькими параметрами или набор параметров (переключатель).

2. Выберите дочерний набор, который вы хотите встроить в родительское поле.

3. На панели Свойства, выберите Атрибуты поля>Фильтровать по и выберите Настройка отношений.

   

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

   

Заметка

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

Добавление полей подстановки и устранение неполадок

После создания пользовательской сущности для использования с полем подстановки, или если поле подстановки не работает, вы должны дважды проверить, что у вас есть настройки, перечисленные ниже, включенные для сущности, которую вы используете с полем подстановки.

1. Данные о подстановке, которые вы будете настраивать, будут доступны в Интернете. Вам нужно будет оценить, какая личная и конфиденциальная информация может быть доступна в Интернете. Как только вы это разрешите, включив соответствующий параметр, вы можете завершить конфигурацию.

2. Определите сопоставление контакта и интереса. Если вы решите сопоставить оба, они должны вернуть один и тот же тип сущности для завершения сопоставления.

3. Для каждой сущности, которую вы выбираете для сопоставления, определите:

   • Представление, которое контролирует, какие значения показаны. Если вы хотите показать только все активные значения, вы можете выбрать связанное представление. Например, при настройке подстановки Организация можно выбрать представление Активные организации.
   • Атрибут, используемый для поиска. Например, Имя организации может быть использовано для подстановки Организация.

4. Проверьте роли безопасности для выбранной конфигурации.

   Совет

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

   Установить роль безопасности вручную:

   1. Откройте меню Настройки в верхней части страницы и выберите Дополнительные настройки.
   2. Область дополнительных параметров откроется в новой вкладке браузера. Обратите внимание, что в этой области используется горизонтальный навигатор в верхней части страницы, а не боковой навигатор. Выберите Параметры>Система>Безопасность.
   3. Выберите значок Роли безопасности.
   4. Перейти Расширяемая роль пользователя служб Marketing>Настраиваемые сущности.
   5. На вкладке Пользовательские сущности найдите имя вашей пользовательской сущности и отметьте поле столбца Чтение (второй столбец) зеленым цветом.
   6. Если вы используете фильтр, убедитесь, что у Расширяемая роль пользователя служб Marketing есть разрешения на чтение для сущностей, используемых в соответствующем представлении. Например, если вы используете представление "Отслеживаемые организации" в качестве фильтра организаций, необходимо убедиться, что у роли есть привилегия на чтение для сущности настраиваемой сущности.

5. Проверьте безопасность доступа на уровне полей.

   Совет

   Если настраиваемое поле используется в качестве поля для поиска или в представлении фильтра, убедитесь, что безопасность на уровне полей настроена правильно. Это применимо только в том случае, если для настраиваемого поля включен параметр «Безопасность полей». Дополнительная информация: Безопасность на уровне столбцов для контроля доступа.

   Настройка безопасности на уровне полей:

   1. Откройте меню Настройки в верхней части страницы и выберите Дополнительные настройки.
   2. Область дополнительных параметров откроется в новой вкладке браузера. Обратите внимание, что в этой области используется горизонтальный навигатор в верхней части страницы, а не боковой навигатор. Выберите Параметры>Система>Безопасность.
   3. Выберите значок Профили безопасности полей.
   4. Щелкните значок Новый, чтобы создать новый профиль безопасности полей, и введите имя в разделе Общие.
   5. В разделе Пользователи добавьте пользователей системы: "# Dynamics 365 Marketing" (для исходящего маркетинга), "# D365 Landing Forms" (для форм циклов взаимодействия в реальном времени) и "# D365 Event Mgmt" (для форм регистрации на мероприятие).
   6. В разделе Разрешения полей добавьте разрешение на Чтение ко всем обязательным полям.

Настройка полей подстановки с помощью API

API JavaScript можно использовать для выполнения запроса поиска в фоновом режиме и заполнения поля подстановки элементами, содержащими указанный поисковый запрос.

Например, после загрузки формы можно искать все элементы, содержащие "Майкрософт":

MsCrmMkt.MsCrmFormLoader.on("afterFormLoad", function() {
    MsCrmMkt.MsCrmFormLoader.fillLookupFromSearch("b9051065-5851-41db-94bc-b7e1dc6bb646", "Microsoft")
        .then(function (r) {
            console.log("Success performing search");
        }).catch(function (e) {
            console.error("Error performing search");
        });
    });

Вот сведения функции, доступные в методах MsCrmMkt.MsCrmFormLoader:

• Имя функции: .fillLookupFromSearch(lookupFieldId, searchTerm)
• Описание: выполняет запрос поиска в фоновом режиме и заполняет указанное поле подстановки результатами.
• Параметры
  • lookupFieldId:
    • тип: строка
    • описание: идентификатор поля ввода подстановки, например "b9051065-5851-41db-94bc-b7e1dc6bb646"
  • searchTerm:
    • тип: строка
    • описание: что искать, например, john@contoso.com
• Возвраты: Promise<boolean>

Дополнительные функции в документации разработчика