JSON 가져오기

JSON 가져오기는 외부에서 제공된 JSON 형식의 데이터를 조직 내로 불러와 이를 해석하고 시스템에 적용하는 기능입니다. 사용자는 이 기능을 통해 기존에 저장해둔 리스트 구성기의 설정을 손쉽게 불러오거나, 새로운 설정을 추가 및 갱신하여 효율적으로 구성 환경을 관리할 수 있습니다.

---

🔸 가져오기

Import JSON 시작하기 버튼을 클릭하면 다른 조직에서 내보낸 리스트 구성기 설정을 가져오는 작업이 시작됩니다.

---

1

JSON 파일 업로드

가져오려는 리스트 구성기 설정 정보가 담긴 JSON 파일을 선택하여 업로드 합니다.

2

리스트 구성기 생성 및 업데이트

리스트 구성기는 Migration Key 연결 여부에 따라 새로 생성되거나, 기존 리스트 구성기가 업데이트됩니다. Migration Key는 가져온 리스트 구성기의 레코드 ID 입니다.

리스트 구성기 정보를 가져온 조직과 현재 조직의 SmallBuilder List 패키지 버전이 다를 경우, 리스트 구성기의 일부 개체나 필드가 누락될 수 있습니다.

번호	영역 및 버튼	설명
1	이전 버튼	JSON 파일 업로드 화면으로 돌아갈 수 있습니다. 잘못된 파일을 선택한 경우, 해당 버튼을 클릭하여 이전 화면으로 돌아가 업로드 과정을 다시 시작할 수 있습니다.
2	가져온 리스트 구성기 정보	현재 조직에 생성되거나 업데이트될 리스트 구성기 정보를 확인합니다.
3	현재 조직의 리스트 구성기 정보	현재 조직에 Migration Key가 연결된 리스트 구성기가 있는 경우 해당 리스트 구성기의 이름이 자동으로 표시되며, 연결된 리스트 구성기가 없는 경우 검색창이 나타납니다다. 검색창에서 Migration Key가 연결되지 않은 리스트 구성기를 조회할 수 있습니다. 조회된 리스트 구성기 중 하나를 선택하면 해당 리스트 구성기가 업데이트 되며, 아무것도 선택하지 않으면면 새로운 리스트 구성기가 생성됩니다.
4	변경사항 미리보기	현재 조직에 있는 기존 리스트 구성기 설정을 업데이트하는 경우 변경되는 항목들을 화면에서 확인할 수 있습니다.
5	생성 및 업데이트 버튼	가져온 리스트 구성기 설정 정보를 기반으로 리스트 구성기 생성 및 업데이트가 시작됩니다.

Migration Key 수동 연결하기

다른 조직에서 현재 조직으로 처음 가져오는 리스트 구성기의 경우 Migration Key가 연결되어 있지 않습니다. 가져온 리스트 구성기의 설정 정보를 사용하여 현재 조직에 존재하는 리스트 구성기를 업데이트 하고 싶은 경우 검색을 통해 Migration Key를 연결할 수 있습니다.

기존 리스트 구성기 조회

Migration Key가 연결되지 않고, 같은 Object로 만들어진 리스트 구성기만 조회됩니다.

업데이트할 리스트 구성기 선택

변경사항 미리보기

Migration Key가 연결되어 업데이트 되는 리스트 구성기의 경우 기존 리스트 구성기 설정에서 변경되는 항목들을 화면에서 확인할 수 있습니다.

3

결과 확인

가져온 리스트 구성기 설정 정보의 생성 및 업데이트 결과를 확인합니다.

누락된 개체 및 필드가 있을 경우

마이그레이션이 성공한 리스트 구성기에는 누락된 개체 및 필드 정보가 포함되지 않으며, 이러한 누락 항목은 결과 화면 하단에 별도로 표시됩니다. 개체 및 필드 누락은 SmallBuilder List 패키지 버전 불일치 또는 필드 권한 부족으로 발생할 수 있으므로, 패키지 버전 및 필드 권한을 확인해주시기 바랍니다.

실패한 리스트 구성기가 있을 경우

번호	영역 및 버튼	설명
1	목록 토글	실패한 리스트 구성기 목록을 열고 닫을 수 있습니다.
2	리스트 구성기 선택	실패한 리스트 구성기 중 다시 JSON 파일로 내보낼 리스트 구성기를 선택할 수 있습니다다.
3	실패한 리스트 구성기 정보	실패한 리스트 구성기의 정보를 확인할 수 있습니다.
4	실패 사유 요약	실패한 사유를 리스트 구성기 설정 개체별로 요약하여 나타냅니다.
5	실패 사유 상세	실패한 사유를 리스트 구성기별로 상세하게 확인 할 수 있습니다.
6	내보내기	선택한 리스트 구성기의 JSON 파일을 내려받을 수 있습니다.

🔻 실패 사유 상세

마이그레이션이 실패한 사유를 상세하게 확인할 수 있으며, Migration Key를 통해 오류가 발생한 개체를 쉽게 파악할 수 있습니다.