Carregar e apresentar ficheiros estáticos

O Grupo de Interesse de Varejo do Dynamics 365 Commerce mudou do Yammer para o Viva Engage. Se você não tiver acesso à nova comunidade Viva Engage, preencha este formulário (https://aka.ms/JoinD365commerceVivaEngageCommunity) para ser adicionado e mantenha-se envolvido nas últimas discussões.

Este artigo descreve como carregar um ficheiro estático no construtor de sites do 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 alojado e servido a partir do site de comércio eletrónico. Estes conectores esperam que o ficheiro seja devolvido por pedidos para um caminho de URL de retorno de chamada e nome de ficheiro específicos. Portanto, este artigo explica como carregar e servir um ficheiro estático que tenha uma URL e um nome de ficheiro definidos pelo utilizador num site de comércio eletrónico do Dynamics 365 Commerce.

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

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

Vá para a biblioteca de suporte de dados do seu site e carregue o ficheiro que deve ser servido por pedidos para a URL que irá definir. Se já carregou o ficheiro, pode ignorar este passo.
Aceda às URLs para o seu site.
Selecione Novo > Nova URL.
Na caixa de diálogo Nova URL, selecione Ativo da biblioteca de suporte de dados.
No campo Caminho da URL, introduza o caminho da URL. Inclua o nome do ficheiro no caminho.
Selecione Seguinte. A Biblioteca de suporte de dados é aberta e mostra todos os ativos de suporte de dados do tipo de documento que foram carregados.
Selecione o ficheiro que deve ser servido para pedidos para a URL definida no passo 5.
Selecione Guardar.

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

Validar e publicar uma URL

Para validar uma URL antes de publicar, siga estes passos.

Aceda às URLs do seu site e selecione a URL para pré-visualização.
No painel de propriedades à direita, abaixo do botão Editar, selecione a ligação de URL correta. Uma nova janela do browser abre e 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 ficheiro que carregou para a Biblioteca de suporte de dados deve ser devolvido na resposta.

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

Aceda às URLs do seu site e selecione a URL.
Selecione Publicar na barra de comandos.

Atualizar o ficheiro para o qual uma URL aponta

Depois de uma URL ser publicada, pode atualizá-la para que aponte para um ficheiro diferente. Em alternativa, pode atualizar a URL para que aponte para um tipo de recurso diferente, conforme descrito na próxima secção. Por exemplo, pode apontar a URL para uma página interna ou um redirecionamento.

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

Aceda às URLs do seu site e selecione a URL para 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 suporte de dados.
Selecione Aplicar.

Atualizar o tipo de ficheiro para o qual uma URL aponta

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 uma URL aponta, siga estes passos.

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

Alterar o caminho da URL

Depois de uma URL ser criada, o 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 eliminar a URL antiga.

Para alterar o caminho da URL, siga estes passos.

Para criar uma nova URL de site 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 a nova URL e selecione Publicar na barra de comandos. A nova URL é publicada.
Para cancelar a publicação da URL antiga, selecione-a e, em seguida, selecione Cancelar publicação na barra de comandos. Agora pode eliminar a URL antiga, se desejar.