ArcGIS

ArcGIS 會將您的自動化工作流程連線至 ArcGIS 組織中的資源。存取 GeoEnrichment、地理編碼和路由服務，將人口統計和位置資訊新增至您的資料。您也可以使用連接器來建立圖徵圖層，並從 ArcGIS 組織中的既有圖徵圖層擷取資料。

此連接器適用於以下產品和區域：

服務	Class	Regions
副駕駛工作室	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
邏輯應用程式	標準	所有 Logic Apps 區域，但下列區域除外： - Azure 中國區域 - 美國國防部（DoD）
Power Apps	進階	除下列區域外的所有 Power Apps 區域： - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
Power Automate（自動化服務）	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）

連絡人
名稱	Esri Power Automate 支援
URL	https://support.esri.com/en-us/contact
Email	support@esri.com

連接器中繼資料
Publisher	Esri公司
網站	https://www.esri.com/en-us/arcgis/products/arcgis-for-microsoft-365/
隱私策略	https://www.esri.com/en-us/privacy/privacy-statements/privacy-statement
類別	IT運營;商業智慧
ArcGIS for Power Automate 問題	https://community.esri.com/t5/arcgis-for-power-automate-questions/bd-p/arcgis-for-power-automate-questions
版本	2025.3.0

ArcGIS 連接器可利用 ArcGIS Online 組織內可用的基於位置的服務來增強理解、洞察並支援資料驅動的決策，從而幫助您獲得位置智慧。它提供豐富業務資料、在空間上啟用來自外部資料來源的資訊，以及從託管圖徵服務存取基於位置的詳細資料的功能。

文件資料

如需其他文件和資訊，請瀏覽 ArcGIS Connectors for Power Automate 文件。

先決條件

需要屬於 ArcGIS Online 組織的 ArcGIS 帳戶才能使用此連接器。

如何取得 ArcGIS 帳戶

如果您沒有 ArcGIS 帳戶，可以建立 ArcGIS 帳戶。公共帳戶的功能有限制。若要使用此連接器中的大部分動作，您需要組織 ArcGIS 帳戶。

如果您沒有 ArcGIS Online 組織，可以先註冊試用組織。

如果您的組織已擁有 ArcGIS Online 訂閱，請聯絡您的管理員或 IT 部門，以要求新增或邀請加入 ArcGIS Online 組織。

開始使用 ArcGIS 連接器

若要使用許多可用動作，必須為您的 ArcGIS 帳戶指派具有特定權限存取權的角色。請參閱下表中每個動作的必要權限：

行動	特權
地理豐富	地理豐富
尋找候選地址	地理編碼
對地址進行地理編碼	地理編碼
點對點佈線	網絡分析
建立圖徵圖層	發佈託管圖徵圖層

Authentication

Microsoft 和 Esri 對維護和刷新帳戶資訊都有嚴格的安全要求。若要保持登入狀態，流程應在指定的權杖逾時期間內至少執行一次。

局限性

將地理編碼地址或從圖徵圖層取得資料與大型資料集搭配使用時，需要將動作的輸入批次處理為多個個別要求。

Name |  Limit
--- | --- |
Geocode addresses   | 150 rows per request

|從圖徵圖層取得資料 |每個請求最多 1000 列|點對點佈線 |每個請求 150 站

常見錯誤

缺少令牌或登入憑證不正確。檢查您的連線和認證，然後重試。
從 www.arcgis.com 擷取資料失敗。這通常是由已過期的無效驗證權杖所造成。請重新驗證以繼續。：如果從動作收到上述任一錯誤，則表示 ArcGIS 權杖已過期。請再次登入 ArcGIS 以重設權杖。

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	250	60 秒

動作

