Salesforce Docs Portal

Excel Session

Excel Session は、すべての Excel 操作を網羅する要素です。 Excel 操作には、Excel 形式のファイル全体およびファイル要素の読み取り、変更、作成が含まれます。Excel Session は、パスワードで保護された Excel ファイルの読み書きをサポートします。

Excel Session では、開く Exce ファイル、ファイルの場所、使い方を定義します。Excel Session 内で他のアクションステップを使用することで、Excel ファイルの情報をさらに処理できます。

Excel Session は、セッションの実行開始時に Excel ファイルを開き、終了時に閉じます。Excel Session には、最大でもう 1 つの Excel Session を含めることができます。

Excel ファイルの行または列のすべての要素にわたってループを実行するには、Excel Controlled Loop アクションステップを使用します。

パフォーマンスに悪影響を与えるため、Excel Session をループの内側には設定しないでください。

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

プロパティ

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 ファイルに書き込むのかを選択します。

[Source file (ソースファイル)]​は、読み取るファイルです。​[Directory path (ディレクトリパス)]​ 項目に、ソースファイルがあるディレクトリへのパスを手動で指定するか、または環境変数とスクリプト変数、ファイルエクスプローラー、またはピン変数を使用して指定します。

[File name (ファイル名)]​ 項目にファイル名を手動で入力するか、ファイルエクスプローラーまたはピン変数を使用して、開くファイルを指定します。

作成時に使用したファイルとは異なるファイルを実行時に指定するには、​[Use different source file name for workflow run (ワークフロー実行で別のソースファイル名を使用)]​ を選択します。この場合、ファイル名と拡張子は同一である必要があり、両方を指定する必要があります。

Excel ファイルにパスワードが必要な場合は、​[Excel file is password protected (Excel ファイルをパスワードで保護)]​ を選択し、ファイルを開くためのパスワードを指定します。

指定されたファイル名がディレクトリパスに存在しない場合に Excel ファイルを作成するには、​[Create Excel file if it doesn’t exist (Excel ファイルが存在しないは作成)]​ を選択します。

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

実行中に使用する別の動的 Excel ファイルを指定するには、​[Use different source file name for workflow run (ワークフロー実行で別のソースファイル名を使用)]​ を選択し、​[Different file name (別のファイル名)]​ 項目で (手動で、もしくはファイルエクスプローラーやピン変数を使用して) ファイルを指定します。

関連情報