Configuração da integração do ASMS por projetos no AFLS

Para tornar a integração entre AFLS e ASMS bilateral, configure-se a integração do AFLS no nível do projeto. O processo de configuração será explicado abaixo.

1. Faça login no console AFLS como usuário Administrador. No menu de cabeçalho, selecione o Configuração e Administrador.

2. No Integração No menu principal, selecione o ícone Central de Serviços e na Visualização de detalhes você pode configurar os seguintes parâmetros levando em consideração o esquema de integração:

3. Na exibição Detalhes do Service Desk, selecione a versão do service desk Aranda GESTÃO DE SERVIÇOS. e clique no ícone Ativo Para habilitar os campos de configuração de integração:

4. No Informações de conexão, insira as respectivas informações:

Campo	Descrição
URL de conexão	URL da API de gerenciamento de serviços da Aranda. Por exemplo: https://url-de-asms/API/.
Token de conexão	Token JWT gerado pelo Aranda Service Management na opção Tokens de integração .

5. Para confirmar se a integração está funcionando, clique no ícone Validar. Este botão testa se a conexão com a API do ASMS foi bem-sucedida, em caso afirmativo, uma mensagem será exibida informando que a conexão foi bem-sucedida.

⚐ Nota: Se os dados forem novos ou atualizados, salve as configurações para ativar as abas de projeto e sincronização de agendamento.

6. Selecione a caixa de seleção Habilitar a sincronização por empresa se você deseja que as empresas registradas no ASMS sejam sincronizadas e registradas como clientes no AFLS. Com a caixa de seleção selecionada, a criação das tarefas de campo usa a empresa enviada pelo ASMS para identificar o cliente correspondente no AFLS; por esse motivo, ao criar uma tarefa, é necessário enviar o ID da empresa. Se a caixa permanecer desmarcada, a integração continua funcionando como antes, sem exigir o ID da empresa.

⚐ Nota: Quando você seleciona ou elimina essa caixa, o sistema exibe uma mensagem de confirmação, pois essa mudança afeta o comportamento de criar tarefas de campo. Você deve confirmar a mensagem e clicar no Salvar para que a mudança entre em vigor; se você não fizer commit da mensagem ou salvar as alterações, a caixa de seleção mantém o valor que tinha antes da alteração.

⚐ Nota: Com a caixa de seleção marcada, o ASMS deve enviar o ID da empresa em cada solicitação de criação de tarefa no campo. Se não for enviada, a AFLS rejeita a solicitação e informa que o ID da empresa é necessário.

7. Clique no botão Salvar para confirmar as alterações feitas.

8. Na Exibição de detalhes da integração do Service Desk no console de configuração do AFLS, selecione o ícone Projetos realizar a parametrização do projeto a ser integrado.

No campo de consulta, você pode procurar o projeto necessário e selecioná-lo da lista.

9. Selecione o projeto adicionado e clique no botão Configurar JSON.

10. No editor de texto habilitado, adicione a parametrização dos modelos, os status a serem homologados e os campos adicionais necessários para cada projeto. Opcionalmente, você também pode definir os serviços AFLS que estarão disponíveis para o projeto. O formato JSON de configuração está detalhado abaixo:

{
//Lista de modelos a parametrizar
  "Models": [
    {
  //Nombre del campo adicional para ingresar resultados al finalizar el flujo de un modelo
      "AdditionalFieldSolution": ""
	//Lista de estado a homologar, se debe ingresar el código de estado de AFLS y su código homólogo en ASMS
      "HomologateStates": [
        {
          "IdAFLSState": 0,
          "IdASMSState": 0
        },
        {
          "IdAFLSState": 0,
          "IdASMSState": 0
        }
      ],
	//ID del modelo en AFLS y de ASMS
      "IdModelAFLS": 0,
      "IdModelASMS": 0,
    }
  ],
// Nombre y código del proyecto, estos datos se cargan automaticamente
  "Project": "CL - Acepta.Com S.A.",
  "ProjectId": 406,
//Lista opcional de identificadores (número entero) de los servicios de AFLS a habilitar para el proyecto; si se omite, se listan en ASMS todos los servicios que el cliente o compañía tenga asociados en AFLS
  "Services": [0],
//Campos adicionales por proyecto, se debe ingresar el indentificador de los campos adicionales tanto de AFLS como de ASMS
  "Workordersadditionalfields": [
    {
      "AflsfieldUniqueName": "",
      "AsmsfieldUniqueName": ""
    }
  ]
}