刪除附件	從圖徵圖層中的記錄中刪除附件。
刪除附件 [已棄用]	此動作已被取代。請改用刪除附件。 ~~從圖徵圖層中的記錄（列）中刪除附件。~~
反向地理編碼	從經度（X）和緯度（Y）值擷取位置的位址。
取得問卷	擷取使用者帳戶所擁有的 Survey123 調查清單。
取得項目資訊	取得項目資訊會傳回特定組織項目的資訊。
在圖徵圖層中建立記錄	在圖徵圖層中建立新記錄（列）。
在圖徵圖層中建立記錄 [已取代]	此動作已被取代。請改用在圖徵圖層中建立記錄。 ~~此動作將新記錄新增至圖徵圖層。~~
地理編碼位址 [已淘汰]	此動作已被取代。請改用地理編碼地址。查找多個（批量）地址、地名和企業，然後在地圖上顯示該信息。此資料可以新增至現有資料集，也可以建立新資料集。此資料可用於在所有 ArcGIS for Microsoft 365 產品中建立新地圖。
地理豐富	使用 GeoEnrichment 服務，使用全球人口統計、行為和地點資料豐富您的資料。
地理豐富 [已棄用]	此動作已被取代。請改用 GeoEnrichment 。獲取有關某個位置或區域的事實。使用 GeoEnrichment 服務，您可以獲取有關特定區域或距離某個位置一定距離或行車時間內的人、地點和企業的信息。（已棄用）
執行幾何圖形計算	使用 ArcGIS Geometry Service 公用程式方法（例如面積和長度、緩衝區等）提供對複雜且常用的幾何作業的存取。
執行資料管線	執行資料管線，以自動化資料準備工作流程，並使 ArcGIS 中的圖徵圖層保持最新狀態。
將記錄新增至圖徵圖層（批次）	此動作會將多個新記錄（列）新增至現有圖徵圖層。
尋找候選位址 [已棄用]	此動作已被取代，請改用「尋找候選地址」動作。使用地理編碼服務找到單個地址。此動作會傳回比對分數最高的頂尖地址候選，以及與該位置相關的其他資訊。
尋找候選位址 [已棄用]	此動作已被取代，請改用「尋找候選地址」動作。使用地理編碼服務找到單個地址。此動作會傳回比對分數最高的頂尖地址候選，以及與該位置相關的其他資訊。
尋找候選地址	使用地理編碼服務找到單個地址。此動作會傳回比對分數最高的頂尖地址候選，以及與該位置相關的其他資訊。
對地址進行地理編碼	查找多個（批量）地址、地名和企業，然後在地圖上顯示該信息。產生的資料可以新增至新的或現有的資料集。這些資料也可用於在 ArcGIS for Microsoft 產品中建立新地圖。
建立圖徵圖層	使用現有來源（例如 SharePoint 清單）中的資料在 ArcGIS 中建立圖徵圖層。圖徵圖層是類似地理圖徵的群組，例如建築物、宗地、城市、道路和地震震中。特徵可以是點、線或多邊形（區域）。圖徵圖層最適合在底圖上視覺化資料。
建立報表	在 ArcGIS Survey123 中產生報表。
建立點幾何圖形	從經度（X）和緯度（Y）值建立點幾何物件。
從 URL 取得附件	使用附件 URL 從圖徵圖層中的記錄取得附件。
從圖像中提取 EXIF 標籤	使用可用資訊從影像中提取 EXIF 元資料和標籤。
從圖層取得資料	連接至 ArcGIS 中的圖徵圖層，以查詢資料、屬性和幾何圖形。指定欄位、比較類型和篩選值，或對複雜查詢使用進階 SQL 語法。使用其他幾何圖形或緩衝區來調整篩選器。使用輸出跨 ArcGIS for Microsoft 產品建立新的地圖或資料集。
從圖徵圖層中刪除記錄	使用輸入 ID 從圖徵圖層中刪除一或多筆記錄（列）。
從圖徵圖層取得幾何圖形 [已棄用]	從圖徵圖層取得幾何或邊界資訊，並將其匯出為 Esri JSON 或匯出至資料集中的形狀欄。此資料可用於所有 ArcGIS for Microsoft 365 產品。
從圖徵圖層取得幾何圖形 [已棄用]	從圖徵圖層取得幾何或邊界資訊，並將其匯出為 Esri JSON 或匯出至資料集中的形狀欄。此資料可用於所有 ArcGIS for Microsoft 365 產品。
從圖徵圖層取得資料 [已棄用]	此動作已被取代。請改用從圖徵圖層取得資料。 ~~連線至 ArcGIS 中的圖徵圖層，並將其資料和屬性提取至現有資料集或建立新資料集。此資料可用於在所有 ArcGIS for Microsoft 365 產品中建立新地圖。~~
從圖徵圖層擷取更新、變更或刪除	擷取對所選圖徵圖層所做的更新、變更或刪除。您必須將此動作與 ArcGIS 觸發程序結合使用，才能擷取圖徵圖層任何變更的相關資訊。
從圖徵圖層擷取更新、變更或刪除 [已棄用]	此動作已被取代。請改用從圖徵圖層擷取更新、變更或刪除。 ~~擷取對所選圖徵圖層所做的更新、變更或刪除。您必須將此動作與 ArcGIS 觸發程序結合使用，才能擷取圖徵圖層任何變更的相關資訊。~~
從特徵層取得編碼值網域	擷取一組可接受的屬性值（網域）。屬性網域定義表格或圖徵類別中屬性的允許值。將圖徵類別中的特徵或表格中的非空間資料組織成子類型時，可以為每個子類型指定特定的屬性網域。
新增附件	將附件新增至圖徵圖層中的記錄（圖徵）。
更新圖徵圖層中的記錄	更新圖徵圖層中的既有記錄（列）。
更新圖徵圖層中的記錄 [已淘汰]	此動作已被取代。請改用更新圖徵圖層中的記錄。 ~~此動作會更新圖徵圖層中的既有記錄。~~
更新圖徵圖層中的記錄（批次）	批次編輯現有圖徵圖層中符合唯一 ID 的多筆記錄（列）。
更新附件	更新圖徵圖層中記錄的附件。
查詢附件	搜尋與圖徵圖層中記錄相關聯的附件。
獲取依戀	從圖徵圖層中的記錄取得附件。
轉換日期和時間格式	在 Epoch Unix 時間戳和字串格式之間進行轉換。
點對點佈線	建立點對點路線。可以按指定順序或以最有效的路線訪問路線中的點，以最大限度地減少旅行時間。路線代表沿著道路訪問停靠點（點位置）的最快或最短路徑。
點對點路由 [已棄用]	此動作已被取代。請改用點對點路由。建立點對點路線。路線中的點可以按照您指定的順序或最小化整體行駛時間或距離的順序進行訪問。路線代表沿著道路訪問停靠點或點位置的最快或最短路徑。

刪除附件

作業識別碼：: DeleteAttachments

從圖徵圖層中的記錄中刪除附件。

參數

名稱	機碼	必要	類型	Description
圖層	contentFilter	True	string	當您使用 ArcGIS 帳戶登入時，可以搜尋組織、組織群組或公用內容中的內容。
圖層	userLayer	True	string	從 ArcGIS 內容中選取圖徵圖層
記錄識別碼	objectid	True	number	與附件相關聯之記錄的物件識別碼
附件 ID	attachmentIds	True	string	圖徵圖層中記錄中附件的 ID

傳回

名稱	路徑	類型
		array of object
物件識別碼	objectId	number
全域ID	globalId	string
成功	success	boolean

刪除附件 [已棄用]

作業識別碼：: DeleteAttachment

此動作已被取代。請改用刪除附件。

~~從圖徵圖層中的記錄（列）中刪除附件。~~

參數

名稱	機碼	必要	類型	Description
圖層	contentFilter	True	string	當您使用 ArcGIS 帳戶登入時，可以搜尋組織、組織群組或公用內容中的內容。
圖層	userLayer	True	string	從 ArcGIS 內容中選取圖徵圖層
記錄識別碼	objectid	True	number	與附件相關聯之記錄的物件識別碼
附件 ID	attachmentId	True	number	圖徵圖層中記錄中附件的 ID。

傳回

名稱	路徑	類型
		array of object
物件識別碼	objectId	number
全域ID	globalId	string
成功	success	boolean

反向地理編碼

作業識別碼：: ReverseGeocode

從經度（X）和緯度（Y）值擷取位置的位址。

參數

名稱	機碼	必要	類型	Description
地理編碼器	geocoder	True	string	選取可用的地理編碼器。
經度（X）	x	True	number	經度（X）
緯度（Y）	y	True	number	緯度（Y）
空間參考系統	srs		string	選擇空間參考系統
比賽類型	locationType		string	指定是否要將屋頂或街道入口位置用於幾何圖形輸出

傳回

