WebクライアントSDK

Content Hub開発者
WebクライアントSDK
ジョブ・クライアント

ジョブ・クライアント

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

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

Web SDKには、次のメソッドを使用してエンティティに対してCRUD操作を実行するためのジョブクライアントが用意されています。

メモ

EntitiesクライアントからJobsクライアントにコードを更新するために、いくつかの例を提供します。

GetTargetsAsync (英語)

このメソッドは、ジョブのターゲットを取得し、JobTargetQuery要求パラメーターをサポートします。このパラメーターは、ジョブターゲットクエリ要求であり、さまざまなフィルターオプションを持つジョブターゲットの要求を表します。これにより、関心のあるジョブ目標を絞り込むための基準を指定できます。

このメソッドでサポートされるプロパティを次の表に示します。

財産	種類	形容
JobId	長い	ジョブの一意のID。
State	糸。	ジョブ・ターゲットの状態。これを使用して、現在の状態に基づいてターゲットをフィルタリングできます。
Condition	糸。	ジョブ・ターゲットの条件。これを使用して、特定の条件に基づいてターゲットをフィルタリングできます。
Type	糸。	ジョブ・ターゲットのタイプ。これを使用して、タイプに基づいてターゲットをフィルタリングできます。
Location	糸。	ジョブ・ターゲットのロケーション。これを使用して、地理的な場所に基づいてターゲットをフィルタリングできます。
Skip	整数	スキップするレコードの数。これは、ページネーションに役立ちます。
Take	整数	取得するレコードの数。これは、ページネーションに役立ちます。デフォルト値は25です。
Cultures	CultureInfo?	エンティティを読み込むカルチャ情報。カルチャが指定されていない場合、複数言語のプロパティは含まれません。デフォルト値は、CultureInfo.InvariantCultureを含む配列です。

次の例では、JobTargetQueryを使用して、状態、条件、種類、場所などのさまざまなフィルターが適用された特定のジョブ (JobId = 123) のジョブターゲットを要求します。このクエリは0レコードをスキップし、50レコードを受け取り、英語 (米国) とフランス語 (FR) カルチャの多言語プロパティが含まれます。

var jobTargetQuery = new JobTargetQuery(123)
{
    State = "Waiting",
    Condition = "Pending",
    Type = "System",
    Location = "67890",
    Skip = 0,
    Take = 50,
    Cultures = new[] { new CultureInfo("en-US"), new CultureInfo("fr-FR") }
};

この例では、クライアントメソッドを呼び出します。

var jobTargetQuery = new JobTargetQuery(123);
IEntityCollectionResult targets = await _client.Jobs.GetTargetsAsync(jobTargetQuery);

このメソッドは、ジョブ・ターゲットのコレクションをTask<IEntityCollectionResult>に戻します。次の例外が発生する可能性があります。

ArgumentNullException - リクエストがnullの場合。
ArgumentOutOfRangeException - request.Takeまたはrequest.Skipの値が負の数値であるか、または要求。JobIdは有効なIDではありません。
ArgumentException - いずれかのrequest.culturesがnullであるか、ジョブエンティティが見つからない場合。

GetTargetAsync

このメソッドは、ジョブの特定のターゲットを取得します。

このメソッドでサポートされるプロパティを次の表に示します。

財産	種類	形容
JobId	長い	ジョブの一意のID。
TargetId	長い	ターゲットID。
Cultures	CultureInfo?	エンティティを読み込むカルチャ情報。カルチャが指定されていない場合、複数言語のプロパティは含まれません。デフォルト値は、CultureInfo.InvariantCultureを含む配列です。

次の例では、

IEntity description = await _client.Jobs.GetTargetAsync(jobId, targetId);

このメソッドは、特定のターゲットエンティティTask<IEntity>を返します。次の例外が発生する可能性があります。

ArgumentException - JobIdまたはTargetIdが有効でない場合。
WebApiException - HTTP要求が失敗した場合。

SaveTargetAsync

このメソッドは、ジョブのターゲットを作成または更新します。次のパラメータをサポートしています。

パラメーター	種類	形容
jobId	長い	ジョブID。
target	イエンティ	ターゲットエンティティ。

このメソッドは、保存されたターゲットTask<long>のIDを返します。次の例外が発生する可能性があります。

ArgumentNullException - ターゲットがnullの場合。
ArgumentException - ジョブIDが無効な場合
WebApiException - ロケーションヘッダーがnullの場合、またはエンティティIDを抽出できない場合。
InternalException - エンティティIDをLocationヘッダーから抽出できない場合。

このメソッドでは、次の構文を使用します。

long targetId = await _client.Jobs.SaveTargetAsync(jobId, target);

DeleteTargetAsync

このメソッドは、ジョブのターゲットを削除します。次のパラメータをサポートしています。

パラメーター	種類	形容
jobId	長い	ジョブID。
targetId	長い	ターゲットID。

このメソッドは、非同期操作を表すタスクを返します。次の例外が発生する可能性があります。

ArgumentException - ジョブIDまたは対象IDが無効な場合
WebApiException - HTTPリクエストが失敗した場合、

このメソッドでは、次の構文を使用します。

await _client.Jobs.DeleteTargetAsync(jobId, targetId);

GetDescriptionAsync

このメソッドは、ジョブの説明を取得します。次のパラメータをサポートしています。

パラメーター	種類	形容
jobId	長い	ジョブID。
cultures	CultureInfo?	説明のオプションのカルチャ。

このメソッドは、ジョブ記述エンティティTask<IEntity>を返します。次の例外が発生する可能性があります。

ArgumentException - ジョブIDが無効な場合
WebApiException - HTTP要求が失敗した場合。

このメソッドでは、次の構文を使用します。

IEntity description = await _client.Jobs.GetDescriptionAsync(jobId);

SaveDescriptionAsync

このメソッドは、ジョブの説明を作成または更新します。次のパラメータをサポートしています。

パラメーター	種類	形容
jobId	長い	ジョブID。
jobDescription	イエンティ	ジョブ記述エンティティ。

このメソッドは、保存されたジョブの説明Task<long>のIDを返します。次の例外が発生する可能性があります。

ArgumentNullException - ジョブの説明がnullの場合。
ArgumentException - ジョブIDまたはジョブ記述IDが無効な場合
WebApiException - ロケーションヘッダーがnullの場合、またはエンティティIDを抽出できない場合。
InternalException - エンティティIDをLocationヘッダーから抽出できない場合。

このメソッドでは、次の構文を使用します。

long descriptionId = await _client.Jobs.SaveDescriptionAsync(jobId, jobDescription);

DeleteDescriptionAsync

このメソッドは、ジョブの説明を削除します。次のパラメーターがサポートされています: jobId (long) - ジョブID。このメソッドは、非同期操作を表すタスクを返します。次の例外が発生する可能性があります。

ArgumentException - ジョブIDが無効な場合
WebApiException - HTTP要求が失敗した場合。

このメソッドでは、次の構文を使用します。

await _client.Jobs.DeleteDescriptionAsync(jobId);

この記事を改善するための提案がある場合は、お知らせください!