매트릭스 로더 CSV 필드 및 필드 옵션 업로드 및 익스포트

CSV 필드 업로드

매트릭스 로더를 통해 모든 필드 유형을 추가하고 편집할 수 있습니다. 이 섹션에서는 판독기가 스프레드시트 파일(Google 스프레드시트, Microsoft Excel 또는 이와 유사한 파일)에서 작업한 다음 결과를 CSV 파일로 내보내 매트릭스 로더에 업로드한다고 가정합니다. 이 항목에서는 매트릭스 로더가 필드 업로드에 허용하는 열과 데이터를 간략하게 설명합니다.

표 1. CSV 파일 열
열 이름	설명	유효한 값	메모
field_type	필드의 데이터 유형을 정의합니다.	텍스트 \| textField 부울 \| booleanField 번호 \| numberField 선택 목록 \| 선택 목록 필드	필수
이름	관리자가 필드 목록에서 보는 이름 관리자 페이지	유효한 문자열은 문자, 숫자, 공백 및 { `}[]()\|\~'_^@?<=>;:/.-,+*ʼ&%$#"!`	필수
variableName	필드를 참조하는 데 사용되는 고유 문자열	유효한 필드 변수 이름은 최대 128개의 문자, 숫자 및 밑줄로 구성됩니다. 첫 번째 및 마지막 문자는 문자 또는 숫자여야 합니다.	필수입니다. 고유해야 함
필수	애플리케이션에서 현재 사용하고 있지 않음	예 \| 아니오 <비어 있음>	선택 사항; 애플리케이션에서 현재 사용하지 않음
defaultValue	구성 환경이 시작될 때 필드에 초기 값을 입력하십시오.	[참고 참조]	선택 사항; textField, booleanField, numberField 및 단일 pickListField와만 관련이 있습니다. 다중 pickListFields는 fieldOptions 업로드 파일에서 기본값을 설정합니다.
minLength	허용되는 최소 문자 수	<번호>	선택 사항; textField에만 관련됨
maxLength	허용되는 최대 문자 수	<번호>	선택 사항; textField에만 관련됨
정밀도	소수점 오른쪽에 정밀도 자릿수 정의	<번호>	선택 사항; numberField에만 관련
minValue	허용되는 최소 숫자 값	<번호>	선택 사항; numberField에만 관련
maxValue	허용되는 최대 숫자 값	<번호>	선택 사항; numberField에만 관련
selectType	pickListField가 단일 선택인지 다중 선택인지 여부 정의	단일 다중 <비어 있음>	선택 사항; pickListField와만 관련이 있습니다. <empty>인 경우 단일 것으로 간주합니다.

주:

필드에 정의된 값이 있으면 기본값은 정의된 값 중 하나를 따라야 합니다. 예:

유효한 부울 필드 기본값은 TRUE 및 FALSE입니다.
숫자 필드에 minValue 또는 maxValue가 정의된 경우 지정된 기본값이 정의를 따라야 합니다.
단일 pickListField의 기본값은 필드에 대해 정의된 옵션 값과 일치해야 합니다. 이 옵션 값은 필드 CSV 파일과 동일한 배치로 매트릭스 로더에서 처리되는 필드 옵션 CSV 파일에서 정의할 수 있습니다.
텍스트 필드 값은 2,000자로 제한됩니다.

열 순서는 고정되어 있지 않습니다. 편의를 위해 관리자는 스프레드시트의 열과 결과 CSV 파일을 다시 정렬할 수 있습니다.

필드 업로드 설명자 파일은 매트릭스 로더에서 허용되는 다양한 필드와 필드 매개변수를 보여줍니다. 회색 배경의 셀은 셀이 행의 컨텍스트와 관련이 없음을 나타냅니다. 설명 파일을 다운로드하려면 매트릭스 로더에서 샘플 파일 섹션의 필드 링크를 클릭합니다.

주:

이 파일의 콘텐츠는 있는 그대로 환경에 업로드할 수 없습니다. 대신 형식 예제를 사용하여 현재 프로젝트의 요구 사항을 충족하는 업로드 파일을 빌드하고, CSV 형식으로 내보낸 다음, 매트릭스 로더를 사용하여 사용자 환경에 업로드합니다.

관리자 UI를 통해 추가된 필드가 하나 이상의 Blueprint와 연결되어야 하는 것처럼 매트릭스 로더를 통해 대량으로 추가되는 필드도 연결되어야 합니다. 지침은 Blueprint에 필드 연결 문서를 참조하십시오.

CSV 필드 익스포트

편의를 위해 관리자는 다음 단계를 통해 환경에 정의된 필드 및 필드 옵션의 CSV 파일을 익스포트할 수 있습니다.

관리자 탐색 창에서 필드를 클릭합니다.
정의된 모든 필드의 목록이 표시됩니다.
(선택 사항) 검색 문자열을 입력하고 <Enter>를 눌러 필드 목록의 범위를 좁힙니다.
익스포트를 클릭합니다. 페이지 하단에 메시지가 임시로 나타납니다.
왼쪽 아래 모서리에 있는 알림 센터를 클릭합니다.
다운로드를 클릭하여 CSV 파일을 다운로드합니다.

결과 ZIP 파일에는 필드 CSV 파일과 필드 옵션 CSV 파일이 포함됩니다.

CSV 필드 옵션 업로드

필드 옵션 업로드는 pickListField 옵션과 속성을 정의합니다. 이 섹션에서는 판독기가 스프레드시트 파일(Google 스프레드시트, Microsoft Excel 또는 이와 유사한 파일)에서 작업한 다음 결과를 CSV 파일로 다운로드/익스포트하여 매트릭스 로더에 업로드한다고 가정합니다. 다음은 매트릭스 로더가 필드 옵션 업로드에서 허용하는 열과 데이터를 간략하게 설명합니다.

표 2. CSV 파일 열
열 이름	설명	유효한 값	메모
variableName	이 행의 옵션이 추가될 필드의 변수 이름	<필드 variableName>	필수
이름	최종 사용자에게 표시되는 옵션 이름	유효한 문자열은 문자, 숫자, 공백 및 { `}[]()\|\~'_^@?<=>;:/.-,+*ʼ&%$#"!`	필수
값	고유 문자열은 필드 옵션을 참조하는 데 사용됩니다.	유효한 필드 옵션 변수 이름은 최대 128개의 문자, 숫자 및 밑줄로 구성됩니다. 첫 번째 및 마지막 문자는 문자 또는 숫자여야 합니다. 필드 옵션 변수 이름은 동일한 필드의 범위에서 고유해야 합니다.	필수
defaultValue	구성 환경이 시작될 때 필드에 초기 값을 입력하십시오.	예 아니오 <비어 있음>	선택 사항; 다중 pickListFields에만 관련
extendedDescri ption	관리자 참조에 대한 상황별 설명	유효한 문자열은 문자, 숫자, 공백 및 { `}[]()\|\~'_^@?<=>;:/.-,+*ʼ&%$#"!`	옵션
이미지 URL	이미지에는 이 pickListField 옵션의 최종 사용자가 표시됩니다.	<URL>	선택 사항; pickListField와 함께 사용합니다. 디스플레이 유형은 레이아웃에서 VisualPicker 또는 MultiSelectVisua lPicker로 정의됩니다.

필드 업로드 설명자 파일은 매트릭스 로더에서 허용되는 다양한 필드 옵션과 필드 옵션 매개변수를 보여줍니다. 회색 배경의 셀은 셀이 행의 컨텍스트와 관련이 없음을 나타냅니다. 설명 파일을 다운로드하려면 매트릭스 로더에서 샘플 파일 섹션의 필드 링크를 클릭합니다.

주:

이 파일의 콘텐츠는 있는 그대로 환경에 업로드할 수 없습니다. 대신 형식 예제를 사용하여 현재 프로젝트의 요구 사항을 충족하는 업로드 파일을 빌드하고, CSV 형식으로 내보낸 다음, 매트릭스 로더를 사용하여 사용자 환경에 업로드합니다.

필드 옵션 CSV 익스포트

필드 옵션은 필드를 익스포트 CPQ하는 데 사용되는 것과 동일한 동작으로 익스포트됩니다. 지침은 위의 "CSV 필드 익스포트" 섹션을 참조하십시오.

CSV 업로드: 제품 선택기

이 섹션에서는 다음 제품/옵션을 포함하는 "내 제품 선택기"라는 제품 선택기를 만드는 단계를 간략하게 설명합니다.

옵션 1/제품 1 - 제품 1
옵션 2/제품 2 - 제품 2
옵션3/제품 3 - 제품 3

제품 선택기를 만들려면 다음 단계를 따르십시오.

매트릭스 로더에서 필드에 대한 샘플 CSV 파일을 추출합니다.
이 CSV 파일에는 제품 선택기를 만드는 데 필요한 필드 정보가 포함되어야 합니다. 샘플 파일의 맨 위에 필드 유형을 제품 선택기로 지정하는 줄을 추가해야 합니다(이 필드 유형은 샘플 파일에 없을 수 있음).
매트릭스 로더에서 필드 옵션에 대한 샘플 CSV 파일을 추출합니다.
이 CSV 파일에는 이전 단계에서 작성된 필드의 최종 사용자 UI에 표시될 제품 이름이 포함되어야 합니다.
새 .yaml 파일을 생성합니다.
이 파일에는 1단계의 CSV 파일에 정의된 대로 제품 선택기에 포함된 필드가 포함되어야 합니다. .yaml 파일은 매트릭스 로더에서 업로드 프로세스 중에 두 개의 CSV 파일을 연결하는 데 사용됩니다. 그러지 않으면 제품 선택기가 생성되지 않습니다.
.yaml 구문의 예:
```
---
- variableName: myProductPicker
	fields:
	- variableName: myProductPicker.value
		target: ProductId
	- variableName: myProductPicker.select
	- variableName: myProductPicker.quantity
		target: ProductQuantity
```
매트릭스 로더에 파일 업로드: 이전 단계의 두 .csv 파일과 .yaml 파일을 압축한 폴더로 압축합니다. 그런 다음 매트릭스 로더로 이동하여 압축된 폴더를 업로드하고 가져오기를 클릭한 다음 계속을 클릭합니다.
UI에서 확인: 새로 만든 제품 선택기는 아래와 같이 관리자 필드에서 CPQ 사용할 수 있어야 합니다.

CSV 익스포트: 제품 선택기

제품 선택기를 익스포트하려면 관리자의 CPQ 필드를 클릭합니다. 제품 선택기를 클릭하고 내보낼 제품 선택기를 선택한 다음 내보내기를 클릭합니다.