Search
K

ExcelOnline

OneDrive上に存在するExcelファイルの操作を行うアクション一覧です。

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もしくは ワークブックの共有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

概要

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月'