名稱	路徑	類型	Description
簡短的地址	address.Address	string	位置的簡短地址
完整地址	address.LongLabel	string	該地點的完整地址
城市	address.City	string	所在城市
區域	address.Region	string	位置的區域
國家	address.CntryName	string	地點所在的國家
郵遞區號	address.Postal	string	該地點的郵遞區號
經度（X）	location.x	number	經度（X）
緯度（Y）	location.y	number	緯度（Y）

取得問卷

作業識別碼：: GetOwnedSurveyList

擷取使用者帳戶所擁有的 Survey123 調查清單。

取得項目資訊

作業識別碼：: GetPortalItemInformation

取得項目資訊會傳回特定組織項目的資訊。

參數

名稱	機碼	必要	類型	Description
搜尋項目標題	searchTerm	True	string	輸入要搜尋的值，或輸入 * 以傳回前 100 個項目。
項目	item	True	string	選取項目或使用標題來縮小搜尋。

傳回

此作業會輸出隨機的結果。

在圖徵圖層中建立記錄

作業識別碼：: CreateItemInFeatureLayerDomains

在圖徵圖層中建立新記錄（列）。

參數

名稱	機碼	必要	類型	Description
圖層	contentFilter	True	string	當您使用 ArcGIS 帳戶登入時，可以搜尋組織、組織群組或公用內容中的內容。
圖層	userLayer	True	string	從 ArcGIS 內容中選取圖徵圖層
資料	data	True	dynamic

傳回

名稱	路徑	類型	Description
建立作業成功狀態	success	boolean	建立狀態
物件識別碼	objectId	number	已建立記錄的物件識別碼
全域ID	globalId	string	已建立記錄的全域 ID

在圖徵圖層中建立記錄 [已取代]

作業識別碼：: CreateItemInFeatureLayer

此動作已被取代。請改用在圖徵圖層中建立記錄。

~~此動作將新記錄新增至圖徵圖層。~~

參數

名稱	機碼	必要	類型	Description
圖層	contentFilter	True	string	當您使用 ArcGIS 帳戶登入時，可以搜尋組織、組織群組或公用內容中的內容。
圖層	userLayer	True	string	從 ArcGIS 內容中選取圖徵圖層
資料	data	True	dynamic

傳回

名稱	路徑	類型	Description
建立作業成功狀態	success	boolean	建立狀態
物件識別碼	objectId	number	已建立記錄的物件識別碼
全域ID	globalId	string	已建立記錄的全域 ID

地理編碼位址 [已淘汰]

作業識別碼：: GeocodeAddresses

此動作已被取代。請改用地理編碼地址。

查找多個（批量）地址、地名和企業，然後在地圖上顯示該信息。此資料可以新增至現有資料集，也可以建立新資料集。此資料可用於在所有 ArcGIS for Microsoft 365 產品中建立新地圖。

參數

名稱	機碼	必要	類型	Description
Addresses	addresses	True	string	具有格式正確欄位的位址陣列

傳回

名稱	路徑	類型	Description
空間參考標識碼	spatialReference.wkid	number	知名ID
地點	locations	array of object	地理編碼位置陣列
Address	locations.address	string	完整地址
地址 ID	locations.attributes.ResultID	number	此值包含地理編碼請求的 ID。使用此值來指定要在其他動作中執行動作的項目，例如清單中的比對標識碼。
經度（X）	locations.location.x	number
緯度（Y）	locations.location.y	number

地理豐富

作業識別碼：: Geoenrich_V2

使用 GeoEnrichment 服務，使用全球人口統計、行為和地點資料豐富您的資料。

參數

名稱	機碼	必要	類型	Description
國家	country	True	string	選取國家/地區以查看可用的資料收集
數據採集	datacollection	True	string	選取資料收集
Variable	parameter	True	string	從集合中選取變數
緩衝區類型	buffertype	True	string	位置周圍的緩衝區類型
body	body	True	dynamic

傳回

名稱	路徑	類型	Description
變數的值	value	number	地理豐富變數值
變數名稱	parameterName	string	在地理豐富過程中正在分析的變數名稱。
單位	units	string	參數單位

地理豐富 [已棄用]

作業識別碼：: Geoenrich

此動作已被取代。請改用 GeoEnrichment 。

獲取有關某個位置或區域的事實。使用 GeoEnrichment 服務，您可以獲取有關特定區域或距離某個位置一定距離或行車時間內的人、地點和企業的信息。（已棄用）

參數

名稱	機碼	必要	類型	Description
學習區域	studyarea	True	string	位址或幾何圖形
國家	country	True	string	選取國家/地區以查看可用的資料收集
數據採集	datacollection	True	string	選取資料收集
Variable	parameter	True	string	從集合中選取變數
緩衝區類型	areatype		string	位置周圍的緩衝區類型
查詢	query		dynamic
空間參考系統	srs		string	選擇空間參考系統

傳回

名稱	路徑	類型	Description
變數的值	value	number	地理豐富變數值
變數名稱	parameterName	string	在地理豐富過程中正在分析的變數名稱。
單位	units	string	參數單位

執行幾何圖形計算

作業識別碼：: GeometryService

使用 ArcGIS Geometry Service 公用程式方法（例如面積和長度、緩衝區等）提供對複雜且常用的幾何作業的存取。

參數

名稱	機碼	必要	類型	Description
幾何運算	operation	True	string	選取要執行的作業
資料	data	True	dynamic

傳回

此作業會輸出隨機的結果。

執行資料管線

作業識別碼：: RunDataPipeline

執行資料管線，以自動化資料準備工作流程，並使 ArcGIS 中的圖徵圖層保持最新狀態。

參數

名稱	機碼	必要	類型	Description
資料管線	dataPipelineFilter	True	string	當您使用 ArcGIS 帳戶登入時，您可以搜尋要執行的資料管線。
資料管線	dataPipelineItem	True	string	從 ArcGIS 內容中選取資料管線
執行時間上限（分鐘）	timeoutInMinutes	True	number	資料管線在取消之前可以執行的時間上限

傳回

身體: runResult

將記錄新增至圖徵圖層（批次）

作業識別碼：: AddFeaturesBatch

此動作會將多個新記錄（列）新增至現有圖徵圖層。

參數

名稱	機碼	必要	類型	Description
圖層	contentFilter	True	string	當您使用 ArcGIS 帳戶登入時，可以搜尋組織、組織群組或公用內容中的內容。
圖層	userLayer	True	string	從 ArcGIS 內容中選取圖徵圖層
body	body	True	dynamic

