エンティティ クライアント
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
この SDK は、エンティティに対して CRUD 操作を実行するエンティティ クライアントを提供しています。
[!注] 次のコード例の
client変数はIMClientインスタンスを意味します。スクリプト SDK を使用する場合、このインスタンスは自動的に作成され、
MClientという名前が付けられます。Web SDK を使用する場合、変数名は自由に選択できますが、ドキュメントの例では
clientという名前が使われています。
エンティティの取得
次のメソッドは、ID によってエンティティを取得します。
IEntity entity = await client.Entities.GetAsync(entityId);
エンティティが存在しない場合、またはユーザーにエンティティを読み取る十分な権限がない場合、メソッドは null を返します。
[!注] ID、識別子、または定義によってエンティティを読み込むために複数のオプションが用意されています。 各オプションの詳細については、API リファレンス ドキュメントの
IEntitiesClientを参照してください。[!注] エンティティを読み込むときに、読み込み設定を渡すことができます。 読み込み設定の詳細については、読み込み設定セクションを参照してください。
エンティティの作成
エンティティは、EntityFactory を使用してのみインスタンス化できます。
次のスニペットでは、アセット エンティティが (ローカルで) 作成されます。
IEntity asset = await client.EntityFactory.CreateAsync("M.Asset");
次のスニペットでは、ローカルで作成されたアセット エンティティがサーバーに送信され、検証および永続化されます。
long id = await client.Entities.SaveAsync(asset);
返される ID は、新しく作成されたエンティティの ID です。 このエンティティの最新バージョンを取得するには、ID を使用してサーバーから再度取得します。
エンティティの更新
エンティティの作成と同様に、変更を実行した後で、エンティティ クライアントに対して「save」メソッドを使用します。
long id = await client.Entities.SaveAsync(asset);
返される ID は、エンティティと同じ ID です。 このエンティティの最新バージョンを取得するには、ID を使用してサーバーから再度取得します。
エンティティの削除
エンティティの削除は、エンティティ クライアントの「Delete」メソッドを使用して実行できます。 削除するには、エンティティ ID を指定する必要があります。
await client.Entities.DeleteAsync(entityId);