Usar um esquema personalizado para analisar mensagens HL7v2

Esta página explica como configurar um esquema personalizado para analisar mensagens HL7v2 que não estão em conformidade com o padrão HL7v2.

Se você estiver convertendo mensagens HL7v2 em outro formato, como FHIR ou OMOP, primeiro será necessário analisar e ingerir as mensagens HL7v2 em um armazenamento HL7v2. Use este guia para garantir que você possa analisar e ingerir mensagens HL7v2.

Visão geral

Às vezes, suas mensagens HL7v2 podem não estar em conformidade com os padrões HL7v2. Por exemplo, suas mensagens HL7v2 podem conter segmentos que não estão incluídos no padrão HL7v2 ou que estão fora de ordem. Ao tentar receber mensagens não conformes, você pode encontrar erros.

Para ingerir as mensagens HL7v2 não em conformidade, é necessário modificar o objeto ParserConfig ao criar ou editar um armazenamento HL7v2. Em ParserConfig, é possível configurar a análise esquematizada com base em tipos e segmentos personalizados, determinar como as mensagens HL7v2 rejeitadas são processadas e muito mais.

Antes de configurar ParserConfig, leia as seções a seguir para entender as mensagens HL7v2, as definições de tipo e as definições de grupo.

Mensagens HL7v2

Esta seção oferece uma breve visão geral da estrutura das mensagens HL7v2, que será útil ao configurar o analisador de esquemas personalizado.

As mensagens HL7v2 são baseadas em eventos e descrevem transições de estado e atualizações parciais de registros clínicos. Cada mensagem HL7v2 tem um tipo que define a finalidade dela. Os tipos de mensagem usam um código de três caracteres e são especificados no cabeçalho do segmento principal obrigatório (MSH, na sigla em inglês) da mensagem. Há dezenas de tipos de mensagens, incluindo:

  • ADT: usado para transmitir partes dos dados de administração de pacientes
  • ORU: usado para transmitir resultados de observação
  • ORM: usado para transmitir informações sobre um pedido

Analise a estrutura das mensagens HL7v2, que compreendem segmentos, campos, componentes e subcomponentes:

Figura 1. Diagrama da estrutura de uma mensagem HL7v2.

Na Figura 1, as seguintes partes da mensagem HL7v2 são rotuladas: o segmento, o cabeçalho do segmento, os campos e os componentes.

Por padrão, as mensagens HL7v2 usam os seguintes caracteres para separar informações. É possível substituir os delimitadores, separadores e terminadores de uma mensagem HL7v2 por mensagem no segmento MSH.

  • Terminador de segmento: \r

    Se as mensagens HL7v2 usarem um separador de segmento diferente, consulte o exemplo de terminador de segmento personalizado e campo personalizado.

  • Separador de campo: |

  • Separador de componentes: ^

  • Separador de subcomponentes: &

  • Separador de repetição: ~

  • Caracteres de escape: \

Definições de tipo e grupo

Para entender o analisador de esquemas, é preciso usar definições de tipo e definições de grupo.

Definição de tipo

O termo "tipos" inclui o seguinte:

  • Tipos de segmento HL7v2, como MSH (cabeçalho do segmento de mensagem), DG1 (diagnóstico) e PID (identificação do paciente)

    Para conferir uma lista de todos os tipos de segmento HL7v2, consulte Definições de segmento.

  • Tipos de dados HL7v2, como ST (dados de string), TS (carimbo de data/hora) e SI (ID da sequência)

    Para conferir uma lista de todos os tipos de dados padrão do HL7v2, consulte Tipos de dados.

Especifique os tipos no campo name dentro do objeto Type.

Os tipos usam um formato modular que consiste em um segmento e os campos, componentes e subcomponentes dele. As informações em um objeto Type indicam como analisar ou interpretar um segmento e respondem a perguntas como esta:

  • Quais campos estão no segmento?
  • Quais são os tipos de dados dos campos?

O exemplo a seguir mostra a definição de tipo de um segmento ZCD personalizado:

{
  "type": {
    "name": "ZCD", // Segment type
    "fields": [
      {
        "name": "1",
        "type": "ST", // Primitive string data type
        "minOccurs": 1, // Must occur at least once
        "maxOccurs": 1 // Not repeated, because it can only occur once
      },
      {
        "name": "2",
        "type": "A", // Custom data type
        "minOccurs": 1 // Repeated, because maxOccurs is not defined
      }
    ]
  }
}

