WPS多次元テーブルデータソースの構成
WPS多次元テーブルデータソースは、オフライン同期を通じてWPS多次元テーブルのデータを読み取り、プラットフォームのプリセットデータウェアハウスに書き込むために使用します。このドキュメントでは、WPS側のアプリ認証、データソースの構成、同期プランの作成、タスクフローへのマウントについて説明します。
使用制限と事前準備
設定を始める前に、以下の制限と前提条件を確認してください:
- WPS多次元テーブルはデータの読み取り元としてのみ使用でき、データの流向はプラットフォームのプリセットデータウェアハウスです。WPS多次元テーブルへの書き戻しはサポートしていません。
- WPSの企業アカウントを用意し、権限を持つ担当者が企業の自社開発アプリケーションを作成し、API権限を申請して、バージョンを審査に提出する必要があります。必要なオープンプラットフォーム機能の利用資格を企業が保有しているか、企業管理者に確認してください。
- 対象のWPS多次元テーブルのドキュメントリンクを用意し、アプリケーションにファイルの読み取り権限があることを確認して、読み取るデータテーブルとビューを決めてください。
- プラットフォームの実行環境からWPSオープンプラットフォームにアクセスできる必要があります。アプリケーションでIP許可リストが有効になっている場合は、サーバーの実際の外向きIPを事前に用意してください。
- 読み取り可能なフィールドの範囲は、選択したデータテーブルとビューに従います。まずデータプレビューでフィールドと内容を確認してください。
| 環境の構成方法 | 適用シナリオ | 設定要件 |
|---|---|---|
| 環境を区別しない | 開発環境と本番環境で同じWPSアプリケーションを共用 | App ID、App Key、APIリクエスト署名の設定を1組入力 |
| 独立環境構成 | 開発環境と本番環境で異なる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であり、操作担当者のPCの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多次元テーブルでは、選択したビューに表示されるフィールドの内容を読み取ることができます。テキスト、数値、ブール値、およびAPIが返す配列やオブジェクトの内容が含まれます。日付、時刻、数式などのフィールドも、データプレビューで実際に返される内容を確認してください。フィールド名やWPS上の表示形式だけで読み取り結果を判断しないでください。
ソースフィールドはすべて文字列(string)として表示されますが、WPSのテキストフィールドだけに対応しているという意味ではありません。
非対応のフィールドと制限
フィールドが削除された場合、選択したビューで非表示になった場合、または現在のアプリに読み取り権限がない場合は、元のフィールド設定のまま同期を続けることはできません。読み取り元の設定を更新し、フィールドの範囲を再確認してください。
構成と検証
- データの流向 で目標テーブルを選択または作成し、業務上の必要に応じて書き込み方法を設定します。
- フィールドマッピングで、ソースフィールドを目標フィールドにマッピングします。
- プラン名、責任者、備考を入力して保存します。
- 手動実行 をクリックし、実行記録でタスクの成功を確認してから、目標テーブルでフィールドとデータの内容を確認します。手動実行では本番環境の構成を使用するため、事前に本番用アプリケーションの認証情報と権限を確認してください。
図のフィールドはマッピング画面の例です。実際の業務に合わせて、同期するフィールドを選択してください。
WPSのデータテーブル、ビュー、フィールドに変更があった場合は、読み取り元の構成とフィールドマッピングを更新し、選択したビューとマッピング済みのフィールドが引き続き有効であることを確認してください。フィールドが削除または非表示になった場合は、マッピングを再確認してから保存・実行する必要があります。
| 現象 | 確認事項 |
|---|---|
| 接続性テストに失敗する | App ID、App Keyが正しいか、アプリケーションの状態が正常かを確認 |
| 接続性テストには成功するが、データを読み込めない、またはプレビューできない | kso.dbsheet.read がアプリ認証タイプで、審査を経て有効になっているか、アプリケーションにドキュメントの読み取り権限があるか、APIリクエスト署名とIP許可リストの構成を確認 |
| URLの検証に失敗する | 標準のWPS多次元テーブルのHTTPSドキュメントリンクを使用し、ドキュメントが存在していて、アプリケーションが読み取れることを確認 |
| データテーブルやビューが見つからない | 対象が削除されていないか確認し、リストを更新して再選択する。データテーブルを切り替えた場合は、ビューを再選択 |
| マッピング済みのフィールドが削除または非表示になったと表示される | WPS側のフィールドとビューの設定を確認し、フィールドマッピングを更新して再確認 |
| 開発環境のプレビューは正常だが、手動実行に失敗する | 本番環境のアプリ認証情報、ドキュメントの権限、APIリクエスト署名、サーバーの外向きIPを確認 |
| 同期後のフィールド内容が想定と異なる | ソースデータのプレビューとフィールドの対応関係を確認し、調整後に再検証してください |
タスクフローへのマウント
手動での検証に成功したら、オフライン同期プランをタスクフローにマウントして、スケジュール周期に従って自動実行できます。
- 保存済みのオフライン同期プランを開き、ジョブフローにマウントする をクリックします。
- 対象のタスクフローを選択します。
- ノード名を入力し、実行モードを選択して、必要に応じて責任者と備考を設定します。ノードタイプと統合プランは自動的に入力されます。
- ノードを作成し、マウントします をクリックします。マウントに成功したら、タスクフローに進む をクリックして、ノードの位置と上流・下流の依存関係を確認できます。
- タスクフローを保存してリリースします。本番のスケジュールでは、本番環境のデータソース設定が使用されます。
同期プランやデータソースを変更する場合は、まず既存のタスクフローの依存関係への影響を評価し、変更後に再度実行して検証してください。

