dataloader

Solicitações de recursos

Envie sua solicitação de recurso como uma ideia no Salesforce IdeaExchange. Certifique-se de usar "Plataforma/Importação e integração de dados" como categoria para sua ideia.

Pré-requisitos

O Java Runtime Environment (JRE) é necessário para instalar e executar o Data Loader. Revise as instruções de instalação da versão mais recente para a versão necessária do JRE.

Instalando o carregador de dados

Salesforce oferece suporte oficial ao Data Loader para Windows e macOS. Todos os outros sistemas operacionais não são suportados. A lista de versões compatíveis do macOS e do Windows e da arquitetura de CPU para uma versão lançada do Data Loader é fornecida nas Notas de versão dessa versão.

instruções de instalação para macOS e Windows.

Instalando no Linux:

• Extraia o conteúdo do arquivo zip do Data Loader
• Renomeie install.command como install.sh
• Execute o comando em um terminal shell: ./install.sh

Executando o Data Loader no modo GUI

Para executar o Data Loader no macOS ou Windows, siga as instruções.

Para executar o Data Loader no Linux, digite o seguinte comando em um shell de comando:

 ./dataloader.sh

OR

java -jar dataloader-x.y.z.jar

Consulte a documentação para obter detalhes sobre como configurar e usar o Data Loader.

Executando o Data Loader no modo Batch

O modo em lote é oficialmente compatível apenas com Windows. Para executar o Data Loader no modo Lote no Windows, consulte Modo Lote para Windows.

Execute o seguinte comando no Mac (substitua dataloader_console por dataloader.sh no Linux):

 ./dataloader_console <config dir containing process-conf.xml and config.properties files> <process name> run.mode=batch

Como alternativa, execute um dos seguintes comandos:

 java -jar dataloader-x.y.z.jar <config dir containing process-conf.xml and config.properties files> <process name> run.mode=batch

OR

java -jar dataloader-x.y.z.jar salesforce.config.dir=<config dir containing process-conf.xml and config.properties files> process.name=<process name> run.mode=batch

Comandos para criar um arquivo de chave de criptografia, criptografar uma senha ou descriptografar uma senha

Consulte Modo em lote para Windows para obter etapas detalhadas para criar um arquivo de chave de criptografia, criptografar uma senha ou descriptografar uma senha no Windows.

O modo em lote requer a especificação de uma senha criptografada em process-conf.xml, config.properties ou como argumento de linha de comando. A primeira etapa para criptografar uma senha é criar um arquivo de chave de criptografia no Mac ou Linux.

Execute o seguinte comando para gerar um arquivo de chave de criptografia no Mac (substitua dataloader_console por dataloader.sh no Linux):

 ./dataloader_console -k [<encryption key file>] run.mode=encrypt

OR

java -jar dataloader-x.y.z.jar -k [<encryption key file>] run.mode=encrypt

Execute o seguinte comando para criptografar uma senha no Mac (substitua dataloader_console por dataloader.sh no Linux):

 ./dataloader_console -e <password in plain text> [<encryption key file>] run.mode=encrypt

OR

java -jar dataloader-x.y.z.jar -e <password in plain text> [<encryption key file>] run.mode=encrypt

Execute o seguinte comando para descriptografar uma senha no Mac (substitua dataloader_console por dataloader.sh no Linux):

 ./dataloader_console -d <encrypted password> [<encryption key file>] run.mode=encrypt

OR

java -jar dataloader-x.y.z.jar -d <encrypted password> [<encryption key file>] run.mode=encrypt

NOTA: esses comandos usam o arquivo de chave de criptografia padrão ${HOME}/.dataloader/dataloader.key se um arquivo de chave de criptografia não for especificado.

Relatando um problema

Colete as seguintes informações antes de entrar em contato com o suporte do Salesforce ou relatar um problema no GitHub:

• Versão do Data Loader, tipo e versão do sistema operacional de desktop, operação sendo executada e capturas de tela do problema.
• Arquivos de configuração: config.properties , log4j2.properties ou log-conf.xml , process-conf.xml .
• arquivo de registro:
  • Defina o nível de log como “debug” na caixa de diálogo Configuração avançada (v58 e posterior). Se o nível de log não estiver visível na caixa de diálogo Configurações avançadas (v57 ou anterior) ou se o nível de log não puder ser alterado na caixa de diálogo Configurações avançadas, defina o nível de log "raiz" como "depurar" em log-conf.xml .
  • Execute novamente o carregador de dados para reproduzir o problema.
  • Envie a saída de log localizada no arquivo mostrado pelas informações “Arquivo de saída de log” na caixa de diálogo Configurações avançadas de seu carregador de dados. As informações do arquivo de saída de registro são mostradas na caixa de diálogo Configurações avançadas a partir da v58.
  • Se você estiver usando v58 ou anterior, o local padrão do log de depuração é <tempdir>/sdl.log
  • O tempdir padrão é %USER%AppDataLocalTemp no Windows
  • O tempdir padrão é ${TMPDIR} no macOS
• Forneça um arquivo CSV de amostra contendo o mínimo possível de colunas e linhas para reproduzir o problema.
• Forneça as seguintes informações sobre sua organização (elas estarão disponíveis no arquivo de log se a versão do carregador de dados for > 58.0.0, o nível de log estiver definido como depuração e o usuário fizer login):
  • Org id : Configuração >> Informações da empresa >> valor do campo ID da organização do Salesforce
  • instance : Configuração >> Informações da empresa >> valor do campo Instância
  • User id : siga as instruções deste artigo.

NOTA: Remova todas as informações pessoais, específicas do negócio e todas as outras informações confidenciais dos arquivos que você compartilha (por exemplo, arquivos de configuração, arquivos de log, capturas de tela, arquivos csv e outros) antes de relatar um problema, especialmente em um fórum público como o github.

Construindo carregador de dados

Consulte a configuração da propriedade "<maven.compiler.release>" em pom.xml para descobrir a versão do JDK para compilar.

    git clone [email protected]:forcedotcom/dataloader.git
    cd dataloader
    git submodule init
    git submodule update
    mvn clean package -DskipTests
        or
    ./dlbuilder.sh

dataloader_v<xyz>.zip será criado no diretório raiz do clone git local.

Depurando o carregador de dados

Para executar o carregador de dados para depuração com um IDE (depuração remota, porta 5005), execute o seguinte comando na pasta raiz do clone git:

 ./rundl.sh -d

OR

java -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=5005 -cp target/dataloader-x.y.z.jar com.salesforce.dataloader.process.DataLoaderRunner salesforce.config.dir=./configs

Testando o carregador de dados

Veja o wiki de testes

Recursos

Para obter mais informações, consulte o Guia do carregador de dados do Salesforce.

As perguntas podem ser direcionadas para o fórum de código aberto.

Dependências e plug-ins

Atualize o SWT executando python3 <root of the git clone>/updateSWT.py <root of the git clone> . Requer python 3.9 ou posterior.

Todas as outras dependências e plug-ins são baixados pelo maven do repositório central do maven. Execute mvn versions:display-dependency-updates para ver quais dependências precisam de atualização. Ele listará todas as dependências cuja versão especificada em pom.xml precisa de atualização. Execute mvn versions:use-latest-releases para atualizar essas dependências. Execute mvn versions:display-plugin-updates novamente para verificar quais plug-ins ainda precisam de atualização e atualize suas versões manualmente.