Para obter os valores a serem configurados no JSON, considere o seguinte:

Solução de campo adicional

Campo adicional criado no modelo. Para obter o nome do campo adicional, vá para o AFLS Configuration Console no campo Catálogo de Serviços No menu principal, selecione o ícone Modelos. Na visualização de informações, selecione o modelo a ser usado na integração; Na visualização de Detalhe do Modelo, clique na Editar modelo.

No Editor de modelos, selecione o ícone Campos adicionais, clique no ícone Editar e expanda as Opções avançadas; copie o valor do campo Nome do campo Adicional.
Para mais informações, veja a configuração do modelo no manual da AFLS Configurando campos adicionais em um modelo .

IdModelAFLS

ID do modelo AFLS a ser utilizado na integração, o campo deve ser consultado no banco de dados wf_id na tabela AFLS_WORKFLOWS, tendo em conta o nome do modelo e que o wf_deleted é igual a 0.

⚐ Exemplo: selecione wf_id, wfcom_id, wf_deleted wf_name de AFLS_WORKFLOWS onde wf_deleted = 0.

IdModelASMS

ID do modelo ASMS a ser usado na integração, consulte o campo do banco de dados Id na tabela asms_model, tendo em conta o nome do modelo e que o Ativo é igual a 1.

⚐ Exemplo: selecione ID, nome a partir de asms_model onde ativo = 1 e item_type_id = 6.

IdAFLSState

ID dos estados AFLS do modelo a ser usado na integração, como primeiro passo, no console AFLS selecione o modelo e veja os estados que você deseja mapear levando em conta o fluxo existente:

Para consultar o ID dos estados que você deseja mapear, valide o campo no banco de dados st_id na tabela AFW_STATEMACHINE_STATES, tendo em conta o ID do modelo (wfcom_id) no campo de_definition_id.

⚐ Exemplo: selecione st_id, de_definition_id st_display_name de AFW_STATEMACHINE_STATES onde de_definition_id = 1.

IdASMSState

ID dos estados ASMS do modelo a ser usado na integração; como primeira etapa, entre no console de administração do ASMS, no Central de Serviços No menu principal, selecione o ícone Estados. Na visualização de informação, defina o tipo de caso Tarefa e o modelo escolhido para integração; Você será capaz de visualizar os estados que deseja mapear levando em conta o fluxo existente:

Para consultar o ID dos estados que você deseja mapear, consulte o campo do banco de dados stat_id na tabela asms_status, tendo em conta o ID do modelo (Id) no campo stat_model_id.

⚐ Exemplo: selecione stat_id, stat_name a partir de asms_status onde stat_model_id = 20.

Serviços

Uma propriedade opcional que permite limitar quais serviços AFLS estarão disponíveis no ASMS para este projeto. Você não precisa configurá-la.

Se você configurar, insira um array com os identificadores (inteiros) dos serviços AFLS que deseja ativar. O ASMS só listará os serviços incluídos nesse array que também estão associados ao cliente ou empresa no caso do AFLS. Ou seja, um serviço só aparecerá no ASMS se estiver na lista Serviços e também está associado a esse cliente ou empresa na AFLS.
Se você não incluir o imóvel Serviços, o ASMS continuará listando todos os serviços que o cliente ou empresa associou à AFLS, assim como no comportamento atual.

Para verificar o identificador de um serviço, acesse o console de configuração do AFLS, na seção Catálogo de Serviços No menu principal, selecione o ícone Serviços e verifique o serviço necessário.

⚐ Nota: Se você incluir o imóvel Serviços, o array deve conter pelo menos um identificador e todos os seus valores devem ser inteiros; caso contrário, o sistema rejeita a configuração e reporta o erro correspondente.

Ao criar uma tarefa de campo a partir do ASMS, se o usuário tentar selecionar ou enviar um serviço que não está ativado para o projeto (porque não está incluído em Serviços ou não está associado ao cliente ou empresa na AFLS), o sistema rejeita a solicitação e informa que o serviço não está habilitado para o projeto.

AflsfieldUniqueName

