FTP 統合パックのアクティビティFTP Integration Pack Activities

重要

このバージョンの Orchestrator はサポートが終了しました。 orchestrator 2019 にアップグレードすることをお勧めします。This version of Orchestrator has reached the end of support, we recommend you to upgrade to Orchestrator 2019.

次の構成手順は、この統合パックのすべての活動に適用されます。The following configuration instructions apply to all activities in this integration pack. このセクションへのリンクは、各アクティビティの構成手順に含まれています。Links to this section are included in the configuration instructions for each activity.

このトピックの手順は、Orchestrator Runbook Designer の [runbook] ウィンドウに配置されたアクティビティに対して実行します。The procedures in this topic are performed on an activity that has been placed in the runbook window of the Orchestrator Runbook Designer.

活動のプロパティActivity Properties

各アクティビティには、そのアクティビティの構成を定義する必須または省略可能なプロパティのセットがあります。Each activity has a set of required or optional properties that define the configuration of that activity. これには、他のアクティビティに接続する方法や、アクティビティがアクションを実行する方法が含まれます。This includes how it connects to other activities or how the activity performs its actions. 活動が runbook ウィンドウに配置されている場合は、アクティビティのプロパティを表示または変更できます。You can view or modify activity properties when the activity is placed in the runbook window.

アクティビティのプロパティを表示および構成するにはTo view and configure the properties for an activity

  1. アクティビティをダブルクリックします。Double-click the activity. または、アクティビティを右クリックし、[ プロパティ] をクリックします。Alternatively, you can right-click the activity, and then click Properties.
  2. 構成エントリを保存するには、[ 完了] をクリックします。To save your configuration entries, click Finish.

[アクティビティのプロパティ] ダイアログボックスでは、左側にあるいくつかのタブを使用して、アクティビティの全般設定と特定の設定にアクセスできます。In the activity properties dialog box, several tabs along the left side provide access to general and specific settings for the activity. オブジェクトのプロパティに使用できるタブの数は、アクティビティによって異なります。The number of available tabs for object properties differs between different activities.

全般タブGeneral Tab

このタブには、アクティビティの 名前説明 のプロパティが表示されます。This tab contains the Name and Description properties for the activity. 既定では、アクティビティの 名前 はアクティビティの種類と同じであり、 説明 は空白になります。By default, the Name of the activity is the same as its activity type, and the Description is blank. これらのプロパティを変更して、わかりやすい名前を作成したり、アクティビティのアクションの詳細な説明を入力したりすることができます。You can modify these properties to create more descriptive names or provide detailed descriptions of the actions of the activity.

[プロパティ] タブProperties Tab

このタブには、アクティビティに固有のプロパティが表示されます。This tab contains properties that are specific to the activity. この統合パック内のすべての活動には、[プロパティ] タブまたは [フィルター ] タブの上部にある "構成名" プロパティがあります。このプロパティは、FTP サーバーへの接続を指定するために使用されます。All activities in this integration pack have the Configuration Name property at the top of the Properties or Filters tab. This property is used to specify the connection to the FTP server.

"構成名" プロパティを構成するにはTo configure the Configuration Name property

  1. [名前] フィールドの横にある省略記号ボタン ([. ..]) をクリックします。Click the ellipsis (...) button next to the Name field.
  2. 該当する接続名を選択します。Select the applicable connection name.

フィルターの動作Filter Behavior

活動はフォルダー/ファイルを一覧表示し、フォルダー/ファイルを同期します。フィルターを使用して、表示または同期される項目を決定します。The activities List Folders/Files and Synchronize Folder/File use filters to determine the items that will be listed or synchronized. 候補の候補のプロパティ値は、条件を満たしているかどうかを判断するために、フィルターの値と比較されます。Property values of potential candidates are compared to the values of the filters to determine if they meet the criteria. 値と照合するときに、使用可能な比較方法の1つを選択できます。When matching against values, you can select one of the available methods of comparison. 各メソッドを使用してフィルターと一致するかどうかを指定するオプションが用意されています。An option is provided to either match or not match the filter using each method. たとえば、メソッドの "do not" バージョンでは、アクティビティを開始するためのフィルターに一致しない項目が検出されます。For example, the "Does not" version of a method finds items that do not match the filter to start the activity. すべてのテキストフィルターでは大文字と小文字が区別されます。All text filters are case sensitive.

  • Equals: メッセージのプロパティは、フィルターで指定されたテキストまたは数値と一致します。Equals: the property of the message matches the text or number specified in the filter.
  • が次の値と等しくない: メッセージのプロパティが、フィルターで指定されたテキストまたは数値と一致しません。Does not equal: the property of the message does not match the text or number specified in the filter.

[実行の動作] タブRun Behavior Tab

このタブには、活動が複数値の公開データを処理する方法と、アクティビティが失敗したり長時間実行されたりした場合にどの通知を送信するかを決定するプロパティが含まれます。This tab contains the properties that determine how the activity handles multi-value published data and what notifications will be sent if the activity fails or runs for an excessive period of time.

複数値公開データの動作Multi-Value Published Data Behavior

Get アクティビティは、別のアクティビティまたは外部ソースから情報を取得し、公開データ内の1つ以上の値を返すことができます。The Get activities retrieve information from another activity or outside source, and can return one or more values in the published data. たとえば、フォルダーまたはファイルの一覧表示活動を使用する場合、そのアクティビティからのデータ出力は、指定したコレクションに属するコンピューターの一覧になります。For example, when you use the List Folders/Files activity, the data output from that activity could be a list of computers that belong to the specified collection.

