Next Topic

Previous Topic

Book Contents

UpdateTicket

更新工單的一個或多個欄位,僅可以更新「工單處理」>「電子郵件讀取器」頁面中列出的欄位。

更新清單欄位

在下例中,「原點」欄位是具有四個可能值的「清單」類型欄位。請求傳送欄位「原點」的名稱、表示清單中值位置的數字 (從 1 開始計數)。例如,「電話」值是清單中的第二個位置,因此傳送的值將「電話」「原點」欄位的變更為 2

Warning: 通過重新排序欄位下拉清單值的順序或在清單中輸入新的值來變更值的順序將變更由「更新工單」作業選定的值。確保使用者在對電子郵件讀取器欄位值進行變更之前瞭解此整合約束。

Word 60% / HTML 100%

關閉工單

更新工單包括通過更新具有值 3 的「狀態」欄位來關閉提交的 MonitorTicketID,3 表示「狀態」欄位下拉清單中的第三個值。範例顯示如下。其他 <TicketField> 名稱/值元素可以新增到以下範例以更新多個欄位。

<UpdateTicketRequest>
	<TicketID>1</TicketID>
	<TicketFields>
		<TicketField>
			<Name>Status</Name>
			<Value>3</Value>
		</TicketField>
	</TicketFields>
	<SessionID>13642146236194247244181221</SessionID>
</UpdateTicketRequest>

更新其他類型的欄位

可以更新以下其他類型的工單欄位:

  • 字串 - 可以包含任意文字,最多 500 個字元長。最適合用於暫停事情,例如不屬於摘要行的問題位置或其他變數。
  • 整數 - 可以獲得任意正或負整數值。
  • 數字 (nn.d) - 始終在小數點右側顯示一個數字的數字。
  • 數字 (nn.dd) - 始終在小數點右側顯示兩個數字的數字。
  • 數字 (nn.ddd) - 始終在小數點右側顯示三個數字的數字。
  • 數字 (nn.dddd) - 始終在小數點右側顯示四個數字的數字。

返回的欄位

系統將返回以下欄位的單個記錄。

Method

string

請求此回應的作業。

TransactionID

decimal

此訊息的唯一訊息 ID。

ErrorMessage

string

如果為空,則系統不會返回錯誤。

ErrorLocation

string

如果為空,則系統不會返回錯誤。

工單附件

API Web 服務無法用於獲得或更新工單檔案附件。工單檔案附件通常位於 KServer 的 C:\Kaseya\WebPages\ManagedFiles 目錄。在進行參考這些附件的 Web 服務 API 呼叫之前,API 開發人員負責將寫入代碼放入此目錄中的附件檔案中。