傳回

身體: batchAddUpdateFeatures

尋找候選位址 [已棄用]

作業識別碼：: FindAddressCandidates

此動作已被取代，請改用「尋找候選地址」動作。使用地理編碼服務找到單個地址。此動作會傳回比對分數最高的頂尖地址候選，以及與該位置相關的其他資訊。

參數

名稱	機碼	必要	類型	Description
商店結果？	forStorage	True	boolean	指定是否要保存作業的結果。
Address	address		string	Address
區域	region		string	區域
城市	city		string	城市
郵遞區號	postal		string	郵遞區號
國家	country		string	選擇國家/地區
比賽類型	locationType		string	指定是否要將屋頂或街道入口位置用於幾何圖形輸出
空間參考系統	srs		string	選擇空間參考系統

傳回

名稱	路徑	類型	Description
完整地址	address	string	列為單行或多行結果的資料位置
國家代碼	countryCode	string	地點所在的國家/地區
城市	city	string	地點所在的城市
經度（X）	Geometry.x	number	經度（X）
緯度（Y）	Geometry.y	number	緯度（Y）
Score	score	number	比賽比分。

尋找候選位址 [已棄用]

作業識別碼：: FindAddressCandidate

參數

名稱	機碼	必要	類型	Description
商店結果？	forStorage	True	boolean	指定是否要保存作業的結果。
Address	address		string	Address
區域	region		string	區域
城市	city		string	城市
郵遞區號	postal		string	郵遞區號
國家	country		string	選擇國家/地區
比賽類型	locationType		string	指定是否要將屋頂或街道入口位置用於幾何圖形輸出
空間參考系統	srs		string	選擇空間參考系統

傳回

名稱	路徑	類型	Description
完整地址	address	string	列為單行或多行結果的資料位置
國家代碼	countryCode	string	地點所在的國家/地區
城市	city	string	地點所在的城市
經度（X）	Geometry.x	number	經度（X）
緯度（Y）	Geometry.y	number	緯度（Y）
Score	score	number	比賽比分。

尋找候選地址

作業識別碼：: FindAddressCandidatesV2

使用地理編碼服務找到單個地址。此動作會傳回比對分數最高的頂尖地址候選，以及與該位置相關的其他資訊。

參數

名稱	機碼	必要	類型	Description
地理編碼器	geocoder	True	string	選取可用的地理編碼器。
body	body	True	dynamic
比賽類型	locationType		string	指定是否要將屋頂或街道入口位置用於幾何圖形輸出
空間參考系統	srs		string	選擇空間參考系統

傳回

此作業會輸出隨機的結果。

對地址進行地理編碼

作業識別碼：: GeocodeAddressesV2

查找多個（批量）地址、地名和企業，然後在地圖上顯示該信息。產生的資料可以新增至新的或現有的資料集。這些資料也可用於在 ArcGIS for Microsoft 產品中建立新地圖。

參數

名稱	機碼	必要	類型	Description
地理編碼器	geocoder	True	string	選取可用的地理編碼器
Addresses	addresses	True	string	具有格式正確欄位的位址陣列

傳回

此作業會輸出隨機的結果。

建立圖徵圖層

作業識別碼：: CreateFeatureLayer

使用現有來源（例如 SharePoint 清單）中的資料在 ArcGIS 中建立圖徵圖層。圖徵圖層是類似地理圖徵的群組，例如建築物、宗地、城市、道路和地震震中。特徵可以是點、線或多邊形（區域）。圖徵圖層最適合在底圖上視覺化資料。

參數

名稱	機碼	必要	類型	Description
Title	layerTitle	True	string	新圖徵圖層的標題
位置類型	locationType		string	欄中的位置資訊類型
body	body	True	dynamic

傳回

名稱	路徑	類型	Description
服務項目標識碼	serviceItemId	string	服務項目標識碼
服務網址	serviceurl	string	服務網址
服務類型	type	string	建立的服務類型
位置類型	locationType	string	用來比對位置的位置類型

建立報表

作業識別碼：: FeatureReportSubmitJob

在 ArcGIS Survey123 中產生報表。

參數

名稱	機碼	必要	類型	Description
調查	surveyItemId	True	string	從 ArcGIS 內容中選取調查
圖層	featureLayerUrl	True	string	從 ArcGIS 內容中選取 Survey123 圖徵圖層
報告範本	templateItemId	True	string	選取 Survey123 報表範本
功能物件識別碼	objectIds		string	使用 ObjectID 選擇特徵;用逗號分隔多個 ObjectID
功能 WHERE 子句	where		string	輸入 WHERE 子句以篩選搜尋中的記錄
UTC 時差	utcOffset		string	為您的時區套用偏移量;例如 +02：00 或 -09：00
報表名稱	outputFileName		string	輸入報表的名稱
格式	outputFormat		string	所產生報告的檔案格式

傳回

名稱	路徑	類型	Description
jobId	jobId	string	產生功能報告的工作識別碼
工作狀態	jobStatus	string	產生功能報告的工作狀態
已提交	submitted	integer	提交工作的時間戳記（以毫秒為單位）
已完成	completed	integer	工作完成時間戳記（以毫秒為單位）
title	resultInfo.title	string	報告的名稱
總計數	resultInfo.totalCount	integer	產生的功能報告總數
succeededObjectIds	resultInfo.succeededObjectIds	array of integer	已成功新增至報表的 ObjectID
failedObjectIds	resultInfo.failedObjectIds	array of	無法新增至報表的 ObjectID
details	resultInfo.details	array of	產生報告的詳細資料
結果檔案	resultInfo.resultFiles	array of object	已完成工作的所有報告輸出
物件標識符	resultInfo.resultFiles.objectIds	array of integer	物件標識符
名稱	resultInfo.resultFiles.name	string	名稱
size	resultInfo.resultFiles.size	integer	size
狀態	resultInfo.resultFiles.status	string	狀態
url	resultInfo.resultFiles.url	string	url
物件標識符	resultInfo.resultFile.objectIds	array of integer	已成功新增至多個報告清單中第一個報告檔案的 ObjectID
名稱	resultInfo.resultFile.name	string	多個報告清單中第一個報告檔案的名稱
size	resultInfo.resultFile.size	integer	多個報告清單中第一個報告檔案的大小
狀態	resultInfo.resultFile.status	string	多個報告清單中第一個報告檔案的狀態
url	resultInfo.resultFile.url	string	多個報表清單中第一個報表檔案的 URL
jobType	inputInfo.jobType	string	為動作執行的工作類型;例如 createReport
featureLayerUrl	inputInfo.parameters.featureLayerUrl	string	與測量相關聯的圖徵圖層的 URL
物件標識符	inputInfo.parameters.queryParameters.objectIds	string	輸入要包含在報告中的物件ID
templateItemId	inputInfo.parameters.templateItemId	string	報表範本的ID
調查項目標識符	inputInfo.parameters.surveyItemId	string	在「建立報告」動作中選擇之調查的項目ID
傳送門網址	inputInfo.parameters.portalUrl	string	與問卷和報告相關聯的入口網站 URL
outputFormat	inputInfo.parameters.outputFormat	string	產生報告的格式

