Instalar e configurar o Connected Field Service para Hub IoT do Azure

  • Artigo

Siga as etapas deste artigo para configurar o Connected Field Service a ser usado com o Hub IoT do Azure.

Observação

O Time Series Insights vai ser preterido depois de março de 2025. O Connected Field Service está em transição para o Azure Data Explorer. Mais informações sobre a transição em breve.

Pré-requisitos

Dica

As imagens que incluem um ícone com esta aparência: podem ser expandidas para mostrar mais detalhes. Selecione a imagem para expandi-la. Para fechá-la, pressione a tecla Esc.

Implantar os recursos do Connected Field Service e do Azure usando um modelo do ARM

Use um modelo de gerenciamento dos recursos do Azure (Azure Resource Manager) para implantar o Hub IoT do Azure e conectá-lo ao ambiente do Field Service.

  1. Selecione Implantar no Azure na página https://github.com/microsoft/Dynamics-365-Connected-Field-Service-Deployment.

  2. Selecione sua assinatura do Azure.

  3. Selecione um grupo de recursos ou crie um.

  4. Defina a região como a mesma região do seu ambiente do Field Service.

    Captura de tela do modelo do Azure Resource Manager para implantar o Hub IoT para Connected Field Service.

  5. Insira o nome exclusivo da organização e a URL da organização do ambiente do Field Service.

  6. Selecione os recursos opcionais que deseja implantar.

    • Selecione Implantar Simulador (opcional) para testar e validar cenários de IoT com dados de exemplo.
    • Selecione Azure Time Series Insights (opcional) para permitir visualizações das leituras de dispositivo e dos blocos de resumo.
    • Selecione Implantar SQL Server para Power BI (opcional) e insira o servidor SQL e as credenciais para criar os próprios relatórios no Power BI.

  7. Selecione Revisar +criar.

Verifique se a implantação está completa antes de continuar.

Criar uma instância do provedor de IoT

  1. Entre no Dynamics 365 e abra o aplicativo Connected Field Service.

  2. No Connected Field Service, vá para a área Configurações.

  3. Selecione Provedores e Novo.

  4. Insira as seguintes informações:

    Captura de tela de uma nova instância do provedor do Hub IoT com dados de exemplo.

    • Nome: o nome do grupo de recursos no Azure no qual você implantou recursos de IoT
    • Provedor de IoT: o provedor de IoT para Hub IoT
    • ID da instância do provedor: o nome do recurso do Hub IoT implantado por você no grupo de recursos no Azure
    • URL: a URL da visão geral do grupo de recursos no portal do Azure; por exemplo, https://portal.azure.com/[tenant_id]/subscriptions/[subscription_id]/resourceGroups/[resource_group_name]/overview.

  5. Selecione Salvar.

Agora você precisa atualizar as configurações da nova instância do provedor.

  1. Na área Definições, selecione Configurações de IoT>Configurações do Provedor de IoT.

    Captura de tela da página Configurações de IoT.

  2. Em Provedor de IoT Padrão, selecione a instância do provedor de IoT criado por você.

  3. Selecione Salvar e Fechar.

  4. Para uma etapa posterior, encontre a linha Instância do Provedor de IoT na tabela msdyn_iotproviderinstance e copie o GUID.

Configurar um ponto de extremidade de IoT

Nesta etapa, você precisa saber o nome do host do Namespace do Barramento de Serviço implantado no grupo de recursos.

  1. Baixe a CLI do Power Platform e instale-a.

  2. Abra a CLI e inicie a Plugin Registration Tool (PRT)usando o comando pac tool prt.

  3. Na janela PRT, selecione Criar Nova Conexão.

  4. Na Lista de exibição das organizações disponíveis, selecione Office 365.

  5. Selecione Lista de exibição das organizações disponíveis e Mostrar Avançado.

  6. Selecione a região do ambiente do Field Service, insira as credenciais do Field Service e selecione Logon.

    Se tiver acesso a várias organizações do Dynamics 365, selecione o nome da organização com a qual você deseja trabalhar.

Agora você precisa atualizar o ponto de extremidade de serviço Mensagem de IoT.

  1. Depois que você se conectar à organização, encontre e selecione o ponto de extremidade de serviço Mensagem de IoT.

  2. Selecione Atualizar.

  3. Em Endereço do Namespace, insira o nome do host do Namespace do Barramento de Serviço na Ferramenta de Registro do Plug-in, prefixado por sb://; por exemplo, sb://myServiceBusNamespace.servicebus.windows.net.

  4. No recurso Namespace do Barramento de Serviço, vá para Filas e encontre a fila com um nome que termina em -crm. Copie o nome completo e insira-o como o Nome do Tópico na Ferramenta de Registro de Plug-in.

  5. Para Formato da Mensagem, escolha XML.

  6. No recurso Namespace do Barramento de Serviço, vá para Políticas de acesso compartilhado>RootManageSharedAccessKey.

  7. Copie e cole o nome em Nome da Chave SaS.

  8. Copie e cole a chave primária na Chave SAS.

  9. Selecione Salvar.

    Captura de tela da página Registro do Ponto de Extremidade de Serviço.

Autorizar a conexão do Azure App

  1. Entre na conta do Azure e vá até o portal do Azure.

  2. Vá até Grupos de Recursos e encontre o grupo de recursos implantado por você no Hub IoT.

  3. Selecione e edite o recurso Conexão de APIcommondataservice.

  4. Em Geral, selecione Editar Conexão de API e Autorizar.

  5. Entre usando as credenciais do Dynamics 365 usadas por você no ambiente do Connected Field Service.

    Elas podem ser diferentes das credenciais usadas para entrar no portal do Azure.

  6. Selecione Salvar.

