Advanced Flow for Microsoft Graph Connector for ServiceNow Knowledge

Se a sua instância do ServiceNow utilizar Scripts Avançados na Base de Dados de Conhecimento ou critérios de utilizador ao nível do artigo, terá de utilizar o fluxo Avançado . Isto garante o processamento preciso de permissões ao ingerir conteúdo no Microsoft Graph.

Passo 1: selecionar Fluxo Avançado na Configuração

Ao configurar o Conector do Microsoft Graph para o Conhecimento do ServiceNow, selecione a opção Avançadas no campo "Selecionar com base na configuração dos critérios de utilizador no ServiceNow". Isto é crucial para lidar corretamente com critérios de utilizador avançados.

Passo 2: Configurar a API REST com Script no ServiceNow

Para permitir que o conector obtenha critérios de utilizador avançados, tem de criar uma API REST com Script na sua instância do ServiceNow. Siga as etapas abaixo.

2.1: Elevar a Função de Utilizador

1. Eleve a sua função no ServiceNow para security_admin.

2.2: Criar Controle de Acesso (ACL)

1. No ServiceNow, navegue para Todas as > Controle de Acesso de Segurança > do Sistema (ACL).
2. Clique em Novo para criar uma nova ACL.
3. Defina os seguintes valores:
   • Tipo: REST_Endpoint
   • Operação: Execute
   • Nome: Microsoft Copilot
   • Função: admin(ou a mesma função atribuída à conta de pesquisa)
4. Clique em Enviar.

2.3: Criar API REST com Script

1. Navegue para Todas as > APIs REST com Scripts de Serviços Web dos Serviços >> Web do Sistema.

2. Clique em Novo.

3. Insira o seguinte:

   • Nome: Microsoft Copilot
   • ID da API: microsoft_copilot

4. Clique em Enviar.

5. Na página da lista API REST com script, clique em Microsoft Copilot - a API REST que acabou de criar.

6. Defina ACLs Predefinidas como Microsoft Copilot (a partir do passo 2.2).

2.4: Adicionar um Recurso à API

1. No separador Recursos , clique em Novo.
2. Preencha os detalhes:
   • Nome: GetAllUserCriteria
   • Caminho Relativo: /user_criteria
   • Script: cole o seguinte código:

(function execute (/*RESTAPIRequest*/ request, /*RESTAPIResponse*/ response) {
    var queryParams = request.queryParams;
    var user = new String(queryParams.user);
    return (new sn_uc.UserCriteriaLoader()).getAllUserCriteria(user);
})(request, response);

3. Certifique-se de que ambas as opções estão selecionadas:

   • Requer autenticação
   • Requer autorização da ACL

4. Certifique-se de que as ACLs estão definidas como Microsoft Copilot.

5. Clique em Atualizar.

2.5: Verificar a Configuração

1. Confirme que o Caminho do Recurso é:

   /api/<API Namespace>/microsoft_copilot/user_criteria
   

2. Clique em Atualizar para guardar a configuração.

Passo 3: introduza o Espaço de Nomes da API na Experiência de Configuração do Conector do Graph

Na configuração do Conector do Microsoft Graph, introduza o Espaço de Nomes da API que criou no ServiceNow.

Observação

Pode encontrar o espaço de nomes da API no campo Caminho do Recurso apresentado no Passo 2.5. Só precisa da parte do espaço de nomes e não do caminho completo.

Por exemplo: se o Caminho do Recurso for /api/abcdef/microsoft_copilot/user_criteria, o espaço de nomes da API é abcdef.