Dynamics 365 の v9.0 リリース以降、Web API は同じ環境でのバージョン固有の違いをサポートしています。
このサポートは v8.x リリースの動作とは異なります。 以前のリリースでは、環境に適用される更新プログラムに応じて、サービスの任意のバージョンで新しい機能を使用できるようになりました。 v8.2 へのアップグレード後、v8.0 サービスと v8.1 サービスはすべて同じでした。 これは、すべての変更が加法であるために可能でした。 何も削除されず、破壊的変更も導入されませんでした。 その結果、v8 のサービス URL で参照される特定のバージョン。x は実際には重要ではありませんでした。
今後、特定の操作の削除などの破壊的変更を含め、サービスの機能が変わる可能性があります。 この変更により、継続的に改善を適用できます。 このトピックでは、バージョン固有の違いと、Web API が SDK for .NET との同等性をまだ達成していない場合の制限事項について説明します。
注
v9.x リリースでは特定の違いをサポートできますが、v9.0、v9.1、v9.2 のリリースには破壊的変更は含まれません。 これらの各リリースには、同じ Web API 動作があります。
API 動作の違いは、製品のバージョンではなく、システムにインストールされているソリューションによって大きく影響されます。 ただし、Microsoft が下位互換性のない基本的な変更を行う必要がある場合は、新しいバージョン番号に変更が含まれます。
ガイダンス: コードを記述したときに最新のバージョン番号を使用します。 文書化された違いとテストを探さずに、新しいバージョンを自動的に使用しないでください。 新しいバージョンが完全に下位互換性があると前提としないでください。
Web API のバージョン固有の違い
次の違いは、Web API の v8.2 バージョンと v9.0 バージョンの変更を示しています。
FetchXML クエリ応答での特殊文字のエンコード
v8 の場合。x バージョンでは、リンク エンティティとその属性を含む FetchXML クエリへの応答には、'.' が 'x002e' になり、'@' が 'x0040' になるように Unicode 特殊文字が含まれます。 この特殊文字のエンコードは、v9 の FetchXML クエリへの応答には存在しません。x リリース。
テーブルと列に同じ名前
テーブル (エンティティ) とその列 (属性) の名前が同じ場合、システムは v8.x インスタンスの属性名に "1" を追加します。 たとえば、エンティティ new_zipcodeにnew_zipcodeという名前の属性がある場合、属性名は new_zipcode1 に変わります。
v9 の場合。x インスタンスの場合、システムは属性名に何も追加しません。
新しい操作が追加されました
v9.x リリースの Web API には、次の操作が追加されます。
Web API の制限事項
Dataverse Web API は、SDK for .NET の機能と完全な同等性を提供します。 Dataverse の場合、このトピックでは、Dataverse v8.x リリースから引き継がれた制限について説明します。 以前のリリースについては、「 Dynamics CRM 2016 Web API の制限事項」を参照してください。
注
複雑な戻り値と単純な戻り値の両方を含むカスタム アクションを定義した場合、Web API は対応するアクションを提供しません。 ただし、組織サービスはこのアクションを提供します。 複合戻り値は、 EntityReference、 Entity、または EntityCollectionです。 単純な戻り値または単一の複合戻り値を任意に組み合わせて使用できます。 詳細については、「独自の メッセージを作成する」を参照してください。
こちらも参照ください
Dataverse Web API を使用する
Web API を使用して Dataverse に対する認証を行う
Web API の種類と操作
Web API を使用して演算を実行する