-
Qualtrics Platform -
Customer Journey Optimizer -
XM Discover -
Qualtrics Social Connect
Extensão Health Connect
Sobre o Health Connect
Com o Health Connect, você pode garantir que as informações do paciente em seu sistema de Registro Médico Eletrônico (EMR) sejam sincronizadas com o Qualtrics Diretório XM. Com as informações administrativas e dos pacientes mantidas constantemente atualizadas em seu diretório, você garante a inclusão das informações mais importantes nos resultados suas pesquisa, nos painéis de controle e no programa geral de experiência do paciente Qualtrics. Health Connect usa o padrão de mensagens Health Nível Seven (HL7) para a transmissão de dados clínicos e administrativos.
Depois que Health Connect tiver sido adicionado à sua licença, todos os usuários precisarão do tipo de usuário Administrador Marca para editar ou criar conexões Health Connect.
Informações necessárias para a integração do Rhapsody
Seu especialista em implementação Qualtrics ajudará a integrar Health Connect ao Rhapsody. O Rhapsody precisará das seguintes informações:
- Pontos de extremidade: Endpoints Health Connect para os diretórios de teste e de produção (consulte Criação de novas conexões e endpoints).
- Token OAuth: Um token OAuth da mesma conta de usuário Qualtrics em que a conexão é criada (consulte Gerando um token API)
- Tipo de conexão: Que tipo de conexão segura você gostaria de usar para conectar seu EMR ao Rhapsody. Seu especialista em implementação pode fornecer mais informações sobre os possíveis tipos de conexão.
- Tipos evento HL7: Todos os tipos evento que você planeja usar. Health Connect é compatível com dois feeds evento HL7: ADT e SIU. Em cada um desses feeds, há alguns tipos evento compatíveis.
Eventos ADT (admissão, alta, transferência)
O tipo de evento ADT rastreia o lifecycle administrativo de um paciente em uma instituição de saúde, como alterações nos dados demográficos, no seguro, no status administrativo ou na localização física do paciente (leito/quarto). As mensagens do ADT são importantes para garantir que as principais informações do paciente sejam consistentes em todo o sistema de manutenção de registros do hospital.
Os tipos de segmentos de dados que você veria em uma mensagem ADT podem incluir Identificação do paciente (PID), Informações da visita (PV1), Parentes Avançar (NK1), Diagnóstico (DG1) e Seguro (IN1).
Oferecemos suporte apenas aos seguintes tipos evento ADT:
- ADT^A01: Admissão do paciente/visita ao paciente internado
- ADT^A02: Transferência de pacientes
- ADT^A03: Alta do paciente
- ADT^A04: Registro de paciente (ambulatorial)
- ADT^A08: Atualizar informações do paciente
Eventos SIU (Informações de programação não solicitadas)
Os eventos SIU detalham a criação, alteração ou cancelamento da consulta de um paciente ou a reserva de um recurso (como uma sala de cirurgia ou um equipamento). As mensagens SIU são importantes para garantir que todos os sistemas de agendamento e calendários tenham informações correspondentes e atualizadas.
Os tipos de segmentos de dados que você veria em uma mensagem SIU podem incluir Identificação do Paciente (PID), Informações de Atividade de Agendamento (SCH) e Grupos de Recursos de Agendamento (RGS, AIG, AIL, AIP).
Oferecemos suporte apenas aos seguintes tipos evento SIU:
- SIU^S12: Notificação de marcação de nova consulta
- SIU^S14: Notificação de modificação de nomeação
Configuração Diretório XM
Com cada conexão EMR que você cria no Health Connect, é possível diferenciar entre um ambiente de teste e de produção. Ao criar um diretório para cada um, você pode testar mais facilmente sua configuração, garantindo que apenas as configurações de campo mais completas sejam enviadas ao vivo para seus programas Qualtrics.
- Criação de Diretório : Crie um diretório para os dados de teste e um segundo diretório para a produção.
- Criação de função: Certifique-se de que haja uma função para cada diretório que permita o acesso de administrador. Adicione-se a ambas as funções.
- Resolução de identidade: Para cada um dos dois diretórios, certifique-se de que os novos contatos duplicar sejam mesclados automaticamente com base na Referência de dados externos.
Depois que Diretório XM tiver sido configurado, você poderá criar uma nova conexão na página da extensão Health Connect.
Gerenciando a extensão Health Connect
- Ir para Admin.
- Vá para Extensões.
Qdica: talvez você precise clicar em More (Mais ) para ver a opção Extensions (Extensões). - Pesquise e selecione Health Connect.
- Vá para Mapeamento de dados.
- Para iniciar uma nova conexão, clique em New connection (Nova conexão).
- Para editar o nome de uma conexão existente, visualizar seus endpoints ou excluí-la, clique no nome da conexão.
Qdica: você também pode editar os detalhes de uma conexão selecionando os três pontos e escolhendo Editar conexão.
- Para editar o mapeamento de dados, selecione os links Testing (Teste ) ou Production (Produção ).
Qdica: você também pode editar o mapeamento de dados clicando nos três pontos e escolhendo Editar mapeamento.
Novas conexões e pontos de extremidade
- Dê um nome à sua conexão.
- Adicione uma descrição opcional.
- Defina o diretório de teste.
- Defina o diretório de produção. (Esse é o diretório que você planeja usar com programas ao vivo).
- Clique em Criar conexão.
- Dois endpoints serão gerados para você: um para o diretório de produção e outro para o diretório de teste.
- Quando você estiver pronto para sair da página, clique em Concluído.
Você também pode clicar nos três pontos ao avançar do nome da conexão (não no teste e na produção aninhados) e selecionar Editar conexão.
Mapeamento de dados para o Health Connect
Os pontos de extremidade para o ambiente de teste e o ambiente de produção são mapeados separadamente.
- Clique nos três pontos avançar de seu ambiente de teste ou produção .
- Clique em Edit Mapping (Editar mapeamento).
- Você verá os feeds do ADT e do SIU. Avançar do feed que você deseja mapear, selecione Editar mapeamento.
- Use os filtros para ajustar os tipos de mensagens JSON que você deseja ver. Veja mais nesta seção abaixo.
- Selecione o tipo de mapeamento de campo que você deseja editar:
- Campos obrigatórios: Campos necessários para que o feed do ADT ou SIU funcione. Se os campos obrigatórios estiverem faltando, a mensagem falhará e as informações do seu EMR não serão atualizadas no Qualtrics.
- Campos opcionais: Campos que não são obrigatórios, mas que já vêm mapeados na extensão (por exemplo, FIRST_NAME, VISIT_DATE).
- Campos derivados: Campos calculados automaticamente pela extensão (por exemplo, AGE, LENGTH_OF_STAY).
- Campos personalizados: Novos campos que você cria para mapear dados específicos que não são cobertos por campos obrigatórios, opcionais ou derivados.
- Cada tipo de segmento é representado por um cabeçalho. Em cada segmento, você verá campos individuais.
Qdica: para saber mais sobre segmentos, consulte a documentação do HL7.
- Para cada campo, você verá:
- nome do campo Qualtrics: como o campo é chamado no Diretório XM e em quaisquer pesquisas ou painéis conectados.
- Expressão de caminho JSON ou valor personalizado: Você pode definir o valor de um campo usando JSON ou inserindo um valor personalizado.
- Expressão de caminho JSON: Define de onde extrair as informações de uma mensagem JSON. Deve começar com um $.
- Valor personalizado: Um valor estático/codificado por hardware.
- Valor: À medida que você extrai dados amostra, essa coluna mostra o valor extraído para o evento de exemplo selecionado.
Exemplo: Se você estiver examinando o campo “FIRST_NAME”, o valor pode ser “Maria”Qdica: Os valores dos campos derivados não podem ser editados, pois são calculados automaticamente pelo Qualtrics.
- Na guia Campos personalizados, você pode clicar em Adicionar campo personalizado na parte inferior para adicionar campos totalmente novos.
Qdica: defina um nome para seu novo campo, como ele deve aparecer no Qualtrics, e o caminho JSON do qual ele deve derivar seu valor ou um valor codificado. A partir daí, você pode até mesmo adicionar transformações. - Quando todo o mapeamento estiver concluído, clique em Save (Salvar).
- Para que um tipo de evento esteja ativo no programa e faça upload de dados para o Diretório XM, certifique-se de que ele também esteja ativado.
Usando dados JSON amostra, essa nova janela mostrará qual valor foi extraído com base na expressão que você inseriu.
Transformações de dados
Atenção: Alguns recursos do mapeador não estarão disponíveis até que a primeira mensagem HL7 tenha sido enviada ao Qualtrics. Quando uma mensagem aparecer na visualização do JSON, todos os recursos estarão disponíveis.
Transformar dados é reformatá-los ou recodificá-los para que se ajustem a um formato mais legível e fácil de usar quando forem salvos no Qualtrics.
Tipos de transformação e exemplos
| Transformação | Descrição | Exemplo |
| Extrair da matriz (posição) | Extrai um elemento de uma matriz usando sua posição numérica (índice). Útil quando você deseja um elemento específico dos dados da matriz. | [“apple”, “banana”, “cherry”]
Extract array (posição = 2) seria “cherry”. |
| Extrair da matriz (propriedade) | Filtra a matriz atual para objetos em que a propriedade selecionada é igual a um valor especificado. Se nenhum elemento corresponder, ele será “null” | [{“firstName”: “Alice”, “lastName”: “Smith”}, {“firstName”: “Bob”, “lastName”: “Hopkins”}, {“firstName”: “Carol”, “lastName”: “Jones”}]
  ;A matriz de extrato (“firstName” = “Carol”) seria [{“firstName”: “Carol”, “lastName”: “Jones”}] |