Neste exemplo, o segmento ZCD contém dois campos, chamados 1 e 2. O tipo de dados de 1 é ST, que é um tipo de dados de string primitivo. O tipo de dados de 2 é A, que é um tipo de dados personalizado.

A definição de tipo a seguir para o tipo de dados personalizado A mostra que ele também contém outro tipo de dados personalizado, chamado B.

{
  "type": {
    "name": "A", // Custom data type
    "fields": [
      {
        "name": "1",
        "type": "ST", // Primitive string data type
        "minOccurs": 1, // Must occur at least once
        "maxOccurs": 1 // Not repeated, because it can only occur once
      },
      {
        "name": "2",
        "type": "B", // Custom data type
        "minOccurs": 1,
        "maxOccurs": 1
      }
    ]
  }
}

O exemplo a seguir mostra a definição de tipo do tipo de dados personalizados B, que tem um campo chamado 1 com o tipo de dados ST e um campo chamado 2 com um tipo de dados de ST repetido:

{
  "type": {
    "name": "B", // Custom data type
    "fields": [
      {
        "name": "1",
        "type": "ST", // Primitive string data type
        "minOccurs": 1, // Must occur at least once
        "maxOccurs": 1 // Not repeated, because it can only occur once
      },
      {
        "name": "2",
        "type": "ST"
        "minOccurs": 1,
        "maxOccurs": 1
      }
    ]
  }
}

Sabendo as informações sobre o segmento e os tipos de dados, é possível estimar a aparência do segmento ZCD na mensagem HL7v2 original. Este exemplo mostra a mensagem HL7v2 com o campo A repetido uma vez, o que é permitido porque maxOccurs não está definido no campo A:

ZCD|ZCD_field_1|A_field_1^B_component_1&B_component_2_repetition_1~A_field_1^B_component_1&B_component_2_repetition_2
Figura 2. Diagrama de uma definição de tipo.

Na Figura 2, as seguintes partes da definição de tipo são identificadas: o segmento, o cabeçalho do segmento, os campos, os componentes, os subcomponentes e as repetições.

Definição do grupo

Os grupos são definidos no nível do segmento e fornecem informações sobre quais tipos de segmentos podem aparecer em cada mensagem HL7v2.

Especifique grupos na matriz groups dentro do objeto GroupOrSegment.

Considere o seguinte snippet de uma estrutura de grupo para uma mensagem HL7v2 ADT_A01:

  • O primeiro segment na matriz members é MSH (cabeçalho do segmento de mensagem), porque MSH é obrigatório em todas as mensagens HL7v2.

  • Um group chamado Group 1.

    Esse grupo só pode ocorrer no máximo 2 vezes e contém o segmento ZCD personalizado.

    Normalmente, um group contém vários segmentos aninhados e outros grupos agrupados de forma lógica, mas, neste exemplo, o Group 1 contém apenas um segmento: ZCD.

{
  "ADT_A01": {
    "members": [
      {
        "segment": {
          "type": "MSH"
        }
      },
      {
        "group": {
          "name": "Group 1",
          "minOccurs": 1,
          "maxOccurs": "2",
          "members": [
            {
              "segment": {
                "type": "ZCD"
              }
            }
          ]
        }
      }
    ]
  }
}

Sabendo as informações sobre os grupos, você pode estimar como a mensagem HL7v2 original vai ficar se ZCD ocorrer duas vezes na mensagem HL7v2, o que é permitido porque maxOccurs em Group 1 está definido como 2. O restante do segmento ZCD é desconhecido sem saber a definição do tipo.

MSH|^~\&|||||20100308000000||ADT^A01|23701|1|2.3||
ZCD|ZCD_CONTENT
ZCD|ZCD_CONTENT
Figura 3. Diagrama de uma definição de grupo.

Na Figura 3, as seguintes partes da definição do grupo são identificadas: o segmento e o cabeçalho do segmento.

Configurar um esquema personalizado em um repositório HL7v2

As seções a seguir explicam os componentes de um esquema personalizado e como configurar o esquema em uma loja HL7v2.