建立點幾何圖形

作業識別碼：: CreatePointGeometryHelper

從經度（X）和緯度（Y）值建立點幾何物件。

參數

名稱	機碼	必要	類型	Description
經度（X）	x	True	number	經度（X）
緯度（Y）	y	True	number	緯度（Y）
空間參考系統	srs		string	選擇空間參考系統

傳回

名稱	路徑	類型	Description
Geometry	geometry	object	點幾何圖形物件

從 URL 取得附件

作業識別碼：: GetAttachmentFromUrl

使用附件 URL 從圖徵圖層中的記錄取得附件。

參數

名稱	機碼	必要	類型	Description
附件網址	attachmentUrl	True	string	與圖徵圖層中記錄中的附件相關聯的 URL。

傳回

附件的內容。

附件內容: binary

從圖像中提取 EXIF 標籤

作業識別碼：: EXIF

使用可用資訊從影像中提取 EXIF 元資料和標籤。

參數

名稱	機碼	必要	類型	Description
影像	data	True	binary	來自其他動作的檔案內容，例如「取得檔案內容」（OneDrive、Share Point）

傳回

此作業會輸出隨機的結果。

從圖層取得資料

作業識別碼：: QueryFeatureLayerData

連接至 ArcGIS 中的圖徵圖層，以查詢資料、屬性和幾何圖形。指定欄位、比較類型和篩選值，或對複雜查詢使用進階 SQL 語法。使用其他幾何圖形或緩衝區來調整篩選器。使用輸出跨 ArcGIS for Microsoft 產品建立新的地圖或資料集。

參數

名稱	機碼	必要	類型	Description
圖層	contentFilter	True	string	當您使用 ArcGIS 帳戶登入時，可以搜尋組織、組織群組或公用內容中的內容。
圖層	userLayer	True	string	從 ArcGIS 內容中選取圖徵圖層
輸出格式	format	True	string	選取傳回格式類型
顯示統計資料	useStatistics		boolean	顯示統計資料欄位
資料	data	True	dynamic

傳回

此作業會輸出隨機的結果。

從圖徵圖層中刪除記錄

作業識別碼：: DeleteItemInFeatureLayer

使用輸入 ID 從圖徵圖層中刪除一或多筆記錄（列）。

參數

名稱	機碼	必要	類型	Description
圖層	contentFilter	True	string	當您使用 ArcGIS 帳戶登入時，可以搜尋組織、組織群組或公用內容中的內容。
圖層	userLayer	True	string	從 ArcGIS 內容中選取圖徵圖層
唯一識別碼欄位	idField	True	string	在圖徵圖層中選取唯一 ID 欄位
刪除記錄	deletedIds		string	用來識別已刪除項目的 ID 清單或單一值。提供的 ID 必須與圖徵圖層中使用的 ID 相符。可以新增多個 ID，並以逗號分隔。

傳回

名稱	路徑	類型	Description
		array of object
刪除狀態	success	boolean	刪除作業成功狀態
物件識別碼	objectId	number	已刪除記錄的物件識別碼
全域ID	globalId	string	已刪除記錄的全域 ID

從圖徵圖層取得幾何圖形 [已棄用]

作業識別碼：: GetFLBoundariesV1

從圖徵圖層取得幾何或邊界資訊，並將其匯出為 Esri JSON 或匯出至資料集中的形狀欄。此資料可用於所有 ArcGIS for Microsoft 365 產品。

參數

名稱	機碼	必要	類型	Description
國家	searchterm	True	string	選取國家/地區以查看可用的資料收集
圖層	layer	True	string	選取圖徵圖層
領域	field	True	string	選取欄位
搜尋參數	parameter	True	string	輸入搜尋參數
第二欄位	field2		string	選取欄位
第二個搜尋參數	parameter2		string	輸入第二個搜尋參數

傳回

名稱	路徑	類型	Description
幾何物件	data	object	幾何物件作為 JSON 字串

從圖徵圖層取得幾何圖形 [已棄用]

作業識別碼：: GetFLBoundaries

從圖徵圖層取得幾何或邊界資訊，並將其匯出為 Esri JSON 或匯出至資料集中的形狀欄。此資料可用於所有 ArcGIS for Microsoft 365 產品。

參數

名稱	機碼	必要	類型	Description
國家	searchterm	True	string	選取國家/地區以查看可用的資料收集
圖層	layer	True	string	選取圖徵圖層
領域	field	True	string	選取欄位
搜尋參數	parameter	True	string	輸入搜尋參數
第二欄位	field2		string	選取欄位
第二個搜尋參數	parameter2		string	輸入第二個搜尋參數

傳回

名稱	路徑	類型	Description
幾何物件	data	object	幾何物件作為 JSON 字串

從圖徵圖層取得資料 [已棄用]

作業識別碼：: GetFeatureLayerData

此動作已被取代。請改用從圖徵圖層取得資料。

~~連線至 ArcGIS 中的圖徵圖層，並將其資料和屬性提取至現有資料集或建立新資料集。此資料可用於在所有 ArcGIS for Microsoft 365 產品中建立新地圖。~~

參數

