Skip to main content
從 Excel 工作簿中取得值。 當 翻譯模式 設定為 範本 時,此操作通常在 Excel 端口 的範本檔案中使用。 不過,此操作也可以用於專用指令碼場景,例如Script 端口

必需的參數

  • sheet: 工作簿中要從中檢索值的工作表。

可選的參數

  • version:目標工作簿的 Excel 版本。 允許的值為AUTO9597-20032007。 預設為 AUTO
  • file:Excel 工作簿在磁碟上的完整路徑,包括檔名。 必須指定filehandle參數。
  • handle:對excelOpen建立的Excel資料的可讀控制代碼引用。 如果指定file參數,則不需要handle
  • map:*:一組一個或多個輸入,其中對映參數的名稱位於冒號之前(例如,map:foo),值是工作表中單元格的名稱或範圍。 例如,值為C1的屬性map:foo在操作的指定輸出項上建立foo屬性,其值是在目標工作表的單元格 C1 中找到的值。 還可以指定一個單元格範圍以檢索該範圍內所有單元格的值。 例如,C1:C10 檢索單元格 C1 到 C10 的所有值。 可以使用萬用字元*來取得列長度的單元格值。 例如,C1:C*檢索從 C1 到列末尾的所有值。

輸出屬性

  • *: 取決於工作表的內容和指定的查詢。 如果存在列標題,則它們用於命名輸出屬性。 此外,如果在輸入項上設定map:*參數,則輸出項包含具有相同名稱的屬性。 有關其他上下文,請參閱範例

範例

有關其他資訊和更多範例,請參閱 Excel 端口 文件的 Excel 到 XML 部分。

取得值並對映到新物件

此範例使用 excelGet 操作從指定工作表中的單元格和列中取得特定的範圍值,並將它們對映到新專案。 稍後可以在範本中使用新專案來填充 XML 輸出檔案的特定 XML 元素,作為 Excel 端口範本模式的一部分。 有關 arc:call 中使用的 arc:map 關鍵字的詳細資訊,請參閱 arc:map

在 Script 端口中使用 excelGet

此範例使用 Script 端口 中的 excelGet 操作開啟磁碟上現有的 Excel 工作簿並從特定單元格讀取資料。 然後關閉 Excel 工作簿,指令碼將該資料作為新的輸出檔案推送。