Configuração do tipo de armazenamento HL7v2

Depois de entender a definição de tipo de uma mensagem HL7v2, você pode especificar uma configuração de tipo em um armazenamento HL7v2. Para especificar a configuração, adicione uma matriz de types e uma matriz de version.

O exemplo a seguir mostra como especificar a configuração para os tipos mostrados na definição do tipo em um armazenamento HL7v2.

A configuração usa a matriz version para especificar os campos mshField e value. Esses campos correspondem a campos e componentes no segmento MSH.

A matriz types especificada se aplica apenas a mensagens que têm um segmento MSH que corresponde aos valores de mshField e value na matriz version. Isso permite que você ingira mensagens HL7v2 com versões diferentes na mesma loja HL7v2.

{
  "types": [
    {
      "version": [
        {
          "mshField": "12",
          "value": "2.3"
        }
      ],
      "type": [
        {
          "name": "ZCD", // Segment type
          "fields": [
            {
              "name": "1",
              "type": "ST",
              "minOccurs": 1,
              "maxOccurs": 1
            },
            {
              "name": "2",
              "type": "A",
              "minOccurs": 1
            }
          ]
        },
        {
          "name": "A", // Data type
          "fields": [
            {
              "name": "1",
              "type": "ST",
              "minOccurs": 1,
              "maxOccurs": 1
            },
            {
              "name": "2",
              "type": "B",
              "minOccurs": 1,
              "maxOccurs": 1
            }
          ]
        },
        {
          "name": "B", // Data type
          "fields": [
            {
              "name": "1",
              "type": "ST",
              "minOccurs": 1,
              "maxOccurs": 1
            },
            {
              "name": "2",
              "type": "ST"
            }
          ]
        }
      ]
    }
  ]
}

Configuração do grupo de armazenamento HL7v2

Você pode usar grupos para configurar uma estrutura aninhada no nível de uma "filiação". Os grupos são especificados em uma matriz members no nível do segmento. A estrutura de um segmento é previsível e normalmente contém campos, componentes e subcomponentes, mas o segmento em si pode estar em qualquer nível da mensagem HL7v2.

Assim como uma configuração de tipo, uma configuração de grupo usa um filtro version para processar mensagens HL7v2 com versões diferentes na mesma loja HL7v2.

O exemplo a seguir mostra como especificar a configuração do grupo exibido em Definição do grupo em uma loja HL7v2:

{
  "version": [
    {
      "mshField": "12",
      "value": "2.3"
    }
  ],
  "messageSchemaConfigs": {
    "ADT_A01": {
      "members": [
        {
          "segment": {
            "type": "MSH"
          }
        },
        {
          "group": {
            "name": "Group 1",
            "maxOccurs": "2",
            "members": [
              "segment": {
                "type": "ZCD"
              }
            ]
          }
        }
      ]
    }
  }
}

Concluir a configuração do repositório HL7v2

Ao combinar a configuração do tipo e a configuração do grupo, é possível determinar como será a configuração completa do esquema personalizado na loja HL7v2. Também é possível determinar que o esquema personalizado corresponde a uma mensagem HL7v2 semelhante a esta:

MSH|^~\&|||||20100101000000||ADT^A01^A01|23701|1|2.3||
ZCD|ZCD_field_1|A_field_1^B_component_1&B_component_2_repetition_1~A_field_1^B_component_1&B_component_2_repetition_2

Abra a seção a seguir para conferir o esquema personalizado completo no armazenamento HL7v2 e continue a criar um armazenamento HL7v2 que use o esquema personalizado:

Abrir