名稱	機碼	必要	類型	Description
圖層	contentFilter	True	string	當您使用 ArcGIS 帳戶登入時，可以搜尋組織、組織群組或公用內容中的內容。
圖層	userLayer	True	string	從 ArcGIS 內容中選取圖徵圖層
可用的欄位	field		string	從 ArcGIS 圖徵圖層中選取屬性
比較類型	comparison		string	使用比較運算子搜尋值，例如「等於」或「大於」
輸出格式	format	True	string	選取傳回格式類型
搜尋參數值	parameter		string	輸入要搜尋的值
哪裡	where		string	輸入 WHERE 子句以篩選搜尋中的記錄
返回幾何圖形	returnGeometry		boolean	返回幾何圖形
起始計數	offset		number	批次處理時，此值是查詢的起點

傳回

此作業會輸出隨機的結果。

從圖徵圖層擷取更新、變更或刪除

作業識別碼：: WebhookGetAsync

擷取對所選圖徵圖層所做的更新、變更或刪除。您必須將此動作與 ArcGIS 觸發程序結合使用，才能擷取圖徵圖層任何變更的相關資訊。

參數

名稱	機碼	必要	類型	Description
從	changesUrl	True	string	從動態內容窗格中選取變更 URL 選項。
圖層	userLayer	True	string	已變更、更新或刪除的圖徵圖層的名稱。
圖徵圖層 ID	layerId	True	number	從動態內容窗格中選取圖徵圖層 ID 選項。
資料	data	True	dynamic

傳回

此作業會輸出隨機的結果。

從圖徵圖層擷取更新、變更或刪除 [已棄用]

作業識別碼：: WebhookGet

此動作已被取代。請改用從圖徵圖層擷取更新、變更或刪除。

~~擷取對所選圖徵圖層所做的更新、變更或刪除。您必須將此動作與 ArcGIS 觸發程序結合使用，才能擷取圖徵圖層任何變更的相關資訊。~~

參數

名稱	機碼	必要	類型	Description
從	changesUrl	True	string	從動態內容窗格中選取變更 URL 選項。
圖層	userLayer	True	string	已變更、更新或刪除的圖徵圖層的名稱。
圖徵圖層 ID	layerId	True	number	從動態內容窗格中選取圖徵圖層 ID 選項。

傳回

此作業會輸出隨機的結果。

從特徵層取得編碼值網域

作業識別碼：: GetCodedDomains

擷取一組可接受的屬性值（網域）。屬性網域定義表格或圖徵類別中屬性的允許值。將圖徵類別中的特徵或表格中的非空間資料組織成子類型時，可以為每個子類型指定特定的屬性網域。

參數

名稱	機碼	必要	類型	Description
圖層	userLayer	True	string	從 ArcGIS 內容中選取圖徵圖層

傳回

此作業會輸出隨機的結果。

新增附件

作業識別碼：: AddAttachment

將附件新增至圖徵圖層中的記錄（圖徵）。

參數

名稱	機碼	必要	類型	Description
圖層	contentFilter	True	string	當您使用 ArcGIS 帳戶登入時，可以搜尋組織、組織群組或公用內容中的內容。
圖層	userLayer	True	string	從 ArcGIS 內容中選取圖徵圖層
記錄識別碼	objectId	True	number	與附件相關聯之記錄的物件識別碼
附件名稱	attachmentName	True	string	將附加的檔案名稱
檔案內容	data	True	binary	來自其他動作的檔案內容，例如「取得檔案內容」（OneDrive、Share Point）
關鍵字	keywords		string	用來識別附件的關鍵字

傳回

名稱	路徑	類型
物件識別碼	objectId	number
全域ID	globalId	string
成功	success	boolean

更新圖徵圖層中的記錄

作業識別碼：: UpdateItemInFeatureLayerDomains

更新圖徵圖層中的既有記錄（列）。

參數

名稱	機碼	必要	類型	Description
圖層	contentFilter	True	string	當您使用 ArcGIS 帳戶登入時，可以搜尋組織、組織群組或公用內容中的內容。
圖層	userLayer	True	string	從 ArcGIS 內容中選取圖徵圖層
唯一識別碼欄位	idField	True	string	在圖徵圖層中選取唯一 ID 欄位
資料	data	True	dynamic

傳回

名稱	路徑	類型	Description
更新作業成功狀態	success	boolean	更新狀態
物件識別碼	objectId	number	已更新記錄的物件識別碼
全域ID	globalId	string	已更新記錄的全域 ID

更新圖徵圖層中的記錄 [已淘汰]

作業識別碼：: UpdateItemInFeatureLayer

此動作已被取代。請改用更新圖徵圖層中的記錄。

~~此動作會更新圖徵圖層中的既有記錄。~~

參數

名稱	機碼	必要	類型	Description
圖層	contentFilter	True	string	當您使用 ArcGIS 帳戶登入時，可以搜尋組織、組織群組或公用內容中的內容。
圖層	userLayer	True	string	從 ArcGIS 內容中選取圖徵圖層
唯一識別碼欄位	idField	True	string	在圖徵圖層中選取唯一 ID 欄位
資料	data	True	dynamic

傳回

名稱	路徑	類型	Description
更新作業成功狀態	success	boolean	更新狀態
物件識別碼	objectId	number	已更新記錄的物件識別碼
全域ID	globalId	string	已更新記錄的全域 ID

更新圖徵圖層中的記錄（批次）

作業識別碼：: UpdateFeaturesBatch

批次編輯現有圖徵圖層中符合唯一 ID 的多筆記錄（列）。

參數

名稱	機碼	必要	類型	Description
圖層	contentFilter	True	string	當您使用 ArcGIS 帳戶登入時，可以搜尋組織、組織群組或公用內容中的內容。
圖層	userLayer	True	string	從 ArcGIS 內容中選取圖徵圖層
唯一識別碼欄位	idField	True	string	在圖徵圖層中選取唯一 ID 欄位
body	body	True	dynamic

傳回

身體: batchAddUpdateFeatures

更新附件

作業識別碼：: UpdateAttachment

更新圖徵圖層中記錄的附件。

參數

名稱	機碼	必要	類型	Description
圖層	contentFilter	True	string	當您使用 ArcGIS 帳戶登入時，可以搜尋組織、組織群組或公用內容中的內容。
圖層	userLayer	True	string	從 ArcGIS 內容中選取圖徵圖層
物件識別碼	objectid	True	number	與附件相關聯之記錄的物件識別碼
待更新附件	attachmentId	True	number	選取更新的附件名稱或輸入附件ID
更新的附件名稱	attachmentName	True	string	更新檔案的名稱
檔案內容	data	True	binary	來自其他動作的檔案內容，例如「取得檔案內容」（OneDrive、Share Point）

