Passar uma URL do Dynamics 365 para uma biblioteca de widgets

Artigo
12/11/2023

Para acessar as APIs da Estrutura de Integração de Canal do Dynamics 365, você precisa carregar o arquivo msdyn_cilibrary.js dentro do seu widget de comunicação. Como o widget está em um domínio diferente, esta biblioteca precisa saber com qual domínio do Dynamics 365 ela deve se comunicar. Por esse motivo, você precisa passar a URL da instância do Dynamics 365 para a biblioteca de widgets.

Importante

A Nuvem da Comunidade Governamental só é compatível no Channel Integration Framework 2.0. Para qualquer organização hospedada na Nuvem da Comunidade Governamental (GCC) ou na Microsoft Cloud Germany, o domínio do provedor deve residir dentro da respectiva nuvem ou deve ter acesso permitido a partir dessa nuvem.

Uma URL do Dynamics 365 para uma biblioteca de widgets pode ser passada usando um dos métodos a seguir.

Adicione atributos à marca de script.
Adicione um parâmetro URL.

Adicionar atributos à marca de script

O provedor de widget deve adicionar os seguintes atributos à marca de script que carrega msdyn_cilibrary.js para passar o domínio do Dynamics 365:

data-cifid: CIFMainLibrary
data-crmurl: <CRM domain name>

Exemplo

<script type="text/javascript" src="https://crmorg.crm.dynamics.com/webresources/Widget/msdyn_ciLibrary.js" data-crmurl="https://crmorg.crm.dynamics.com" data-cifid="CIFMainLibrary">
</script>