{
  "parserConfig": {
    "schema": {
      "schemas": [
        {
          "version": [
            {
              "mshField": "12",
              "value": "2.3"
            }
          ],
          "messageSchemaConfigs": {
            "ADT_A01": {
              "name": "ADT_A01",
              "members": [
                {
                  "segment": {
                    "type": "MSH",
                    "minOccurs": 1,
                    "maxOccurs": 1
                  }
                },
                {
                  "group": {
                    "name": "Group 1",
                    "minOccurs": 1,
                    "maxOccurs": "2",
                    "members": [
                      {
                        "segment": {
                          "type": "ZCD"
                        }
                      }
                    ]
                  }
                }
              ]
            }
          }
        }
      ],
      "types": [
        {
          "version": [
            {
              "mshField": "12",
              "value": "2.3"
            }
          ],
          "type": [
            {
              "name": "ZCD", // Segment type
              "fields": [
                {
                  "name": "1",
                  "type": "ST",
                  "minOccurs": 1,
                  "maxOccurs": 1
                },
                {
                  "name": "2",
                  "type": "A"
                  "minOccurs": 1,
                  "maxOccurs": 1
                }
              ]
            },
            {
              "name": "A", // Data type
              "fields": [
                {
                  "name": "1",
                  "type": "ST"
                  "minOccurs": 1,
                  "maxOccurs": 1
                },
                {
                  "name": "2",
                  "type": "B"
                  "minOccurs": 1,
                  "maxOccurs": 1
                }
              ]
            },
            {
              "name": "B", // Data type
              "fields": [
                {
                  "name": "1",
                  "type": "ST"
                  "minOccurs": 1,
                  "maxOccurs": 1
                },
                {
                  "name": "2",
                  "type": "ST"
                  "minOccurs": 1
                }
              ]
            }
          ]
        }
      ]
    },
    "version": "V3"
  }
}

Criar um armazenamento HL7v2 com o esquema personalizado

Para criar um armazenamento HL7v2 que use o esquema personalizado completo, conclua esta seção.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do seu projeto do Google Cloud;
  • LOCATION: o local do conjunto de dados;
  • DATASET_ID: o conjunto de dados pai da loja HL7v2
  • HL7V2_STORE_ID: o ID do repositório HL7v2

Corpo JSON da solicitação:

{
  "parserConfig": {
    "schema": {
      "schemas": [
        {
          "version": [
            {
              "mshField": "12",
              "value": "2.3"
            }
          ],
          "messageSchemaConfigs": {
            "ADT_A01": {
              "name": "ADT_A01",
              "members": [
                {
                  "segment": {
                    "type": "MSH",
                    "minOccurs": 1
                  }
                },
                {
                  "group": {
                    "name": "Group 1",
                    "minOccurs": 1,
                    "members": [
                      {
                        "segment": {
                          "type": "ZCD"
                        }
                      }
                    ]
                  }
                }
              ]
            }
          }
        }
      ],
      "types": [
        {
          "version": [
            {
              "mshField": "12",
              "value": "2.3"
            }
          ],
          "type": [
            {
              "name": "ZCD",
              "fields": [
                {
                  "name": "1",
                  "type": "ST",
                  "minOccurs": 1,
                  "maxOccurs": 1
                },
                {
                  "name": "2",
                  "type": "A",
                  "minOccurs": 1
                }
              ]
            },
            {
              "name": "A",
              "fields": [
                {
                  "name": "1",
                  "type": "ST",
                  "minOccurs": 1,
                  "maxOccurs": 1
                },
                {
                  "name": "2",
                  "type": "B",
                  "minOccurs": 1,
                  "maxOccurs": 1
                }
              ]
            },
            {
              "name": "B",
              "fields": [
                {
                  "name": "1",
                  "type": "ST",
                  "minOccurs": 1,
                  "maxOccurs": 1
                },
                {
                  "name": "2",
                  "type": "ST",
                  "minOccurs": 1,
                  "maxOccurs": 1
                }
              ]
            }
          ]
        }
      ]
    },
    "version": "V3"
  }
}

Para enviar a solicitação, escolha uma destas opções:

curl

Salve o corpo da solicitação em um arquivo chamado request.json. Execute o comando a seguir no terminal para criar ou substituir esse arquivo no diretório atual: 

