updateTagFieldValues updatetagfieldvalues

更新標籤欄位的標籤字典值。

語法

授權的使用者型別 section-0372b742b1344979b0668faacb36fcc6

  • IpsAdmin
  • IpsCompanyAdmin
  • ImagePortalAdmin

參數 section-0a3a4bab026746238c9d4009caf42e94

輸入(updateTagFieldValuesParam)

名稱
類型
必要
說明
companyHandle
xsd:string
公司控點。
fieldHandle
xsd:string
標籤欄位控制代碼。
updatearray
型別:TagValueUpdateArray

您要更新的標籤欄位值陣列。

注意:僅更新標籤字串值。 不會影響資產關聯。

輸出(updateTagFieldValuesReturn)

名稱
類型
必要
說明
successCount
xsd:int
成功更新的標籤欄位數。
warningCount
xsd:int
作業嘗試更新標籤欄位時產生的警告數目。
errororcount
xsd:int
作業嘗試更新標籤欄位時產生的錯誤數。
warningDetailArray
types:TagValueUpdateFaultArray
與資產關聯的詳細資訊陣列,在作業嘗試更新標籤欄位時產生警告。
errorDetailArray
types:TagValueUpdateFaultArray
與資產關聯的詳細資訊陣列,在操作嘗試更新標籤欄位時產生錯誤。

範例 section-bb4dcf97044c4675974c9b8d27674001

請求

<updateTagFieldValuesParam xmlns="http://www.scene7.com/IpsApi/xsd/2010-01-31">
   <companyHandle>c|3</companyHandle>
   <fieldHandle>m|3|ASSET|SingleFixedTag</fieldHandle>
   <updateArray>
      <items>
         <oldValue>Nurth</oldValue>
         <newValue>North</newValue>
      </items>
      <items>
         <oldValue>Suth</oldValue>
         <newValue>South</newValue>
      </items>
      <items>
         <oldValue>East</oldValue>
         <newValue>West</newValue>
      </items>
      <items>
         <oldValue>Banana</oldValue>
         <newValue>Pear</newValue>
      </items>
   </updateArray>
</updateTagFieldValuesParam>

回答

<updateTagFieldValuesReturn xmlns="http://www.scene7.com/IpsApi/xsd/2010-01-31">
   <successCount>2</successCount>
   <warningCount>0</warningCount>
   <errorCount>2</errorCount>
   <errorDetailArray>
      <items>
         <value>East</value>
         <code>30001</code>
         <reason>New tag value 'West' already exists.</reason>
      </items>
      <items>
         <value>Banana</value>
         <code>30001</code>
         <reason>Tag value 'Banana' not found.</reason>
      </items>
   </errorDetailArray>
</updateTagFieldValuesReturn>
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681