Создание или изменение веб-ресурсов для расширения возможностей приложения

Эта тема относится к Dynamics 365 Customer Engagement (on-premises). Версию этой темы для Power Apps см. по адресу: Создание или изменение веб-ресурсов управляемого моделью приложения для расширения приложения

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

Совет

Всестороннее обсуждение веб-ресурсов см. в разделе Веб-ресурсы для Customer Engagement.

Что такое веб-ресурсы?

Веб-ресурсы представляют собой виртуальные файлы, хранящиеся в системе. Каждый веб-ресурс имеет уникальное имя, которое может использоваться в URL-адресе для извлечения соответствующего файла. Рассматривайте их так: если бы у вас был доступ к веб-серверу, на котором фактически запущено веб-приложение, вы могли вы копировать файлы на этот веб-сайт. Однако с большинством интернет-служб это сделать невозможно. Вместо этого можно использовать веб-ресурсы для отправки файлов в систему, а затем ссылаться на них по имени, как будто вы скопировали их как файлы на веб-сервер.

Например, при создании HTML-страницы в качестве веб-ресурса с именем new_myWebResource.htm эту страницу можно открыть в браузере по URL-адресу следующего вида:

<Dynamics 365 Customer Engagement (on-premises) URL>/WebResources/new_myWebResource.htm

где <URL-адрес приложения> — это URL-адрес, который обычно используется, чтобы открыть приложение. Поскольку веб-ресурс представляет собой данные в системе, только лицензированные пользователи организации могут обращаться к ним таким образом. Обычно веб-ресурсы включают в формы, а не ссылаются на них непосредственно. Чаще всего их используют для предоставления библиотек JavaScript для скриптов форм.

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

Создание и редактирование веб-ресурсов

1. Откройте обозреватель решений, затем выберите Веб-ресурсы.

2. В разделе Компоненты выберите Веб-ресурсы.

3. Чтобы создать веб-ресурс, выберите Создать.

   Чтобы изменить веб-ресурс, дважды щелкните веб-ресурс, который нужно изменить.

4. Форма веб-ресурса имеет следующие поля и возможности:

   Метка	Описание
   Название	Необходимые. Это уникальное имя для данного веб-ресурса. Изменить его после сохранения веб-ресурса невозможно. Это имя может содержать только буквы, цифры, точки и символы косой черты ("/"; не последовательно). В начало имени веб-ресурса будет добавлен префикс настройки издателя решения.
   Отображаемое имя	Имя, отображаемое при просмотре списка веб-ресурсов.
   Описание	Описание веб-ресурса.
   Тип	Необходимые. Это тип веб-ресурса. Изменить его после сохранения веб-ресурса невозможно.
   Текстовый редактор	Если тип веб-ресурса представляет какого-либо рода текстовый файл, выберите эту кнопку, чтобы открыть страницу для изменения содержимого в текстовом редакторе.
   Язык	Используется для выбора языка. Этот параметр просто помечает тегом запись, в которой хранятся данные веб-ресурса. Поведение веб-ресурса он не изменяет.
   Отправка файла	Выберите кнопку Обзор... для выбора отправляемого файла в качестве веб-ресурса. Отправить файл можно при создании нового веб-ресурса или чтобы перезаписать существующий веб-ресурс. Расширение имени файла должно соответствовать допустимым разрешениям. По умолчанию максимальный размер файла, который можно отправить в качетсве веб-ресурса, составляет 5 МБ. Это значение можно изменить в Dynamics 365 Customer Engagement (on-premises), используя параметр Системные параметры> вкладка Электронная почта>Задать ограничение размера файла для вложений. Дополнительные сведения см. в разделе Диалоговое окно "Системные параметры" — вкладка "Электронная почта"
   URL-адрес	После сохранения веб-ресурса здесь будет отображаться URL-адрес веб-ресурса. Выберите эту ссылку для просмотра веб-ресурса в браузере.

5. После внесения необходимых изменений выберите Сохранить, затем Опубликовать.

Заметка

Публикация настроек может помешать нормальной работе системы. Рекомендуется публиковать настройки в оптимальный для пользователей период.

Использование текстового редактора

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

В текстовом редакторе используется элемент управления, который изменяет исходный HTML так, чтобы его можно было редактировать. Эти изменения могут привести к тому, что страница в браузере будет вести себя не так, как планировалось, а более сложный код перестанет работать. Открытие веб-ресурса HTML в текстовом редакторе и сохранение его без внесения каких-либо изменений может привести в нарушению работы некоторых веб-ресурсов HTML.

Рекомендуется использовать внешний редактор для редактирования текстовых файлов, а затем сохранять их локально, прежде чем отправлять с помощью кнопки Передать файл. Это позволяет сохранить копию веб-ресурса на случай, если понадобится вернуться к более ранней версии. Можно использовать простой редактор, такой как Блокнот, однако настоятельно рекомендуется использовать текстовый редактор с более широкими возможностями. Visual Studio Express распространяется бесплатно и содержит мощные функции для редактирования файлов, используемых текстовыми веб-ресурсами.