既定では、フォルダー/ファイルの一覧表示活動のデータは、複数の個別の出力として渡されます。By default, the data from the List Folders/Files activity will be passed on as multiple individual outputs. これにより、出力内の項目と同じ回数だけ次のアクティビティが呼び出されます。This invokes the next activity as many times as there are items in the output. または、[ フラット 化] オプションを有効にすることで、アクティビティに対して1つの出力を指定することもできます。Alternatively, you can provide a single output for the activity by enabling the Flatten option. このオプションを有効にする場合は、書式設定オプションを選択する必要があります。When you enable this option, you must choose a formatting option:

  • 改行を使用して区切ります。Separate with line breaks. 各項目は新しい行にあります。Each item is on a new line. この形式は、出力用に人間が判読できるテキストファイルを作成する場合に便利です。This format is useful for creating human-readable text files for the output.
  • と区別します。Separate with. 各項目は、選択した1つ以上の文字で区切られます。Each item is separated by one or more characters of your choice.
  • CSV 形式を使用します。Use CSV format. すべての項目は CSV (コンマ区切り値) 形式です。All items are in CSV (comma-separated value) format. この形式は、スプレッドシートまたはその他のアプリケーションにデータをインポートする場合に便利です。This format is useful for importing data into spreadsheets or other applications.

アクティビティは、実行するたびに新しいデータセットを生成します。The activity will produce a new set of data every time it runs. フラット化機能は、同じアクティビティの複数のインスタンスにわたってデータを平坦化するものではありません。The Flatten feature does not flatten data across multiple instances of the same activity.

イベント通知Event Notifications

一部のアクティビティは、完了までに限られた時間がかかると想定されています。Some activities are expected to take a limited amount of time to complete. この時間内に完了しなかった場合、または完了できない問題が発生している可能性があります。If they do not complete within that time they may be stalled or there may be another issue preventing them from completing. 操作が完了するまでの待機時間を秒数で定義できます。You can define the number of seconds to wait for completion of the action. この期間が過ぎると、プラットフォームイベントが送信され、問題が報告されます。After this period a platform event will be sent and the issue will be reported. 活動がエラーを返した場合にプラットフォーム イベントを生成するかどうかも選択できます。You can also choose whether to generate a platform event if the activity returns a failure.

アクティビティの実行時間が指定した時間を超えた場合、または実行に失敗した場合に通知されるようにするにはTo be notified when the activity takes longer than a specified time to run or fails to run

  1. [ イベント通知 ] ボックスに、通知が生成されるまでの実行時間を 秒数 で入力します。In the Event Notifications box, enter the number of seconds of run time before a notification is generated.
  2. 実行 に失敗した場合 に実行失敗の通知を生成するには、[レポート] を選択します。Select Report if activity fails to run to generate run failure notifications.

公開データPublished Data

公開データは、作業用 runbook の基盤です。Published data is the foundation of a working runbook. これは、アクティビティのアクションの結果として生成されるデータです。It is the data produced as a result of the actions of an activity. このデータは、runbook ごとに一意の内部データバスに発行されます。This data is published to an internal data bus that is unique for each runbook. Runbook 内の後続のアクティビティは、このデータをサブスクライブして、そのデータを構成で使用できます。Subsequent activities in the runbook can subscribe to this data and use it in their configuration. リンク条件では、この情報を使用して、runbook に意思決定機能を追加することもできます。Link conditions also use this information to add decision-making capabilities to runbooks.

活動は、runbook の前にリンクされているアクティビティからのデータのみをサブスクライブできます。An activity can subscribe only to data from the activities that are linked before it in the runbook. 公開データを使用して、アクティビティに必要なプロパティ値を自動的に設定できます。You can use published data to automatically populate the property values needed by activities.

公開データを使用するにはTo use published data

  1. [プロパティ値] ボックスを右クリックし、[ サブスクライブ] をクリックして、[ 公開データ] をクリックします。Right-click the property value box, click Subscribe, and then click Published Data.
  2. [ アクティビティ ] ドロップダウンボックスをクリックし、データの取得元となるアクティビティを選択します。Click the Activity drop-down box and select the activity from which you want to obtain the data. すべての runbook に共通するその他のデータ要素を表示するには、[ 共通の公開データを表示する] を選択します。To view additional data elements common to all runbooks, select Show Common Published Data.
  3. 使用する公開データ要素をクリックし、[ OK] をクリックします。Click the published data element that you want to use, and then click OK.

各アクティビティによって発行されたデータ要素の一覧については、「アクティビティ」トピックの「 公開データ 」テーブルを参照してください。For a list of the data elements published by each activity, see the Published Data table in the activity topic. 共通の公開データ項目の詳細については、「 共通の公開データ」を参照してください。For information about the common published data items, see Common Published Data.

ActivitiesActivities

この統合パックでは、[Runbook Designer の [アクティビティ] ウィンドウに [ FTP ] カテゴリが追加されます。This integration pack adds the FTP category to the Activity pane in the Runbook Designer. このカテゴリには、次のアクティビティが含まれます。This category contains the following activities:

フォルダーの作成Create Folder
ファイルの削除Delete File
フォルダーの削除Delete Folder
ファイルのダウンロードDownload File
フォルダー/ファイルの一覧表示List Folders/Files
ファイル/フォルダー名の変更Rename File/Folder
ファイルのダウンロードの再開Resume File Download
フォルダー/ファイルの同期Synchronize Folder/File
ファイルのアップロードUpload File