傳回

名稱	路徑	類型
物件識別碼	objectId	number
全域ID	globalId	string
成功	success	boolean

查詢附件

作業識別碼：: QueryAttachment

搜尋與圖徵圖層中記錄相關聯的附件。

參數

名稱	機碼	必要	類型	Description
圖層	contentFilter	True	string	當您使用 ArcGIS 帳戶登入時，可以搜尋組織、組織群組或公用內容中的內容。
圖層	userLayer	True	string	從 ArcGIS 內容中選取圖徵圖層
記錄識別碼	objectId	True	number	與附件相關聯之記錄的物件識別碼
關鍵字	keywords		string	用來識別附件的關鍵字

傳回

名稱	路徑	類型
		array of object
附件物件識別碼	id	number
附件全域 ID	globalId	string
附件名稱	name	string
內容類型	contentType	string
附件大小	size	number
關鍵字	keywords	string
附件網址	url	string

獲取依戀

作業識別碼：: GetAttachment

從圖徵圖層中的記錄取得附件。

參數

名稱	機碼	必要	類型	Description
圖層	contentFilter	True	string	當您使用 ArcGIS 帳戶登入時，可以搜尋組織、組織群組或公用內容中的內容。
圖層	userLayer	True	string	從 ArcGIS 內容中選取圖徵圖層
物件識別碼	objectid	True	number	與附件相關聯之記錄的物件識別碼
附件	attachmentId	True	number	選取附件名稱或輸入附件 ID

傳回

附件的內容。

附件內容: binary

轉換日期和時間格式

作業識別碼：: TimeConversionHelper

在 Epoch Unix 時間戳和字串格式之間進行轉換。

參數

名稱	機碼	必要	類型	Description
日期時間	dateTime	True	string	時間為 Unix 紀元（以秒或毫秒為單位）或以字串形式表示。

傳回

名稱	路徑	類型	Description
字串格式的日期和時間	stringTime	string	字串格式的日期和時間
日期和時間作為 Unix 時間戳記（以秒為單位）	unixTimeStampSeconds	number	日期和時間作為 Unix 時間戳記（以秒為單位）
日期和時間作為 Unix 時間戳記（以毫秒為單位）	unixTimeStampMilliseconds	number	日期和時間作為 Unix 時間戳記（以毫秒為單位）

點對點佈線

作業識別碼：: GetRouteV2

建立點對點路線。可以按指定順序或以最有效的路線訪問路線中的點，以最大限度地減少旅行時間。路線代表沿著道路訪問停靠點（點位置）的最快或最短路徑。

參數

名稱	機碼	必要	類型	Description
路由停靠點	stops	True	string	停靠點為緯度（Y）和經度（X）、圖徵或圖徵服務
出行模式	travelModeName		string	選擇旅行模式
尋找最佳路線	findBestSequence		boolean	指定服務是否應重新排序停靠點以尋找最佳化路線
保留第一站	preserveFirstStop		boolean	指出服務在重新排序停靠點時是否應保持第一個停靠點固定
回程路線	returnDirections		boolean	指定服務是否應為每條路線產生行車路線

傳回

名稱	路徑	類型	Description
方向	Directions	array of object
方向文字	Directions.text	string
名稱	Name	string	路線名稱
距離（公里）	Kilometers	number	路線距離（以公里為單位）
距離（以英里為單位）	Miles	number	路線距離（以英里為單位）
旅行時間	TravelTime	number	預計旅行時間（以分鐘為單位）
佈線幾何圖形	Geometry	object	佈線的幾何物件

點對點路由 [已棄用]

作業識別碼：: GetRoute

此動作已被取代。請改用點對點路由。

建立點對點路線。路線中的點可以按照您指定的順序或最小化整體行駛時間或距離的順序進行訪問。路線代表沿著道路訪問停靠點或點位置的最快或最短路徑。

參數

名稱	機碼	必要	類型	Description
路由停靠點	stops	True	string	停靠點為緯度（Y）和經度（X）、圖徵或圖徵服務
出行模式	travelModeName		string	選擇進行分析的交通方式
尋找最佳路線	findBestSequence		boolean	指定服務是否應重新排序停靠點以尋找最佳化路線
保留第一站	preserveFirstStop		boolean	指出服務在重新排序停靠點時是否應保持第一個停靠點固定
回程路線	returnDirections		boolean	指定服務是否應為每條路線產生行車路線

傳回

名稱	路徑	類型	Description
方向	Directions	array of object
方向文字	Directions.text	string
名稱	Name	string	路線名稱
距離（公里）	Kilometers	number	路線距離（以公里為單位）
距離（以英里為單位）	Miles	number	路線距離（以英里為單位）
旅行時間	TravelTime	number	預計旅行時間（以分鐘為單位）
佈線幾何圖形	Geometry	object	佈線的幾何物件

觸發程序

刪除附件時	此動作會在圖徵圖層中刪除附件時觸發流程。您必須將此觸發器與「從圖徵圖層擷取更新、變更或刪除」動作結合使用，才能擷取有關圖徵圖層任何變更的資訊。
在圖徵圖層中建立記錄時	此動作會在圖徵圖層中建立記錄時觸發流程。您必須將此觸發器與「從圖徵圖層擷取更新、變更或刪除」動作結合使用，才能擷取有關圖徵圖層任何變更的資訊。
在圖徵圖層中更新記錄時	此動作會在圖徵圖層中更新記錄時觸發流程。您必須將此觸發器與「從圖徵圖層擷取更新、變更或刪除」動作結合使用，才能擷取有關圖徵圖層任何變更的資訊。
建立附件時	此動作會在圖徵圖層的記錄中建立附件時觸發流程。您必須將此觸發器與「從圖徵圖層擷取更新、變更或刪除」動作結合使用，才能擷取有關圖徵圖層任何變更的資訊。
從圖徵圖層中刪除記錄時	此動作會在圖徵圖層中刪除記錄時觸發流程。您必須將此觸發器與「從圖徵圖層擷取更新、變更或刪除」動作結合使用，才能擷取有關圖徵圖層任何變更的資訊。
提交問卷回覆時	當使用者提交問卷回應時觸發新流程
更新附件時	此動作會在圖徵圖層中更新附件時觸發流程。您必須將此觸發器與「從圖徵圖層擷取更新、變更或刪除」動作結合使用，才能擷取有關圖徵圖層任何變更的資訊。

