Data Loader를 일괄 처리 모드로 사용할 때의 설정 절차

먼저 설정 파일에서 사용할 암호화 키를 생성합니다. 

 

1. Data Loader의 설치 디렉토리로 이동합니다. 

[cd C:\Program Files (x86)\salesforce.com\Data Loader\bin] 

2. 임의의 문자열을 이용하여 암호화 키를 생성합니다. 명령어 중에서 <seedtext>는 임의의 문자열로 대체합니다. 

[encrypt.bat -g <seedtext>] 

3. 출력된 다음과 같은 콘솔의 *************** 부분을 텍스트 파일에 복사하고 "key.txt"로 저장합니다. 해당 키는 다음 단계에서 비밀번호를 암호화할 때 사용합니다. 

[security.EncryptionUtil main (EncryptionUtil.java:304) - ***************] 

Windows 명령 프롬프트에서 암호화 키 생성하기(Data Loader 버전 43, 44인 경우)

1. Data Loader의 설치 디렉토리로 이동합니다. 

[cd C:\Program Files (x86)\salesforce.com\Data Loader\bin] 

2. 암호화 키 파일을 생성합니다. 명령어 중의 <path to key file>은 임의의 디렉토리 및 파일명(확장자는 .key로 지정)으로 대체합니다. <path to key file>을 지정하지 않는 경우, "C:\Users\<Windows 사용자명>\.dataloader\dataLoader.key"로 암호화 키 파일이 생성됩니다.

[encrypt.bat -k <path to key file>] 

3. 암호화 키 파일이 생성된 것을 확인합니다. 해당 파일은 다음 단계에서 비밀번호를 암호화할 때 사용합니다. 

예: [Keyfile "C:\Users\<Windows 사용자명>\.dataloader\dataLoader.key" was created!] 

 

이어서 암호화 비밀번호를 생성합니다. 

암호화 키를 이용하여 Data Loader의 비밀번호를 암호화 비밀번호로 변환합니다. <password>는 Data Loader가 Salesforce에 로그인하기 위해 사용하는 비밀번호, <filepath>는 "key.tet"를 저장한 디렉토리로 대체하여 명령 프롬프트에서 실행합니다. 

[encrypt.bat -e <password> "<filepath>\key.txt"] 

 

로그인 사용자명의 암호화 비밀번호 만들기(Data Loader 버전 43 이상인 경우)

암호화 키 파일을 이용하여 Data Loader의 비밀번호를 암호화 비밀번호로 변환합니다. <password>는 Data Loader가 Salesforce에 로그인하기 위해 사용하는 비밀번호, <filepath>는 ".key"를 저장한 디렉토리로 대체하여 명령 프롬프트에서 실행합니다. 

예: [encrypt.bat -e <password> "C:\Users\<Windows사용자명>\.dataloader\dataLoader.key"] 

 

## 비고1 ## 

암호화 비밀번호는 나중에 설정 파일에서 Salesforce의 로그인 비밀번호로 사용합니다. 또한 암호화는 설정 파일상의 비밀번호를 보호할 목적으로 실행합니다. 

 

## 비고2 ## 

Data Loader에 로그인하기 위한 비밀번호는 일반적으로 Saleforce에 로그인하기 위한 비밀번호와 다르며, 여기에는 보안 토큰이 필요합니다. 보안 토큰을 사용하는 경우, 로그인 비밀번호 끝자리에 보안 토큰을 이어붙인 뒤 암호화하여 sfdc.password로 설정해야 합니다. 보안 토큰을 획득하는 방법은 아래의 글을 참조해 주세요.

「보안 토큰 재설정」
 

 

 

다음으로 입력 파일과 출력 파일의 매핑용 파일을 만듭니다. 

 

1. 매핑 파일을 새로 만들고 확장자로 .sdl을 지정합니다. 

2. 다음 구문에 따라 매핑 파일을 만듭니다. 

 

설정 예는 아래와 같습니다. 

 

<데이터 삽입 열의 매핑 예> 

----- 

SLA__C=SLA__c 

BILLINGCITY=BillingCity 

----- 

 

## 비고 ## 

이번에는 Insert를 예로 들어 설명하고 있으므로 왼쪽을 Insert할 파일의 열 이름, 오른쪽을 삽입처(Salesforce)의 항목명으로 설정했습니다. 

각 항목의 자세한 내용 등은 아래를 참고해 주세요. 

 

「Create the Field Mapping File」

 

 

이어서 Data Loader의 설정 파일을 만듭니다. 

 

Data Loader가 데이터를 처리하기 위한 설정 파일 만들기 

 

1. Data Loader의 설치 디렉토리의 [\samples\conf] 디렉토리에서 [process-conf.xml] 파일을 복사합니다. 

2. 고객의 로그인 정보, 설정 파일, 처리에 필요한 각 파일의 정보를 [process-conf.xml]에 덮어쓰기합니다. 

 

<설정 예> 

----- 

<entry key="sfdc.endpoint" value="https://login.salesforce.com"/> 

<entry key="sfdc.username" value="hogehoge@test"/> 

<entry key="sfdc.password" value="******암호화 비밀번호*****"/> 
<entry key="process.encryptionKeyFile" value="key.txt"/> //(Data Loader 버전 42 이하인 경우)
<entry key="process.encryptionKeyFile" value="C:\Users\<Windows 사용자명>\.dataloader\dataLoader.key"/> //(Data Loader 버전 43인 경우)
<entry key="process.mappingFile" value="test.sdl"/> 
<entry key="dataAccess.name" value="test_data.csv"/> 
<entry key="sfdc.debugMessages" value="true"/> 
<entry key="sfdc.debugMessagesFile" value="testMap.sdl"/> 
<entry key="process.outputSuccess" value="C:\test\success.csv"/> 
<entry key="process.outputError" value="C:\test\error.csv"/> 
<entry key="dataAccess.type" value="databaseWrite"/> 

 

----- 

 

 

 

각 항목의 자세한 내용은 아래를 참고해 주세요. 

 

「Create the Configuration File」

「Data Loader Process Configuration Parameters」

 

 

 

마지막으로 프로세스를 명령줄에서 실행합니다. 

 

명령 프롬프트에서 처리를 실행합니다. 

<file path to process-conf.xml>을 process-conf.xml을 포함하는 디렉토리 경로로, <process name>을 process-conf.xml에 지정된 프로세스로 각각 대체합니다.

 

[process.bat "<file path to process-conf.xml>" <process name>] 

 

※[process-conf.xml에 지정된 프로세스]는 beans의 프로세스이며, [bean id="*****"]의 "" 부분을 의미합니다. 

 

이상의 순서를 실행하면 Data Loader를 GUI가 아닌 명령줄에서 실행할 수 있습니다.

 

아래의 관련 글을 참조해 주세요. 

 

「Run in Batch Mode (Windows Only)」 

「Data Loader Command Line Introduction」