Configurar a tarefa de importação de dados do playbook Eventos de ciclo de vida da conta

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 7 min. de leitura
  • Configure a tarefa de importação de dados de Eventos de ciclo de vida da conta usando Playbooks.

    Para configurar a tarefa de importação de dados, você deve ter as seguintes funções:
    • sn_acct_lc.agente
    • Uma ou mais funções Playbooks. Consulte Playbooks roles para obter detalhes.

    A tabela a seguir mostra as várias tarefas envolvidas na configuração da tarefa de importação de dados.

    Tabela 1. Tarefas de importação de dados
    Tarefa Seção
    Crie o modelo do Excel para importar dados para a tabela de destino. Criar modelo do Excel
    Crie a tabela de preparação na qual os dados de importação podem ser armazenados antes de serem movidos para a tabela de destino. Criar a tabela de preparação
    Crie a fonte de dados e anexe o arquivo de modelo ao registro. Criar a fonte de dados
    Configure o mapa de transformação. Configurar o mapa de transformação
    Adicione a atividade do playbook ao processo Playbooks. Adicionar a tarefa de importação de dados
    Nota:
    As seções a seguir descrevem como configurar a tarefa de importação de dados para a tabela de local disponível com o sistema de base. Os nomes e valores usados nessas seções são exemplos, mas você pode seguir este processo para configurar qualquer tabela usada para a tarefa de importação de dados.

    Criar modelo do Excel

    Crie o modelo do Excel para importar dados para a tabela de destino:

    1. Navegue até Todos e insira cmn_location.list no filtro Pesquisar.
    2. Selecione o ícone Personalizar e selecione as colunas que serão incluídas no modelo. Insira as condições do filtro, se necessário, selecione o ícone Opções de coluna e selecione Exportar para o Excel (.xlsx).
    3. Selecione Baixar para baixar o arquivo exportado.
    4. Abra o arquivo do Excel baixado, limpe todos os dados existentes e selecione Salvar.
    5. Você pode ver que o arquivo contém as colunas selecionadas anteriormente. Este arquivo pode ser usado como modelo do Excel para importar dados.

    Criar a tabela de preparação

    Crie a tabela de preparação na qual os dados de importação podem ser armazenados antes de serem movidos para a tabela de destino:

    1. Navegar até Todos > Definição do Sistema > Tabelas.
    2. Selecione Novo e insira os seguintes detalhes:
      • Rótulo: insira um nome para a tabela do local, por exemplo, Importação de dados para o local.
      • Nome: insira o nome interno da tabela. Por exemplo, sn_acct_lc_account_onb_import_locations.
      • Estende a tabela: selecione a linha de importação de tecnologia.
    3. Desmarque a caixa de seleção Criar módulo e selecione a guia Controles.
    4. No campo Função do usuário, insira sn_acct_lc.agent e selecione Salvar.
    5. Selecione a guia Colunas e selecione Novo. Insira os seguintes detalhes:
      • Tipo: Cadeia de caracteres. Todas as colunas devem ser do tipo Cadeia de caracteres.
      • Rótulo da coluna: insira um nome de campo (nome da coluna) do arquivo de modelo.
      • Nome da coluna: insira o rótulo da coluna com o prefixo u_. Por exemplo, se você inseriu o Rótulo da coluna como Rua, insira u_street aqui.
      • Tamanho máximo: especifique o tamanho máximo da coluna, conforme necessário.
      Siga as etapas anteriores para adicionar todas as colunas do arquivo de modelo.
    6. Selecione Lista de layouts nos Links relacionados. Na lista suspensa Exibição de lista, selecione Novo e crie duas exibições de lista para esta tabela:
      • ready_to_publish: adicione todos os campos lógicos a esta exibição. Esta exibição aparece quando você seleciona o bucket Pronto para publicar no registro da tarefa de importação de dados.
      • necessidades_attention: adicione todos os campos lógicos mais o campo Comentários a esta exibição. Esta exibição aparece quando você seleciona o bucket Precisa de atenção no registro da tarefa de importação de dados.
    7. Selecione o formulário de layout nos links relacionados.
    8. No menu suspenso Exibir nome, selecione Novo e crie o import_view. Adicione todos os campos lógicos e o campo Comentários a esta exibição. Esta exibição é mostrada quando você tenta abrir o registro da tabela de preparação na guia Importação de dados

    Criar fonte de dados

    Crie a fonte de dados e anexe o arquivo de modelo ao registro.
    1. Navegar até Todos > Administração > Fontes de dados.
    2. Selecione Novo e insira os seguintes detalhes:
      • Nome: insira um nome para a fonte de dados.
      • Nome da tabela do conjunto de importação: insira o nome da tabela interna. Por exemplo, sn_acct_lc_account_onb_import_locations.
    3. Anexe o arquivo de modelo ao registro da fonte de dados que você criou.

    Configurar o mapa de transformação

    A transformação converte valores de entrada de campo brutos em valores padronizados que são mais significativos para uma organização. Os administradores controlam quando a transformação acontece definindo regras e condições para campos específicos.

    Como parte da configuração de importação de dados, você deve configurar os seguintes scripts de transformação necessários que são fornecidos com o sistema de base. Para configurar os scripts de transformação, siga estas etapas:

    1. Navegar até Todos > Mapas de transformação.
    2. Pesquise a aplicação Eventos de ciclo de vida da conta.
    3. Selecione o mapa de transformação do local do cliente de integração da conta.
      Selecione a guia Transformar scripts. Você pode ver os seguintes scripts:
      • onComplete
      • onAfter
      • onBefore
    4. Selecione um dos scripts e modifique-o conforme necessário e selecione Atualizar para salvar as mudanças.
    Script onComplete
    (function runTransformScript(source, map, log, target /*undefined onStart*/ ) {
    	//Check if there is any Needs Attention Record is present or not.
    	//If Yes, then script will create a new import set record and attach all the Needs Attention records to the new Import Set.
    	//Also, it will update the new import set reference on the import Task Table.
    	var util = new sn_acct_lc.AlonStagingRecordState();
    	util.onCompleteTransformMap(source, import_set);
    })(source, map, log, target);
    Script onAfter
    (function runTransformScript(source, map, log, target /*undefined onStart*/ ) {
    
    	// Add your code here
    	
    	var alonStagingUtil = new sn_acct_lc.AlonStagingRecordState();
    	alonStagingUtil.afterTransform(source);
    	if(source.sys_import_state == TechOnbEditableContants.SN_IMPORT_TRANFORM_IGNORED) {
    		return;
    	}
    	
    
    })(source, map, log, target);
    onBefore
    (function runTransformScript(source, map, log, target /*undefined onStart*/ ) {
    
    	// Add your code here
    	var alonStagingUtil = new sn_acct_lc.AlonStagingRecordState();
    	var status = alonStagingUtil.beforeTransform(source.import_state);
    	if(status == TechOnbEditableContants.SN_IMPORT_TRANFORM_IGNORE) {
    		ignore = true;
    	}
    
    })(source, map, log, target);

    Adicionar a tarefa de importação de dados

    Adicione a tarefa de importação de dados que você configurou ao processo de integração do ciclo de vida da conta definido no Designer de automação de processos.

    1. Navegar até Todos > Designer de automação de processos.
    2. Selecione o Processo de integração do ciclo de vida da conta.
    3. Navegue até a raia Captura e validação de dados e selecione Adicionar uma atividade.
    4. Selecione Eventos de ciclo de vida da conta e selecione Criar e exibir registro de tarefa técnica.
    5. Selecione o ícone Editar na tarefa recém-adicionada para exibir as propriedades.
    6. Selecione Exibir todas as propriedades e Avançado.
    7. Na guia Geral, insira o nome e a descrição do rótulo.
    8. No campo Quando iniciar, selecione Com o anterior. Esta opção permite executar todas as atividades na tarefa em paralelo.
    9. Selecione a guia Automação e, na seção Entradas, insira o seguinte:
      • Tabela: a tabela para a qual o registro está sendo criado. Selecione Tarefa de importação do ciclo de vida da conta (sn_ti_core_imp_task).
      • Condições canceladas: especifique as condições que devem ser atendidas antes que a tarefa seja movida para o estado cancelado.
      • Condições encerradas: especifique as condições que devem ser atendidas antes que a tarefa seja movida para o estado Encerrado.
      • Caso de integração de conta: selecione o gatilho de registro de caso de integração de conta para associar este registro ao caso de integração de conta.
      • Exibição de registro: o nome da exibição de formulário que será exibida no playbook Eventos de ciclo de vida da conta. Insira tech_pad_imp_task_view aqui.
      • Nome da responsabilidade: selecione a função de usuário desenvolvedor/administrador da ServiceNow na lista. Esta função é atribuída aos membros da equipe interna (definidos na tarefa Atribuir responsabilidades da equipe interna da fase Iniciar do playbook. Consulte Usando o playbook Eventos de ciclo de vida da conta para obter detalhes). Usuários com esta função podem executar a tarefa de importação de dados.
    10. Selecione Adicionar campo e insira dados nos seguintes campos da tabela Tarefa de importação Eventos de ciclo de vida da conta.
      • Tabela de origem: adicione o nome interno da tabela de preparação. Por exemplo, sn_acct_lc_account_onb_import_locations.
      • Tabela de destino: adicione o nome interno da tabela de destino. Por exemplo, cmn_location.
      • Fonte de dados: selecione a fonte de dados. Por exemplo, cmn_location_template.xlsx.
      • Estado da importação de dados: o valor padrão é definido como 1 (Dados não carregados ainda).
      • Estado: o estado padrão é definido como 1 (Aberto).
      • Tipo: selecione Captura de dados.
      • Conta: selecione o caso de integração de conta associado à tarefa de caso.
      • Primário: selecione o registro primário associado ao caso de integração de conta.
      • Visível: defina como falso.
    11. Insira o Assunto e a Descrição conforme necessário, selecione Concluído e, em seguida, selecione Ativar.

    Depois que a tarefa de importação de dados tiver sido configurada, o playbook Eventos de ciclo de vida da conta poderá ser usado para integrar os clientes. Consulte Usando o playbook Eventos de ciclo de vida da conta para obter detalhes.