Metadados do domínio do conector

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 2 min. de leitura
  • Substitua os valores de metadados de domínio padrão do conector push instalados com Gestão de eventos pelos valores na solicitação HTTP do evento, incluindo URL, cabeçalhos, corpo da solicitação (carga útil) e parâmetros do conector. Substitua os valores de metadados do domínio do conector de extração somente por parâmetros do conector.

    Parâmetros de metadados do domínio

    Nome Descrição Substitui a propriedade do sistema
    connectorDomainInfoTableName Nome da tabela que contém os registros com as informações de domínio. evt_mgmt.connector_domain_info_table_name
    • Tipo: cadeia de caracteres
    • Valor padrão: core_company
    connectorDomainInfoColumnName Nome da coluna que tem um valor que deve ser correspondido com o identificador do domínio. Por exemplo, talvez você queira identificar um registro na tabela Informações do domínio que tenha um valor correspondente no campo company_name. evt_mgmt.connector_domain_info_column_name
    • Tipo: cadeia de caracteres
    • Valor padrão: nome
    connectorDomainIdColumnName Nome da coluna da tabela que armazena o ID do domínio. evt_mgmt.connector_domain_id_column_name
    • Tipo: cadeia de caracteres
    • Valor padrão: sys_domain
    connectorDomainPathColumnName Nome da coluna da tabela que armazena o caminho do domínio. evt_mgmt.connector_domain_path_column_name
    • Tipo: cadeia de caracteres
    • Valor padrão: sys_domain_path

    Ordem de preferência para acessar metadados de domínio

    Você deve fornecer metadados de domínio para configurar domínios de conector push personalizados. Os metadados na ordem preferencial de acesso são:
    1. Parâmetros do conector push
    2. Parâmetros de consulta de URL
    3. Cabeçalhos HTTP
    4. Corpo da solicitação (carga)
    5. Propriedades do sistema padrão

    Parâmetros de consulta de URL

    Os conectores push têm a seguinte sintaxe de URL:

    • Tipo de instância: https://<instance-name> .service-now.com/api/sn_em_connector/em/inbound_event?source=<connector-source>
    • MID Server tipo: http://<MID_Server_IP> :<MID_Web_Server_Port> /api/mid/em/inbound_event?Transform=<connector-transform-script-name>

    Você pode incluir metadados de domínio como parâmetros de consulta adicionais na URL do webhook do conector push ServiceNow. Por exemplo, se a fonte de informações do domínio for a tabela sys_user, a URL poderá ser https://<instance-name> .service-now.com/api/sn_em_connector/em/inbound_event?source=<connector-source> &connectorDomainInfoTableName=sys_user

    Cabeçalhos da solicitação

    Qualquer uma das propriedades de metadados de domínio pode ser passada como parte dos cabeçalhos de solicitação HTTP. Verifique a documentação da ferramenta de monitoramento de terceiros para obter informações sobre como os cabeçalhos de solicitação são definidos.

    Corpo da solicitação (carga)

    Você pode fazer referência a metadados de domínio do corpo da solicitação (carga JSON) definindo os parâmetros de metadados como chaves de nível raiz na carga útil. O exemplo a seguir mostra como os parâmetros connectorDomainInfoTableName e connectorDomainInfoColumnName podem ser passados como parte do corpo da solicitação:
    {
    “origem”: “Azure Monitor”,
    “host”: “127.0.0.1”,
    “empresa”: “ServiceNow”,
    “connectorDomainInfoTableName”: “sys_user”,
    “connectorDomainInfoColumnName”: “first_name”
    }
    Nota:
    Para obter informações sobre os parâmetros do conector, consulte Personalizar domínios para eventos do conector push usarem na criação de eventos.