Carregamento de dados usando a conexão direta

Observação:

A opção Carregar dados usando conexão direta está disponível para modelos de aplicativos específicos de processo que usam um sistema de origem ServiceNow ou um sistema de origem Salesforce, bem como para os modelos de aplicativos genéricos Log de evento e Processo personalizado, se você quiser configurar uma conexão direta para ServiceNow ou Salesforce. É a opção padrão para modelos de aplicativos que usam um sistema de origem para o qual uma conexão direta está disponível.

Pré-requisitos

O carregamento de dados usando uma conexão direta usa conexões do Integration Service . Isso implica que você precisa ter:

• uma licença para o Integration Service;
• Integration Service habilitado em seu tenant;
• acesso ao Orchestrator e às pastas do Orchestrator.

As conexões do Integration Service são restritas por pasta. Se quiser usar uma conexão de uma pasta específica, você precisa ter acesso a essa pasta no Orchestrator para vê-la no Process Mining. Se você criar uma nova conexão a partir do Process Mining, essa conexão será criada em seus espaços de trabalho pessoais no Orchestrator.

Consulte o guia do Integration Service para obter mais informações sobre licenciamento do Integration Service e conexões do Integration Service .

Configuração de uma conexão direta

Você pode configurar usando uma conexão direta com seu sistema de origem na etapa Seleção da origem de dados em vez de configurar uma conexão usando o CData Sync.

A opção Carregar dados usando conexão direta carrega dados para seu aplicativo de processo diretamente do sistema de origem.

Siga estas etapas para configurar uma conexão direta com o sistema de origem:

1. Selecione a opção Carregar dados usando conexão direta . O sistema de origem usado para o modelo de aplicativo exibido.
2. Selecione Conectar. Uma nova guia do navegador é aberta, onde você pode inserir os detalhes de autenticação para a conexão.
   Observação:

   Se você estiver usando um modelo de aplicativo específico de um processo, certifique-se de que as credenciais do usuário tenham acesso à lista padrão de tabelas e campos especificados no modelo de aplicativo. Consulte Modelos de aplicativo para obter detalhes.

Mapeamento de tabelas de entrada

1. Uma tabela é adicionada na seção Tabelas de origem para cada tabela extraída e é mapeada automaticamente para a tabela de entrada relacionada na seção Tabelas de destino .
2. Certifique-se de que cada tabela esteja mapeada para a tabela de destino correta. Se necessário, selecione uma tabela diferente na lista Tabelas de destino para corrigir o mapeamento.
3. Selecione Avançar.

Se você carregar uma tabela que não esteja listada como tabela obrigatória, uma nova tabela será adicionada automaticamente na seção Tabelas de origem para cada arquivo carregado e uma tabela de entrada correspondente será criada na seção Tabelas de destino . Por padrão, o nome do arquivo carregado é usado como o nome das tabelas.

Observação:

Uma mensagem de aviso é exibida indicando que a tabela precisa de configuração antes que os dados possam ser carregados para a tabela. Quando uma nova tabela é carregada, ela fica disponível nas transformações de dados. No entanto, outras etapas são necessárias para tornar esses dados visíveis nos painéis. Primeiro, os dados da tabela devem ser carregados usando uma consulta SQL. Em seguida, a tabela deve ser incorporada ao modelo de dados do aplicativo de processo. Consulte Modelos de dados para obter mais informações sobre como adicionar uma tabela ao modelo de dados.

Configuração de tabelas de entrada

As configurações para a tabela de entrada de destino são detectadas automaticamente e você só precisa verificá-las.

Siga estas etapas para editar as configurações para uma tabela de entrada.

1. Localize a tabela que você deseja configurar e selecione o ícone Editar tabela para abrir o painel Editar tabela para a tabela selecionada.
2. Edite as configurações como desejar e selecione Salvar.

A tabela a seguir descreve as configurações da tabela.

Configuração	Description
Nome da tabela	O nome da tabela de entrada em Transformações de dados.
Obrigatório	Opção para definir a tabela como obrigatória. Se TRUE , a tabela será necessária mais tarde ao publicar ou importar o aplicativo de processo. Se a tabela não for carregada, um erro será gerado. Se FALSE , a tabela é considerada como Opcional ., ao publicar ou importar o aplicativo. Se a tabela não for carregada, uma tabela vazia será criada para que as consultas SQL subsequentes não falhem.
DetecçãoAutomática	Permite que você identifique os tipos de campos no arquivo de entrada e aplique automaticamente os tipos de campos detectados aos campos correspondentes na tabela de destino.
Codificação	A codificação usada no arquivo.
Delimitador	O delimitador que separa os diferentes campos.
FimDaLinha	O caractere usado para marcar o fim de uma linha e o início de uma nova.
Caractere entre aspas	As aspas usadas nos campos de caso são envolvidas entre aspas.
Caractere de escape	O caractere de escape usado para interpretar corretamente caracteres que, de outra forma, seriam tratados como caracteres de controle especial (como aspas ou delimitadores). Observação: por padrão, o caractere Aspas selecionado é usado como o caractere de escape. Ou então, você pode selecionar a barra invertida (\) como o caractere de escape.
Tipo de carga	O tipo de carga da tabela. Observação: se você selecionar Incremental como o Tipo de carga , deverá especificar configurações adicionais para configurar a carga incremental para a tabela.

