Studio ガイド

最終更新日時 2025年4月2日

ローコードワークフローでコード化されたオートメーションを使用する

このチュートリアルでは、CodedResetAssetValue.cs というコード化されたオートメーションをローコードワークフローに組み込む方法を学習します。CodedResetAssetValue.cs オートメーションは、以下の手順を実行します。

Orchestrator から特定のアセットの現在値を取得します。
取得したアセット値と、引数として指定した入力値を比較します。
以前のアセット値が入力値と一致しない場合は、Orchestrator のアセット値を更新します。
アセット値のステータス (更新されたか、変更されていないか) を知らせるメッセージをログに記録します。

ローコードワークフロー内でコード化されたオートメーションを使用するには、まずコード化されたワークフローを作成してから、[ワークフローファイルを呼び出し] アクティビティを使用してローコードワークフローでそのワークフローを呼び出します。コード化されたオートメーションをローコードワークフローに組み込むには、次の手順を実行します。

新しいコード化されたワークフローを作成します。この例では、CodedResetAssetValue という名前を付けます。

アセット値が変更されたかどうかと、現在のアセット値を知らせるため、Execute メソッドに次の return 引数を指定します: (bool assetValueWasChanged, string assetValue)。

Execute メソッドに、入力パラメーター assetName (string) と assetValue (string) を追加します。

 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]public (bool assetValueWasChanged, string assetValue) Execute(string assetName, string assetValue)

GetAsset API を使用し、assetName パラメーターを使用して指定したアセットの現在値を取得します。

以前のアセット値を previousAssetValue 変数に格納します。

 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]var previousAssetValue = system.GetAsset(assetName).ToString();

Equals メソッドを使用して、前のアセット値と入力アセット値を比較します。
値が等しい場合は、アセット値が変更されていないことを示す (false, assetValue) を返します。
値が異なる場合は、SetAsset API を使用してアセット値を入力 assetValue に更新します。
アセット値が変更されたことを示す (true, previousAssetValue) を、以前のアセット値とともに返します。

 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]if (previousAssetValue.Equals(assetValue))
      {
        return (assetValueWasChanged: false, assetValue: assetValue);
      }
      else
      {
        system.SetAsset(assetValue, assetName);
        return (assetValueWasChanged: true, assetValue: previousAssetValue);
      }

ローコードワークフローを作成します。この例では、WorkflowUsingCodedAutomation という名前を付けます。
[代入] アクティビティを追加し、assetValue 変数に値を代入します。
[ワークフローファイルを呼び出し] アクティビティを追加し、コード化されたオートメーション CodedResetAssetValue.cs を呼び出して、必要な引数を追加します。

注: Windows プロジェクトの場合: [ワークフローファイルを呼び出し] アクティビティで [ファイルを参照] を選択し、参照しているファイルの拡張子を ワークフローファイル (*.xaml、*.uiwf) からすべてのファイル (*.*) に変更します。これにより、.cs を含むすべてのファイルを表示できるようになります。
[条件分岐 (if)] アクティビティを追加して、アセットの値が変更されなかった場合とアセット値が更新された場合のログメッセージを入力します。