Para criar o campo adicional, vá para o console de configuração do AFLS, no Configuração No menu principal, selecione o ícone Campos adicionais E o item Ordens de serviço AFLS. Para modificar o campo, clique no botão Editar do campo adicional selecionado e expanda a opção Opções avançadas, copie o valor do campo Nome do campo Adicional.

Para mais informações, veja a criação de campos adicionais no manual da AFLS Criando campos adicionais .

AsmsfieldUniqueName

Para criar o campo adicional, faça login no Console de administração do ASMS, no Central de Serviços No menu principal, selecione o ícone Adicional. Definir como tipo de caso Tarefa e o modelo.

Na visualização Informações de Campos Adicionais, selecione um registro e, na visualização Detalhe, selecione a opção Geral e o valor do campo Identificador.

Para mais informações, veja criar campos adicionais no manual do ASMS Adicional .

⚐ Nota: Para campos adicionais do tipo lista, os valores devem ser exatamente os mesmos no AFLS e no ASMS para homologar o valor corretamente.

Abaixo está um exemplo de um JSON configurado com 2 modelos diferentes e cada um contém seus respectivos estados e campos adicionais mapeados:

{
  "Models": [
    {
      "AdditionalFieldSolution": "ca-mp campo modelo 1-1",
      "HomologateStates": [
        {
          "IdAFLSState": 1,
          "IdASMSState": 168
        },
        {
          "IdAFLSState": 2,
          "IdASMSState": 402
        },
        {
          "IdAFLSState": 7,
          "IdASMSState": 169
        }
      ],
      "IdModelAFLS": 1,
      "IdModelASMS": 22
    },
    {
      "AdditionalFieldSolution": "ca-ma campo modelo 1-1",
      "HomologateStates": [
        {
          "IdAFLSState": 9,
          "IdASMSState": 400
        },
        {
          "IdAFLSState": 12,
          "IdASMSState": 170
        },
        {
          "IdAFLSState": 15,
          "IdASMSState": 172
        },
        {
          "IdAFLSState": 16,
          "IdASMSState": 173
        }
      ],
      "IdModelAFLS": 2,
      "IdModelASMS": 23
    }
  ],
  "Project": "SONDA",
  "ProjectId": 17,
  "Services": [22, 35],
  "Workordersadditionalfields": [
    {
      "AflsfieldUniqueName": "ca-campo orden parrafo-2",
      "AsmsfieldUniqueName": "1"
    }
  ]
}

11. Depois que o arquivo JSON for parametrizado, clique no Validar JSON. Esse botão valida que os modelos e todos os status parametrizados AFLS e ASMS coincidem e existem. Se a validação do arquivo de configuração for bem-sucedida, salve as alterações e conclua a parametrização do projeto.

12. Na Exibição de detalhes da integração do Service Desk no console de configuração do AFLS, selecione o ícone Sincronização de agendamento para sincronizar usuários ASMS com o AFLS no projeto configurado. Se o projeto tiver a caixa de seleção selecionada Habilitar a sincronização por empresa (veja o passo 6), essa mesma tarefa programada também sincroniza as empresas ASMS com a AFLS.

⚐ Nota: Com a caixa Habilitar a sincronização por empresa (veja o passo 6) ativa, as empresas ASMS são sincronizadas e registradas como clientes na AFLS; enquanto essa caixa de seleção está ativa, os clientes da ASMS não estão integrados à AFLS. Se a caixa de seleção estiver marcada, a sincronização continua com o comportamento anterior: as empresas ASMS se registram como empresas na AFLS e os clientes da ASMS se registram como clientes na AFLS.

⚐ Nota: Com a caixa Habilitar a sincronização por empresa ativa, se uma empresa ASMS não tiver um cliente correspondente no AFLS, o sistema o cria; se o cliente já existir e as informações da empresa mudaram no ASMS, o sistema atualiza os dados do cliente no AFLS.

⚐ Nota: Se ocorrer um erro durante a execução, ao processar uma empresa específica, o sistema registra os detalhes do erro, continua a sincronizar as outras empresas do projeto e gera um relatório com o resultado da execução.

13. Nos respectivos campos, selecione o ícone Data e hora de início e defina um periodicidade para que a sincronização seja executada de acordo com o horário configurado.

14. Para concluir a configuração da integração, clique no ícone salvar ou selecione o ícone Atualize agora para que a sincronização seja agendada imediatamente.