Statische bestanden uploaden en verwerken

Artikel
08/01/2024

In dit artikel wordt beschreven hoe u een statisch bestand uploadt in Microsoft Dynamics 365 Commerce Site Builder en hoe u een aangepaste URL en bestandsnaam maakt die u kunt gebruiken om dat bestand aan te vragen.

Voor sommige connectors van derden moet een bestand worden gehost en vanaf de e-commerce site worden aangeboden. Deze connectors verwachten dat het bestand wordt geretourneerd door verzoeken naar een specifiek callback URL-pad en bestandsnaam. Daarom wordt in dit artikel uitgelegd hoe u een statisch bestand kunt uploaden en bedienen met een door de gebruiker te definiëren URL en bestandsnaam op een Dynamics 365 Commerce e-commercesite.

Een site-URL maken die een statisch bestand retourneert

Voer de volgende stappen uit om een site-URL te maken die een statisch bestand retourneert in Commerce site builder.

Ga naar de Mediabibliotheek van uw site en upload het bestand dat moet worden geleverd door verzoeken naar de URL die u gaat definiëren. Als u het bestand al hebt geüpload, kunt u deze stap overslaan.
Ga naar URL's voor uw site.
Selecteer Nieuw > Nieuwe URL.
Selecteer in het dialoogvenster Nieuwe URL de optie Mediabibliotheekmaterialen.
Voer in het veld URL-pad het URL-pad in. Neem de bestandsnaam op in het pad.
Selecteer Volgende. De Mediabibliotheek wordt geopend en toont alle mediamaterialen van het type document dat is geüpload.
Selecteer het bestand dat moet worden geleverd voor verzoeken naar de URL die u in stap 5 hebt gedefinieerd.
Selecteer Opslaan.

Op dit moment bevindt de URL die u hebt gemaakt zich in een conceptstatus. Het bestand waarnaar de URL verwijst, wordt niet geretourneerd totdat u de URL publiceert. Voordat u de URL publiceert, kunt u valideren of de juiste gegevens worden geretourneerd.

Een URL valideren en publiceren

Ga als volgt te werk om een URL te valideren voordat u deze publiceert.

Ga naar URL's voor uw site en selecteer de URL die u wilt bekijken.
Selecteer in het deelvenster Eigenschappen rechtsonder via de knop Bewerken de juiste URL-koppeling. Er wordt een nieuw browservenster geopend en er wordt een 404-fout weergegeven.
Voeg de ?preview=inprogress-query reeks toe aan de URL (bijvoorbeeld https://yoursite.com/callback.html?preview=inprogress) en laad de pagina opnieuw. Het bestand dat u naar de Mediabibliotheek hebt geüpload, moet in het antwoord zijn geretourneerd.

Nadat u de URL hebt gevalideerd, kunt u deze publiceren.

Ga naar URL's voor uw site en selecteer de URL.
Selecteer Publiceren in de opdrachtbalk.

Het bestand bijwerken waarnaar een URL verwijst

Nadat een URL is gepubliceerd, kunt u deze bijwerken zodat deze naar een ander bestand verwijst. U kunt de URL ook bijwerken, zodat deze verwijst naar een ander type bron, zoals wordt beschreven in de volgende sectie. U kunt bijvoorbeeld de URL naar een interne pagina of een omleiding verwijzen.

Voer de volgende stappen uit om het bestand bij te werken waarnaar een URL verwijst:

Ga naar URL's voor uw site en selecteer de URL die u wilt bijwerken.
Selecteer Bewerken in het eigenschappenvenster aan de rechterkant.
Selecteer onder URL-toewijzing het vak Stap 2 en selecteer vervolgens een nieuw document in de Mediabibliotheek.
Selecteer Toepassing.

Het materiaaltype bijwerken waarnaar een URL verwijst

U kunt ook een URL bijwerken zodat deze naar een ander type materiaal (resource) verwijst, zoals een interne pagina of een omleiding.

Voer de volgende stappen uit om het materiaaltype bij te werken waarnaar een URL verwijst:

Ga naar URL's voor uw site en selecteer de URL die u wilt bijwerken.
Selecteer Bewerken in het eigenschappenvenster aan de rechterkant.
Selecteer onder URL-toewijzing onder Stap 1 een ander materiaaltype.
Selecteer het vak Stap 2 en selecteer vervolgens het nieuwe materiaal.
Selecteer Toepassing.

Het URL-pad wijzigen

Nadat een URL is gemaakt, kan het pad ervan niet worden gewijzigd. Als u het URL-pad moet wijzigen dat een bestand of een ander type bron bevat, moet u een nieuwe URL maken, deze toewijzen aan het bestaande bestand of een andere bron, en vervolgens de publicatie ongedaan maken en de oude URL verwijderen.

Als u het URL-pad wilt wijzigen, volgt u deze stappen.

Als u een nieuwe URL wilt maken en toewijzen aan het bestaande bestand of een andere bron, volgt u de instructies in de sectie Een site-URL maken die een statisch bestand retourneert eerder in dit artikel.
Selecteer de nieuwe URL en selecteer Publiceren in de opdrachtbalk. De nieuwe URL wordt gepubliceerd.
Als u de publicatie van de oude URL ongedaan wilt maken, selecteert u de URL en selecteert u vervolgens Publicatie ongedaan maken in de opdrachtbalk. U kunt nu de oude URL verwijderen als u wilt.