Carregar e apresentar ficheiros estáticos

Artigo
12/11/2024

Isto artigo descreve como carregar um ficheiro estático no construtor de sites Microsoft Dynamics 365 Commerce e como criar uma URL personalizada e um nome de ficheiro que podem ser utilizados para solicitar esse ficheiro.

Alguns conectores de terceiros exigem que um ficheiro seja hospedado e servido a partir do site de comércio eletrônico. Esses conectores esperam que o ficheiro seja retornado por solicitações para um caminho de URL de retorno de chamada e nome de ficheiro específicos. Portanto, isto artigo explica como carregar e veicular um ficheiro estático que tenha uma URL e um nome de ficheiro definidos pelo utente em um site de Dynamics 365 Commerce comércio eletrônico.

Criar um URL de site que devolve um ficheiro estático

Para criar uma URL de site que retorna um ficheiro estático no Commerce construtor de sites, siga estas etapas.

Vá para a biblioteca de media do seu site e carregue o ficheiro que deve ser servido por solicitações para o URL que você definirá. Se já carregou o ficheiro, pode ignorar esta passo.
Vá para URLs do seu site.
Selecione Novo > Novo URL.
Na caixa de diálogo Nova URL , selecione Ativo da biblioteca de media.
No campo Caminho da URL, insira o caminho da URL. Inclua o nome do ficheiro no caminho.
Selecione Seguinte. A Biblioteca de media é aberta e mostra todos os ativos de media do tipo de documento que foram carregados.
Selecione o ficheiro que deve ser servido para solicitações para a URL definida no passo 5.
Selecione Guardar.

Neste ponto, a URL que você criou está em um estado de rascunho. O ficheiro para o qual o URL aponta não será devolvido até que publique o URL. Antes de publicar o URL, você pode validar se ele retorna os dados corretos.

Validar e publicar um URL

Para validar um URL antes de o publicar, siga estes passos.

Aceda aos URLs do seu site e selecione o URL a pré-visualização.
No painel de propriedades à direita, abaixo do botão Editar , selecione o ligação de URL correto. Uma nova janela do navegador é aberta e você deve receber um erro 404.
Anexar o ?pré-visualização=inprogress query string para o URL (por exemplo, https://yoursite.com/callback.html?preview=inprogress) e recarregue a página. O ficheiro que carregou para a Biblioteca de multimédia deve ser devolvido na resposta.

Depois de validar o URL, pode publicá-lo.

Vá para URLs do seu site e selecione o URL.
Selecione Publicar na barra de comandos.

Atualizar o ficheiro para o qual um URL aponta

Depois que um URL é publicado, você pode atualizá-lo para que ele aponte para um ficheiro diferente. Como alternativa, você pode atualizar a URL para que ela aponte para um tipo de recurso diferente, conforme descrito na próxima secção. Por exemplo, você pode apontar o URL para uma página interna ou um redirecionamento.

Para atualizar o ficheiro para o qual um URL aponta, siga estes passos.

Aceda aos URLs do seu site e selecione o URL a atualizar.
No painel de propriedades à direita, selecione Editar.
Em Atribuição de URL, selecione a caixa passo 2 e, em seguida, selecione um novo documento na Biblioteca de media.
Selecione Aplicar.

Atualizar o tipo de ativo para o qual um URL aponta

Você também pode atualizar uma URL para que ela aponte para um tipo diferente de ativo (recurso), como uma página interna ou um redirecionamento.

Para atualizar o tipo de ativo para o qual um URL aponta, siga estas etapas.

Aceda aos URLs do seu site e selecione o URL a atualizar.
No painel de propriedades à direita, selecione Editar.
Em Atribuição de URL, em passo 1, selecione um tipo de ativo diferente.
Selecione a passo caixa 2 e, em seguida, selecione o novo ativo.
Selecione Aplicar.

Alterar o caminho do URL

Depois que um URL é criado, seu caminho não pode ser alterado. Se for necessário alterar o caminho da URL que serve um ficheiro ou qualquer outro tipo de recurso, será necessário criar uma nova URL, mapeá-la para o ficheiro existente ou outro recurso e, em seguida, cancelar a publicação e excluir a URL antiga.

Para alterar o caminho do URL, siga estes passos.

Para criar uma nova URL e mapeá-la para o ficheiro existente ou outro recurso, siga as instruções na secção Criar uma URL de site que retorna um ficheiro estático anteriormente neste artigo.
Selecione o novo URL e selecione Publicar na barra de comandos. O novo URL é publicado.
Para cancelar a publicação do URL antigo, selecione-o e, em seguida, selecione Cancelar publicação na barra de comandos. Agora você pode excluir o URL antigo, se desejar.