Resolver problemas de configuração e configuração do conector EHR do Microsoft Teams
Este artigo fornece orientações sobre como resolver problemas comuns de configuração e configuração do conector Microsoft Teams Electronic Health Record (EHR). Utilize-o para ajudar a resolver os bloqueadores que poderá experimentar ao configurar e configurar o conector EHR para integrar com o seu sistema Oracle Health EHR ou Epic EHR .
O URL do FHIR não está a funcionar
Recebo um erro "O URL do FHIR não é válido" quando tento configurar o conector EHR
Este problema pode ocorrer nos seguintes cenários:
- O URL base do FHIR não tem a extensão DSTU2 e está a utilizar a versão 1.1 ou 1.2 do Teams.
- O URL base do FHIR não tem a extensão R4 e está a utilizar a versão 1.3 do Teams.
Contacte o seu especialista técnico da Epic para fornecer o URL base completo do FHIR.
Sou analista épico e recebo um erro "OAUTH2" da Epic quando tento aprovar o URL do FHIR
Este problema pode ocorrer se as chaves não estiverem configuradas na instância Épica ou se a configuração do OAuth não estiver concluída pela Epic. Contacte o seu especialista técnico da Epic.
Sou analista da Epic e quando tento aprovar o URL do FHIR no portal de configuração do conector EHR, não consigo iniciar sessão no Epic com as minhas credenciais Épicas
As suas permissões têm de ser alteradas no Epic. Contacte o seu especialista técnico da Epic para verificar e atualizar as suas permissões.
Não é possível iniciar compromissos virtuais
Configurei o conector do EHR pela primeira vez e os pacientes não conseguem iniciar uma consulta virtual a partir do portal do paciente
Eis alguns motivos comuns pelos quais poderá estar a ter este problema e como resolvê-lo.
Os registos FDI no Epic não correspondem aos valores do portal de configuração do conector EHR
O URL de início e os tokens de contexto têm de ser copiados do portal de configuração do conector EHR para os registos FDI no Epic. Contacte o analista da Epic na sua organização para verificar se os valores foram copiados corretamente. Tenha em atenção que, em alguns casos, é permitido manipular os registos FDI após copiá-los do portal de configuração do conector EHR.
Os registos FDI não são atualizados no ambiente Épico correto
Os URLs base FHIR para os ambientes de teste e produção no Epic são diferentes. Verifique se os registos FDI refletem os valores do ambiente correto.
Está a utilizar um ambiente de produção e não tem uma licença de produção
A sua organização tem de ter, pelo menos, uma licença ativa para Microsoft Cloud for Healthcare, suplemento Microsoft Teams EHR Connector ou suplemento de conector do Microsoft Teams EMR. Para os clientes do Oracle Health, também é necessária uma licença para fins de teste.
Os utilizadores recebem um erro "Configuração do inquilino não encontrada" ao iniciar um compromisso virtual, apesar de todos os nossos URLs base do FHIR estarem configurados corretamente
Este problema pode ocorrer se um utilizador iniciar acidentalmente o compromisso virtual no ambiente de produção do EHR com o URL base do FHIR de teste ou vice-versa.
Para resolver este problema:
- Certifique-se de que o URL base FHIR de produção é utilizado apenas para iniciar compromissos virtuais no ambiente de produção.
- Certifique-se de que o URL base FHIR de teste é utilizado apenas para iniciar compromissos virtuais no ambiente de teste.
Visitas de grupo
As visitas de grupo não estão a funcionar na minha organização
Atualmente, as visitas a grupos só são suportadas no Epic.
Eis alguns motivos comuns pelos quais poderá estar a ter este problema ao integrar com o Epic e como resolvê-lo.
- Está a utilizar uma versão incorreta do Teams. As visitas a grupos requerem um mínimo da versão 1.2 do Teams e tem de ser pedida uma atualização no Hub de Ligação Epic.
- É necessário adicionar novos registos FDI. O seu analista Epic terá de criar novos registos FDI para visitas de grupo para suportar a experiência de associação de fornecedores e pacientes. Além disso, tem de alterar o token de contexto no grupo para visitar registos FDI de
sessionId=%CSN%parasessionId=%CONFERENCEID%. Contacte o seu especialista técnico da Epic para obter ajuda. - Se ainda estiver a ter este problema depois de experimentar os passos anteriores nesta lista, as definições de inquilino poderão ter de ser alteradas. Contacte Suporte da Microsoft para abrir um pedido de suporte para o conector teams EHR. Indique na permissão que as definições de grupo têm de ser ativadas.
Experiência do fornecedor
Os fornecedores não recebem uma notificação do Teams quando os pacientes entram numa consulta virtual
Muitas vezes, isto pode ser resolvido através da preparação. Quando um fornecedor inicia o compromisso virtual, é apresentada uma notificação temporária ao fornecedor para admitir o paciente. Esta notificação só é apresentada brevemente.
Os fornecedores também podem selecionar Pessoas nos controlos de reunião na parte superior do ecrã para ver a lista de participantes e, em seguida, em A aguardar na sala de espera, selecione a marca de verificação verde junto ao nome do participante para os admitir.
Experiência do paciente
É pedido aos pacientes que transfiram a aplicação Teams em vez de aderirem a partir de um browser. Queremos que os pacientes participem a partir de um browser sem terem de instalar o Teams
Contacte Suporte da Microsoft e abra um pedido de suporte para o conector EHR do Teams. Indique na permissão que a definição de associação ao browser tem de estar ativada. Esta alteração tem de ser feita pela equipa de conectores do Teams EHR.
Depois de ativar a definição de associação ao browser, os pacientes podem participar em consultas virtuais num browser sem terem de instalar o Teams.
Os pacientes podem enviar mensagens de chat para fornecedores no Teams após o compromisso virtual terminar a partir do compromisso. Como podemos bloquear isto?
Este cenário pode ocorrer por vários motivos.
O fornecedor sai do compromisso, mas não o acabou
Se o fornecedor sair da consulta, mas não o tiver terminado e o paciente permanecer na consulta, ambos poderão continuar a conversar. Para impedir que o paciente envie mensagens de chat, o fornecedor tem de selecionar Terminar reunião no Teams para terminar o compromisso.
A definição de associação ao browser está desativada e o paciente, que também é funcionário da sua organização, adere à aplicação Teams com as respetivas credenciais de trabalho
Se o paciente for um funcionário da sua organização e aderir ao compromisso através da aplicação Teams com as respetivas credenciais de trabalho, irá participar no compromisso como membro da sua organização e não como convidado. Isto significa que podem enviar mensagens de chat mesmo depois de o compromisso terminar.
Para evitar este cenário, pode efetuar uma das seguintes ações:
- Contacte Suporte da Microsoft e abra um pedido de suporte para o conector EHR do Teams. Indique na permissão que a definição de associação ao browser tem de estar ativada. Esta alteração tem de ser feita pela equipa de conectores do Teams EHR.
- Prepare os seus funcionários para não iniciarem sessão no Teams com as respetivas credenciais de trabalho quando estes participarem em consultas como pacientes.
Administração experiência
Não consigo aceder ao portal de configuração do conector EHR ou só consigo ver as configurações existentes e não consigo adicionar novas
Não tem acesso de administrador ao portal de configuração do conector EHR. Como uma verificação rápida, veja se pode aceder ao centro de administração do Teams. Se não conseguir aceder ao centro de administração do Teams, não tem permissões de administrador.
Contacte um administrador na sua organização para lhe conceder acesso de administrador ou configurar a integração no portal.
A minha organização quer partilhar a integração do Conector EHR com outras organizações na minha rede
Se quiser partilhar o URL base do FHIR, envie-nos um e-mail com o URL base do FHIR que pretende partilhar no TeamsForHealthcare com as seguintes informações:
- URL base do FHIR a ser partilhado
- ID de inquilino do inquilino principal/inicial da Microsoft que aloja o conector EHR (como o hospital principal que aloja o EHR)
- IDs de inquilino dos novos inquilinos que irão partilhar o conector do EHR (como ramos regionais, consultórios médicos relacionados ou clínicas)
Suporte de Infraestrutura de Ambiente de Trabalho Virtual (VDI)
A minha organização utiliza um ambiente Citrix. Como devo proceder para configurá-lo para utilizar o conector EHR?
Pode configurar um ambiente Citrix para encaminhar determinados URLs de volta para o computador local e não iniciar na máquina virtual. Por exemplo, para iniciar compromissos virtuais no Teams, configure todo o tráfego de "*.teams.microsoft.com" para o computador local.
Para saber mais, veja a seguinte documentação do Citrix: