User Guide
0 mins to read
Serviços extensíveis
User Guide
0 mins to read
Saiba mais sobre a tecnologia de serviços extensíveis, que permite que os usuários colaborem com parceiros de negócios confiáveis, estendendo seus dados de telemática para outros usuários do aplicativo de gerenciamento de frota. Este documento descreve o processo de envio, cancelamento e recebimento de uma solicitação de serviços extensível.
Guia do parceiro
Mai 2024
Índice
O Compartilhamento de Dados é uma tecnologia de compartilhamento de dados segura que permite que os usuários se conectem e colaborem com parceiros de negócios confiáveis, compartilhando seus dados de telemática com outros usuários do MyGeotab. Por exemplo, com o Compartilhamento de Dados, os usuários podem compartilhar os dados de segurança e de desempenho aos provedores de seguros para economizar na cobertura, ou os dados de diagnóstico do motor com provedores de manutenção para economizar nos reparos.
✱ OBSERVAÇÃO: Com o MyGeotab (versão de software 2101 ou posterior), o compartilhamento de dados estará disponível para todos as bases de dados nos seguintes planos de tarifas padrão: Base, Regulatório, Pro e ProPlus.
O Compartilhamento de Dados começa com uma transação entre dois usuários do MyGeotab: um administrador de base de dados que faz uma solicitação para compartilhar os serviços de telemática para outra base de dados e um usuário de base de dados que aceita ou rejeita a solicitação com base nas necessidades de seus negócios. Quando o Compartilhamento de Dados está ativado, os dados são enviados simultaneamente para as bases de dados especificadas.
! IMPORTANTE: Nesse momento, se o plano de tarifas no compartilhamento de dados for maior que o plano de tarifas na base de dados principal, a base de dados principal receberá dados de telemática associados ao plano de tarifas mais altas. Essa é uma anomalia e não terá impacto sobre as taxas de faturamento atuais de nenhum das bases de dados. No entanto, se o plano de tarifas no compartilhamento de dados for inferior ao compartilhamento de dados na base de dados principal, não haverá alterações em nenhum dos planos de tarifas e cada base de dados receberá os dados de telemática em que estão inscritos. Esperamos resolver esse problema em uma versão futura, em que as bases de dados principal e compartilhada receberão dados de telemática com base em seus respectivos planos de tarifas, em todos os casos.
Além disso, o compartilhamento de dados permite que os dados sejam enviados para bases de dados em diferentes planos de tarifas. Por exemplo, os dados podem ser compartilhados entre uma base de dados que está no plano Base e outra base de dados que está no plano ProPlus. Para visualizar os dados nas bases de dados do MyGeotab, por meio do portal do MyGeotab ou da API, o usuário deve ter uma conta. Este diagrama abaixo fornece uma visão geral rápida do processo do Compartilhamento de Dados no MyGeotab.
! IMPORTANTE: Para melhorar nossos produtos, podemos, a qualquer momento e sem aviso, alterar o design, a apresentação ou a funcionalidade do software. As imagens mostradas aqui são para fins de ilustração e podem parecer um pouco diferentes no software.
Antes de começar, revise as informações a seguir com atenção.
✱ PRÉ-REQUISITOS:
✱ DEFINIÇÕES:
✱ OBSERVAÇÕES:
API | Descrição |
DeviceShare | Um compartilhamento de dispositivo representa o compartilhamento de dados de streaming de um dispositivo em várias bases de dados. Uma base de dados que é o assinante principal do dispositivo pode compartilhar os dados com uma ou muitas outras bases de dados. |
DeviceShareSearch | O objeto usado para especificar os argumentos ao pesquisar por DeviceShare. |
DeviceShareStatus | Os vários status que um DeviceShare pode ter. |
DeviceShareType | Representa o tipo de fluxo de dados de um DeviceShare. |
Para obter mais informações, consulte a seção DeviceShare no SDK do MyGeotab.
O Compartilhamento de Dados está disponível diretamente no MyAdmin como um único ponto de acesso para compartilhar o serviço de telemática de uma base de dados principal para uma base de dados compartilhada, iniciada pelo Cliente. Como Parceiro, você visualiza informações relacionadas à base de dados no MyAdmin na página Centro de Compartilhamento de Dados.
Para acessar a página Centro de Compartilhamento de Dados, navegue até Dispositivos > Centro de Compartilhamento de Dados no menu principal.
A página Centro de Compartilhamento de Dados exibe uma lista de dispositivos que compartilham dispositivos GO entre várias bases de dados. Para exibir informações de um dispositivo específico, use as opções de filtro para restringir os resultados e selecione Pesquisar. A tabela exibe as seguintes informações:
✱ OBSERVAÇÃO: O status pode levar até 30 minutos para ser atualizado.
A assinatura do dispositivo pode ser desativada na base de dados Principal via MyAdmin na página Gerenciamento do dispositivo. Quando o plano do dispositivo é desativado para o dispositivo GO especificado, a conta da base de dados Principal não é mais faturada.
! IMPORTANTE: Encerrar a assinatura do dispositivo é um processo separado de encerrar o dispositivo na base de dados Principal. O dispositivo não pode ser removido da base de dados principal ao compartilhar serviços para uma base de dados compartilhada. Todos os serviços compartilhados devem ser desativados primeiro da(s) base(s) de dados compartilhada(s) antes de remover o dispositivo da base de dados principal.
✱ OBSERVAÇÃO: A alteração do plano de tarifas do dispositivo na base de dados principal não afeta as assinaturas do Compartilhamento de dados às bases de dados compartilhadas.
Para desativar a assinatura do dispositivo na base de dados principal, siga as etapas abaixo:
1 | Navegue até o site do MyAdmin. |
2 | No menu principal, navegue até Dispositivos > Gerenciamento do dispositivo. |
3 | Na página Gerenciamento de dispositivos, selecione a opção de filtro Número de série. |
4 | Digite o número de série desejado na opção de filtro Número de série seguido por uma vírgula ou quebra de linha (tecla Enter ou Return) e selecione Aplicar. |
5 | Na tabela, selecione o número de série do dispositivo para editá-lo. A página foi atualizada para exibir as seguintes informações sobre o dispositivo. |
6 | Na guia Detalhes, selecione Desativar em Plano e Faturamento. |
7 | No pop-up, selecione um Motivo para desativar e Motivo de substituição, se aplicável. |
8 | Insira quaisquer comentários e selecione Confirmar para prosseguir com a finalização da assinatura do dispositivo. |
Você desativou com sucesso a assinatura do dispositivo.
O sistema confirma que a solicitação de alteração do plano foi enviada e a solicitação foi adicionada à coluna Solicitação(ões) pendente(s) em Gerenciamento de dispositivo. A solicitação de alteração do plano pode levar até 24 horas para ser processada. Depois que a solicitação de alteração do plano for aprovada, o status na coluna Plano de faturamento ativo será atualizado para Somente serviços.
O Compartilhamento de Dados só pode ser desativado por meio do MyAdmin na página Centro de Compartilhamento de Dados. Depois que os serviços do Compartilhamento de Dados forem desativados para o dispositivo GO especificado, a conta da base de dados compartilhada não será mais faturada.
Para desativar o Compartilhamento de Dados, siga estas etapas:
1 | Navegue até Dispositivos > Centro de Compartilhamento de Dados no menu principal. |
2 | Na página Centro de Compartilhamento de Dados, use as opções de filtro para restringir os resultados e selecione Pesquisar. |
3 | Clique ou toque no dispositivo para o qual deseja desativar os serviços de Compartilhamento de Dados. |
4 | Selecione Desativar. |
5 | Na janela pop-up, selecione Enviar para enviar uma solicitação de desativação. |
Uma vez desativado, o status da assinatura compartilhada muda de Ativo para Desativado e a base de dados compartilhada não é mais faturada.
✱ OBSERVAÇÃO: O status pode levar até 30 minutos para ser atualizado.
É necessário o MyGeotab versão 2101 ou mais recente para que a base de dados use o Compartilhamento de Dados e compartilhe dados com outra base de dados.
Para verificar se o Compartilhamento de Dados está ativado, siga estas etapas:
1 | Navegue até o site do MyAdmin. |
2 | Vá para Dispositivos > Gerenciamento de dispositivos no menu principal. |
3 | Na página Gerenciamento de dispositivos, insira o nome da conta desejada. |
4 | Selecione Personalizar visualização, selecione Comunicação do dispositivo em modos de exibição e, em seguida, selecione Aplicar. |
5 | Revise a coluna base(s) de dados compartilhada(s) para verificar se os serviços de Compartilhamento de Dados foram ativados. |
A coluna Base(s) de dados compartilhada(s) na tabela indica se um dispositivo GO é compartilhado entre bases de dados. A coluna só é visível para usuários com as funções Device_Admin e SharedDatabases-View.
Como alternativa, os clientes podem verificar o fluxo de dados para as bases de dados individuais do MyGeotab usando a tabela na página Gerenciamento de dispositivos no MyAdmin. As colunas Base de dados Principal e Base(s) de dados compartilhada(s) na tabela da página Gerenciamento de dispositivos exibem o status da comunicação. Se a tabela exibir o nome da base de dados Principal e da(s) base(s) de dados compartilhada(s), isso indica que o dispositivo está se comunicando com ambas as bases de dados.
Os planos de tarifas disponíveis para a base de dados compartilhada são Base, Regulatório, Pro e ProPlus. Os preços desses planos de tarifas do Compartilhamento de Dados estarão disponíveis para parceiros na página Planos de tarifas no MyAdmin.
O Compartilhamento de Dados não pode ser ativado, a menos que o dispositivo GO esteja associado a uma base de dados Principal.