Excel Session

Excel Session​ は、すべての Excel 操作を網羅する要素です。 Excel 操作には、Excel 形式のファイル全体およびファイル要素の読み取り、変更、作成が含まれます。

Excel 操作を使用するために、Microsoft Excel をコンピューターにインストールする必要はありません。

Excel Session では、どの場所のどの Excel ファイルをいつ開き、どのように使用する必要があるかを定義します。

Excel Session​ 内に他のアクションステップを配置すると、Excel ファイルの情報をさらに処理できます。

Excel ファイルは、​Excel Session​ の実行を開始するときに開き、セッションの終了時に適切に閉じます。

Excel Session​ には、最大でさらにもう 1 つの Excel Session を含めることができます。 コンピューターのパフォーマンスを最適化するには、Excel Session をループ内に配置しないでください。Excel ファイルの行または列のすべての要素でループを実行する場合、Excel Session 内に関連するループを配置してください。

プロパティ

Destination Excel Operation Settings (宛先の Exce 操作設定)

[Destination Excel Operation Settings (宛先の Exce 操作設定)] は、[Read from source and write to different file (読み取り元から読み取って別のファイルに書き込む)] モードを選択している場合にのみ関連します。

  • Create destination file (宛先ファイルを作成)​ (Bool (ブール)、デフォルト: False) まだ存在しない場合に宛先ファイルを作成する必要があるかどうかを定義します。

  • Destination file name (宛先ファイル名)​ (string (文字列)、デフォルトなし) 書き込まれるファイルなどの宛先ファイルの名前。

  • Different destination directory path for workflow run (ワークフロー実行の別の宛先ディレクトリパス)​ ​[Use different destination directory path for workflow run (ワークフロー実行で別の宛先ディレクトリパスを使用)]​ オプションがアクティブ化されている場合、ここで指定された代替宛先ディレクトリが実行時に使用されます。

  • Different destination file name for workflow run (ワークフロー実行の別の宛先ファイル名)​ ​[Use different destination file name for workflow run (ワークフロー実行で別の宛先ファイル名を使用)]​ オプションがアクティブ化されている場合、代替ファイル名が実行時に使用されます。

  • Directory Path (ディレクトリパス)​ (string (文字列)、デフォルト: %​STWS_BASEPATH​%) 宛先ファイルがあるディレクトリへのパス

設計時とは異なるディレクトリパスが実行時に使用されるかどうかに関係なく、宛先ファイルには 1 つのファイル名のみが使用されます。

  • Sheet name to be added (追加されるシート名)​ (string (文字列)、デフォルトなし) 宛先ファイルに追加されるシートの名前

  • Use different destination directory path for workflow run (ワークフロー実行で別の宛先ディレクトリパスを使用)​ このオプションがアクティブ化されている場合、代替パスが実行時に使用されます。

  • Use different destination file name for workflow run (ワークフロー実行で別の宛先ファイル名を使用)​ このオプションがアクティブ化されている場合、代替ファイル名が実行時に使用されます。

Excel Operation Settings (Excel 操作設定)

  • Operation mode (操作モード)​ (ドロップダウン選択、デフォルト: Read only (読み取り専用)) ​Excel 操作​の種別。 次の 3 つのモードを使用できます。

    • Read only (読み取り専用)​ ソースファイルは読み取りのみが行われ、変更できません

    • Read and write to the same file (同じファイルに対して読み書きを行う)​ ソースファイルは読み取られ、変更できます。

    • Read from source and write to different file (読み取り元から読み取って別のファイルに書き込む)​ ソースファイルは読み取られますが、変更できません。さらに、宛先ファイルが開き、そこで変更が行われます。

Source Excel Operation Settings (読み取り元の Excel 操作設定)

  • Different source directory path for workflow run (ワークフロー実行の別の読み取り元ディレクトリパス)​ (string (文字列)、デフォルトなし) ​[Use separate source directory path for Execution (実行で別の読み取り元ディレクトリパスを使用)]​ が選択されている場合、ここで指定されたパスがソースファイルがあるディレクトリへのパスとして使用されます。

  • Different source file name for workflow run (ワークフロー実行の別のソースファイル名)​ ​[Use different source file name for workflow run (ワークフロー実行で別のソースファイル名を使用)]​ オプションがアクティブ化されている場合、代替ファイル名が実行時に使用されます。

  • Directory Path (ディレクトリパス)​ (string (文字列)、デフォルト: %​STWS_BASEPATH​%) ソースファイルがあるディレクトリへのパス

  • Source file name (ソースファイル名)​ (string (文字列)、デフォルトなし) ソースファイルの名前。これは、​[Read and write to the same file (同じファイルに対して読み書きを行う)]​ モードで読み取られて書き込まれるファイルです。

  • Use different source directory path for workflow run (ワークフロー実行で別の読み取り元ディレクトリパスを使用)​ (Bool (ブール)、デフォルト: False) 作成時とは異なる読み取り元ディレクトリをワークフローの実行時に使用する必要があるかどうかを決定します。

  • Use different source file name for workflow run (ワークフロー実行で別のソースファイル名を使用)​ (Bool (ブール)、デフォルト: False) ワークフローの実行時にドラフト名ではなく代替ファイル名を使用する必要があるかどうかを決定します。

インバウンド変数

  • DirectoryPathSource

  • FileNameSource

  • SeparateSource

  • DirectoryPathDestination

  • FileNameDestination

  • CreateDstIfNotExists

  • SheetToBeCreated

アウトバウンド変数

このアクションステップには、アウトバウンド変数はありません。

ウィザード

[Operation Mode (操作モード)]​ セクションで、まず Excel ファイルの読み取りのみを行うのか、読み取りと変更を行うのか、別の Excel ファイルに書き込むのかを選択します。​[Read Only (読み取り専用)]​ モードが選択されている場合、ソースファイルは読み取りのみが行われ、変更できません。

ソースファイル​は、読み取る必要があるファイルです。ソースファイルがあるディレクトリへのパスを入力項目に直接書き込んだり、環境変数やスクリプト変数を挿入したり、ファイルエクスプローラー を使用して選択したり、Pin 変数に接続したりできます。作成時とは異なるファイルを実行時に使用することもできます。

この場合、ファイル名が一致している必要があります。ファイル名だけでなくファイル拡張子も必ず指定する必要があります。

2 番目のファイルを​宛先ファイル​として使用できます。この場合、ソースファイルは読み取りのみが行われ、変更できません。宛先ファイルは、情報を保存するために使用されます。​[Create destination file if it doesn’t exist (宛先ファイルが存在していない場合は作成)]​ チェックボックスがオンになっていると、宛先ファイルがまだ存在していない場合は作成されます。

Excel 操作の実行時に動的な Excel ファイルを使用できます。​[Different file name (別のファイル名)]​ 項目を使用して実行時用の別のファイルを直接指定したり、PIN 変数を使用してマップしたりできます。