Отправка и подача статических файлов

Статья
08/01/2024

Эта статья описывает, как отправить статический файл в конфигуратор сайта Microsoft Dynamics 365 Commerce, и как создать пользовательский URL-адрес и имя файла, которые могут быть использованы для запроса этого файла.

Некоторые сторонние соединители требуют, чтобы файл размещался и предоставлялся с сайта электронной коммерции. Эти соединители ожидают, что файл будет возвращен по запросам на определенный URL-путь обратного вызова и имя файла. Таким образом, эта статья объясняет, как отправить и предоставить статический файл, который имеет определяемый пользователем URL-адрес и имя файла на сайте электронной коммерции Dynamics 365 Commerce.

Создание URL-адреса сайта, который возвращает статический файл

Чтобы создать URL-адрес сайта, который возвращает статический файл в конфигураторе сайта Commerce, следуйте этим шагам.

Перейдите в библиотеку мультимедиа вашего сайта и отправьте файл, который должен предоставляться по запросам на URL-адрес, который вы определите. Если вы уже отправили файл, вы можете пропустить этот шаг.
Перейдите в раздел URL-адреса для вашего сайта.
Выберите Создать > Создать URL-адрес.
В диалоговом поле Создать URL-адрес выберите Актив библиотеки мультимедиа.
В поле URL-путь введите URL-путь. Включите имя файла в путь.
Выберите Далее. Открывается библиотека мультимедиа и отображаются все ресурсы мультимедиа типа документ, которые были отправлены.
Выберите файл, который должен быть предоставлен для запросов на URL-адрес, который вы определили в шаге 5.
Нажмите Сохранить.

На этом этапе URL-адрес, который вы создали, находится в состоянии черновика. Файл, на который указывает URL-адрес, не будет возвращен до тех пор, пока вы не опубликуете URL-адрес. Перед публикацией URL-адреса можно подтвердить, что он возвращает правильные данные.

Проверка и публикация URL-адреса

Чтобы проверить URL-адрес перед его публикацией, выполните следующие действия.

Перейдите в раздел URL-адреса для вашего сайта и выберите URL-адрес для предварительного просмотра.
На панели свойств справа под кнопкой Изменить выберите правильную ссылку URL. Открывается новое окно браузера, и вы должны получить ошибку 404.
Добавьте строку запроса ?preview=inprogress к URL-адресу (например, https://yoursite.com/callback.html?preview=inprogress) и перезагрузите страницу. Файл, отправленный в библиотеку мультимедиа, должен быть возвращен в ответ.

После проверки URL-адреса его можно опубликовать.

Перейдите в раздел URL-адреса для вашего сайта и выберите URL-адрес.
Выберите Опубликовать на панели команд.

Обновление файла, на который указывает URL-адрес

После публикации URL-адреса можно обновить его так, чтобы он указывал на другой файл. Кроме того, можно обновить URL-адрес, чтобы он указывал на другой тип ресурса, как описано в следующем разделе. Например, можно задать, чтобы URL-адрес указывал на внутреннюю страницу или перенаправление.

Чтобы обновить файл, на который указывает URL-адрес, следуйте этим шагам.

Перейдите в раздел URL-адреса для вашего сайта и выберите URL-адрес для обновления.
В области свойств справа выберите Изменить.
В разделе Назначение URL-адреса выберите поле Шаг 2, затем выберите новый документ из библиотеки мультимедиа.
Выберите Применить.

Обновление типа ресурса, на который указывает URL-адрес

Можно также обновить URL-адрес, чтобы он указывал на другой тип актива (ресурса), например на внутреннюю страницу или перенаправление.

Чтобы обновить тип ресурса, на который указывает URL-адрес, следуйте этим шагам.

Перейдите в раздел URL-адреса для вашего сайта и выберите URL-адрес для обновления.
В области свойств справа выберите Изменить.
В разделе Назначение URL-адреса в пункте Шаг 1, выберите другой тип ресурса.
Выберите поле Шаг 2, затем выберите новый актив.
Выберите Применить.

Изменение URL-пути

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

Чтобы изменить URL-путь, выполните следующие действия.

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