구성 옵션의 일괄 프로비저닝
옵션의 구성 옵션을 만들거나 수정하려면 신규 및/또는 변경된 옵션 및 값이 포함된 CSV(쉼표로 구분된 값) 파일을 업로드합니다. 해당 열 개체에 옵션 및 값을 입력하거나 수정합니다. GAX에 업로드한 경우 작업 열에 표시된 대로 수행할 작업에 따라 파일에 나열된 옵션이 생성되거나 수정됩니다.
GAX를 사용해서 선택한 옵션의 정보를 다운로드하거나 내보낼 수도 있습니다. 원하는 경우, 이 다운로드를 사용하여 데이터 업로드에 사용되는 "템플릿"을 만들 수 있습니다.
이 구성 옵션 가져오기/내보내기 기능은 모든 개체 유형에 사용할 수 있습니다.
내보내기 옵션
GAX를 통해 선택한 옵션을 스프레드시트에 내보낼 수 있습니다. 필요에 따라 스프레드시트를 수정하고, .csv 또는 .cfg 파일로 저장하며, GAX에 다시 업로드할 수 있습니다. 또는 스프레드시트에서 데이터를 제거하거나(열 머리글은 제거하지 않음), "빈" 템플릿을 사용해서 구성 옵션을 업로드할 수 있습니다.
옵션을 내보내려면 다음을 수행합니다.
- Configuration Manager에서, 옵션을 내보낼 개체의 옵션 탭을 엽니다.
- 내보낼 섹션과 옵션을 선택합니다.
- 오른쪽 상단 옵션 목록 위에 있는 추가 메뉴에서 내보내기를 클릭합니다.
- 옵션 내보내기 대화 상자에서, 출력 파일 형식을 CFG 또는 CSV로 선택하고 내보내기를 클릭합니다.
출력 파일이 생성되어 브라우저로 다운로드됩니다. 파일 이름은
<object type>_annex_<object DBID>.csv 또는 cfg
형식으로 표시됩니다. 예를 들어
CfgPerson_annex_6378.cfg 또는 CfgPerson_annex_6378.cfg로 표시됩니다.
파일 업로드
일괄 업데이트를 업로드하기 전에, 데이터를 스프레드시트에 입력한 후 CSV 파일로 저장해야 합니다. 다음 사항에 유의해야 합니다.
- 업데이트의 대부분이 새 옵션을 개체에 추가하는 작업인 경우에는 빈 템플릿을 만들어 적절한 값을 입력합니다.
- 업데이트의 대부분이 기존 옵션을 변경하는 작업인 경우에는 변경하려는 옵션만 내보내고 변경을 수행합니다.
데이터를 GAX로 업로드하려면 다음을 수행합니다.
- Configuration Manager에서, 옵션을 업로드할 개체의 옵션 탭을 엽니다.
- 오른쪽 상단 옵션 목록 위에 있는 추가 메뉴에서 가져오기를 클릭합니다.
- 개체 가져오기 대화 상자에서 다음을 수행합니다.
- 파일 선택을 클릭하고 변경사항이 포함된 .csv 또는 .cfg 파일을 선택합니다.
- 개체에 이미 있을 수 있는 모든 옵션에 대해 정확하고 최신 상태의 값이 파일에 있다고 확신할 경우 기존 옵션 덮어쓰기를 선택합니다. 그렇지 않은 경우 공백으로 둡니다.
- 업로드를 클릭합니다.
- 레코드가 처리되면 결과를 요약하여 보여주는 작업 완결됨 대화 상자가 표시됩니다. 닫기를 클릭하고 옵션 탭으로 돌아갑니다.
소스 파일
GAX는 구성 옵션 가져오기 및 내보내기에 .csv(쉼표로 구분된 값) 및 .cfg 파일을 사용합니다. 두 형식은 모두 문자열 가져오기 및 내보내기 옵션만 지원합니다. 다른 유형의 구성 옵션은 무시되며 가져오거나 내보낼 수 없습니다. 이 파일의 모든 문자열은 UTF-8로 인코딩되어야 합니다.
CSV 소스 파일에서 각 줄은 단일 구성 옵션을 나타냅니다. 소스 파일에서 동일한 옵션은 한 번만 나타날 수 있습니다. 구성 옵션 섹션이 개체 구성에 아직 없으면 만들어집니다. 소스 파일 범위에 있는 옵션의 고유 식별자는 섹션 필드와 키 필드를 조합한 것입니다. 파일에는 구성 옵션 섹션, 옵션 이름(키), 옵션 값에 사용되는 3개의 열이 있으며, 파일의 첫 번째 행에 있는 항목(섹션, 키, 값)에 따라 각각 이름이 지정됩니다. 열 순서는 중요하지 않습니다. 각 열 항목 뒤에 쉼표가 삽입됩니다. 소스 파일에서는 각 옵션에 대해 다음과 같은 정보가 포함됩니다.
| 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| 섹션 | 문자열 | 예 | 구성 파일의 이름입니다. |
| 키 | 문자열 | 예 | 옵션의 이름입니다. |
| 값 | 문자열 | 아니요 | 옵션의 새 값입니다. |
CFG 파일에서, 각 섹션 및 옵션은 별도의 줄에 표시되며 섹션 이름은 대괄호로 묶여 있습니다. 각 섹션 다음에는 해당 섹션의 옵션 목록이 다음과 같은 적절한 값과 함께 표시됩니다.
[section_name1]
option-name1=option_value2
...
option_nameN=option_valueN
[section_name2]
option-nameN+1=option_valueN+1
...
예
다음 데이터가 GAX에 업로드되어 기존 사용자 개체에 대해 2개의 신규 옵션을 추가합니다.
| 섹션 | 키 | 값 |
|---|---|---|
| gaxproperties | datemodified | 1478163902397 |
| htcc | roles | 상담원 |
이 데이터에 대한 CSV 파일은 다음과 같습니다.
Section,Key,Value
gaxproperties,datemodified,1478163902397
htcc,roles,AgentGAX에서 CFG 파일로 내보낸 동일한 정보는 다음과 같습니다.
[gaxproperties]
datemodified=1478163902397
[htcc]
roles=Agent