SFTP - 사용자 정의 필드 사용 안내

목차

• SFTP - 사용자 정의 필드 사용 안내
  • 사용자 정의 필드 응답 파일 처리 방식
  • 파일 형식 및 파일명 규칙
  • 업로드 주기 및 일정 관리
  • 사용자 정의 필드 파일 형식

이 안내에서는 파일 업로드가 원활하게 진행될 수 있도록 꼭 알아두셔야 할 정보를 담고 있습니다.

SFTP에 대한 기본 안내 및 추가 정보는 SFTP - 설정 방법를 참고해 주세요.

사용자 정의 필드 응답 파일 처리 방식

Spotnana에서는 파일을 업로드할 때마다 전체 또는 일부 사용자 정의 필드 응답 데이터를 보내실 수 있습니다. 파일명에는 어떤 사용자 정의 필드와 응답 목록에 대한 데이터인지가 표시됩니다. 각 사용자 정의 필드와 그에 대한 응답은 반드시 별도의 파일로 업로드해야 하며(파일명 규칙은 아래에서 자세히 안내합니다), 업로드한 CSV 파일의 데이터는 다음과 같은 방식으로 처리됩니다:

• 해당 행의 ACTION 컬럼이 CREATE로 설정되어 있으면, 해당 응답 옵션이 새로 생성됩니다.

• 해당 행의 ACTION 컬럼이 UPDATE 이고 이미 해당 응답 옵션이 존재한다면, 해당 응답의 설명이 업데이트됩니다.

해당 행의 ACTION 컬럼이 DELETE 로 설정된 경우, 해당 응답 옵션이 삭제됩니다. 만약 Spotnana 데이터베이스에 일치하는 응답 옵션이 없다면, 해당 행은 건너뛰고 아무 작업도 하지 않습니다.

파일 형식 및 파일명 규칙

각 .CSV 사용자 정의 필드 파일명은 다음과 같은 형식을 따라야 합니다:

CUSTOM_FIELD_V3_OPTIONS.[customFieldID].[optionGroupID].*.csv

여기서:

• [customFieldID] 는 각 필드마다 달라지는 값입니다. 이 ID는 2단계 의 SFTP 가져오기 안내 대화상자(Import from SFTP directory 안내의 일부)에 표시된 파일명에 포함되어 있습니다. 

• [optionGroupID] 는 각 응답 목록마다 달라지는 값입니다. 이 ID 역시 2단계 의 SFTP 가져오기 안내 대화상자(Import from SFTP directory 안내의 일부)에 표시된 파일명에 포함되어 있습니다.  

• * (와일드카드)는 파일명에 추가로 원하는 어떤 문자든 넣을 수 있음을 의미합니다. 

• [optionGroupID] 뒤의 “.”와 “csv” 앞의 “.”는 반드시 포함되어야 합니다. 파일명은 대소문자를 구분하지 않습니다. 추후 문제 해결을 쉽게 하기 위해 파일명에 날짜와 시간을 넣는 것을 권장합니다. 예시: 

CUSTOM_FIELD_V3_OPTIONS.[customFieldID].[optionGroupID].spotnana_integration_

<DateTime>.csv.CSV 파일은 반드시 정해진 형식에 맞춰야 하며, 컬럼명도 아래에 안내된 형식과 정확히 일치해야 합니다(자세한 내용은

사용자 정의 필드 형식 섹션을 참고해 주세요). 업로드 주기 및 일정 관리 

파일 업로드는

매일 진행하시는 것을 권장합니다. 사용자 정의 필드에 변동이 자주 있다면 매일 업데이트하시는 것이 좋습니다. 이렇게 관리하시면: 새로운 응답 옵션은 여행자가 결제 시 바로 선택할 수 있게 됩니다. 

• 더 이상 사용하지 않는 응답 옵션은 선택지에서 사라지며, 여행자가 선택할 수 없게 됩니다. 

• 단, 사용 중단된 응답 옵션도 보고서에서는 계속 확인하실 수 있습니다. 

사용자 정의 필드 파일 형식

아래 정보를 참고하셔서 사용자 정의 필드 파일이 올바른 형식으로 준비되었는지 꼭 확인해 주세요.

컬럼