Carregar e fornecer arquivos estáticos

Artigo
08/01/2024

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

Alguns conectores de terceiros exigem que um arquivo seja hospedado e fornecido usando o site de comércio eletrônico. Esses conectores esperam que o arquivo seja retornado por solicitações a um caminho de URL de retorno de chamada e nome de arquivo específicos. Portanto, este artigo explica como carregar e fornecer um arquivo estático que possui uma URL e um nome de arquivo definidos pelo usuário em um site de comércio eletrônico do Dynamics 365 Commerce.

Criar uma URL de site que retorne um arquivo estático

Para criar uma URL de site que retorna um arquivo estático no assistente de criação de sites do Commerce, siga estas etapas:

Acesse a Biblioteca de Mídia do seu site e carregue o arquivo que deve ser fornecido por solicitações para a URL que você definirá. Se você já carregou o arquivo, pode ignorar essa etapa.
Acesse URLs do seu site.
Selecione Novo > Nova URL.
Na caixa de diálogo Nova URL, selecione Ativo de biblioteca de mídia.
No campo Caminho da URL, insira o caminho da URL. Inclua o nome do arquivo no caminho.
Selecione Avançar. A Biblioteca de Mídia é aberta e mostra todos os ativos de mídia do tipo documento que foram carregados.
Selecione o arquivo que deve ser fornecido por solicitações à URL que você definiu na etapa 5.
Selecione Salvar.

Nesse momento, a URL que você criou está em estado de rascunho. O arquivo para o qual a URL aponta não será retornado até que você publique a URL. Antes de publicar a URL, você pode validar se ela retornará os dados corretos.

Validar e publicar uma URL

Para validar uma URL antes de publicá-la, siga as etapas a seguir.

Vá até URLs do seu site e selecione a URL para exibição.
No painel de propriedades à direita, abaixo do botão Editar, selecione o link de URL correto. Uma nova janela do navegador é aberta e você deve receber um erro 404.
Anexe a cadeia de caracteres de consulta ?preview=inprogress à URL (por exemplo, https://yoursite.com/callback.html?preview=inprogress) e recarregue a página. O arquivo que você carregou na Biblioteca de Mídia deve ser retornado na resposta.

Depois de validar a URL, você pode publicá-la.

Vá até URLs do seu site e selecione a URL.
Selecione Publicar na barra de comandos.

Atualizar o arquivo para o qual uma URL aponta

Após a publicação de uma URL, você pode atualizá-la para que aponte para um arquivo diferente. Como alternativa, você pode atualizar a URL para que aponte para um tipo diferente de recurso, conforme descrito na próxima seção. Por exemplo, você pode apontar a URL para uma página interna ou um redirecionamento.

Para atualizar o arquivo para o qual uma URL aponta, siga estas etapas:

Vá até URLs do seu site e selecione a URL para atualização.
No painel de propriedades à direita, selecione Editar.
Em Atribuição de URL, selecione a caixa Etapa 2 e, em seguida, selecione um novo documento na Biblioteca de Mídia.
Selecione Aplicar.

Atualizar o tipo de ativo para o qual uma URL aponta

Você também pode atualizar uma URL para que 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 uma URL aponta, siga estas etapas:

Vá até URLs do seu site e selecione a URL para atualização.
No painel de propriedades à direita, selecione Editar.
Em Atribuição de URL, em Etapa 1, selecione um tipo de ativo diferente.
Selecione a caixa Etapa 2 e, em seguida, selecione o novo ativo.
Selecione Aplicar.

Alterar o caminho da URL

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

Para alterar o caminho do URL, siga estas etapas:

Para criar uma nova URL e mapeá-la para o arquivo existente ou outro recurso, siga as instruções na seção Criar uma URL de site que retorna um arquivo estático anteriormente neste artigo.
Selecione a novo URL e selecione Publicar na barra de comandos. A nova URL é publicada.
Para cancelar a publicação da URL antiga, selecione-a e depois escolha Cancelar publicação na barra de comandos. Agora é possível excluir a URL antiga, se desejar.