メインコンテンツまでスキップ

WPS多次元テーブルデータソースの構成

最終更新 2026/11/03

WPS多次元テーブルデータソースは、オフライン同期を通じてWPS多次元テーブルのデータを読み取り、プラットフォームのプリセットデータウェアハウスに書き込むために使用します。このドキュメントでは、WPS側のアプリ認証、データソースの構成、同期プランの作成、タスクフローへのマウントについて説明します。

使用制限と事前準備​

設定を始める前に、以下の制限と前提条件を確認してください:

  • WPS多次元テーブルはデータの読み取り元としてのみ使用でき、データの流向はプラットフォームのプリセットデータウェアハウスです。WPS多次元テーブルへの書き戻しはサポートしていません。
  • WPSの企業アカウントを用意し、権限を持つ担当者が企業の自社開発アプリケーションを作成し、API権限を申請して、バージョンを審査に提出する必要があります。必要なオープンプラットフォーム機能の利用資格を企業が保有しているか、企業管理者に確認してください。
  • 対象のWPS多次元テーブルのドキュメントリンクを用意し、アプリケーションにファイルの読み取り権限があることを確認して、読み取るデータテーブルとビューを決めてください。
  • プラットフォームの実行環境からWPSオープンプラットフォームにアクセスできる必要があります。アプリケーションでIP許可リストが有効になっている場合は、サーバーの実際の外向きIPを事前に用意してください。
  • 読み取り可能なフィールドの範囲は、選択したデータテーブルとビューに従います。まずデータプレビューでフィールドと内容を確認してください。
環境の構成方法適用シナリオ設定要件
環境を区別しない開発環境と本番環境で同じWPSアプリケーションを共用App ID、App Key、APIリクエスト署名の設定を1組入力
独立環境構成開発環境と本番環境で異なるWPSアプリケーション構成を使用個別に構成し、両方のアプリケーションがプランで選択したドキュメント、データテーブル、ビューにアクセスできるようにする
ヒント

構成の検証とデータプレビューには開発環境の構成を、手動実行には本番環境の構成を使用します。独立環境構成では、アプリケーションの権限、ドキュメントの読み取り権限、APIリクエスト署名、サーバーの外向きIPをそれぞれ確認してください。

WPSオープンプラットフォームでの権限付与​

  1. 企業アカウントを準備します。WPS 365にログインし、画面の案内に従って企業を作成するか、企業管理者から招待を受けて既存の企業に参加します。続いて、同じアカウントでWPS開発者管理画面にログインし、今回の接続で使用する企業を選択します。必要なオープンプラットフォーム機能と利用資格は、企業管理者からWPSに確認してください。
  2. 企業の自社開発アプリケーションを作成します。開発者管理画面で アプリケーションを作成 をクリックし、企業の自社開発アプリケーション を選択して、名前や説明などを入力します。作成後に App ID と App Key を取得し、接続担当者に引き渡してデータソースを構成してもらいます。具体的な操作は企業の自社開発アプリケーションの作成を参照してください。
  3. 読み取り権限を申請し、審査を完了します。アプリケーションの 権限管理 で下表の権限を申請し、アプリ認証(app) タイプを選択します。続いてアプリケーションのバージョンを作成して公開申請を提出します。企業管理者の審査に合格すると、権限が有効になります。アプリケーション機能情報の構成を参照してください。
機能名権限scope権限タイプ
多次元テーブルのクエリkso.dbsheet.readアプリ認証(app)
  1. ドキュメントの読み取り権限を準備します。ドキュメントの責任者に、対象の多次元テーブルの所属先、アクセス範囲、権限設定を確認してもらい、アプリケーションがドキュメントを読み取れるようにしてください。アプリケーションのAPI権限とファイル権限の両方が要件を満たす必要があります。個人がブラウザーでドキュメントを開けることは、アプリケーションが読み取り権限を取得済みであることを意味しません。ファイルの読み取り権限についてはWPS多次元テーブルの読み取りに関する説明を参照してください。後の構成で使用するドキュメントリンクをコピーします。例:https://www.kdocs.cn/l/ExampleID。
  2. セキュリティ設定を構成します。アプリケーションの セキュリティ設定 で、企業のセキュリティ要件に従って APIリクエスト署名 を構成し、その状態を接続担当者に伝えて、WPS側とデータソース側の構成を一致させます。IP許可リスト を有効にする場合は、運用担当者にWPSへアクセスするサーバーの実際の外向きIPを確認し、必要なすべてのIPを許可リストに追加してください。登録するのはサーバーの外向きIPであり、操作担当者のPCのIPではありません。環境やノードによって外向きIPが異なる場合は、それぞれ構成する必要があります。WPSの呼び出しプロセスとセキュリティ構成を参照してください。
