Microsoft Excel®ワークブックをチェーンの一部として管理するには、Microsoft Excel接続コマンドを含むステップを追加します。
注: Microsoft Excelコネクターは、マクロ対応の Excel ワークブック(XLSM)ファイルをサポートしますが、VBA(Virtual Basic for Applications)マクロや、Workbook Open、BeforeSave、SheetCalculate などのイベントベースのマクロは実行できません。
これらのコマンドを有効にするには、まずIT管理者が、Microsoft Excelコネクタ を作成する。
ファイルからワークブックを作成する
区切り文字で区切られた値ファイルのデータに基づいてシートを持つエクセルのワークブックを作成または更新するには、Create Workbook from Files コマンドを使用します。
コネクターの構成によって2つの出力オプションがあることに留意してください:
-
GroundRunner を使用する場合は、JSON(Javascript Object Notation)オブジェクトを入力します。
-
CloudRunner を使用する場合は、チェーン内のコマンド出力またはリソースを指定します。
プロパティ
| プロパティ |
詳細 |
| ファイル |
ワークブックの別シートとして作成するファイルを指定する:
- チェーン内の出力またはリソースに基づくファイルについては、Add をクリックし、各ファイルの出力またはリソースを選択し、シート名称(31文字以内)を入力します。
- ファイルをJSONとして指定するには、変数を有効化を選択し、JSONを入力するか、以前のコマンドの出力からJSONオブジェクトを選択します。JSONを次のように書式設定します:
[ {"file": "fullPathToFile_1", "name": "sheetName_1"}, {"file": "fullPathToFile_2", "name": "sheetName_2"} ] 注: 以前のコマンドの出力ファイルをJSONに含むには、GroundRunnerのプロセス・フォルダ内のフル・パスを入力します。
|
| 区切り記号 |
ファイルで使用する区切り文字を選択します。 |
| ワークブック名称 |
ファイルに基づいて新規ワークブックを作成するには、その識別を手助けするために一意の名称を入力する。 注: 提供されていない場合、コマンドは自動的に.xlsx の拡張機能を作成します。 |
| 既存のワークブック |
ファイルのデータを新規ではなく、既存のワークブックに追加するには、更新するワークブックファイルを選択します。Files に名称が入力されたシートはすべて上書きされる。 重要: 保護されたファイルでこのコマンドを使用すると、結果のワークブックは保護されません。つまり、保護されたファイルを扱う際には、マニュアルで暗号化を再追加する必要がある。 |
出力
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
コマンド成功 |
| 1 |
エラー |
一般的な失敗 |
リストシート
ExcelワークブックのすべてのシートのJSONリストを作成するには、List Sheets コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| ワークブックファイル |
シートを一覧表示するXLSまたはXLSXワークブックを入力します。 |
| パスワード |
ワークブックファイル がパスワードで保護された XLSX ワークブックの場合、そのパスワードを入力する。 |
出力
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
コマンド成功 |
| 1 |
エラー |
一般的な失敗 |
ワークシートからCSVへ
エクセルのワークブックのシートのデータを表ファイルに変換するには、Worksheet to CSV コマンドを使用する。
注: Worksheet to CSVコマンドは、ワークシートで最後に計算された値を抽出します。値を更新するための数式計算は実行されません。自動計算が無効になっているワークシートでは、精度を保証するために、チェーンを実行する前に値をマニュアルで計算し、保存してください。
プロパティ
| プロパティ |
詳細 |
| ワークブックファイル |
表形式ファイルに変換するシートを含む XLS または XLSX ワークブックを入力します。 |
| パスワード |
ワークブックファイル がパスワードで保護された XLSX ワークブックの場合、そのパスワードを入力する。 |
| 区切り記号 |
出力ファイルで使用する区切り記号を選択します。 |
| シート名 |
変換するワークブックのシート名称を入力します。代わりにインデックスでシートを識別する場合は、空白のままにしてください。 |
| シート索引 |
変換するワークブックのシートのインデックス位置を入力します。最初のシートは1 とし、最後のシートは-1 とします。シートの名称によって識別する場合は、空白のままにしてください。 |
| 開始セル |
変換するシートのデータの最初の行と列の両方のセルを入力します。 |
| 列終了 |
A1表記では、変換するデータが終了する列のレター(A、B、Cなど)を入力する(行番号は入力しない)。 メモ: コマンドは、この列以降のシート内のデータを無視する。 |
| 列の最後 |
A1表記で、変換するデータが終わる行の番号(10、200、3000など)を列レターなしで入力する。行を無視するには、0 と入力する。 メモ: コマンドは、この行以降の列のデータを無視する。 |
| 値の書式設定されたセルの使用 |
日付/時間の処理など、生の値ではなくセルの表示値を変換するには、このボックスにチェックを入れる。 |
| プレビュー結果 |
出力ファイルのプレビューを有効にするには、このボックスをチェックします。 |
| ストリーミング・モード |
大きなXLSXファイルにのみ適用されます。 20MB以上のファイルを推奨します。 メモリ使用状況を減らすため、ファイルを小さなデータウィンドウで読み込む。 この設定を値の書式設定オプションと組み合わせて有効にすると、一部の数式、特にファイル内の離れたセルを参照する数式が正しく機能しないことがある。 |
出力
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
コマンド成功 |
| 1 |
エラー |
一般的な失敗 |