Carga de dados incremental

Com uma carga completa, todos os dados são extraídos da origem e carregados no sistema de destino, independentemente de os dados terem sido alterados ou permanecerem os mesmos desde o último carregamento. Uma carga incremental apenas extrai dados que foram alterados (adicionados ou atualizados) desde a última carga. Uma carga incremental é normalmente mais rápida e consome menos recursos do que uma carga completa, especialmente ao lidar com grandes volumes de dados em que apenas um pequeno subconjunto pode ser alterado com frequência.

Para habilitar o carregamento de dados incremental para uma tabela, você deve definir o Tipo de carregamento para a tabela como Incremental. A carga incremental requer um identificador exclusivo para garantir que os dados sejam carregados corretamente e um campo (como um carimbo de data/hora ou uma versão) para rastrear alterações nos dados de origem.

A tabela a seguir descreve as configurações adicionais necessárias para a carga Incremental .

Configuração	Description
Chaves primárias	O campo ou campos de chave primária que identificam exclusivamente cada registro na origem de dados.
Campo de carimbo de data/hora	O campo usado para rastrear quando cada registro foi atualizado ou adicionado pela última vez.
Formato do carimbo de data/hora	O formato do valor de carimbo de data/hora usado no campo Carimbo de data/hora .

Importante:

O método de extração usado para carregar dados pode exigir uma configuração adicional ou específica para extração incremental. Consulte Carregamento de dados usando o CData Sync para obter mais informações sobre como configurar a extração incremental para o CData Sync. Consulte Carregamento de dados usando o Theobald Xtract Universal para obter mais informações sobre como configurar a extração incremental para o Theobald Xtract Universal. Consulte Carregamento de dados usando DataUploader para obter mais informações sobre como configurar DataUploader para extração incremental. Se você alternar o Tipo de carregamento para Completa, certifique-se de configurar o método de extração usado de acordo.

Removendo um arquivo de origem

Se você selecionar acidentalmente um arquivo de origem enquanto carrega os dados de origem, poderá removê-lo da tela de Dados de entrada.

Observação:

Um arquivo de origem só pode ser removido se nenhum dado tiver sido carregado para ele.

Siga estas etapas para remover um arquivo de origem.

1. Localize o arquivo de origem que você deseja remover na lista Tabelas de origem .
2. Passe o mouse sobre a tabela e selecione Remover arquivo.

O arquivo de entrada é removido.

Exclusão de uma tabela de entrada

Você pode excluir uma tabela de entrada que você carregou anteriormente, diretamente da página Tabelas de mapeamento na tela Dados de entrada. Excluir uma tabela de entrada remove os dados de seu aplicativo de processo. Se quiser usar os dados em seu aplicativo de processo em um estágio posterior, você deve carregar novamente a tabela de entrada.

Importante:

Excluir uma tabela pode causar uma falha nas transformações de dados.

Siga estas etapas para excluir uma tabela.

1. Localize a tabela que você deseja excluir e clique no ícone Excluir tabela. uma mensagem de confirmação é exibida.
2. Selecione Excluir.

Mapeamento de campos de entrada

Observação:

Para a tabela selecionada, os campos de entrada obrigatórios para a tabela são exibidos na seção Campos obrigatórios na página Campos .

Os campos de origem detectados na tabela de entrada são mapeados automaticamente para os campos correspondentes na tabela de destino.

1. Certifique-se de que cada campo esteja mapeado para o campo de destino correto. Se necessário, selecione um campo diferente na lista Campos de destino para corrigir o mapeamento.
2. Selecione Avançar para continuar.

Configuração de campos de entrada

As configurações para os campos de entrada de destino são detectadas automaticamente e você só precisa verificá-las.

Siga estas etapas para editar as configurações para um campo de entrada.

1. Localize o campo que você deseja configurar e selecione o ícone Editar campo para abrir o painel Editar campo para o campo selecionado.
2. Edite as configurações como desejar e selecione Salvar.

