Создание или изменение веб-ресурсов для расширения возможностей приложения
Эта тема относится к 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 для скриптов форм.
Поскольку веб-ресурсы — это данные в системе, которые поддерживают решения, их можно перемещать их в другие организации путем экспорта в составе решения и последующего импорта этого решения в другую организацию.
Создание и редактирование веб-ресурсов
Откройте обозреватель решений, затем выберите Веб-ресурсы.
В разделе Компоненты выберите Веб-ресурсы.
Чтобы создать веб-ресурс, выберите Создать.
Чтобы изменить веб-ресурс, дважды щелкните веб-ресурс, который нужно изменить.
Форма веб-ресурса имеет следующие поля и возможности:
Метка Описание Название Необходимые. Это уникальное имя для данного веб-ресурса. Изменить его после сохранения веб-ресурса невозможно.
Это имя может содержать только буквы, цифры, точки и символы косой черты ("/"; не последовательно).
В начало имени веб-ресурса будет добавлен префикс настройки издателя решения.Отображаемое имя Имя, отображаемое при просмотре списка веб-ресурсов. Описание Описание веб-ресурса. Тип Необходимые. Это тип веб-ресурса. Изменить его после сохранения веб-ресурса невозможно. Текстовый редактор Если тип веб-ресурса представляет какого-либо рода текстовый файл, выберите эту кнопку, чтобы открыть страницу для изменения содержимого в текстовом редакторе. Язык Используется для выбора языка. Этот параметр просто помечает тегом запись, в которой хранятся данные веб-ресурса. Поведение веб-ресурса он не изменяет. Отправка файла Выберите кнопку Обзор... для выбора отправляемого файла в качестве веб-ресурса.
Отправить файл можно при создании нового веб-ресурса или чтобы перезаписать существующий веб-ресурс.
Расширение имени файла должно соответствовать допустимым разрешениям.
По умолчанию максимальный размер файла, который можно отправить в качетсве веб-ресурса, составляет 5 МБ. Это значение можно изменить в Dynamics 365 Customer Engagement (on-premises), используя параметр Системные параметры> вкладка Электронная почта >Задать ограничение размера файла для вложений. Дополнительные сведения см. в разделе Диалоговое окно "Системные параметры" — вкладка "Электронная почта"URL-адрес После сохранения веб-ресурса здесь будет отображаться URL-адрес веб-ресурса. Выберите эту ссылку для просмотра веб-ресурса в браузере. После внесения необходимых изменений выберите Сохранить, затем Опубликовать.
Заметка
Публикация настроек может помешать нормальной работе системы. Рекомендуется публиковать настройки в оптимальный для пользователей период.
Использование текстового редактора
Текстовый редактор, предусмотренный в приложении для веб-ресурсов, следует исползовать исключительно для простого редактирования текстовых файлов. Его можно использовать для создания и редактирования веб-ресурсов HTML, однако редактировать следует только веб-ресурсы HTML, созданных в текстовом редакторе. Текстовый редактор предназначен для очень простого HTML-содержимого. Если содержимое веб-ресурса HTML было создано не в текстовом редакторе, не используйте текстовый редактор для его редактирования.
В текстовом редакторе используется элемент управления, который изменяет исходный HTML так, чтобы его можно было редактировать. Эти изменения могут привести к тому, что страница в браузере будет вести себя не так, как планировалось, а более сложный код перестанет работать. Открытие веб-ресурса HTML в текстовом редакторе и сохранение его без внесения каких-либо изменений может привести в нарушению работы некоторых веб-ресурсов HTML.
Рекомендуется использовать внешний редактор для редактирования текстовых файлов, а затем сохранять их локально, прежде чем отправлять с помощью кнопки Передать файл. Это позволяет сохранить копию веб-ресурса на случай, если понадобится вернуться к более ранней версии. Можно использовать простой редактор, такой как Блокнот, однако настоятельно рекомендуется использовать текстовый редактор с более широкими возможностями. Visual Studio Express распространяется бесплатно и содержит мощные функции для редактирования файлов, используемых текстовыми веб-ресурсами.
Создание и изменение веб-ресурса в форме
Можно добавлять или изменять веб-ресурсы на форме, чтобы она выглядела более удобной или полезной для пользователей. Убедитесь, что у вас есть роль безопасности "Системный администратор" или эквивалентные привилегии.
Заметка
Нельзя включить веб-ресурс в верхний или нижний колонтитул формы.
Откройте обозреватель решений.
В разделе Компоненты раскройте узел Сущности, затем раскройте сущность, с которой требуется работать.
Щелкните Формы, найдите в списке форму типа "Основная", затем дважды щелкните или нажмите запись, чтобы открыть и изменить форму.
Чтобы добавить веб-ресурс, выберите вкладку (например, Общие или Примечания), в которую следует его вставить, затем на вкладке Вставка выберите Веб-ресурс.
-ИЛИ-
Чтобы изменить веб-ресурс, выберите вкладку формы и веб-ресурс, который требуется изменить, затем на вкладке Главная выберите Изменить свойства.В диалоговом окне Добавить веб-ресурс или Свойства веб-ресурса на вкладке Общие введите соответствующие данных в обязательных полях. Необходимо учесть следующее:
- В поле Веб-ресурс выберите изображение, HTML-файл, или требуемый веб-ресурс Silverlight.
Заметка
После указания веб-ресурса в нижней части этой вкладки появится раздел Свойства веб-ресурса с параметрами, которые зависят от типа добавляемого веб-ресурса. Эти параметры включают указываемые пользовательские параметры, передачу кода типа объекта как параметра или указание альтернативного текста, который описывает ресурс, а в случае изображений – делает изображение более доступным для всех пользователей. Вот несколько важных свойств. Полный перечень см. в разделе: Свойства веб-ресурсов. - В поле Имя введите уникальное имя для поля. Оно может содержать только алфавитно-цифровые знаки и символы подчеркивания.
- Поле Метка автоматически заполняется вариантом введенного вами имени, однако следует убедиться, что предлагаемая метка соответствует вашим требованиям и при необходимости изменить ее.
- В поле Веб-ресурс выберите изображение, HTML-файл, или требуемый веб-ресурс Silverlight.
Параметры, отображаемые на вкладке Форматирование, могут менять в зависимости от типа вставляемого веб-ресурса. Эти параметры включают определение числа отображаемых строк и столбцов, указывают, отображается ли рамка, а также определяют поведение прокрутки.
Если вкладка Зависимости отображается в диалоговом окне Добавление веб-ресурса или Свойства веб-ресурса, выберите из списка Доступные поля те поля, которые требуются для веб-ресурса, выберите кнопку Добавить выбранные записи , чтобы переместить выбранные поля в список "Зависимые поля", затем выберите кнопку OK, чтобы закрыть диалоговое окно.
Когда в форму будут внесены изменения, на вкладке Домашняя страница выберите Сохранить и закрыть, чтобы закрыть форму. Чтобы просмотреть, как будет выглядеть основная форма и как будут работать ее события, выполните следующие действия:
- На вкладке Домашняя страница выберите Предварительный просмотр, затем выберите Создать форму, Обновить форму или Форма только для чтения.
- Чтобы закрыть форму "Предварительный просмотр", в меню Файл выберите Закрыть.
Выполнив настройки, опубликуйте их:
- Чтобы опубликовать настройки только для того компонента, который вы сейчас изменяете, в области навигации выберите изменяемую сущность, затем выберите Опубликовать.
- Чтобы опубликовать настройки для всех неопубликованных компонентов одновременно, в области навигации выберите Сущности, затем на панели инструментов Действия выберите Опубликовать все настройки.
Добавление или изменение веб-ресурса изображения
Веб-ресурсы представляют собой виртуальные файлы в различных форматах, например файлы HTML, приложения JavaScript и Silverlight, хранящиеся в системе и доступные по уникальному URL-адресу.
Откройте обозреватель решений.
Чтобы создать новый веб-ресурс, щелкните Компоненты>Веб-ресурсы, затем на панели инструментов "Действия" щелкните Создать.
Введите или измените сведения в полях ввода.
В поле ввода Имя введите имя, а также расширение файла, которые вместе составят имя файла ресурса.
Имя, введенное в поле Отображаемое имя, будет отображаться в Отображаемом имени.
В раскрывающемся списке Тип выберите необходимый тип файла.
Щелкните Обзор, чтобы выбрать и отправить файл с локального компьютера.
Для предварительного просмотра отправленного веб-ресурса изображения щелкните Веб-ресурс>Предварительный просмотр.
Для изменения текстового веб-ресурса щелкните Текстовый редактор.
Для предварительного просмотра текстового веб-ресурса щелкните Веб-ресурс>Предварительный просмотр.
Когда вы будете готовы сохранить данные, щелкните Сохранить и закрыть.
Опубликуйте свои настройки.
Только для измененного компонента: выберите Сохранить>Опубликовать на вкладке Домашняя страница.
Для всех неопубликованных компонентов одновременно щелкните Опубликовать все настройки.
Заметка
Установка решения или публикация настроек может помешать нормальной работе системы. Рекомендуется запланировать импорт решения в оптимальный для пользователей период.
См. также
Свойства веб-ресурса
Создание и разработка форм
Приступая к настройке
Веб-ресурсы для Customer Engagement