Caricare e utilizzare file statici

Articolo
03/08/2023

Questo articolo descrive come caricare un file statico nel generatore di siti di Microsoft Dynamics 365 Commerce e come creare un URL e un nome file personalizzati che possono essere utilizzati per richiedere quel file.

Alcuni connettori di terze parti richiedono che un file sia ospitato e servito dal sito di e-commerce. Questi connettori prevedono che il file venga restituito dalle richieste in un percorso URL di callback e un nome file specifici. Pertanto, questo articolo spiega come caricare e servire un file statico con un URL e un nome file definibili dall'utente in un sito di e-commerce di Dynamics 365 Commerce.

Crea un URL del sito che restituisca un file statico

Per creare un URL del sito che restituisce un file statico nel generatore di siti di Commerce, attenersi alla seguente procedura.

Andare alla libreria multimediale del sito e caricare il file che deve essere servito dalle richieste all'URL che verrà definito. Se è già stato caricato il file, è possibile saltare questo passaggio.
Andare a URL per il sito.
Selezionare Nuovo > Nuovo URL.
Nella finestra di dialogo Nuovo URL, selezionare Risorsa libreria multimediale.
Nel campo Percorso URL inserire il percorso dell'URL. Includere il nome del file nel percorso.
Selezionare Avanti. La libreria multimediale viene aperta e mostra tutte le risorse multimediali di tipo documento che sono state caricate.
Seleziona il file che deve essere servito per le richieste all'URL definito nel passaggio 5.
Selezionare Salva.

A questo punto, l'URL creato è in stato bozza. Il file a cui punta l'URL non verrà restituito finché non si pubblica l'URL. Prima di pubblicare l'URL, è possibile verificare che restituisca i dati corretti.

Convalidare e pubblicare un URL

Per convalidare un URL prima di pubblicarlo, attenersi alla seguente procedura.

Andare a URL per il sito e selezionare l'URL da visualizzare in anteprima.
Nel riquadro delle proprietà a destra, sotto il pulsante Modifica selezionare il collegamento URL corretto. Si apre una nuova finestra del browser e viene visualizzato un errore 404.
Aggiungere la stringa di query ?preview=inprogress all'URL (ad esempio, https://yoursite.com/callback.html?preview=inprogress) e ricaricare la pagina. Il file caricato nella libreria multimediale viene restituito nella risposta.

Dopo aver convalidato l'URL, è possibile pubblicarlo.

Andare a URL per il sito e selezionare l'URL.
Nella barra dei comandi selezionare Pubblica.

Aggiornare il file a cui punta un URL

Dopo che un URL è stato pubblicato, è possibile aggiornarlo in modo che punti a un file diverso. In alternativa, è possibile aggiornare l'URL in modo che punti a un diverso tipo di risorsa, come descritto nella sezione successiva. Ad esempio, è possibile puntare l'URL a una pagina interna o a un reindirizzamento.

Per aggiornare il file a cui punta un URL, seguire questi passaggi.

Andare a URL per il sito e selezionare l'URL da aggiornare.
Nel riquadro delle proprietà a destra, selezionare Modifica.
Sotto Assegnazione URL, selezionare la casella Passaggio 2 quindi selezionare un nuovo documento dalla libreria multimediale.
Selezionare Applica.

Aggiornare il tipo di risorsa a cui punta un URL

È anche possibile aggiornare un URL in modo che punti a un diverso tipo di risorsa (asset), come una pagina interna o un reindirizzamento.

Per aggiornare il tipo di risorsa a cui punta un URL, seguire questi passaggi.

Andare a URL per il sito e selezionare l'URL da aggiornare.
Nel riquadro delle proprietà a destra, selezionare Modifica.
Sotto Assegnazione URL, sotto Passaggio 1, selezionare un altro tipo di risorsa.
Selezionare la casella Passaggio 2 quindi selezionare la nuova risorsa.
Selezionare Applica.

Modificare il percorso dell'URL

Dopo aver creato un URL, il suo percorso non può essere modificato. Se è necessario modificare il percorso dell'URL che serve un file o qualsiasi altro tipo di risorsa, è necessario creare un nuovo URL, mapparlo al file esistente o un'altra risorsa, quindi annullare la pubblicazione ed eliminare il vecchio URL.

Per modificare il percorso dell'URL, eseguire le operazioni indicate di seguito.

Per creare un nuovo URL e mapparlo al file esistente o a un'altra risorsa, segui le istruzioni nella precedente sezione Creare un URL del sito che restituisca un file statico in questo articolo.
Selezionare il nuovo URL e selezionare Pubblica sulla barra dei comandi. Il nuovo URL viene pubblicato.
Per annullare la pubblicazione del vecchio URL, selezionalo, quindi selezionare Annulla pubblicazione sulla barra dei comandi. È possibile ora eliminare il vecchio URL se si desidera.