Exchange ユーザー アクティビティ

重要

このバージョンの Orchestrator はサポート終了に達しました。 Orchestrator 2022 にアップグレードすることをお勧めします。

この記事の構成手順は、Exchange ユーザー統合パックのすべてのアクティビティに適用されます。 アクティビティには、タスク、予定、電子メール、連絡先グループの作成、変更、管理が含まれます。 すべてのアクティビティのタスク固有の構成命令に関する記事には、この記事へのリンクが含まれています。

この記事の手順は、Orchestrator Runbook Designerの Runbook ウィンドウに配置されたすべてのアクティビティに対して実行されます。

アクティビティのプロパティ

各アクティビティには、そのアクティビティの構成を定義する必須または省略可能なプロパティのセットがあります。 構成では、アクティビティがアクションを実行する方法と、該当する他のアクティビティに接続する方法を定義します。 アクティビティが Runbook ウィンドウに配置されている場合は、アクティビティのプロパティを表示または変更できます。

アクティビティのプロパティを表示および構成するには

1. Runbook ウィンドウでアクティビティを見つけて、アクティビティをダブルクリックします。 または、アクティビティを右クリックし、[プロパティ] を選択 します。
2. 構成エントリを保存するには、[完了] を選択 します。

[アクティビティのプロパティ] ダイアログで、左側のいくつかのタブから、アクティビティの一般的な設定と特定の設定にアクセスできます。 オブジェクト プロパティに使用できるタブの数は、アクティビティの種類によって異なります。

全般タブ

[ 全般 ] タブには、アクティビティの Name プロパティと Description プロパティが含まれています。 既定では、アクティビティの [名前] はアクティビティの種類と同じで、[ 説明] は空白です。 これらのプロパティを変更して、よりわかりやすい名前を作成したり、アクティビティのアクションの詳細な説明を提供したりできます。

[プロパティ] タブ

[ プロパティ ] タブには、アクティビティに固有のプロパティが含まれています。 この統合パック内のすべてのアクティビティには、[プロパティ] タブまたは [フィルター] タブの上部に [構成名] プロパティがあります。このプロパティは、Exchange サーバーへの接続を指定するために使用されます。

構成名プロパティを構成するには

1. [名前] フィールドの横にある省略記号 (...) ボタンを選択します。

2. 該当する接続名を選択します。 一覧に表示される接続は、「 Exchange Users Integration Pack for System Center - Orchestrator」の説明に従って以前に構成されています。

フィルターの動作

監視アクティビティと Get アクティビティでは、フィルターを使用して、Runbook を呼び出すかアクティビティを取得する値を決定します。 候補候補のプロパティ値をフィルターの値と比較して、条件を満たしているかどうかを判断します。 フィルター条件を指定するには、使用可能な比較方法のいずれかを選択します。 各メソッドを使用して、フィルターに一致するか一致しないかのどちらかのオプションが提供されます。 たとえば、メソッドの "Not not" バージョンでは、フィルターに一致しないメッセージが検索されます。 すべてのテキスト フィルターでは大文字と小文字が区別されます。 使用可能なフィルターオプションを次に示します。

• 等しい: メッセージの プロパティは、フィルターで指定されたテキストまたは数値と一致します。
• 等しくない: メッセージの プロパティが、フィルターで指定されたテキストまたは数値と一致しません。
• より小さい: メッセージの プロパティは、フィルターで指定された数より小さくなります。
• 次の値以下: メッセージの プロパティは、フィルターで指定された数以下です。
• より大きい: メッセージの プロパティがフィルター内の数値より大きい。
• 以上: メッセージの プロパティは、フィルターで指定された数値以上です。
• Contains: メッセージの プロパティには、フィルターで指定された正確なテキストが含まれています。 Equals フィルターの動作とは異なり、一致するテキストを囲む他のテキストが存在する可能性があります。
• 含まれていない: メッセージの プロパティに、フィルターで指定された正確なテキストが含まれていません。 Equals フィルターの動作とは異なり、一致するテキストを囲む他のテキストが存在する可能性があります。
• pattern で始まる: メッセージの プロパティは、フィルターで指定された正確なテキストで始まります。 Equals フィルターの動作とは異なり、一致するテキストの後に他のテキストが存在する可能性があります。