警告

App Keyは安全に保管し、安全な方法で引き渡してください。スクリーンショット、ログ、公開ドキュメントに露出させないでください。接続済みアプリケーションのAPIリクエスト署名やIP許可リストを変更する場合は、既存の同期タスクへの影響を避けるため、事前に接続担当者に確認してください。

WPS多次元テーブルデータソースの作成​

  1. データ開発プラットフォーム > 連携 > データソース に移動し、+ データソース をクリックします。
  2. WPS多次元テーブル を選択し、次のステップ をクリックして、データソース名と備考を入力します。
  3. 環境を区別しない または 独立環境構成 を選択します。独立環境構成では、開発環境と本番環境の設定をそれぞれ完了する必要があります。
  4. アプリケーションの App ID、App Key を入力し、WPSアプリケーションのセキュリティ設定に合わせて APIリクエスト署名 を構成します。
  5. 接続性テスト で テスト をクリックし、アプリケーションの認証に成功したことを確認してから、完了 をクリックします。
WPS多次元テーブルデータソースのアプリ認証情報とAPIリクエスト署名を構成
構成項目説明
App IDWPSの企業の自社開発アプリケーションのApp ID
App Key対応するアプリケーションのApp Key
APIリクエスト署名WPSアプリケーションのAPIリクエスト署名設定と一致させ、企業のセキュリティ要件に従って構成
ヒント

接続性テストでは、アプリケーションの認証のみを検証します。ドキュメントへのアクセス権限とAPIリクエスト署名は、次のセクションのデータ読み込みまたはデータプレビューで確認する必要があります。テストに成功したら、引き続き読み取り元の構成とプレビューを完了してください。

保存済みのデータソースを編集する場合、App Keyはデフォルトでマスクされて表示されます。認証情報を変更する場合は、新しいApp Keyを入力し、接続を再度テストして、ドキュメントへのアクセスを確認してください。

