Write To Excel (365)

説明

WriteToExcel365コンポーネントは、データをExcel形式でMicrofost365に出力することができます。

このコンポーネントを使用するには、Microfost365 for Businessの契約と事前設定が必要です。

事前設定はMicrosoft 365 OAuth2設定を参照してください。

excel365

入力ペイロード(cv.Payload)はJSON配列の配列か、JSON Objectの配列での入力を受け付けます。それ以外の場合は文字列に変換して、1行、1カラムのExcelファイルとして出力します。

入力ペイロード例
JSON配列ペイロードの例[[123, "abc", "xxx"], [456, "def", "yyy"], [789, "hij", "zzz"]]
JSON Objectのペイロードの例[{"field1": 123, "field2":"abc", "field3":"xxx"}, {"field1": 456, "field2":"def", "field3":"yyy"}, {"field1": 789, "field2":"hij", "field3":"zzz"}]

コンポーネントプロパティ

プロパティ名説明
ファイル名出力するExcelのファイル名を指定
シート名データを出力するシート名を指定
書込モード新しいファイル（New File）を作成するか、セルを更新（Overwrite）するか、行を追加（Append）するかを指定. cp.WriteModeの値としては、 "New" , "Append" , "Overwrite" のいずれか
出力ヘッダーデータを出力するときにヘッダも出力するかを選択
出力フィールド順ステップ出力のカラムのうち、Excelのどの列に出力するかを指定します。複数指定可能です。（例: 出力ペイロードのaをエクセルのA列、cをエクセルのB列に出力する場合は「Payload.a:A,Payload.c:C」とステップ出力のフィールドとエクセルの列は ":" で指定して、複数指定する場合には "," カンマで区切ります）
スタート列出力する最初の列を指定します。
スタート行出力する最初の行を指定します。
認証方式先進認証（OAuth2）または基本認証（パスワード）
非公開アプリ先進認証の場合、クライアントシークレットを使用する場合に指定
クライアント IdアプリケーションIDを指定
テナント Idディレクトリ（テナント）IDを指定
インスタンス（変更しません）
ユーザー名基本認証の場合、Microsoft365 Businessのアカウントを指定
パスワード基本認証の場合、Microsoft365 Businessのアカウントのパスワードを指定
OAuth2クライアントシークレット先進認証の場合、AzureからClient Secretを指定します
OAuth2リダイレクトURL先進認証の場合、AzureからRedirect URLを指定します
OAuth2スコープ（変更しません）
OAuth2アクセストークントークンを取得ボタンを押して取得します。またトークンを更新ボタンを押して更新することもできます

OAuth2アクセストークンの取得方法はOAuth2アクセストークン取得方法を参照してください

「書込モード」（WriteMode）

・行を追加 (Add Rows)

列の指定に関わらず、データが入っている最後の行の次の行からデータが追加されます。ただし、Write To Excel (Local)の場合は、過去にデータを入力して削除した行もデータが入っていると見なされます。

指定した「スタート行」がデータが入っている最後の行の次の行よりも大きい場合、その「スタート行」からデータが追加されます。

・セルを更新 (Update Cells)

一部のセルが置き換えられます。既存の内容がある場合は、そのセルの内容が上書きされます。

・新しいファイル (New File)

既存のファイルがある場合は、そのファイルが上書きされます。（注意：Write To Excel (365)の場合、ブラウザでファイルが開いているとエラーが発生することがあります。）

出力フィールド順の指定方法

JSON Objectのペイロードが下記の場合に、出力フィールド順に field3, field1 と指定するとExcelファイルが出力されます。

・JSON Objectのペイロード

[
  {"field1": 123, "field2":"abc", "field3":"xxx"}, 
  {"field1": 456, "field2":"def", "field3":"yyy"}, 
  {"field1": 789, "field2":"hij", "field3":"zzz"}
]

・出力ペイロード（Excelファイル）

field3, field1
xxx,123
yyy,456
zzz,789