ExcelOnline
OneDrive上に存在するExcelファイルの操作を行うアクション一覧です。
※扱うことのできるExcelファイルの拡張子は「.xlsx」のみです。
CreateWorkbook
概要
CreateWorkbookは、OneDrive上にExcelファイルを作成します。
パラメーター
*は、必須パラメーター
名前 | 型 | 概要 | 例 |
---|---|---|---|
provider* | 文字列 | OneDriveコネクションのプロバイダーID | onedrive_1234 |
title* | 文字列 | 作成するエクセルのファイル名(パス指定も可能) | sample.xlsx |
アウトプット
タイプ | 型 | 概要 | 例 |
---|---|---|---|
Workbook | ワークブック | Workbookオブジェクト | 下記参照 |
{
"@odata.context": "https://graph.microsoft.com/{version}/$metadata#users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJGUJ7JHBSZDFZFL25KSZGQTVAUN')/workbook/worksheets",
"value": [
{
"@odata.id": "/users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJGUJ7JHBSZDFZFL25KSZGQTVAUN')/workbook/worksheets(%27%7B00000000-0001-0000-0000-000000000000%7D%27)",
"id": "{00000000-0001-0000-0000-000000000000}",
"name": "Sheet1",
"position": 0,
"visibility": "Visible"
},
]
}
使用例
+create_workbook_1:
action>: CreateWorkbook
provider: onedrive_1234
title: 'sample.xlsx'
GetWorkbook
概要
GetWorkbookは、Workbookオブジェクトを取得するアクションです。\ コネクション連携するアカウントがオーナーでない共有ワークブックの場合は、workbook_idに共有URLを入力してください。\ Onedriveのロゴが記載されるマークをクリックして対象ワークブックを選択すると、そのオーナーを自動で判別して適切な値を入力します。
パラメーター
*は、必須パラメーター
名前 | 型 | 概要 | 例 |
---|---|---|---|
provider* | 文字列 | OneDriveコネクションのプロバイダーID | onedrive_1234 |
workbook_id* | 文字列 | ワークブックのファイルIDもしくは |
01YUHGTHI6XQ5CVZ4CINF3K7LVMEOUQC3T, |
アウトプット
タイプ | 型 | 概要 | 例 |
---|---|---|---|
Workbook | ワークブック | Workbookオブジェクト | 下記参照 |
{
"@odata.context": "https://graph.microsoft.com/{version}/$metadata#users('f6d92604-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJGUJ7JHBSZDFZFL25KSZGQTVAUN')/workbook/worksheets",
"value": [
{
"@odata.id": "/users('f6d904-4b76-4b70-9a4c-93dfbcc054d5')/drive/items('01CYZLFJGJ7JHBSZDFZFL25KSZGQTVAUN')/workbook/worksheets(%27%7B00000000-0001-0000-0000-000000000000%7D%27)",
"id": "{00000000-0001-0000-0000-000000000000}",
"name": "Sheet1",
"position": 0,
"visibility": "Visible"
},
]
}
使用例
+get_workbook_1:
action>: GetWorkbook
provider: onedrive_1234
workbook_id: '01YUHGTHI6XQ5CVZ4CINF3K7LVMEOUQC3T'
GetWorksheetCells
概要
GetWorksheetCellsは、ワークシートからセルの値を取得するアクションです。 取得するワークシートは閉じた状態で実行しないと、想定と異なる結果が得られる可能性がありますのでご注意ください。
パラメーター
*は、必須パラメーター
名前 | 型 | 概要 | 例 |
---|---|---|---|
workbook* | オブジェクト | ワークブックオブジェクト | +get_workbook_1 |
range* | 文字列 | 取得したいセルの範囲(A1記法) | Sheet1!A1:B2 |
findAll* | 真理値 | trueの場合、範囲内の空白セルを全て含む配列を返却します。falseの場合、外側の空白行・列を除いた配列を返却します | true |
アウトプット
タイプ | 型 | 概要 | 例 |
---|---|---|---|
Array | 配列 | 取得したセルの値を[行][列]の二次元配列で返します。 | *使用例を参照 |
使用例
A1:D4(画像赤枠)を選択
- findAllにfalseを指定した時
+get_worksheet_cells_1:
action>: GetWorksheetCells
workbook: +get_workbook_1
range: 'Sheet1!A1:D4'
findAll: false
# => [
# [],
# [
# "B2",
# "C2"
# ],
# [
# "B3",
# "C3"
# ]
# ]
- findAll にtrueを指定した時
+get_worksheet_cells_1:
action>: GetWorksheetCells
workbook: +get_workbook_1
range: 'Sheet1!A1:D4'
findAll: true
# => [
# [
# "",
# "",
# "",
# ""
# ],
# [
# "",
# "B2",
# "C2",
# ""
# ],
# [
# "",
# "B3",
# "C3",
# ""
# ],
# [
# "",
# "",
# "",
# ""
# ]
# ]
UpdateWorksheetCells
概要
UpdateWorksheetCellsは、ワークシートのセルの値を更新するアクションです。
パラメーター
*は、必須パラメーター
名前 | 型 | 概要 | 例 |
---|---|---|---|
workbook* | ワークブック | Workbookオブジェクト | +get_workbook_1 |
range* | 文字列 | セルの範囲(A1記法) | Sheet1!A1:B2 |
values* | 配列 | 書き込む値 | [['A1','B1'],['A2', 'B2']] |
アウトプット
タイプ | 型 | 概要 | 例 |
---|---|---|---|
Workbook | ワークブック | Workbookオブジェクト | GetWorkbookのアウトプットを参照 |
使用例
+update_worksheet_cells_1:
action>: UpdateWorksheetCells
workbook: +get_workbook_1
range: 'Sheet1!A1:B2'
values: [['A1','B1'],['A2', 'B2']]
ClearWorksheetValues
概要
ClearWorksheetValuesは、ワークシートのセルの値を削除するアクションです。
パラメーター
*は、必須パラメーター
名前 | 型 | 概要 | 例 |
---|---|---|---|
workbook* | ワークブック | Workbookオブジェクト | +get_workbook_1 |
range* | 文字列 | セルの範囲(A1記法) | Sheet1!A1:B2 |
アウトプット
タイプ | 型 | 概要 | 例 |
---|---|---|---|
Workbook | ワークブック | Workbookオブジェクト | GetWorkbookのアウトプットを参照 |
使用例
+clear_worksheet_values_1:
action>: ClearWorksheetValues
workbook: +get_workbook_1
range: 'Sheet1!A1:B2'
GetWorksheetBlankRows
概要
GetWorksheetBlankRowsは、指定した範囲内にある空行を取得するアクションです。
パラメーター
*は、必須パラメーター
名前 | 型 | 概要 | 例 |
---|---|---|---|
workbook* | ワークブック | Workbookオブジェクト | +get_workbook_1 |
range* | 文字列 | セルの範囲(A1記法) | Sheet1!A1:B2 |
findAll* | 真理値 | trueの場合、範囲内の空行を全て取得します。falseの場合、範囲内にある最初の空行を取得します。 | true |
アウトプット
タイプ | 型 | 概要 | 例 |
---|---|---|---|
Array or Text | 配列 or 文字列 | 空行を1行ごとにA1記法で出力します。findAllパラメーターがtrueの場合は配列で、falseの場合は文字列で返却されます。 | 下記参照 |
findAllがtrueの時
['Sheet1!A1:B1', 'Sheet1!A4:B4', ...]
findAllがfalseの時
'Sheet1!A1:B1'
使用例
+get_worksheet_blank_rows_1:
action>: GetWorksheetBlankRows
workbook: +get_workbook_1
range: 'Sheet1!A1:B2'
findAll: true
DuplicateWorkbook
概要
DuplicateWorkbookは、ワークブックをコピーするアクションです。\ 指定したフォルダが存在しない場合は、自動生成します。
パラメーター
*は、必須パラメーター
名前 | 型 | 概要 | 例 |
---|---|---|---|
workbook* | ワークブック | Workbookオブジェクト | +get_workbook_1 |
name* | 文字列 | ファイル名(パス指定可能) | documents/test.xlsx |
アウトプット
タイプ | 型 | 概要 | 例 |
---|---|---|---|
Workbook | ワークブック | Workbookオブジェクト | GetWorkbookのアウトプットを参照 |
使用例
+duplicate_workbook_1:
action>: DuplicateWorkbook
workbook: +get_workbook_1
name: 'documents/test.xlsx'
AppendWorksheet
概要
AppendWorksheetは、ワークブックに1つ新たにシートを追加するアクションです。 追加して作成されたWorkbookオブジェクトを出力します。
パラメーター
*は、必須パラメーター
名前 | 型 | 概要 | 例 |
---|---|---|---|
workbook* | オブジェクト | Workbookオブジェクト | +get_workbook_1 |
name | 文字列 | 追加するシート名。指定なしの場合、Excel Onlineのデフォルトのシート名になります。また、次の文字列や記号はシートの名前に含めることができません。対象: \ / ? * [ ] | 10月(デフォルトでは「Sheet3」のような名前になります。) |
アウトプット
タイプ | 型 | 概要 | 例 |
---|---|---|---|
Workbook | ワークブック | Workbookオブジェクト | GetWorkbookのアウトプットを参照 |
使用例
+append_worksheet_1:
action>: AppendWorksheet
workbook: +get_workbook_1
name: '10月'