この記事では、Dataverse を使用する際にPython (およびその他の.NET以外の) プログラマが成功することを認識する必要がある Dataverse に関する主要な概念について説明します。 また、より詳細な情報へのリンクも提供します。 Dataverse の機能は広範ですが、これらの他の機能は自分のペースで調べることができます。
C#/.NET でコーディングするプログラマは、広範なDataverse 開発者ガイドを読む必要があります。
テーブルとメッセージ
行と列に編成されたテーブルにデータを格納します。 メッセージは、テーブルとテーブル データに対して動作する操作です。 テーブルは エンティティとも呼ばれ、ドキュメントでは行が レコード と呼ばれることもあります。
テーブル
Dataverse では、通常、システム、カスタマイズ、カスタムの 3 種類のテーブルを使用します。 システム テーブル (既定のテーブルとも呼ばれます) は変更できません。また、Dataverse の基本的な機能をサポートしています。 適切なアクセス許可がある場合は、対話形式またはプログラムによってカスタマイズ可能なテーブルとカスタム テーブルを変更できます。
テーブルを対話的に 作成または変更するには、 Power Platform 管理センター (PPAC) を使用します。 プログラムによってテーブルを作成または変更するには、テーブルのメタデータを変更します。 SDK for Pythonには、テーブル メタデータを簡単に操作できる関数 (client.tables) が含まれています。
Dataverse テーブル行 (レコードとも呼ばれます) は、列スキーマ名を持つPythonディクショナリとして表されます。
詳細については、「 Web API EntityType リファレンス 」および「 テーブル定義で Web API を使用する」を参照してください。
Messages
メッセージは、実行する Web サービス操作を表します。 メッセージは、作成、取得、更新、削除 (CRUD) などのより簡単な操作になります。 メッセージは、book や win などのより複雑な操作を呼び出すこともできます。これは、他の操作の組み合わせを開始する可能性があります。
エンティティ型の参照には、すべての既知の (非カスタム) テーブルと、各テーブルでサポートされている標準メッセージが一覧表示されます。 カスタム テーブルを作成すると、そのテーブルに対して既定のメッセージ セットを使用できます。
セキュリティ
Dataverse 環境内のデータへのアクセスは、管理者が割り当てるセキュリティ ロール (またはロール) と、そのロールのデータ管理アクセス許可に基づいて制限されます。 ロールによってテーブル全体へのアクセスが許可される場合や、セキュリティによって特定の行と列へのアクセスが制限される場合があります。
詳細については、セキュリティの 概要 と セキュリティとデータ アクセスに関するページを参照してください。
カスタマイズと拡張機能
このセクションでは、Dataverse をカスタマイズおよび拡張するいくつかの方法について説明します。
テーブルに関する詳細情報
Dataverse では、カスタマイズ可能なテーブルとカスタム テーブルがサポートされています。 カスタマイズ可能なテーブルは、Dataverse に付属する既存のテーブルであり、たとえば、列の追加や削除、テーブル名の変更などを変更できます。
カスタム テーブルとは、自分 (またはサード パーティ) が作成するテーブルです。 この記事で前述したように、SDK には、カスタム テーブルの作成と削除に使用できるPython関数が用意されています。
Important
カスタム テーブルと列に対するすべての操作にカスタマイズ プレフィックス値を含める必要があります (たとえば、"MyTestTable" ではなく "new_MyTestTable")。
SDK API 呼び出しでは、テーブル スキーマ名 ("account"、"new_MyTestTable") と列スキーマ名 ("name"、"new_MyTestColumn") を常に使用します。
詳細については、Microsoft Dataverseテーブル定義>を参照してください。
拡張機能
イベント ハンドラー (プラグインと呼ばれます) とカスタム ワークフロー アクティビティを使用して、Dataverse のデータ処理の機能を変更できます。 これらのコンパイル済みのカスタム コード オブジェクトは、特定のテーブルとメッセージの組み合わせに登録されます。 プラグインまたはワークフロー アクティビティは、Dataverse のメイン データ処理操作の前後にデータを変更できます。 予想と異なるデータ結果が表示される場合は、これらの拡張機能のいずれかが原因である可能性があります。
Dataverse をカスタマイズおよび拡張するその他の方法は存在しますが、完全な一覧はこの記事の範囲外です。
Web API
SDK には、Dataverse Web API を内部的に呼び出す Python プログラミング インターフェイスが用意されています。
DataverseClient クラスは、Web API で必要とされる OData 2.0 承認への簡略化されたインターフェイスを提供します。
Web API 関数とアクションは、Python プログラム内から直接呼び出すことができます。 ただし、SDK for Python では、Python 開発者やデータ サイエンティストが想定どおりに Dataverse データにアクセスするための、より自然なプログラミング構文が提供されています。
ソリューション
ソリューションは、Dataverse を拡張およびカスタマイズするフォルダーとファイルのコンテナーです。 ソリューションは、カスタマイズと拡張機能をエクスポート用の 1 つの圧縮ファイルにパッケージ化するためのメカニズムです。 そのソリューション ファイルは、他の環境 (組織とも呼ばれます) にインポートできます。
拡張機能とカスタマイズは常にソリューションに存在します。 Dataverse には、既定のソリューションがあります。 拡張機能またはカスタマイズをカスタム ソリューションに追加せずに環境に追加すると、既定のソリューションに自動的に含まれます。
ソリューションを作成、管理、エクスポート、インポートするには、PPAC を使用するか、Web API を使用してプログラムを使用します。
詳細については、ソリューションのコンセプト を参照してください。