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:

Parâmetros do conector push
Parâmetros de consulta de URL
Cabeçalhos HTTP
Corpo da solicitação (carga)
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.