| Concatenar valores | Combina vários valores de cadeia de caracteres de ponta a ponta com delimitadores entre eles (como espaços ou vírgulas). Usado para criar nomes completos, endereços ou combinar campos de dados. | Se os valores forem: “John”, “Doe”
Eles seriam concatenados em “John Doe” |
| Letras maiúsculas e minúsculas | Converte uma cadeia de caracteres para que a primeira letra de cada palavra seja maiúscula e as demais sejam minúsculas. Ajuda a padronizar nomes, títulos ou rótulos. | “the quick BROWN fox” (a rápida raposa marrom) se tornaria “The Quick Brown Fox” (a rápida raposa marrom). |
Adição de transformações
- Avançar do campo que você deseja transformar, clique nos três pontos e, em seguida, em Editar campo.
- Clique em Add Transformation (Adicionar transformação).
- Escolha entre os tipos de transformação disponíveis e configure-os da seguinte forma:
- Extrair matriz (posição): A partir de 0, insira a posição da matriz que você deseja extrair. Se desejar, você também pode extrair uma propriedade específica.
- Extrair matriz (propriedade): Selecione uma propriedade exata que você deseja extrair e defina-a como igual a um valor específico que você deseja destino. Se desejar, você também pode extrair uma propriedade específica.
- Concatenar valores: Em geral, o formato será propriedade, texto estático e, em seguida, propriedade. A propriedade é o valor específico entre a matriz que você deseja extrair, e “static text” refere-se ao delimitador pelo qual você deseja separá-los. Para usar um espaço em vez de um delimitador, você pode excluir completamente o “texto estático”.
- Caso de título: Não são necessárias etapas adicionais.
- Extrair matriz (posição): A partir de 0, insira a posição da matriz que você deseja extrair. Se desejar, você também pode extrair uma propriedade específica.
- Use os dados amostra à direita para garantir que está obtendo os resultados desejados.
- Quando terminar de fazer as alterações, clique em Save (Salvar).
Visualização de transformações existentes
Se um campo tiver uma transformação aplicada, ele será resumido por seu tipo de transformação logo abaixo do campo.
Você também pode visualizar e editar as transformações existentes na janela Editar campo.
Visualização de amostras de mensagens JSON
Uma vez que seu EMR tenha sido conectado ao Qualtrics usando o Rhapsody, as mensagens do seu sistema EMR aparecerão no lado direito da tela em um formato JSON.
O filtro tipo de evento e o filtro avançado podem ser usados para restringir as mensagens específicas que você deseja ver.
- Tipo de evento: Escolha qualquer um dos tipos evento para ver o conteúdo JSON bruto à direita.
- Filtro avançado: Crie filtros avançados para encontrar mensagens passadas transmitidas de seu EMR para o Qualtrics, com base nas informações que elas contêm. Filtro por campo Qualtrics ou por expressões de caminho JSON.
Navegue pelas mensagens recebidas recentemente usando os botões de amostra anterior e amostra avançar na parte superior.
Exemplos de expressões de caminho JSON
A tabela abaixo contém alguns exemplos de expressões de caminho JSON que você pode usar em filtros avançados.
| Campo | Caminho JSON | Caso de uso |
| MESSAGE_CONTROL_ID | $.content.MSH.10_messageControlId | Esse é o ID exclusivo de uma mensagem HL7 específica. |
| VISIT_ID | $.content.PATIENT[0].PV1[0].19_visitNumber.19_1_id | Também conhecido como número de série Contato (CSN). |
| UNIT_ID | $.content.PV1[0].3_assignedPatientLocation.3_1_pointOfCare | Isso também é conhecido como ID do departamento. |
Qdica: os filtros são criados usando condições “qualquer/todos” que podem ser separadas em vários conjuntos. Para obter instruções gerais não específicas do Health Connect, consulte:
Exclusão de uma conexão
- Clique no nome da conexão.
- Selecione Excluir conexão.
- Confirmar Excluir conexão.