特定管理 > 訂做企業物件 > 類型及屬性管理 > 類型及屬性管理指令行工具 > 將欄新增至類型 > 執行 AddColumns 工具
  
執行 AddColumns 工具
AddColumns 工具可從 Windchill shell 執行。
* 
在執行 AddColumns 以將本機屬性欄新增至類型之前，請先使用 AddColumns 參數執行 -r 工具，檢查是否有任何警告。請先修正這些警告，然後再繼續將本機屬性欄新增至類型。
AddColumns 工具的用法如下：
AddColumns [-a][-u][-r][-syncFromDB] type_name datatype=number {datatype=number} [directory] [-s][-f][-stringSize]
AddColumns -u [-s]
AddColumns -r type_name [directory]
AddColumns -syncFromDB
AddColumns [-a] type_name [datatype=number {datatype=number}] -stringSize
方括號 ( [ ] ) 指示選用的參數，而大括號 ( { } ) 指示可以多次指定的參數。欲查看 AddColumns 工具的詳細用法資訊，請從 Windchill shell 執行 AddColumns 指令，而不使用其他參數。
下表描述您可以使用 AddColumns 工具指定的輸入參數與引數：
參數
描述
-a
僅將其他欄新增至指定的類型類別，而不升級資料庫結構描述。也必須指定 type_name和datatype 與 number。將 Introspection (.ser) 與類別檔案 (.class) 更新為包括新欄。
* 
類型上 ObjectReference 與 VersionReference 欄的總數不得超過三十五個。
-u
升級資料庫結構描述與本機屬性欄結構描述檔案。必須在對多個類型使用 -a 參數執行指令之後使用此參數，才能啟動或重新啟動應用伺服器。除非在與 -u 參數相同的時間指定 -s 參數，否則「Windchill 升級工具」的「升級結構描述」視窗會啟動以顯示進度。在資料庫結構描述升級完成後，視窗就會消失。
升級資料庫結構描述 (使用 -u 參數執行 AddColumns 工具) 會花費較長時間。因此，-u 參數通常只會在多次使用 -a 參數執行 AddColumns 工具之後執行。
如果您超過類型上 ObjectReference 與 VersionReference 欄數的上限 (35)，或所新增之類型上的欄總數超過資料庫的最大允許值，資料庫結構描述升級會失敗。
-r
報告所指定類型的欄資訊。如需詳細資訊，請參閱AddColumns 報告及解決警告。
-syncFromDB
將本機屬性欄結構描述檔案更新為與資料庫結構描述相符，同時將 Introspection (.ser) 與類別檔案 (.class) 更新為與所有類型的資料庫結構描述相符。
type_name
要將欄新增至之模型化類別的完全合格名稱。此值會顯示在「類型及屬性管理」公用程式中類型的「內部名稱」欄中。
datatype
要新增之欄的資料類型。合法值包括：String、Long、Double、Boolean、Timestamp、ObjectReference、VersionReference 與 InlineBLOB。
number
要新增的欄數。
directory
要在其中儲存所產生類型欄 Java 檔案的目錄。此參數是選用的。若無此參數，產生的 Java 檔案會儲存在 <Windchill>\temp\src 中。
-s
在無訊息模式下執行，也就是說，不會啟動「Windchill 升級工具」的「升級結構描述」視窗。此參數只在與 -u 或 -syncFromDB 參數一起指定時才有效。
-f
即使表格欄的總數大於 255 也強制新增欄。將欄總數增加到 255 以上可能會影響效能。您無法新增比資料庫所允許數量上限更多的欄。
-stringSize
根據 com.ptc.core.lwc.string.ColumnSizes 內容的值 (有效範圍為 500-4000) 重新配置 String 資料類型欄的欄大小。如需詳細資訊，請參閱為字串本機屬性設定較大的資料庫欄大小。