Process Mining
2023.10
falso
Carregamento de dados usando o Theobald Xtract Universal - Automation Suite 2023.10
Imagem de fundo do banner
Logotipo
Process Mining
Última atualização 19 de dez de 2023

Carregando dados usando o Theobald Xtract Universal

Introdução

Esta página descreve como usar Theobald Xtract Universal (XU) para carregar dados de seu sistema de origem SAP em um aplicativo de processos. Consulte o site oficial Theobald Software para mais informações sobre o Theobald Xtract Universal (XU).

Theobald Xtract Universal fornece acesso rápido e extrações rápidas de dados para fontes de dados SAP ECC e SAP HANA. Para obter instruções gerais sobre como usar o Theobald Xtract Universal, consulte a documentação oficial do Theobald Software Introdução ao Theobald Xtract Universal.

Pré-requisitos

Assume-se que você:

  • uma licença válida do Theobald Xtract Universal.
    Observação:

    A licença é fornecida via UiPath com a finalidade de utilização com Process Mining.

  • Theobald Xtract Universal instalado. Consulte a documentação oficial do Theobald Software para obter mais informações sobre a instalação de uma atualização do Theobald Xtract Universal e a personalização do módulo de função para extração de tabela no SAP.

  • configurar o acesso do SQL Server com as permissões corretas. Veja
Nota: Carregar dados usando o Theobald Xtract Universal requer que a ferramenta de linha de comando (xu.exe) possa ser executada sem autenticação adicional.

Configuração do Theobald Xtract Universal

O Theobald Xtract Universal é a ferramenta de extração certificada pela SAP usada para extrair dados dos sistemas de origem SAP, integrando-se ao SAP por meio de Chamadas de Função Remota (RFC). O Theobald Xtract Universal contém um módulo de função personalizado somente leitura Z_THEO_READ_TABLE-transport1 que deve ser instalado no SAP.

Use o seguinte link para baixar o módulo personalizado: Z_THEO_READ_TABLE-transport1.zip.

Atenção:
A versão mais recente do arquivo Z_THEO_READ_TABLE-transport1.zip sempre será incluída ao baixar o Xtract Universal.

Siga estas etapas para configurar o Theobald Xtract Universal.

  1. Baixe a versão de avaliação mais recente do Theobald Xtract Universal de nosso site, consulte Baixar versão de avaliação. Instale o Theobald Xtract Universal em um servidor Windows / Máquina virtual.

  2. Verifique se o acesso à rede ao seu sistema SAP está aberto, consulte Portas TCP/IP do SAP.

  3. Conceda direitos de usuário do SAP para acessar a instância do SAP, consulte Objetos de autoridade - Direitos de usuário do SAP para tabela.

  4. Os seguintes componentes no Theobald Xtract Universal requerem personalização no SAP: Z_THEO_READ_TABLE.
  5. Configure o Theobald Xtract Universal para o(s) modelo(s) de aplicativo necessário(s). Consulte Modelos de aplicativo.

Observação:

As etapas 2 a 4 exigirão validação de sua equipe SAP.

Configuração de credenciais para o banco de dados SQL Server

Carregar dados para o Process Mining (Automation Suite) requer acesso ao local do banco de dados SQL Server para o qual os dados extraídos precisam ser carregados. Para configurar uma conexão de destino do SQL Server, são necessários os seguintes parâmetros de configuração para autenticar o acesso ao local do banco de dados SQL Server.

  • Server
  • Database
  • Schema
  • Role

Carregando dados usando o Theobald Xtract Universal

A configuração do carregamento de dados usando o Theobald Xtract Universal requer a execução de várias etapas.

  1. Importe as extrações do template;
  2. Configurar a fonte;
  3. Configurar o destino;
  4. Configure o script de extração;
  5. Execute o script de extração.

As etapas são descritas em detalhes a seguir.

Importando as extrações do modelo

Siga estas etapas para importar as extrações de modelo no Theobald Xtract Universal.

  1. Acesse a página Modelos de aplicativo e abra a página de documentação do seu modelo de aplicativo.

    Observação:

    Você pode fazer login usando o usuário padrão.

    docs image
    docs image
  2. Localize a seção Carregando dados usando o Theobald Xtract Universal e baixe o arquivo XU_template_extractions_as.zip para seu modelo de aplicativo. Consulte Modelos de aplicativos. Este arquivo XU_template_extractions_as.zip contém as pastas destinations, extractionse sources.
  3. Copie as pastas do arquivo baixado XU_template_extractions_as.zip para a pasta config do Xtract Universal. A localização desta pasta é [XU_installation_path]/config.
  4. Abra o Theobald Xtract Universal Designer e clique no botão atualizar para carregar todas as extrações.

Uma lista de todas as extrações que extraem uma tabela do sistema SAP é exibida. A origem do modelo é denominada SAP e o destino do modelo é denominado CSV.