[実行動作] タブ

[ 実行動作 ] タブには、アクティビティが複数値のパブリッシュされたデータを処理する方法を決定するプロパティが含まれており、アクティビティが失敗したり、過剰な期間実行されたりした場合に送信される通知も決定します。

複数値発行データの動作

Get アクティビティは、別のアクティビティまたは外部ソースから情報を取得し、パブリッシュされたデータ内の 1 つ以上の値を返すことができます。 たとえば、 アイテムの取得 アクティビティからのデータ出力には、既存の予定の詳細を指定できます。

既定では、 Get アクティビティのデータは複数の個別の出力として渡されます。 複数の出力では、出力に項目がある限り、次のアクティビティが呼び出されます。 または、[ フラット化 ] オプションを有効にして、アクティビティに 1 つの出力を指定することもできます。 このオプションを有効にする場合は、書式設定オプションを選択する必要があります。

• 改行で区切ります。 各項目は新しい行に配置されます。 この形式は、出力用に人間が判読できるテキスト ファイルを作成する場合に便利です。
• で区切る。 各項目は、任意の 1 つ以上の文字で区切られます。
• CSV 形式を使用します。 すべての項目は CSV (コンマ区切り値) 形式です。 この形式は、スプレッドシートやその他のアプリケーションにデータをインポートする場合に便利です。

アクティビティは、実行されるたびに新しいデータ セットを生成します。 フラット化機能は、同じアクティビティの複数のインスタンス間でデータをフラット化しません。

イベント通知

一部のアクティビティは、完了するまでに限られた時間がかかると予想されます。 その時間内に完了しない場合は、停止している可能性があります。または、完了できない別の問題が発生する可能性があります。 アクションの完了を待機する秒数を定義できます。 この指定された期間が経過すると、プラットフォーム イベントが送信され、問題が報告されます。 活動がエラーを返した場合にプラットフォーム イベントを生成するかどうかも選択できます。

アクティビティの実行に指定した時間以上かかるか、実行に失敗したときに通知を受け取る

1. [ イベント通知 ] ボックスに、通知が生成されるまでの実行時間の 秒数 を入力します。
2. [ アクティビティの実行に失敗した場合にレポートする ] を選択して、実行エラー通知を生成します。

公開データ

発行されたデータは、動作中の Runbook の基礎です。 アクティビティのアクションの結果として生成されるデータです。 このデータは、Runbook ごとに一意の内部データ バスに発行されます。 Runbook の後続のアクティビティでは、このデータをサブスクライブし、その構成で使用できます。 リンク条件では、この情報を使用して Runbook に意思決定機能を追加することもできます。

アクティビティは、Runbook の前にリンクされているアクティビティのデータにのみサブスクライブできます。 パブリッシュされたデータを使用して、アクティビティに必要なプロパティ値を自動的に設定できます。

パブリッシュされたデータを使用するには

1. プロパティ値ボックスを右クリックし、[ サブスクライブ] を選択して、[ 発行済みデータ] を選択します。
2. [ アクティビティ ] ドロップダウン ボックスを選択し、データを取得するアクティビティを選択します。 すべての Runbook に共通する追加のデータ要素を表示するには、[ 発行済みの共通データの表示] を選択します。
3. 使用するパブリッシュ済みデータ要素を選択し、[OK] を選択します。

各アクティビティによって公開されるデータ要素の一覧については、「アクティビティ」セクションの 「発行済みデータ 」テーブルを参照してください。 一般的なパブリッシュ済みデータ項目の詳細については、「 Common Published Data」を参照してください。

Activities

この統合パックは、Runbook Designerの [アクティビティ] ウィンドウに Exchange ユーザー カテゴリを追加します。 このカテゴリには、次のアクティビティが含まれています。

• 電子メールの作成と送信
• アイテムの作成
• 項目の削除
• 予定の検索
• アイテムの転送
• アイテムの取得
• アイテムの監視
• アイテムの移動またはコピー
• 電子メールに返信する
• 電子メールの送信
• アイテムの更新