cat > request.json << 'EOF'
{
  "parserConfig": {
    "schema": {
      "schemas": [
        {
          "version": [
            {
              "mshField": "12",
              "value": "2.3"
            }
          ],
          "messageSchemaConfigs": {
            "ADT_A01": {
              "name": "ADT_A01",
              "members": [
                {
                  "segment": {
                    "type": "MSH",
                    "minOccurs": 1
                  }
                },
                {
                  "group": {
                    "name": "Group 1",
                    "minOccurs": 1,
                    "members": [
                      {
                        "segment": {
                          "type": "ZCD"
                        }
                      }
                    ]
                  }
                }
              ]
            }
          }
        }
      ],
      "types": [
        {
          "version": [
            {
              "mshField": "12",
              "value": "2.3"
            }
          ],
          "type": [
            {
              "name": "ZCD",
              "fields": [
                {
                  "name": "1",
                  "type": "ST",
                  "minOccurs": 1,
                  "maxOccurs": 1
                },
                {
                  "name": "2",
                  "type": "A",
                  "minOccurs": 1
                }
              ]
            },
            {
              "name": "A",
              "fields": [
                {
                  "name": "1",
                  "type": "ST",
                  "minOccurs": 1,
                  "maxOccurs": 1
                },
                {
                  "name": "2",
                  "type": "B",
                  "minOccurs": 1,
                  "maxOccurs": 1
                }
              ]
            },
            {
              "name": "B",
              "fields": [
                {
                  "name": "1",
                  "type": "ST",
                  "minOccurs": 1,
                  "maxOccurs": 1
                },
                {
                  "name": "2",
                  "type": "ST",
                  "minOccurs": 1,
                  "maxOccurs": 1
                }
              ]
            }
          ]
        }
      ]
    },
    "version": "V3"
  }
}
EOF

Depois execute o comando a seguir para enviar a solicitação REST: 

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores?hl7V2StoreId=HL7V2_STORE_ID"

PowerShell

Salve o corpo da solicitação em um arquivo chamado request.json. Execute o comando a seguir no terminal para criar ou substituir esse arquivo no diretório atual: 

@'
{
  "parserConfig": {
    "schema": {
      "schemas": [
        {
          "version": [
            {
              "mshField": "12",
              "value": "2.3"
            }
          ],
          "messageSchemaConfigs": {
            "ADT_A01": {
              "name": "ADT_A01",
              "members": [
                {
                  "segment": {
                    "type": "MSH",
                    "minOccurs": 1
                  }
                },
                {
                  "group": {
                    "name": "Group 1",
                    "minOccurs": 1,
                    "members": [
                      {
                        "segment": {
                          "type": "ZCD"
                        }
                      }
                    ]
                  }
                }
              ]
            }
          }
        }
      ],
      "types": [
        {
          "version": [
            {
              "mshField": "12",
              "value": "2.3"
            }
          ],
          "type": [
            {
              "name": "ZCD",
              "fields": [
                {
                  "name": "1",
                  "type": "ST",
                  "minOccurs": 1,
                  "maxOccurs": 1
                },
                {
                  "name": "2",
                  "type": "A",
                  "minOccurs": 1
                }
              ]
            },
            {
              "name": "A",
              "fields": [
                {
                  "name": "1",
                  "type": "ST",
                  "minOccurs": 1,
                  "maxOccurs": 1
                },
                {
                  "name": "2",
                  "type": "B",
                  "minOccurs": 1,
                  "maxOccurs": 1
                }
              ]
            },
            {
              "name": "B",
              "fields": [
                {
                  "name": "1",
                  "type": "ST",
                  "minOccurs": 1,
                  "maxOccurs": 1
                },
                {
                  "name": "2",
                  "type": "ST",
                  "minOccurs": 1,
                  "maxOccurs": 1
                }
              ]
            }
          ]
        }
      ]
    },
    "version": "V3"
  }
}
'@  | Out-File -FilePath request.json -Encoding utf8

Depois execute o comando a seguir para enviar a solicitação REST: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores?hl7V2StoreId=HL7V2_STORE_ID" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

Faça a ingestão e análise da mensagem HL7v2 usando o esquema personalizado

Para ingerir uma versão codificada em base64 da mensagem HL7v2, conclua esta seção.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: é o ID do projeto do Google Cloud.
  • LOCATION: o local do conjunto de dados pai
  • DATASET_ID: o conjunto de dados pai da loja HL7v2
  • HL7V2_STORE_ID: o ID do repositório HL7v2

Corpo JSON da solicitação:

{
  "message": {
    "data": "TVNIfF5+XCZ8fHx8fDIwMTAwMTAxMDAwMDAwfHxBRFReQTAxXkEwMXwyMzcwMXwxfDIuM3x8DVpDRHxaQ0RfZmllbGRfMXxBX2ZpZWxkXzJeQl9jb21wb25lbnRfMSZCX2NvbXBvbmVudF8yX3JlcGV0aXRpb25fMX5BX2ZpZWxkXzJeQl9jb21wb25lbnRfMSZCX2NvbXBvbmVudF8yX3JlcGV0aXRpb25fMQ=="
  }
}