A tabela a seguir descreve as configurações da tabela.

Configuração	Description
Name	O nome do campo. Observação: o nome é um campo obrigatório.
DetecçãoAutomática	Permite que você identifique o tipo de campo no arquivo de entrada e aplique automaticamente o tipo de campo detectado para o campo na tabela de destino.
Tipo	O tipo de dados do campo. Texto Número inteiro Número decimal Booleano Data DateTime Observação: dependendo do tipo de campo, você deve especificar configurações de análise para configurar o campo.
Obrigatório	Opção para definir o campo como obrigatório. Se selecionado, o campo é obrigatório ao publicar ou importar o aplicativo de processos. Um erro será gerado se o campo estiver ausente. Se não for selecionado, o campo será considerado opcional. Quando estiver ausente, o campo será adicionado com valores NULL, para que as consultas SQL subsequentes não falhem.
Exclusivo	Opção para definir que o valor do campo tenha um valor distinto ou exclusivo para cada registro.
Não é NULL	Opção para definir que o campo deve ter um valor para cada registro. O campo não pode ficar vazio ou ser preenchido com um valor NULL.

Analisar configurações para tipos de campo

A tabela a seguir descreve as configurações de análise disponíveis para os diferentes tipos de campo.

Tipo de campo	Analisar configurações
Número inteiro	Separador de milhar Nenhum Ponto (.) Vírgula (,)
Número decimal	Separador Decimal Ponto (.) Vírgula (,) Separador de milhar Nenhum Ponto (.) Vírgula (,)
Booleano	Valor verdadeiro: TRUE ou 1 Valor FALSE FALSE ou 0 Observação: o valor Verdadeiro e o valor Falso são configurações obrigatórias e devem ser diferentes.
Data	Formato da data (Confira Exemplo de configurações de análise para formatos de data ).
DateTime	Formato de data e hora Formato de data (Confira as configurações de análise de exemplo para formatos de data e hora .)

Exemplo de configurações de análise para formatos de data

Format	Exemplo
yyyy-mm-dd	2025-04-05 2025-4-5
mm/dd/yy	04/05/25 4/5/25
mm/dd/yyyy	04/05/2025 4/5/2025
mm-dd-yyyy	04-05-2025 4-5-2025
dd-mm-yyyy	05-04-2025 5-4-2025
yyyy/mm/dd	2025/04/05

Exemplo de configurações de análise para formatos de data e hora

Format	Exemplo
yyyy-mm-dd hh:mm:ss[.nnn]	2025-04-05 14:30:45.123 2025-4-5 14:30:45.123
yyyy/mm/dd hh:mm:ss[.nnn]	2025/04/05 14:30:45.123 2025/4/5 14:30:45.123
mm/dd/yyyy hh:mm:ss[.nnn]	04/05/2025 14:30:45.123 4/5/2025 14:30:45.123 04/05/2025 14:30:45 4/5/2025 14:30:45
yyyy-mm-ddThh:mm:ss[.nnn]	2025-04-05T14:30:45.123 2025-4-5T14:30:45.123
mm-dd-yyyy hh:mm:ss[.nnn]	04-05-2025 14:30:45.123 4-5-2025 14:30:45.123 04-05-2025 14:30:45 4-5-2025 14:30:45
dd-mm-yyyy hh:mm:ss[.nnn]	05-04-2025 14:30:45.123 5-4-2025 14:30:45.123 05-04-2025 14:30:45 5-4-2025 14:30:45
yyyy-mm-ddThh:mm:ss[.nnn]+00:00*	2025-04-05T14:30:45.123+02:00 2025-04-05T14:30:45-03:00 2025-04-05T14:30:45 2025-4-5T14:30:45.123+02:00 2025-4-5T14:30:45-03:00 2025-4-5T14:30:45Z
yyyy-mm-ddThh:mm:ss[.nnn]+0000*	2025-04-05T09:30:00+0000 2025-04-05T09:30:00.123+0000
yyyy-mm-dd hh:mm:ss[.nnn]+00:00*	2025-04-05 09:30:00+00:00 2025-04-05 09:30:00.123+00:00
yyyy-mm-dd hh:mm:ss[.nnn]+0000*	2025-04-05 09:30:00+0000 2025-04-05 09:30:00.123+0000
dd/mm/yyyy hh:mm:ss[.nnn]	05/04/2025 14:30:45.123 5/4/2025 14:30:45.123
mm/dd/yy hh:mm:ss[.nnn] AM/PM	04/05/25 02:30:45 PM 4/5/25 02:30:45 PM

*) Os carimbos de data/horário que incluem informações de fuso horário são convertidos automaticamente em UTC durante a ingestão de dados.