Metadados do domínio do conector

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • Substitua os valores de metadados de domínio padrão do conector de push instalados com Gestão de eventos Com os valores na solicitação HTTP do evento, incluindo URL, cabeçalhos, corpo da solicitação (carga) e parâmetros do conector. Substituir valores de metadados de 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 ao identificador de domínio. Por exemplo, você pode querer identificar um registro na tabela Informações do domínio que tenha um valor correspondente em company_name campo. 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 do conector por push personalizados. Os metadados na ordem de acesso preferencial são:
    1. Parâmetros do conector por 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 de 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> inbound:<MID_Web_Server_Port>/api/mid/em/inbound_event <connector-transform-script-name>

    Você pode incluir metadados de domínio como parâmetros de consulta adicionais no ServiceNow URL do webhook do conector por push. Por exemplo, se a origem 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 do domínio pode ser passada como parte dos cabeçalhos de solicitação HTTP. Verifique a documentação da sua 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 aos metadados do domínio do corpo da solicitação (carga JSON) definindo os parâmetros de metadados como chaves de nível raiz na carga. O exemplo a seguir mostra como connectorDomainInfoTableNamee. connectorDomainInfoColumnNameos parâmetros podem ser passados como parte do corpo da solicitação:
    {
    "Origem": "Monitor do Azure",
    "host": "127,0.0,1",
    "Empresa": "ServiceNow",
    "ConnectorDomainInfoTableName": "Sys_user",
    "ConnectorDomainInfoColumnName": "First_name"
    }
    Nota:
    Para obter informações sobre parâmetros do conector, consulte Personalize domínios para eventos do conector por push para usar na criação de eventos.