Para enviar a solicitação, escolha uma destas opções:

curl

Salve o corpo da solicitação em um arquivo chamado request.json. Execute o comando a seguir no terminal para criar ou substituir esse arquivo no diretório atual: 

cat > request.json << 'EOF'
{
  "message": {
    "data": "TVNIfF5+XCZ8fHx8fDIwMTAwMTAxMDAwMDAwfHxBRFReQTAxXkEwMXwyMzcwMXwxfDIuM3x8DVpDRHxaQ0RfZmllbGRfMXxBX2ZpZWxkXzJeQl9jb21wb25lbnRfMSZCX2NvbXBvbmVudF8yX3JlcGV0aXRpb25fMX5BX2ZpZWxkXzJeQl9jb21wb25lbnRfMSZCX2NvbXBvbmVudF8yX3JlcGV0aXRpb25fMQ=="
  }
}
EOF

Depois execute o comando a seguir para enviar a solicitação REST: 

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages:ingest"

PowerShell

Salve o corpo da solicitação em um arquivo chamado request.json. Execute o comando a seguir no terminal para criar ou substituir esse arquivo no diretório atual: 

@'
{
  "message": {
    "data": "TVNIfF5+XCZ8fHx8fDIwMTAwMTAxMDAwMDAwfHxBRFReQTAxXkEwMXwyMzcwMXwxfDIuM3x8DVpDRHxaQ0RfZmllbGRfMXxBX2ZpZWxkXzJeQl9jb21wb25lbnRfMSZCX2NvbXBvbmVudF8yX3JlcGV0aXRpb25fMX5BX2ZpZWxkXzJeQl9jb21wb25lbnRfMSZCX2NvbXBvbmVudF8yX3JlcGV0aXRpb25fMQ=="
  }
}
'@  | Out-File -FilePath request.json -Encoding utf8

Depois execute o comando a seguir para enviar a solicitação REST: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages:ingest" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

Determinar a cardinalidade do campo

É possível determinar a cardinalidade de um campo em uma mensagem HL7v2 definindo os seguintes campos na loja HL7v2:

  • minOccurs: determina o número mínimo de vezes que um grupo, segmento, campo, componente ou subcomponente precisa estar presente ou ser repetido nas mensagens HL7v2 recebidas.
  • maxOccurs: determina o número máximo de vezes que um grupo, segmento, campo, componente ou subcomponente pode estar presente ou ser repetido nas mensagens HL7v2 recebidas

Ignorar elementos ausentes

Defina ignoreMinOccurs como true se quiser que a API HL7v2 aceite todas as mensagens HL7v2 recebidas, independentemente dos elementos ausentes. Isso significa que uma mensagem não será rejeitada se estiver faltando grupos, segmentos, campos, componentes ou subcomponentes obrigatórios.

Se você não conseguir ingerir mensagens HL7v2 porque elas não têm campos obrigatórios, recomendamos definir ignoreMinOccurs como true.

Tipo de campo curinga

O caractere curinga, *, é um tipo especial usado para campos. O uso de * indica ao parser HL7v2 que o campo precisa ser analisado com base na estrutura da mensagem HL7v2. O uso de * no lugar de um valor para um campo é útil quando você não quer aplicar um tipo de dados de campo rígido. Contanto que o conteúdo no campo siga o padrão HL7v2, a API Cloud Healthcare poderá analisar a mensagem HL7v2.

Por exemplo, considere a seguinte definição de tipo. O campo 2 usa um caractere curinga em vez de um tipo de dados de campo. A definição é equivalente à primeira definição em Definição de tipo e não exige que você especifique os tipos A e B:

"type": {
  "name": "ZCD"
  "fields": [
    {
      "name": "1",
      "type": "ST"
    },
    {
      "name": "2",
      "type": "*"
    }
  ]
}

A seguir

Saiba mais sobre como configurar analisadores de esquemas personalizados com Exemplos de analisadores de esquemas personalizados.