Configuração do EHR da Epic

Nesta página, descrevemos como registrar e configurar um app da Epic antes de criar o repositório de dados do EHR da Epic. Sua organização registra o próprio app da Epic. Geralmente, o analista da Epic conclui essas etapas.

Registrar o app Epic

Registre um app para o Gemini Enterprise no Epic on FHIR e disponibilize-o nos seus ambientes do Epic. Use as seguintes configurações:

Configuração Valor
Público-alvo do aplicativo Profissionais de saúde ou usuários administrativos
APIs de entrada As APIs R4 listadas em Ativar as APIs da Epic
APIs de saída Nenhum
Este app vai registrar clientes dinâmicos? Não
É um cliente confidencial Sim
Requer acesso persistente Sim
Usa tokens de atualização contínua Sim
URL do conjunto de JWK Deixar em branco
Versão do SMART on FHIR R4
Versão do escopo SMART SMART v1
Esquema de geração de IDs do FHIR Usar IDs FHIR limitados a 64 caracteres para recursos FHIR do USCDI

As configurações de acesso persistente da sua organização para o app determinam por quanto tempo a autorização de um usuário é válida. Quando ele termina, o usuário autoriza o conector novamente.

Definir os URIs de redirecionamento

No app, registre os dois URIs de redirecionamento a seguir exatamente como mostrado:

  • https://vertexaisearch.cloud.google.com/oauth-redirect
  • https://vertexaisearch.cloud.google.com/console/oauth/default_oauth.html

Ativar as APIs da Epic

No app, ative as APIs de leitura e pesquisa do R4 para os seguintes recursos do FHIR: Patient, Observation, Condition, MedicationRequest, AllergyIntolerance, DiagnosticReport, DocumentReference, Binary, Encounter, ServiceRequest, Coverage, Immunization e Procedure.

Alguns recursos, como Observation e Condition, têm uma API separada para cada categoria, por exemplo, laboratórios e sinais vitais. Ative as categorias que você quer que os usuários consultem. Não ative as APIs de gravação.

Se uma API não estiver ativada, apenas as ações que a usam vão falhar.

Receber o ID do cliente e a chave secreta do cliente

A Epic emite um ID do cliente de não produção e um ID do cliente de produção para o app. Use o ID do cliente que corresponde ao ambiente da Epic para o qual seus URLs apontam. Como o app é um cliente confidencial, ele também tem uma chave secreta do cliente. Insira o ID do cliente e a chave secreta do cliente ao criar o repositório de dados.

Encontrar seus endpoints da Epic

Para criar o repositório de dados, você precisa de três URLs do seu ambiente Epic: o URL de base do FHIR R4, o URL de autorização e o URL do token. Seu analista da Epic pode fornecê-los. A configuração SMART da sua organização, em FHIR_BASE_URL/.well-known/smart-configuration, também lista o URL de autorização (authorization_endpoint) e o URL do token (token_endpoint). Substitua FHIR_BASE_URL pelo URL de base do FHIR R4.

Insira cada URL com https:// e sem uma barra no final. Por exemplo, o sandbox público da Epic usa os seguintes URLs:

URL Exemplo de sandbox da Epic
URL de base do FHIR R4 https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4
URL de autorização https://fhir.epic.com/interconnect-fhir-oauth/oauth2/authorize
URL do token https://fhir.epic.com/interconnect-fhir-oauth/oauth2/token

Resolver problemas

A tabela a seguir lista problemas comuns e como resolvê-los:

Problema Resolução
O console mostra uma das seguintes mensagens:
  • "O URL do Epic FHIR R4 precisa ser um URL https:// sem uma barra no final."
  • "O URL de autorização da Epic precisa ser um URL https:// sem uma barra no final."
  • "O URL do token do Epic precisa ser um URL https:// sem uma barra no final."
 Insira o URL com https:// e sem uma barra no final.
O console mostra "Falha ao receber token de atualização". No app Epic, selecione Is Confidential Client e Requires Persistent Access e salve as mudanças. Em seguida, no console do Google Cloud , clique em Verificar autenticação novamente.
A Epic informa que o URI de redirecionamento não corresponde. Registre os dois URIs de redirecionamento exatamente como mostrado em Definir os URIs de redirecionamento.
A Epic mostra "Solicitação OAuth 2.0 inválida" durante o login. Cada link de login da Epic funciona apenas uma vez. Portanto, recarregar a janela de login mostra esse erro. Feche a janela e inicie o login novamente sem recarregar. Se o erro persistir, verifique se o app tem as APIs para os escopos solicitados.
O Epic retorna invalid_client. O ID do cliente ou a chave secreta do cliente está incorreto, tem espaços extras ou pertence ao outro ambiente da Epic. Insira o ID do cliente e a chave secreta do cliente para o ambiente para o qual os URLs apontam.
A janela de login não retorna ao Gemini Enterprise ou o conector não é autorizado após o login. Feche a janela de login, atualize o Gemini Enterprise e autorize o conector novamente.
Uma ação falha, e outras funcionam. A API Epic para essa ação não está ativada. Ative-a no app e peça para o usuário autorizar o conector novamente.
O Gemini Enterprise diz "Você não tem permissão para realizar esta operação. Please contact an administrator." para um usuário que já autorizou o conector. A autorização da Epic do usuário terminou. O usuário autoriza o conector novamente.
O Gemini Enterprise não encontra um paciente pelo nome. Adicione a data de nascimento ou use o MRN ou o ID do paciente da Epic.
O Gemini Enterprise diz que alguns registros não puderam ser recuperados. A segurança da Epic retém esses registros do usuário. Os usuários veem apenas os registros que a Epic permite que eles vejam.
O texto de um relatório ou nota não está disponível. O documento é um PDF ou outro formato que o conector não consegue ler. Abra o documento no Epic.
A autorização continua falhando em apenas um app. Remova o repositório de dados do Epic EHR do app, adicione-o novamente e autorize o conector de novo.

A seguir