Excelファイルのセルに値を書き込む「セルに書き込む」アクティビティについてです。
1. アクティビティのプログラム名
RCA.Activities.Excel.WriteCell
2. 説明
Studio バージョン ~2.0.2.0
クイックアクセス： 「ツールボックス」 > 「Excel」 > 「セルに書き込む」
Studio バージョン 2.0.3.0~
クイックアクセス： 「ツールボックス」 > 「Excel」 > 「ClosedXML」 > 「セルに書き込む」
Excelファイルの指定したセルに値を書き込みます。範囲を指定すると、指定した範囲すべてに値を書き込みます。プロパティ「セル」の値は省略できません。ワークブックパスに設定した Excelファイルが存在しない場合、新規に作成されます。シート名が存在しない場合、シートを新規に作成します。指定した Excelファイルにデータが存在する場合、指定したセルのみ上書きされます。また指定した Excelファイルが使用中の場合、System.IO.IOException がスローされエラーとなります。このアクティビティは Excel がインストールされていない場合も使用できます。
※動作を確認したコボットStudioのバージョン：2.0.1.6、2.0.1.8
※バージョンによって文言などが一部異なる場合がございます
3. プロパティ
| プロパティ項目 | プロパティ名 | 入力欄 | 説明 |
|---|---|---|---|
| その他 | パブリック | チェック項目 | ログにアクティビティ内の変数と引数がログファイルに書き込まれ、Centerにプッシュされる。（詳細は「プロパティ項目「パブリック」について」を参照） |
| 表示名 | 任意の文字列 | デザイナーパネルのアクティビティ名に反映される。 | |
| 入力 | シート名 | 値を入力（String型） | 書き込むシート名を設定する。シート名が存在しない場合、シートが新規に作成される。 |
| セル | 値を入力（String型） | データの書き込みたいセルを設定する。 | |
| ワークブックパス | 値を入力（String型） | 書き込む Excelファイルのパスを設定する。相対パスの場合、プロジェクトフォルダーが基準となる。存在しない Excelファイルのパスを設定した場合、新規に作成される。 | |
| 値 | 値を入力（String型） | 書き込む値を設定する。 |
4.使い方
Excelファイル「サンプル.xlsx」の「サンプル」シート「A2」セルに、文字列「サンプル」を書き出す場合を見ていきましょう。
アクティビティ「Excel > セルに書き込む」を、ツールボックスからデザイナーパネルにドラッグ&ドロップで配置します。
アクティビティ内のプロパティ「入力 > ワークブックパス」を設定します。今回は「Excelファイルを選択」ダイアログからファイルを選択していきます。プロパティの横にある「Excelファイルを選択」ダイアログ表示ボタンをクリックします。
「Excelファイルを選択」ダイアログでは、xamlファイルの保管先フォルダ（プロジェクトのフォルダ）が開きますが、プロジェクトのフォルダ以外に保管されたファイルも指定できます。プロジェクトのフォルダ配下のファイルを指定した場合はファイル名のみが入り、プロジェクトのフォルダ以外のファイル場合は「 "C:\Users\（ユーザー名）\Downloads\サンプル.xlsx" 」のようにファイルの絶対パスが入ります。
※ボックスにファイルパス「"サンプル.xlsx"」と直接記述し設定する事もできます。この場合「サンプル.xlsx」が存在する場合は上書きされ、存在しない場合は新規に作成されます。
Excelファイル「サンプル.xlsx」を選択し、「開く」ボタンをクリックします。
アクティビティ内の①プロパティ「入力 > シート名」に「"サンプル"」を、②プロパティ「入力 > セル」に「"A2"」を設定します。
※プロパティパネルからも設定できます。「"A2:B3"」のように範囲を指定することもできます。「"A2:B3"」と設定した場合、サンプルシート内のA2・B2・A3・B3の4つのセルを設定できます。
書き出す値の設定です。 アクティビティ内の「入力 > 値」に「"サンプル"」を設定します。
「ホーム > スタート」をクリック、または、「F5キー」押下で実行します。
実行結果です。サンプルシートの A2 セルに値が書き出されました。