Atualizar devicerules.json

O trabalho do Stream Analytics implantado no grupo de recursos se refere a um arquivo chamado devicerules.json. Esse arquivo define uma regra que cria Alertas de IoT quando você usa o simulador de dispositivo opcional.

Para usar a regra, carregue o arquivo devicerules.json. Você deve reproduzir a estrutura exata do diretório para que o alerta de amostra funcione.

  1. Baixe o arquivo devicerules.json do repositório do GitHub.

  2. Abra o grupo de recursos no portal de administração do Azure e selecione a conta de armazenamento implantada em seu grupo de recursos.

  3. Selecione Contêineres e crie um contêiner chamado devicerules.

  4. Abra o novo contêiner devicerules e selecione Carregar.

  5. Procure e selecione devicerules.json.

  6. Expanda a seção Avançado. No campo Carregar na pasta, insira 2016-05-30 e selecione Carregar.

  7. Abra a nova pasta 2016-05-30 e selecione Carregar.

  8. Procure e selecione devicerules.json.

  9. Expanda a seção Avançado. No campo Carregar na pasta, insira 22-40 e selecione Carregar.

Iniciar os trabalhos do Azure Stream Analytics

  1. No portal do Azure, vá até Grupos de recursos e encontre o grupo de recursos implantado por você no Hub IoT.

  2. Selecione cada trabalho do Stream Analytics e, na guia Visão geral, selecione Iniciar.

Parabéns! Agora você está pronto para transmitir os dados entre o Hub IoT do Azure e o Dynamics 365 para usar o Connected Field Service.

Configurar a conexão do Azure Time Series Insights

Use o Azure Time Series Insights para criar visualizações. Nesta etapa, você precisa saber a ID do locatário do Azure.

  1. No Dynamics 365, abra o aplicativo Connected Field Service.

  2. Acione as ferramentas para desenvolvedores do navegador e vá para o console.

  3. Digite ou cole o script a seguir no console e o execute. Substitua o parâmetro Value pela ID do locatário do Azure.

var req = {};

req.getMetadata = function () {
return {
boundParameter: null,
parameterTypes: {
"Key": {
"typeName": "Edm.String",
"structuralProperty": 1
},
"Value": {
"typeName": "Edm.String",
"structuralProperty": 1
},
},
operationType: 0,
operationName: "msdyn_IoTSetConfiguration"
};
};

req["Key"]="TSI_PLUGIN_AZURE_TENANT_ID";
req["Value"]="REPLACE";

Xrm.WebApi.online.execute(req).then( 
function (data) { 
console.log("Success Response Status: " + data.status);
}, 
function (error) { 
console.log("Error: " + error.message);
}
);

  1. Reexecute o script. Desta vez, substitua Key por TSI_PLUGIN_CLIENT_APPLICATION_ID e Value pela ID do cliente do aplicativo no registro do aplicativo Time Series Insights criado por você como pré-requisito.

  2. Execute o script mais uma vez. Desta vez, substitua Key por TSI_PLUGIN_CLIENT_SECRET e Value pelo segredo do cliente no registro do aplicativo Time Series Insights criado por você como pré-requisito.

  3. Execute o script a seguir usando a URL do Time Series Insights e o GUID da linha da instância do provedor de IoT na tabela msdyn_iotproviderinstance da instância do provedor de IoT criada por você anteriormente.

var data = {"msdyn_timeseriesinsightsurl": "Enter Data Access FQDN found on Time Series Insights environment overview"};
Xrm.WebApi.updateRecord("msdyn_iotproviderinstance", "Copy the value for msdyn_iotproviderinstanceid from the json object returned with the API call https://[your-environment-name].crm.dynamics.com/api/data/v9.2/msdyn_iotproviderinstances", data);

(Opcional) Configurar o simulador

O simulador permite que você teste o Connected Field Service sem a necessidade de conectar o hardware físico. A simulação de dispositivos e dados de IoT ajuda você a entender as partes do sistema que favorecem a transformação dos dados de IoT em ordens de serviço.

Para esta etapa, você precisa da URL do simulador e da chave primária da política iothubowner.

Obter a chave de acesso

  1. Entre na conta do Azure e vá até o portal do Azure.

  2. Vá até Grupos de Recursos e encontre o grupo de recursos implantado por você no Hub IoT.

  3. Selecione o hub IoT.

  4. Selecione Políticas de acesso compartilhado e copie a chave primária de iothubowner.

    Captura de tela da política de acesso compartilhado do recurso do Hub IoT do Azure para iothubowner, com a chave primária realçada.

Obter a URL do simulador

  1. No grupo de recursos do portal do Azure no qual você implantou o Hub IoT, selecione o tipo de recurso do Serviço de Aplicativo que começa com Simulator e copie a URL no canto superior direito.

  2. Cole a URL na barra de endereços do navegador e carregue a página.

  3. Selecione Conexão.

  4. Insira o nome do host do recurso Hub IoT e iothubowner como o nome da política. No campo Chave, cole a chave primária copiada por você anteriormente.

    Captura de tela da janela

  5. Verifique se Status da conexão está Conectado e feche a janela da conexão.

Envie um comando de teste usando o simulador. Por exemplo, clique na temperatura e aumente-a para mais de 70 graus. O simulador será pré-programado para criar um alerta de IoT se a temperatura exceder 70 graus.

Próximas etapas