オフライン同期プランの作成​

  1. データ開発プラットフォーム > 連携 > オフライン同期 に移動し、+ 統合プラン をクリックします。
  2. データソース で WPS多次元テーブル と作成済みのデータソースを選択します。
  3. WPS多次元テーブル URL にドキュメントリンク(例:https://www.kdocs.cn/l/ExampleID)を入力し、URLを検証 をクリックします。
  4. URLの検証と読み込みに成功したら、読み取る データテーブル を選択し、その中の ビュー を選択します。
  5. データプレビュー をクリックして、フィールドとデータの内容を確認し、現在のアプリケーションが選択したドキュメントを読み取れることを確認します。
WPS多次元テーブル内のデータテーブルとビューを選択
ヒント

WPS多次元テーブルのHTTPSドキュメントリンクを入力してください。データソースの切り替え、URLの変更、データテーブルの切り替え後は、データテーブル、ビュー、フィールドマッピングを再確認してください。データテーブルを切り替えた場合は、ビューを再度選択する必要があります。

データテーブルやビューが見つからない場合、またはプレビューできない場合は、まずアプリケーションの読み取り権限が審査を経て有効になっているか、ドキュメントの読み取り権限、APIリクエスト署名、IP許可リストの設定を確認してください。独立環境構成では、この手順で開発環境の構成を使用します。本番環境でも、同じプランで選択したコンテンツを読み取れる必要があります。

フィールドマッピングと同期の検証​

読み取り元の構成が完了したら、プラットフォームのプリセットデータウェアハウスで目標テーブルを選択し、フィールドマッピングを設定します。ソースフィールドには、WPS内のフィールド名が優先して表示されます。

対応するフィールドタイプ​

WPS多次元テーブルでは、選択したビューに表示されるフィールドの内容を読み取ることができます。テキスト、数値、ブール値、およびAPIが返す配列やオブジェクトの内容が含まれます。日付、時刻、数式などのフィールドも、データプレビューで実際に返される内容を確認してください。フィールド名やWPS上の表示形式だけで読み取り結果を判断しないでください。

ソースフィールドはすべて文字列(string)として表示されますが、WPSのテキストフィールドだけに対応しているという意味ではありません。

非対応のフィールドと制限​

フィールドが削除された場合、選択したビューで非表示になった場合、または現在のアプリに読み取り権限がない場合は、元のフィールド設定のまま同期を続けることはできません。読み取り元の設定を更新し、フィールドの範囲を再確認してください。

構成と検証​

  1. データの流向 で目標テーブルを選択または作成し、業務上の必要に応じて書き込み方法を設定します。
  2. フィールドマッピングで、ソースフィールドを目標フィールドにマッピングします。
  3. プラン名、責任者、備考を入力して保存します。
  4. 手動実行 をクリックし、実行記録でタスクの成功を確認してから、目標テーブルでフィールドとデータの内容を確認します。手動実行では本番環境の構成を使用するため、事前に本番用アプリケーションの認証情報と権限を確認してください。
WPSのソースフィールドを目標フィールドにマッピング

図のフィールドはマッピング画面の例です。実際の業務に合わせて、同期するフィールドを選択してください。

WPSのデータテーブル、ビュー、フィールドに変更があった場合は、読み取り元の構成とフィールドマッピングを更新し、選択したビューとマッピング済みのフィールドが引き続き有効であることを確認してください。フィールドが削除または非表示になった場合は、マッピングを再確認してから保存・実行する必要があります。

現象確認事項
接続性テストに失敗するApp ID、App Keyが正しいか、アプリケーションの状態が正常かを確認
接続性テストには成功するが、データを読み込めない、またはプレビューできないkso.dbsheet.read がアプリ認証タイプで、審査を経て有効になっているか、アプリケーションにドキュメントの読み取り権限があるか、APIリクエスト署名とIP許可リストの構成を確認
URLの検証に失敗する標準のWPS多次元テーブルのHTTPSドキュメントリンクを使用し、ドキュメントが存在していて、アプリケーションが読み取れることを確認
データテーブルやビューが見つからない対象が削除されていないか確認し、リストを更新して再選択する。データテーブルを切り替えた場合は、ビューを再選択
マッピング済みのフィールドが削除または非表示になったと表示されるWPS側のフィールドとビューの設定を確認し、フィールドマッピングを更新して再確認
開発環境のプレビューは正常だが、手動実行に失敗する本番環境のアプリ認証情報、ドキュメントの権限、APIリクエスト署名、サーバーの外向きIPを確認
同期後のフィールド内容が想定と異なるソースデータのプレビューとフィールドの対応関係を確認し、調整後に再検証してください

タスクフローへのマウント​

手動での検証に成功したら、オフライン同期プランをタスクフローにマウントして、スケジュール周期に従って自動実行できます。

  1. 保存済みのオフライン同期プランを開き、ジョブフローにマウントする をクリックします。
  2. 対象のタスクフローを選択します。
  3. ノード名を入力し、実行モードを選択して、必要に応じて責任者と備考を設定します。ノードタイプと統合プランは自動的に入力されます。
  4. ノードを作成し、マウントします をクリックします。マウントに成功したら、タスクフローに進む をクリックして、ノードの位置と上流・下流の依存関係を確認できます。
  5. タスクフローを保存してリリースします。本番のスケジュールでは、本番環境のデータソース設定が使用されます。

同期プランやデータソースを変更する場合は、まず既存のタスクフローの依存関係への影響を評価し、変更後に再度実行して検証してください。

このページは役に立ちましたか?