刪除附件時

作業識別碼：: WebhookAttachmentDeleted

此動作會在圖徵圖層中刪除附件時觸發流程。您必須將此觸發器與「從圖徵圖層擷取更新、變更或刪除」動作結合使用，才能擷取有關圖徵圖層任何變更的資訊。

參數

名稱	機碼	必要	類型	Description
圖層	userLayer	True	string	使用者擁有且已啟用變更追蹤的圖徵圖層。

傳回

此作業會輸出隨機的結果。

在圖徵圖層中建立記錄時

作業識別碼：: WebhookFLCreated

此動作會在圖徵圖層中建立記錄時觸發流程。您必須將此觸發器與「從圖徵圖層擷取更新、變更或刪除」動作結合使用，才能擷取有關圖徵圖層任何變更的資訊。

參數

名稱	機碼	必要	類型	Description
圖層	userLayer	True	string	使用者擁有且已啟用變更追蹤的圖徵圖層。

傳回

此作業會輸出隨機的結果。

在圖徵圖層中更新記錄時

作業識別碼：: WebhookFLEdited

此動作會在圖徵圖層中更新記錄時觸發流程。您必須將此觸發器與「從圖徵圖層擷取更新、變更或刪除」動作結合使用，才能擷取有關圖徵圖層任何變更的資訊。

參數

名稱	機碼	必要	類型	Description
圖層	userLayer	True	string	目前使用者擁有的圖徵圖層。此處列出的圖層已啟用「追蹤變更」選項。

傳回

此作業會輸出隨機的結果。

建立附件時

作業識別碼：: WebhookAttachmentCreated

此動作會在圖徵圖層的記錄中建立附件時觸發流程。您必須將此觸發器與「從圖徵圖層擷取更新、變更或刪除」動作結合使用，才能擷取有關圖徵圖層任何變更的資訊。

參數

名稱	機碼	必要	類型	Description
圖層	userLayer	True	string	使用者擁有且已啟用變更追蹤的圖徵圖層。

傳回

此作業會輸出隨機的結果。

從圖徵圖層中刪除記錄時

作業識別碼：: WebhookFLDeleted

此動作會在圖徵圖層中刪除記錄時觸發流程。您必須將此觸發器與「從圖徵圖層擷取更新、變更或刪除」動作結合使用，才能擷取有關圖徵圖層任何變更的資訊。

參數

名稱	機碼	必要	類型	Description
圖層	userLayer	True	string	目前使用者擁有的圖徵圖層。此處列出的圖層已啟用「追蹤變更」選項。

傳回

此作業會輸出隨機的結果。

提交問卷回覆時

作業識別碼：: AddData

當使用者提交問卷回應時觸發新流程

參數

名稱	機碼	必要	類型	Description
調查	surveyId	True	string	從 ArcGIS 內容中選取調查
events	events	True	array of string	events
包含入口網站資訊	includePortalInfo	True	boolean	在承載中包含入口網站資訊，例如入口網站的 URL
包含使用者資訊	includeUserInfo	True	boolean	在承載中包含使用者資訊，例如名稱和電子郵件地址
包含問卷資訊	includeSurveyInfo	True	boolean	在承載中包含調查資訊，例如調查標題和項目ID
包括提交的記錄	includeServiceRequest	True	boolean	在承載中包含記錄資訊，例如特徵的屬性和幾何圖形
包括伺服器回應	includeServiceResponse	True	boolean	在承載中包含伺服器回應

傳回

此作業會輸出隨機的結果。

更新附件時

作業識別碼：: WebhookAttachmentUpdated

此動作會在圖徵圖層中更新附件時觸發流程。您必須將此觸發器與「從圖徵圖層擷取更新、變更或刪除」動作結合使用，才能擷取有關圖徵圖層任何變更的資訊。

參數

名稱	機碼	必要	類型	Description
圖層	userLayer	True	string	使用者擁有且已啟用變更追蹤的圖徵圖層。

傳回

此作業會輸出隨機的結果。

定義

run結果

名稱	路徑	類型	Description
應用程式網址	appUrl	string	應用程式 URL 以檢視執行結果。
runId	runId	string	執行標識碼。
itemId（項目識別碼）	itemId	string	資料管線項目識別碼。
狀態	status	string	執行狀態。

batchAddUpdate功能

名稱	路徑	類型	Description
錯誤計數	errorCount	number	錯誤計數
成功很重要	successCount	number	成功計數
勝	result.success	array of object
物件識別碼	result.success.objectId	number	已建立記錄的物件識別碼
全域ID	result.success.globalId	string	已建立記錄的全域 ID
錯誤	result.error	array of object
物件識別碼	result.error.objectId	number	已建立記錄的物件識別碼
全域ID	result.error.globalId	string	已建立記錄的全域 ID

二進位

這是基本數據類型『binary』。

共用方式為

ArcGIS

文件資料

先決條件

如何取得 ArcGIS 帳戶

開始使用 ArcGIS 連接器

Authentication

局限性

常見錯誤

節流限制

動作

刪除附件

參數

傳回

刪除附件 [已棄用]

參數

傳回

反向地理編碼

參數

傳回

取得問卷

取得項目資訊

參數

傳回

在圖徵圖層中建立記錄

參數

傳回

在圖徵圖層中建立記錄 [已取代]

參數

傳回

地理編碼位址 [已淘汰]

參數

傳回

地理豐富

參數

傳回

地理豐富 [已棄用]

參數

傳回

執行幾何圖形計算

參數

傳回

執行資料管線

參數

傳回

將記錄新增至圖徵圖層 （批次）

參數

傳回

尋找候選位址 [已棄用]

參數

傳回

尋找候選位址 [已棄用]

參數

傳回

尋找候選地址

參數

傳回

對地址進行地理編碼

參數

傳回

建立圖徵圖層

參數

傳回

建立報表

參數

傳回

建立點幾何圖形

參數

傳回

從 URL 取得附件

參數

傳回

從圖像中提取 EXIF 標籤

參數

傳回

從圖層取得資料

參數

傳回

從圖徵圖層中刪除記錄

參數

將記錄新增至圖徵圖層（批次）

更新圖徵圖層中的記錄（批次）