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

results matching ""

    No results matching ""