1. データソース

データソース クライアント

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

SDK は、データソースで CRUD 操作を実行するデータソース クライアントを提供しており、オプション リストとも呼ばれます。

[!注] 次のコード例の client 変数は IMClient インスタンスを意味します。

スクリプト SDK を使用する場合、このインスタンスは自動的に作成され、MClient という名前が付けられます。

Web SDK を使用する場合、変数名は自由に選択できますが、ドキュメントの例では client という名前が使われています。

データソースの取得

データソースは、名前で取得できます。

IDataSource result = await client.DataSources.GetAsync(name);

これにより IDataSource オブジェクトが返されますが、次の方法で適切なタイプのデータソースにダウンキャストすることをお勧めします。

IHierarchicalDataSource hierachicalDataSource = await client.DataSources.GetAsync(name) as IHierarchicalDataSource;
IFlatDataSource flatDataSource = await client.DataSources.GetAsync(name) as IFlatDataSource;

データソースの値を変更できるようにするには、データソースを適切なタイプにダウンキャストする必要があります。 IDataSource の Type プロパティを使用すると、適切なデータソースのタイプを実行時に識別できます。

データソースの作成

階層構造のデータソースを作成するには、最初にファクトリがインスタンスを作成する必要があります。 その後は、クライアントを使用してインスタンスを保存できます。 データソースはメディア タイプに対して使用でき、すべてのタイプのメディアは、さらに多くのサブ値を持つことができます。

この例では、「mp4」がビデオ メディア タイプのサブタイプとして追加されています。

var dataSource = client.DataSourceFactory.CreateHierarchicalDataSource("MediaType");
dataSource.Labels.Add(enUs, "Media type");

var video = new HierarchicalDataSourceValue("Video")
{
    Labels = { { enUs, "Video" } }
};

var mp4 = new HierarchicalDataSourceValue("MP4")
{
    Labels = { { enUs, "mp4" } }
};
video.Values.Add(mp4);

var image = new HierarchicalDataSourceValue("Image")
{
    Labels = { { enUs, "Image" } }
};

dataSource.Values.Add(video);
dataSource.Values.Add(image);

await client.DataSources.CreateAsync(dataSource);

データソースの更新

次の例では、フラットな Colors データソースが、Red という色で拡張されています。

var dataSource = await client.DataSources.GetAsync("Colors") as IFlatDataSource;

var red = new FlatDataSourceValue("Red")
{
    Labels = { { enUs, "Red" } }
};
dataSource.Values.Add(red);

await client.DataSources.UpdateAsync(dataSource);

データソースの削除

次の例では、MediaType データソースが削除されます。

await client.DataSources.DeleteAsync("MediaType");
この記事を改善するための提案がある場合は、 お知らせください!