Cargar y servir archivos estáticos

Artículo
12/11/2024

Este artículo describe cómo cargar un archivo estático en el generador de sitios de Microsoft Dynamics 365 Commerce y cómo crear una URL personalizada y un nombre de archivo que se pueda usar para solicitar ese archivo.

Algunos conectores de terceros requieren que un archivo esté hospedado y servido desde el sitio de comercio electrónico. Estos conectores esperan que el archivo sea devuelto por solicitudes a una ruta de acceso URL de devolución de llamada y un nombre de archivo específicos. Por lo tanto, este artículo explica cómo cargar y entregar un archivo estático que tiene una URL y un nombre de archivo definibles por el usuario en un sitio de comercio electrónico de Dynamics 365 Commerce.

Crear una URL de sitio que devuelva un archivo estático

Para crear una URL de sitio que devuelva un archivo estático en el generador de sitios de Commerce, siga estos pasos.

Vaya a la biblioteca de medios de su sitio y cargue el archivo que deben servir las solicitudes a la URL que definirá. Si ya cargó el archivo, puede omitir este paso.
Vaya a las URL para su sitio.
Seleccione Nuevo > Nueva URL.
En el cuadro de diálogo Nueva URL, seleccione Activo de la biblioteca de medios.
En el campo Ruta de acceso URL, especifique la ruta de acceso URL. Incluya el nombre del archivo en la ruta de acceso.
Seleccione Siguiente. La biblioteca de medios se abre y muestra todos los activos de medios del tipo de documento que se han subido.
Seleccione el archivo que se debe servir para las solicitudes a la URL que definió en el paso 5.
Seleccione Guardar.

En este punto, la dirección URL que ha creado se encuentra en un estado de borrador. El archivo al que apunta la URL no se devolverá hasta que publique la URL. Antes de publicar la URL, puede validar que devuelva los datos correctos.

Validar y publicar una URL

Para validar una URL antes de publicarla, siga estos pasos.

Vaya a las URL para su sitio y seleccione la URL de la que quiere obtener la vista previa.
En el panel de propiedades de la derecha, debajo del botón Editar, seleccione el enlace URL correcto. Se abre una nueva ventana del explorador y debería recibir un error 404.
Anexe la cadena de consulta ?preview=inprogress a la URL (por ejemplo, https://yoursite.com/callback.html?preview=inprogress) y vuelva a cargar la página. El archivo que cargó en la biblioteca de medios debe devolverse en la respuesta.

Una vez que haya validado la URL, puede publicarla.

Vaya a las URL para su sitio y seleccione la URL.
Seleccione Publicar en la barra de comandos.

Actualizar el archivo al que apunta una URL

Una vez publicada una URL, puede actualizarla para que apunte a un archivo diferente. Alternativamente, puede actualizar la URL para que apunte a un tipo de recurso diferente, como se describe en la siguiente sección. Por ejemplo, puede apuntar la URL a una página interna o una redirección.

Para actualizar el archivo al que apunta una URL, siga estos pasos.

Vaya a las URL para su sitio y seleccione la URL que quiere actualizar.
En el panel de propiedades de la derecha, seleccione Editar.
En Asignación de URL, seleccione el cuadro Paso 2 y luego seleccione un nuevo documento de la biblioteca de medios.
Seleccionar Aplicar.

Actualizar el tipo de activo al que apunta una URL

También puede actualizar una URL para que apunte a un tipo diferente de activo (recurso), como una página interna o una redirección.

Para actualizar el tipo de activo al que apunta una URL, siga estos pasos.

Vaya a las URL para su sitio y seleccione la URL que quiere actualizar.
En el panel de propiedades de la derecha, seleccione Editar.
En Asignación de URL, en Paso 1, seleccione un tipo de activo diferente.
Selecciona el cuadro Paso 2 y, a continuación, seleccione el nuevo activo.
Seleccionar Aplicar.

Cambiar la ruta de acceso de la URL

Después de crear una URL, su ruta de acceso no se puede cambiar. Si tiene que cambiar la ruta de acceso de la URL que sirve a un archivo o cualquier otro tipo de recurso, debe crear una nueva URL, asignarla al archivo existente u otro recurso y luego anular la publicación y eliminar la URL anterior.

Para cambiar la ruta de acceso de la URL siga estos pasos.

Para crear una nueva URL y asignarla al archivo existente u otro recurso, siga las instrucciones en la sección Crear una URL de sitio que devuelva un archivo estático anteriormente en este artículo.
Seleccione la nueva URL y seleccione Publicar en la barra de comandos. Se publica la nueva URL.
Para anular la publicación de la URL anterior, selecciónela y luego seleccione Anular publicación en la barra de comandos. Ahora puede eliminar la URL anterior si lo desea.