Создание и изменение веб-ресурса в форме

Можно добавлять или изменять веб-ресурсы на форме, чтобы она выглядела более удобной или полезной для пользователей. Убедитесь, что у вас есть роль безопасности "Системный администратор" или эквивалентные привилегии.

Заметка

Нельзя включить веб-ресурс в верхний или нижний колонтитул формы.

1. Откройте обозреватель решений.

2. В разделе Компоненты раскройте узел Сущности, затем раскройте сущность, с которой требуется работать.

3. Щелкните Формы, найдите в списке форму типа "Основная", затем дважды щелкните или нажмите запись, чтобы открыть и изменить форму.

4. Чтобы добавить веб-ресурс, выберите вкладку (например, Общие или Примечания), в которую следует его вставить, затем на вкладке Вставка выберите Веб-ресурс.
   -ИЛИ-
   Чтобы изменить веб-ресурс, выберите вкладку формы и веб-ресурс, который требуется изменить, затем на вкладке Главная выберите Изменить свойства.

5. В диалоговом окне Добавить веб-ресурс или Свойства веб-ресурса на вкладке Общие введите соответствующие данных в обязательных полях. Необходимо учесть следующее:

   • В поле Веб-ресурс выберите изображение, HTML-файл, или требуемый веб-ресурс Silverlight.

     Заметка

     После указания веб-ресурса в нижней части этой вкладки появится раздел Свойства веб-ресурса с параметрами, которые зависят от типа добавляемого веб-ресурса. Эти параметры включают указываемые пользовательские параметры, передачу кода типа объекта как параметра или указание альтернативного текста, который описывает ресурс, а в случае изображений – делает изображение более доступным для всех пользователей. Вот несколько важных свойств. Полный перечень см. в разделе: Свойства веб-ресурсов. - В поле Имя введите уникальное имя для поля. Оно может содержать только алфавитно-цифровые знаки и символы подчеркивания.

   • Поле Метка автоматически заполняется вариантом введенного вами имени, однако следует убедиться, что предлагаемая метка соответствует вашим требованиям и при необходимости изменить ее.

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

7. Если вкладка Зависимости отображается в диалоговом окне Добавление веб-ресурса или Свойства веб-ресурса, выберите из списка Доступные поля те поля, которые требуются для веб-ресурса, выберите кнопку Добавить выбранные записи , чтобы переместить выбранные поля в список "Зависимые поля", затем выберите кнопку OK, чтобы закрыть диалоговое окно.

8. Когда в форму будут внесены изменения, на вкладке Домашняя страница выберите Сохранить и закрыть, чтобы закрыть форму. Чтобы просмотреть, как будет выглядеть основная форма и как будут работать ее события, выполните следующие действия:

   • На вкладке Домашняя страница выберите Предварительный просмотр, затем выберите Создать форму, Обновить форму или Форма только для чтения.
   • Чтобы закрыть форму "Предварительный просмотр", в меню Файл выберите Закрыть.

9. Выполнив настройки, опубликуйте их:

   • Чтобы опубликовать настройки только для того компонента, который вы сейчас изменяете, в области навигации выберите изменяемую сущность, затем выберите Опубликовать.
   • Чтобы опубликовать настройки для всех неопубликованных компонентов одновременно, в области навигации выберите Сущности, затем на панели инструментов Действия выберите Опубликовать все настройки.

Добавление или изменение веб-ресурса изображения

Веб-ресурсы представляют собой виртуальные файлы в различных форматах, например файлы HTML, приложения JavaScript и Silverlight, хранящиеся в системе и доступные по уникальному URL-адресу.

1. Откройте обозреватель решений.

2. Чтобы создать новый веб-ресурс, щелкните Компоненты>Веб-ресурсы, затем на панели инструментов "Действия" щелкните Создать.

3. Введите или измените сведения в полях ввода.

   • В поле ввода Имя введите имя, а также расширение файла, которые вместе составят имя файла ресурса.

   • Имя, введенное в поле Отображаемое имя, будет отображаться в Отображаемом имени.

   • В раскрывающемся списке Тип выберите необходимый тип файла.

4. Щелкните Обзор, чтобы выбрать и отправить файл с локального компьютера.

   • Для предварительного просмотра отправленного веб-ресурса изображения щелкните Веб-ресурс>Предварительный просмотр.

   • Для изменения текстового веб-ресурса щелкните Текстовый редактор.

   • Для предварительного просмотра текстового веб-ресурса щелкните Веб-ресурс>Предварительный просмотр.

5. Когда вы будете готовы сохранить данные, щелкните Сохранить и закрыть.

6. Опубликуйте свои настройки.

   • Только для измененного компонента: выберите Сохранить>Опубликовать на вкладке Домашняя страница.

   • Для всех неопубликованных компонентов одновременно щелкните Опубликовать все настройки.

Заметка

Установка решения или публикация настроек может помешать нормальной работе системы. Рекомендуется запланировать импорт решения в оптимальный для пользователей период.

См. также

Свойства веб-ресурса
Создание и разработка форм
Приступая к настройке
Веб-ресурсы для Customer Engagement