特定管理 > 確保資料安全性 > 安全性標籤與協定 > 使用 UpdateSecurityLabels 指令行公用程式 > UpdateSecurityLabels 指令行公用程式輸出檔案
  
UpdateSecurityLabels 指令行公用程式輸出檔案
當您執行 UpdateSecurityLabels 指令行公用程式之後,便會建立輸出檔案。輸出檔案會針對公用程式所處理的物件顯示物件狀況資訊。使用輸出檔案解決在執行公用程式時所發生的任何問題。解決任何問題之後,您可以重新執行公用程式以確保所有物件都已套用適當的安全性標籤。
執行工具之後,輸出檔案的位置會在 windchill shell 的摘要行中提供。輸出檔案為 TSV 檔案格式,但可以轉換為 XLS 或 XLSX 以便易於檢視。在某些情況下,例如當處理大量資料時,會建立多個輸出檔案。其他輸出檔案可在加上 "_x" 後綴的相同目錄中找到,其中 "_x" 是檔案編號。
* 
其他任何輸出檔案並沒有標題列指出欄工作分派。標題列可以從第一個輸出檔案中複製。
輸出檔案有物件識別元的欄、顯示識別、物件狀況、描述狀況的訊息,以及安全性標籤的新舊值。輸入檔案位置與含有總成功數、總失敗數等資訊的摘要行也會列出。
下表顯示了可能的物件狀況值。輸出檔案中可用的詳細資訊量可能因配置的 log4j.logger.UpdateSecurityLabelsReport 內容設定而不同。錯誤或失敗將始終顯示。
狀況
描述
修復
已略過:物件無法套用安全性標籤。
當在「物件識別元」欄中指定的物件不能套用安全性標籤時,會顯示。
只有某些物件類型可以套用安全性標籤。如需詳細資訊,請參閱顯露安全性標籤的物件類型
無法套用安全性標籤變更。從輸入檔案中移除物件。
失敗︰指定的物件識別元無效。
當輸入檔案中的「物件識別元」欄包含無效值時,會顯示。
確保輸入檔案的物件識別中沒有打字錯誤。物件識別元可以在 Windchill 中顯示。如需詳細資訊,請參閱匯出物件資訊與安全性標籤值的組態匯出含有目前安全性標籤值的物件
失敗:遺失物件識別元資訊
當輸入檔案中的「物件識別元」欄為空白時,會顯示。
1. 輸入適當的物件識別資訊。
2. 從輸入檔案中移除列。
失敗:物件不存在。
當在 Windchill 中找不到物件時,會顯示。
1. 檢查輸入檔案中的打字錯誤。
2. 從輸入檔案中移除物件。
失敗:無法為物件設定安全性標籤值,因為其位於個人資料夾或工作區中,而值會限制擁有者的存取權:<Security Label>=<Value>
當使用者已出庫指定物件時會顯示,且安全性標籤值變更會防止其入庫物件。
1. 入庫物件。
2. 將輸入檔案中的目標安全性標籤值更新為不限制使用者存取的值。
失敗:由於一或多個版本的物件位於個人資料夾或工作區中,因此無法針對這個版本的物件設定安全性標籤值,且值會限制擁有者的存取權:<Security Label>=<Value>
當符合下列條件時,會顯示:
當執行公用程式時會指定 -allVersions 參數。
使用者已出庫某一個版本的物件,且安全性標籤值變更會防止其入庫物件。
1. 入庫物件。
2. 將輸入檔案中的目標安全性標籤值更新為不限制使用者存取的值。
3. 在不使用 -allVersions 參數的情況下執行公用程式。
失敗:發生非預期的錯誤。請聯絡您的管理員。
執行公用程式時若發生錯誤,會顯示。
請準備好下列資訊並聯絡您的管理員:
公用程式的名稱。
您遇到錯誤的時間。
失敗:遇到非預期的錯誤之後,UpdateSecurityLabels 指令已失敗。
執行公用程式時若發生錯誤,會顯示。
請準備好下列資訊並聯絡您的管理員:
公用程式的名稱。
您遇到錯誤的時間。
失敗:物件的安全性標籤不可設定為目標值,因為標籤或標籤值已禁用:<Security Label>=<Value>
當在輸入檔案中指定的安全性標籤或安全性標籤值已禁用時,會顯示。
在輸入檔案中將安全性標籤值設定為有效選項。
如果安全性標籤已禁用,安全性標籤值可以設定為相同值或不受限制的 (空) 值。
如果安全性標籤值已禁用,安全性標籤值可以設定為相同的安全性標籤值、已啟用的安全性標籤值,或不受限制的 (空) 值。
檢查安全性標籤組態檔案,找到各自的 SecurityLabelValue 部份,然後分別將已啟用的屬性的值更新為 true
失敗:目標安全性標籤值無效:<Security Label>=<Value>
當在輸入檔案中指定安全性標籤值不是已配置的安全性標籤值時,會顯示。
在輸入檔案中將安全性標籤值設定為有效值。
失敗:<Security Label> 不支援多個安全性標籤值
使用者嘗試針對未配置為具有多個安全性標籤值的標準安全性標籤設定多個值時,將出現此失敗訊息。
檢查安全性標籤組態檔案,找到各自的 SecurityLabel 元素,並新增具有所需條件的 MultiValueLogicalOperator 標籤。如需詳細資訊,請參閱 SecurityLabel 元素
無變更
當指定物件的安全性標籤值設定未變更時,會顯示。
成功
當指定物件的安全性標籤值設定成功更新時,會顯示。
* 
如果您在試算表處理程式 (例如 Microsoft Excel) 中開啟輸出檔案,您可以按物件狀況排序輸出資料。