WPS 다차원 테이블 데이터 소스 구성
WPS 다차원 테이블 데이터 소스는 오프라인 동기화를 통해 WPS 다차원 테이블의 데이터를 읽어 플랫폼의 기본 스토리지에 쓰는 데 사용됩니다. 이 문서에서는 WPS의 앱 권한 부여, 데이터 소스 구성, 동기화 계획 생성, 작업 플로우 연결 방법을 소개합니다.
사용 제한 및 사전 준비
구성을 시작하기 전에 다음 제한 사항과 사전 조건을 확인하십시오.
- WPS 다차원 테이블은 데이터 소스로만 사용할 수 있으며 데이터 목적지는 플랫폼의 기본 스토리지입니다. WPS 다차원 테이블에 데이터를 다시 쓰는 기능은 지원하지 않습니다.
- WPS 기업 계정을 준비해야 하며, 권한이 있는 담당자가 기업 자체 개발 앱 생성, API 권한 신청 및 버전 심사 제출을 진행해야 합니다. 필요한 오픈 기능 이용 자격을 기업이 갖추고 있는지 기업 관리자에게 확인하십시오.
- 대상 WPS 다차원 테이블의 문서 링크를 준비하고 앱에 파일 읽기 권한이 있는지 확인한 후 읽을 데이터 테이블과 뷰를 결정해야 합니다.
- 플랫폼 실행 환경에서 WPS 오픈 플랫폼에 접근할 수 있어야 합니다. 앱에서 IP 허용 목록을 사용하는 경우 서버의 실제 외부 통신용 IP를 미리 준비하십시오.
- 읽을 수 있는 필드 범위는 선택한 데이터 테이블과 뷰를 기준으로 합니다. 먼저 데이터 미리보기에서 필드와 내용을 확인하십시오.
| 환경 설정 방식 | 활용 상황 | 설정 요구 사항 |
|---|---|---|
| 환경 구분 없음 | 개발 환경과 운영 환경이 하나의 WPS 앱을 공유 | App ID, App Key 및 API 요청 서명 설정 한 세트를 입력 |
| 독립 환경 설정 | 개발 환경과 운영 환경이 서로 다른 WPS 앱 설정을 사용 | 각 환경을 별도로 설정. 두 앱 모두 동기화 계획에서 선택한 문서, 데이터 테이블 및 뷰에 접근할 수 있어야 함 |
설정 검증과 데이터 미리보기에는 개발 환경 설정을 사용하고, 수동 실행에는 운영 환경 설정을 사용합니다. 독립 환경 설정에서는 앱 권한, 문서 읽기 권한, API 요청 서명 및 서버 외부 통신용 IP를 각각 확인하십시오.
WPS 오픈 플랫폼에서 권한 부여 완료
- 기업 계정 준비. WPS 365에 로그인하여 페이지 안내에 따라 기업을 생성하거나, 기업 관리자에게 초대를 요청하여 기존 기업에 가입합니다. 이어서 같은 계정으로 WPS 개발자 콘솔에 로그인하고 이번 연동에 해당하는 기업을 선택합니다. 필요한 오픈 기능과 이용 자격은 기업 관리자가 WPS에 확인해야 합니다.
- 기업 자체 개발 앱 생성. 개발자 콘솔에서 앱 생성을 클릭하고 기업 자체 개발 앱을 선택한 후 이름, 설명 등을 입력합니다. 생성 후 App ID와 App Key를 확보하여 연동 담당자에게 전달하고 데이터 소스를 설정하도록 합니다. 구체적인 절차는 기업 자체 개발 앱 생성을 참조하십시오.
- 읽기 권한 신청 및 심사 완료. 앱의 권한 관리에서 아래 표의 권한을 신청하고 앱 권한 부여(app) 타입을 선택합니다. 이어서 앱 버전을 생성하여 배포 신청을 제출하고 기업 관리자의 승인을 받아야 권한이 적용됩니다. 앱 기능 정보 설정을 참조하십시오.
| 기능 이름 | 권한 scope | 권한 타입 |
|---|---|---|
| 다차원 테이블 조회 | kso.dbsheet.read | 앱 권한 부여(app) |
- 문서 읽기 권한 준비. 문서 담당자가 대상 다차원 테이블의 소유 관계, 접근 범위 및 권한 설정을 확인하여 앱이 문서를 읽을 수 있도록 합니다. 앱 API 권한과 파일 권한이 모두 요구 사항을 충족해야 합니다. 사용자가 브라우저에서 문서를 열 수 있다고 해서 앱에 읽기 권한이 부여된 것은 아닙니다. 파일 읽기 권한 요구 사항은 WPS 다차원 테이블 읽기 설명을 참조하십시오. 이후 설정에 사용할 문서 링크(예:
https://www.kdocs.cn/l/ExampleID)를 복사합니다. - 보안 설정 구성. 앱의 보안 설정에서 기업 보안 요구 사항에 따라 API 요청 서명을 설정하고 그 상태를 연동 담당자에게 전달하여 WPS 측과 데이터 소스의 설정이 일치하도록 합니다. IP 허용 목록을 사용해야 하는 경우 운영 담당자에게 WPS에 접근하는 서버의 실제 외부 통신용 IP를 요청하고 필요한 IP를 모두 허용 목록에 추가하십시오. 작업자 컴퓨터의 IP가 아닌 서버의 외부 통신용 IP를 입력해야 합니다. 환경이나 노드마다 외부 통신용 IP가 다르면 각각 설정해야 합니다. WPS 호출 절차 및 보안 설정을 참조하십시오.
App Key를 안전하게 보관하고 안전한 방식으로 전달하여 스크린샷, 로그 또는 공개 문서에 노출되지 않도록 하십시오. 이미 연동된 앱의 API 요청 서명이나 IP 허용 목록을 변경하기 전에는 기존 동기화 작업에 영향을 주지 않도록 연동 담당자와 먼저 확인하십시오.
WPS 다차원 테이블 데이터 소스 생성
- 데이터 개발 플랫폼 > 통합 > 데이터 소스로 이동하여 + 데이터 소스를 클릭합니다.
- WPS 다차원 테이블을 선택하고 다음을 클릭한 후 데이터 소스 이름과 비고를 입력합니다.
- 환경 구분 없음 또는 독립 환경 설정을 선택합니다. 독립 환경 설정에서는 개발 환경과 운영 환경을 각각 설정해야 합니다.
- 앱의 App ID, App Key를 입력하고 WPS 앱의 보안 설정에 따라 API 요청 서명을 설정합니다.
- 연결 테스트에서 테스트를 클릭하고 앱 인증에 성공했는지 확인한 후 완료를 클릭합니다.
| 구성 항목 | 설명 |
|---|---|
| App ID | WPS 기업 자체 개발 앱의 App ID |
| App Key | 해당 앱의 App Key |
| API 요청 서명 | WPS 앱의 API 요청 서명 설정과 일치시켜야 하며 기업 보안 요구 사항에 따라 설정 |
연결 테스트는 앱 인증만 검증합니다. 문서 접근 권한과 API 요청 서명은 다음 절의 데이터 로드 또는 데이터 미리보기로 검증해야 합니다. 테스트를 통과한 후에도 소스 설정과 미리보기를 계속 진행하십시오.
저장된 데이터 소스를 편집할 때 App Key는 기본적으로 마스킹되어 표시됩니다. 자격 증명을 교체하려면 새 App Key를 입력하고 연결 테스트를 다시 수행한 후 문서 접근을 검증하십시오.
오프라인 동기화 계획 생성
- 데이터 개발 플랫폼 > 통합 > 오프라인 동기화로 이동하여 + 통합 방안을 클릭합니다.
- 데이터 소스에서 WPS 다차원 테이블과 생성한 데이터 소스를 선택합니다.
- WPS 다차원 테이블 URL에 문서 링크(예:
https://www.kdocs.cn/l/ExampleID)를 입력하고 URL 검증을 클릭합니다. - URL 검증과 로드에 성공하면 읽을 데이터 테이블을 선택한 후 그 안의 뷰를 선택합니다.
- 데이터 미리보기를 클릭하여 필드와 데이터 내용을 확인하고 현재 앱이 선택한 문서를 읽을 수 있는지 확인합니다.
WPS 다차원 테이블의 HTTPS 문서 링크를 입력하십시오. 데이터 소스를 변경하거나 URL을 수정하거나 데이터 테이블을 변경한 후에는 데이터 테이블, 뷰 및 필드 매핑을 다시 확인하십시오. 데이터 테이블을 변경한 후에는 뷰를 다시 선택해야 합니다.
데이터 테이블이나 뷰를 찾을 수 없거나 미리보기를 사용할 수 없는 경우 앱 읽기 권한이 심사를 거쳐 적용되었는지, 문서 읽기 권한이 있는지, API 요청 서명과 IP 허용 목록이 올바르게 설정되었는지 먼저 확인하십시오. 독립 환경 설정에서는 이 단계에 개발 환경 설정을 사용합니다. 운영 환경에서도 동일한 동기화 계획에서 선택한 내용을 읽을 수 있어야 합니다.
필드 매핑 및 동기화 검증
데이터 소스 설정을 완료한 후 플랫폼 기본 스토리지의 타겟 테이블을 선택하고 필드 매핑을 설정합니다. 소스 필드는 WPS의 필드 이름을 우선하여 표시합니다.
지원 필드 타입
WPS 다차원 테이블은 선택한 뷰에서 표시되는 필드 내용을 읽을 수 있습니다. 여기에는 텍스트, 숫자, 불리언과 인터페이스가 반환하는 배열 및 객체 내용이 포함됩니다. 날짜, 시간, 수식 등의 필드도 데이터 미리보기에서 실제 반환 내용을 확인해야 하며, 필드 이름이나 WPS의 표시 형태만으로 읽기 결과를 판단할 수 없습니다.
소스 필드는 모두 문자열(string)로 표시되며 WPS의 텍스트 필드만 지원한다는 의미는 아닙니다.
지원하지 않는 필드 및 제한
필드가 삭제되거나 선택한 뷰에서 숨겨졌거나 현재 앱에 읽기 권한이 없으면 기존 필드 설정으로 계속 동기화할 수 없습니다. 소스 설정을 새로 고치고 필드 범위를 다시 확인하십시오.
설정 및 검증
- 데이터 목적지에서 타겟 테이블을 선택하거나 생성하고, 비즈니스 요구에 따라 쓰기 방식을 설정합니다.
- 필드 매핑에서 소스 필드를 타겟 필드에 매핑합니다.
- 계획 이름, 담당자, 비고를 입력한 후 저장합니다.
- 수동 실행을 클릭하고 실행 기록에서 작업이 성공했는지 확인한 후 타겟 테이블에서 필드와 데이터 내용을 확인합니다. 수동 실행에는 운영 환경 설정을 사용하므로 운영 앱의 자격 증명과 권한을 미리 확인하십시오.
그림의 필드는 매핑 화면을 보여 주기 위한 예시입니다. 실제 업무에 맞게 동기화할 필드를 선택하십시오.
WPS 데이터 테이블, 뷰 또는 필드가 변경된 후에는 소스 설정과 필드 매핑을 새로 고치고 선택한 뷰와 매핑된 필드가 여전히 유효한지 확인하십시오. 필드가 삭제되거나 숨겨진 경우 매핑을 다시 확인한 후 저장하거나 실행해야 합니다.
| 증상 | 확인 항목 |
|---|---|
| 연결 테스트 실패 | App ID, App Key가 올바른지, 앱 상태가 정상인지 확인 |
| 연결 테스트를 통과했지만 데이터 로드 또는 미리보기를 사용할 수 없음 | kso.dbsheet.read가 앱 권한 부여 타입이고 심사를 거쳐 적용되었는지, 앱에 문서 읽기 권한이 있는지, API 요청 서명과 IP 허용 목록이 올바르게 설정되었는지 확인 |
| URL 검증 실패 | 표준 WPS 다차원 테이블 HTTPS 문서 링크를 사용하고 문서가 여전히 존재하며 앱이 읽을 수 있는지 확인 |
| 데이터 테이블 또는 뷰를 찾을 수 없음 | 해당 항목이 삭제되지 않았는지 확인하고 목록을 새로 고친 후 다시 선택. 데이터 테이블을 변경한 후에는 뷰를 다시 선택 |
| 매핑된 필드가 삭제되거나 숨겨졌다는 메시지가 표시됨 | WPS 측의 필드 및 뷰 설정을 확인하고 필드 매핑을 새로 고친 후 다시 확인 |
| 개발 환경의 미리보기는 정상이지만 수동 실행이 실패함 | 운영 환경의 앱 자격 증명, 문서 권한, API 요청 서명 및 서버 외부 통신용 IP를 확인 |
| 동기화 후 필드 내용이 예상과 다름 | 소스 데이터 미리보기와 필드 대응 관계를 확인하고 조정 후 다시 검증 |
작업 플로우에 연결
수동 검증에 성공하면 오프라인 동기화 계획을 작업 플로우에 연결하여 스케줄링 주기에 따라 자동으로 실행할 수 있습니다.
- 저장된 오프라인 동기화 계획을 열고 작업 플로우에 연결을 클릭합니다.
- 대상 작업 플로우를 선택합니다.
- 노드 이름을 입력하고 실행 모드를 선택한 후, 필요에 따라 담당자와 비고를 설정합니다. 노드 타입과 통합 계획은 자동으로 채워집니다.
- 노드 생성 및 연결을 클릭합니다. 연결에 성공하면 작업 플로우로 이동을 클릭하여 노드 위치와 상하위 의존성을 확인할 수 있습니다.
- 작업 플로우를 저장하고 배포를 완료합니다. 운영 스케줄링에는 운영 환경의 데이터 소스 설정이 사용됩니다.
동기화 계획이나 데이터 소스를 교체하려면 기존 작업 플로우 의존 관계에 미치는 영향을 먼저 검토하고 변경 후 다시 실행하여 검증하십시오.

