Sheet and workbook overview
In Sheet, a workbook contains ordered sheets; each sheet tab contains cells. Its 22 registry Actions cover workbook/tab creation, File Center import, discovery, bounded reads, atomic tab/cell batches (apply_workbook_changes), individual writes, workbook lifecycle/export, and private history. create_workbook creates an initial Sheet1, and its initial name is limited to 500 characters. Sheet tab names and later workbook renames accept 1–255 characters. A dry-run never mutates.
Begin with get_workbook_summary instead of writing blindly. It returns the current integer version, ordered sheets, each usedRange, and optionally up to 20 preview rows. When workbookId is omitted, an explicit conversationId or the current conversation resolves the triggering user’s per-conversation selected workbook. If none is selected, runtime returns resource_not_found: no workbook selected for this conversation; call list_workbooks and let the user choose, or supply workbookId. With conversationId, every list item reports isSelectedForConversation.
import_workbook creates a new workbook from an authorized File Center xlsx, xls, or csv file. import_into_workbook replaces an existing workbook, requires baseVersion plus UserConfirm, and rejects stale versions. create_sheet adds a blank 100-by-26 tab, up to 50 per workbook; rename_sheet changes its name. Both require the current baseVersion, write access, and a unique non-empty name. Actions cannot insert/delete rows or columns, format, sort, filter, manage permissions, or change conversation preferences. Permanent delete_workbook requires the workbook to be archived and requires UserConfirm. Export writes to personal File Center. All Sheet Actions are private. Registry policy and runtime results override this card.
Related actions
Section titled “Related actions”arinova.sheet.create_workbook, arinova.sheet.import_workbook, arinova.sheet.import_into_workbook, arinova.sheet.apply_workbook_changes, arinova.sheet.create_sheet, arinova.sheet.rename_sheet, arinova.sheet.list_workbooks, arinova.sheet.list_sheets, arinova.sheet.get_workbook_summary, arinova.sheet.read_range, arinova.sheet.update_cells, arinova.sheet.append_rows, arinova.sheet.rename_workbook, arinova.sheet.archive_workbook, arinova.sheet.unarchive_workbook, arinova.sheet.delete_workbook, arinova.sheet.export_workbook, arinova.sheet.list_versions, arinova.sheet.get_version, arinova.sheet.create_named_version, arinova.sheet.restore_version, arinova.sheet.copy_version
Also known as
sheet, spreadsheet, workbook, worksheet, cells, table data, 試算表, 工作表, 活頁簿, 儲存格
Build a7f47a5ca54ddcf7806cd48b81ce1b9827042766