Przekazywanie i obsługiwanie plików statycznych

Artykuł
03/08/2023

W tym artykule opisano sposób przekazywania pliku statycznego do kreatora witryn Microsoft Dynamics 365 Commerce oraz tworzenia niestandardowego adresu URL i nazwy pliku, które mogą być używane do żądania tego pliku.

Niektóre łączniki innych firm wymagają, aby plik był hostowany i obsługiwany przez witrynę handlu elektronicznego. Te łączniki oczekują, że plik będzie zwracany przez żądania do konkretnej ścieżki URL wywołania zwrotnego i nazwy pliku. W tym artykule opisano sposób przekazywania i obsługiwania pliku statycznego, który ma definiowany przez użytkownika adres URL i nazwę pliku w witrynie handlu elektronicznego Dynamics 365 Commerce.

Utwórz adres URL witryny, który zwraca plik statyczny

Aby utworzyć adres URL witryny, który zwraca plik statyczny w kreatorze witryny Commerce, wykonaj następujące kroki.

Przejdź do biblioteki multimediów w witrynie i przekaż plik, który powinien być obsługiwany przez żądania kierowane do zdefiniowanego adresu URL. Jeśli plik został już przekazany, można pominąć ten krok.
Przejdź do adresów URL witryny.
Wybierz pozycję Nowy > Nowy adres URL.
W oknie dialogowym Nowy adres URL wybierz opcję Zasób biblioteki multimediów.
W polu Ścieżka URL wprowadź ścieżkę URL. Umożliwia uwzględnienie nazwy pliku w ścieżce.
Wybierz pozycję Następny. Biblioteka multimediów jest otwarta i zawiera wszystkie zasoby multimedialne typu dokument, które zostały przekazane.
Wybierz plik, który ma być obsługiwany dla żądań dla adresu URL zdefiniowanego w kroku 5.
Wybierz opcję Zapisz.

W tym momencie utworzony adres URL jest w stanie wersji roboczej. Plik, do którego wskazuje adres URL, nie zostanie zwrócony do momentu opublikowania adresu URL. Przed opublikowaniem adresu URL można sprawdzić, czy zwróci on poprawne dane.

Weryfikowanie i publikowanie adresu URL

Aby zweryfikować adres URL przed jego opublikowaniem, wykonaj następujące kroki.

Przejdź do Adresów URL swojego serwisu i wybierz adres URL do podglądu.
W okienku właściwości po prawej stronie, pod przyciskiem Edycja, zaznacz odpowiednie łącze URL. Zostanie otwarte nowe okno przeglądarki i pojawi się komunikat o błędzie 404.
W adresie URL należy dołączyć ciąg kwerendy w postaci ?preview=inprogress (na przykład https://yoursite.com/callback.html?preview=inprogress), a następnie ponownie załadować stronę. Plik przekazany do biblioteki multimediów powinien zostać zwrócony w odpowiedzi.

Po sprawdzeniu adresu URL można go opublikować.

Przejdź do Adresów URL swojego serwisu i wybierz adres URL.
Na pasku poleceń wybierz opcję Publikuj.

Aktualizacja pliku, na który wskazuje adres URL

Po opublikowaniu adresu URL można go aktualizować w taki sposób, aby wskazywał inny plik. Można również zaktualizować adres URL, tak aby wskazywał inny typ zasobu, zgodnie z opisem w następnej sekcji. Można na przykład wskazać adres URL na stronie wewnętrznej lub przekierowaniu.

Aby zaktualizować plik, na który wskazuje adres URL, wykonaj następujące kroki.

Przejdź do Adresów URL swojego serwisu i wybierz adres URL do aktualizacji.
W panelu właściwości po prawej stronie wybierz pozycję Edytuj.
W obszarze Przypisywanie adresów URL zaznacz pole Krok 2, a następnie wybierz nowy dokument z biblioteki multimediów.
Wybierz opcję Zastosuj.

Aktualizacja typu zasobu, na który wskazuje adres URL

Można również zaktualizować adres URL, aby wskazywał na inny typ elementu zawartości (zasobu), taki jak wewnętrzna strona lub przekierowanie.

Aby zaktualizować typ zasobu, na który wskazuje adres URL, wykonaj następujące kroki.

Przejdź do Adresów URL swojego serwisu i wybierz adres URL do aktualizacji.
W panelu właściwości po prawej stronie wybierz pozycję Edytuj.
W obszarze Przypisywanie adresu URL w Kroku 1 wybierz inny typ zasobu.
Zaznacz pole Krok 2, a następnie wybierz nowy zasób.
Wybierz opcję Zastosuj.

Zmiana ścieżki URL

Po utworzeniu adresu URL nie można zmienić jego ścieżki. Jeśli trzeba zmienić ścieżkę URL, która obsługuje plik lub jakikolwiek inny typu zasobu, należy utworzyć nowy adres URL, zmapować go do istniejącego pliku lub innego zasobu, a następnie cofnąć publikowanie i usunąć stary adres URL.

Aby zmienić ścieżkę adresu URL, wykonaj następujące kroki.

Aby utworzyć nowy adres URL i zmapować go do istniejącego pliku lub innego zasobu, postępuj zgodnie z instrukcjami w sekcji Tworzenie adresu URL witryny, który zwraca plik statyczny, dostępnej powyżej w tym artykule.
Wybierz nowy adres URL i wybierz opcję Publikuj na pasku poleceń. Nowy adres URL zostanie opublikowany.
Aby cofnąć publikowanie starego adresu URL, zaznacz go, a następnie wybierz opcję Cofnij publikowanie na pasku poleceń. W razie potrzeby można teraz usunąć stary adres URL.