ExcelOnline
OneDrive上に存在するExcelファイルの操作を行うアクション一覧です。
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は、Workbookオブジェクトを取得するアクションです。
コネクション連携するアカウントがオーナーでない共有ワークブックの場合は、workbook_idに共有URLを入力してください。
Onedriveのロゴが記載されるマークをクリックして対象ワークブックを選択すると、そのオーナーを自動で判別して適切な値を入力します。
*は、必須パラメーター
名前 | 型 | 概要 | 例 |
|---|---|---|---|
provider* | 文字列 | OneDriveコネクションのプロバイダーID | onedrive_1234 |
workbook_id* | 文字列 | ワークブックのファイルIDもしくは
ワークブックの共有URL | 01YUHGTHI6XQ5CVZ4CINF3K7LVMEOUQC3T,
https://1drv.ms/x/s!BEJX7tLM6XOCgQg |
タイプ | 型 | 概要 | 例 |
|---|---|---|---|
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は、ワークシートからセルの値を取得するアクションです。 取得するワークシートは閉じた状態で実行しないと、想定と異なる結果が得られる可能性がありますのでご注意ください。
*は、必須パラメーター
名前 | 型 | 概要 | 例 |
|---|---|---|---|
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は、ワークシートのセルの値を更新するアクションです。
*は、必須パラメーター
名前 | 型 | 概要 | 例 |
|---|---|---|---|
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は、ワークシートのセルの値を削除するアクションです。
*は、必須パラメーター
名前 | 型 | 概要 | 例 |
|---|---|---|---|
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は、指定した範囲内にある空行を取得するアクションです。
*は、必須パラメーター
名前 | 型 | 概要 | 例 |
|---|---|---|---|
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は、ワークブックをコピーするアクションです。
指定したフォルダが存在しない場合は、自動生成します。
*は、必須パラメーター
名前 | 型 | 概要 | 例 |
|---|---|---|---|
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は、ワークブックに１つ新たにシートを追加するアクションです。 追加して作成されたWorkbookオブジェクトを出力します。
*は、必須パラメーター
名前 | 型 | 概要 | 例 |
|---|---|---|---|
workbook* | オブジェクト | Workbookオブジェクト | +get_workbook_1 |
name | 文字列 | 追加するシート名。指定なしの場合、Excel Onlineのデフォルトのシート名になります。また、次の文字列や記号はシートの名前に含めることができません。対象: \ / ? * [ ] | 10月（デフォルトでは「Sheet３」のような名前になります。） |
タイプ | 型 | 概要 | 例 |
|---|---|---|---|
Workbook | ワークブック | Workbookオブジェクト | GetWorkbookのアウトプットを参照 |
+append_worksheet_1:
action>: AppendWorksheet
workbook: +get_workbook_1
name: '10月'
Last modified 1yr ago