Configuração da origem

Siga estas etapas para configurar a fonte SAP no Theobald Xtract Universal.

  1. Vá para Servidor - Gerenciar fontes e edite a fonte SAP.
  2. Preencha as configurações nas guias Geral e Autenticação para se conectar ao seu sistema SAP.
  3. Teste a conexão.

Configuração do destino

Siga estas etapas para configurar o destino do SQL Server no Theobald Xtract Universal.

  1. Vá para Servidor - Gerenciar destinos e edite o destino do SQL Server.
  2. Preencha as configurações para se conectar ao destino do SQL Server.

Configuração do script de extração

Siga estas etapas para configurar o script de extração.

  1. Acesse a página Modelos de aplicativo e abra a página de documentação do seu modelo de aplicativo.

  2. Localize a seção Carregando dados usando o Theobald Xtract Universal e baixe o arquivo extract_theobald_as.zip para seu modelo de aplicativo. Este arquivo extract_theobald_as.zip contém o script extract_theobald.ps1 e o arquivo config.json .

  3. Descompacte o conteúdo do arquivo extract_theobald_as.zip no servidor onde o Theobald Xtract Universal está instalado.

  4. Configure as variáveis para o script no config.json conforme listado abaixo.

Variável

Description

xu_location

A pasta de instalação do Xtract Universal. Esta é a pasta onde você pode encontrar o xu.exe. Por exemplo: C:\\MinhaPasta.

xu_server

Endereço do servidor onde o Xtract Universal está instalado. O padrão é localhost.

xu_port

Porta do servidor onde o Xtract Universal está instalado. A porta padrão de uma instalação é 8065.

end_of_upload_api

A API que é chamada para iniciar o processamento de dados no Process Mining, assim que todos os dados forem carregados, é: Consulte Recuperação dos parâmetros do banco de dados do SQL Server

.

extraction_start_date

Data de início a ser usada para limitar as extrações. Somente tabelas em que um filtro de data é aplicado são filtradas nesta data. Formato é YYYYMMDD. O padrão não é nenhuma limitação indicada até a data de início 19700101.
Observação: extraction_start_date deve ter um valor.

extraction_end_date

Data de término a ser usada para limitar as extrações. Somente tabelas em que um filtro de data é aplicado são filtradas nesta data. Formato é YYYYMMDD. O padrão não é nenhuma limitação indicada até a data de término 20991231.
Observação: extraction_end_date deve ter um valor.

language

O idioma em que os dados serão extraídos do sistema de origem. O padrão é E.

exchange_rate_type

O tipo de taxa de câmbio usado para conversão de moeda. O padrão é M.

Execução do script de extração

Para carregar os dados e carregá-los para uso no Process Mining, execute o arquivo extract_theobald.ps1.

O tempo necessário para esta tarefa dependerá muito dos volumes de dados carregados.

Como iniciar o arquivo manualmente

Siga esta etapa para iniciar a execução de dados.

  1. Execute o arquivo extract_theobald.ps1 para iniciar a execução de dados.
A execução de dados também cria um arquivo de log que pode ajudar em caso de resultados inesperados ou se o upload de dados com o carregador de dados falhar. O arquivo extraction.log contém os logs da última execução de dados. Para cada extração que falhou, um código de retorno é exibido. Consulte a documentação oficial do Theobald Software Chamada via linha de comando para obter mais informações. Quando algo na configuração está incorreto, isso é mencionado na mensagem de erro.

Agendar uma tarefa para a execução de dados

Em vez de executar o arquivo manualmente, use o Agendador de Tarefas do Windows para agendar uma tarefa que executa o script em lote para atualizações de dados automatizadas.

Observação: Recomenda-se selecionar a conta de usuário local do SISTEMA para executar a tarefa e selecione a opção Executar com prioridade máxima na janela Criar Tarefa ao criar a tarefa no Windows Scheduler.
Importante: Se você adicionar um intervalo para o qual não há dados disponíveis, os painéis exibirão uma mensagem de erro.

Quando a extração é bem-sucedida, a ingestão de dados pode falhar devido à extração de alguns dados defeituosos. Você pode filtrar esses dados usando Theobald Xtract Universal usando a cláusula WHERE. Consulte a documentação oficial do Theobald para obter mais informações sobre a Cláusula WHERE.

Observação:

Se você tiver uma cláusula WHERE que usa variáveis (por exemplo, a data de extração), não poderá filtrar por meio da interface do usuário.

Ícone de suporte e serviços
Obtenha a ajuda que você precisa
Ícone do UiPath Academy
Aprendendo RPA - Cursos de automação
Ícone do Fórum do UiPath
Fórum da comunidade da Uipath
Logotipo branco da Uipath
Confiança e segurança
© 2005-2024 UiPath. All rights reserved.