服務 Worker 參數

參數名稱

輸出類型

描述

ApplyTranslationFilter

PDF

XML 束

使用 XSL

指定當發佈已翻譯的物件時，是否應套用基準線篩選器條件。如果設定為 true，則在發佈期間將會考慮基準線中所包含的物件版本。如果設定為 false，亦即預設值，發佈時將會使用已翻譯文件的最新版本。

attachmentFilter

XML 束

使用 XSL

指定要包含在有效負載中之動態文件與 WTDocument 附件 (附屬內容) 的類別。符合規格的附件會在有效負載中發佈。

預設值衍生自前面附加 *: (指定所有類別) 的 ContentFilter 參數。

會將每個附件指派給 Windchill 中的類別。指定類別與相關檔案副檔名的語法：

([-]*|category)[:
[-]ext,
ext,...
[|...]

類別為 Windchill 中類別的名稱。使用分隔號 | 分隔多個類別篩選器

ext 為指定類別的選用檔案副檔名。多個檔案副檔名會以逗號分隔。

例如：

GRAPHICS:png,gif|
ILLUSTRATIONS:png,gif

如果類別由其自身設定，將允許使用其所有附屬內容檔案。例如：

GRAPHICS

如果 ext 規格為空，則表示不會將該類別的任何內容傳遞到有效負載。例如：

GRAPHICS:

您可以指定 * 萬用字元來包括所有類別。它可單獨使用，也可與一或多個 ext 值搭配使用。例如，下列範例允許針對所有類別使用指定副檔名。

*:png,tif,jpg

下列範例允許使用除不含檔案副檔名之檔案以外的所有附屬內容。

會將未指定的類別或副檔名視為包括在內。

category 或 ext 的整個篩選器規格開頭可使用 - 排除字元，以排除其後的所有內容。例如，下列範例會排除 GRAPHICS 類別的所有附屬內容：

-GRAPHICS

在下列每個範例中，jpg 與 tif 檔案均被排除：

-GRAPHICS:jpg,tif

GRAPHICS:-jpg,tif

下列篩選器會排除指定類別的指定副檔名。

-ILLUSTRATIONS:png,jpg,
tif|GRAPHICS:cgm,tif

- 可在規格中與萬用字元 * 組合。

例如，下列範例會排除所有附屬內容：

會針對下列每個範例中的所有類別排除 png 與 jpg 檔案：

-*:png,jpg

*:-png,jpg

萬用字元 * 規格必須放在多個特定值之後 (例如，*|GRAPHICS:jpg 允許使用所有檔案並略過其後的 GRAPHICS 規格)。

類別的範例清單位於此表格之後。

Audit.Enabled

HTML

PDF

XML 束

使用 XSL

指定發佈流程是否記錄連結至內容持有者的動態文件物件集合的相關診斷資訊。

指定 yes 或 no (預設)。

指向其他動態文件的動態文件連結不會被稽核。

Audit.IncludeChild

HTML

PDF

XML 束

使用 XSL

指定是否收集動態文件的子內容物件 (稱為子動態文件)。稽核子動態文件預設為不啟用。指定 yes 或 no (預設)。

如果您指定 yes，Audit.Enabled 也必須設定為 yes。

collectChildDocMetadata

XML 束

指定是否包含來自圖形或動態文件參考的中繼資料。

指定 yes 將包含參考中繼資料，或指定 no (預設值) 將略過中繼資料。

completeTranslationCheck

HTML

PDF

XML 束

使用 XSL

指定在找不到屬性值的翻譯時是否繼續發佈。

指定 yes 將在找不到已翻譯的屬性值時使發佈失敗，或指定 no (預設值) 將使用屬性值的來源文字繼續發佈。

contentFilter

HTML

PDF

XML 束

使用 XSL

指定要作為 AttachmentFilter 與 PrimaryFilter 的後援預設篩選器規格使用的檔案副檔名。

您可以指定以逗號分隔的檔案副檔名清單。預設值為 * 萬用字元，其允許使用所有圖形動態文件及其附件。

欲專門針對圖形動態文件重新定義此值，請參見 AttachmentFilter 與 PrimaryFilter 參數。

emitAttachments

HTML

PDF

XML 束

使用 XSL

指定是否將圖形動態文件或 Wtdocument (附屬內容) 的附件包含在有效負載中。

指定 yes 將包含附件，或指定 no (預設值) 將略過附件。

文字資訊元素會略過這個參數。

「零件清單」也會略過這個參數。依預設，「零件清單插圖」附件會包括在有效負載中。

emitRepresentations

HTML

PDF

XML 束

使用 XSL

指定是否根據 RepresentationFilter 指定的值，將表示包含在有效負載中。

指定 yes 將包含表示。預設為 no。

enableNoServiceEffectivity
Delegate

HTML

PDF

XML 束

使用 XSL

指定是否從有效負載篩選出沒有服務生失效的零件清單。

指定 yes 將篩選沒有服務生失效的零件清單。指定 no (預設值) 將包含沒有服務生失效的零件清單。

includeContentMetadata

HTML

PDF

XML 束

使用 XSL

指定是否將動態文件與零件清單中繼資料包含在已發佈至有效負載的發佈結構中。

指定 yes 將中繼資料包含在發佈結構中。指定 no (預設值) 將丟棄中繼資料。

中繼資料仍然一直包含在資訊清單中。

includeEmptyBranches

HTML

PDF

XML 束

使用 XSL

指定是否將所有沒有內容 (動態文件或零件清單) 的部分包含在服務結構有效負載中。

指定 yes 將包含沒有內容的部分。指定 no (預設值) 將丟棄空的部分。

includeMilestoneTimes
InWorkerLog

HTML

PDF

XML 束

使用 XSL

指定是否在 SIS Worker 記錄檔中包含用於發佈里程碑的事件效能資訊。指定 true 將包含里程碑效能。指定 false (預設值) 將排除它們。

每個里程碑項目都包含關聯活動完成的時間。追蹤包括壓縮發行請求的時間與持續時間、傳送它的時間與持續時間，以及傳回回應的時間與持續時間。

language

HTML

PDF

XML 束

使用 XSL

指定發佈工作的語言。定義目標翻譯的地區設定，例如 fr_FR。地區設定需要符合編寫內容中的翻譯連結以及可本地化物件的地區設定屬性。

此參數可以由在「發佈表示」對話方塊中選擇的「語言」重新定義。

language 用來：

• 跟蹤指向已翻譯內容的翻譯連結。

• 使用翻譯字典翻譯可本地化的屬性。

• 在有效負載中產生 translation.xml 檔案。

• 在發佈流程中執行語言特定的動作 (例如產生的文字翻譯)。

• 定義 XML 配套的語言

如果未指定 (預設值) 且服務結構包含多種編寫語言，則不會跟蹤任何翻譯連結，而有效負載仍然包含多種語言。

maxErrorCount

HTML

PDF

XML 束

使用 XSL

指定顯示在失敗通知中的遺失的翻譯錯誤數量。指定失敗通知中翻譯錯誤數的最大整數值。預設為 100。

maxPartReferenceDepth

HTML

PDF

XML 束

使用 XSL

指定要在有效負載內部零件清單中包括的相關零件的深度。指定要包含之相關零件深度的整數值。其深度等於或小於該值的相關零件將會包含在有效負載中。

零件清單可以透過關係間接參考零件，例如汰換零件、全域替代零件、特定替代零件或補充零件。這些間接參考的零件稱為相關零件。每個相關零件都比參考它的零件多一個深度。

零件清單直接參考的零件深度為 0。當此值設定為 0 時，有效負載中將不會包含任何相關零件。

當此參數的值為 -1 (預設值) 時，所有相關零件都會包含在有效負載中。

onBundleWithoutContexts

XML 束

指定當服務結構與產品階層或產品階層節點不關聯時的發佈行為。預設值 warning 會在 WVS 記錄檔中報告一則警告訊息，並繼續發佈工作。

指定 ignore 將發佈，但沒有訊息。

指定 error 將在 WVS 記錄檔中報告一則錯誤訊息，且發佈工作將在流程完成之後失敗。

指定 fatal 將在 WVS 記錄檔中報告一則嚴重錯誤訊息，且發佈工作將立即失敗。

onContentHolderLinkFailed

HTML

PDF

XML 束

使用 XSL

指定當內容持有者的內容不可用，或擁有多個關聯內容物件時，處理該內容持有者的方式。預設值 Latest 會套用最新的組態規格來找到關聯的內容。

指定 ignore 將略過遺失的內容並繼續。

指定 warning 將報告 WVS 記錄檔中遺失的內容、略過遺失的內容，然後繼續進行發佈工作。

指定 error 將報告 WVS 記錄檔中遺失的內容、略過遺失的內容，但在流程完成後發佈工作將失敗。

指定 fatal 將報告第一個遺失的資料物件，且發佈工作會立即失敗。

onContentWithNoPrimary

HTML

PDF

XML 束

使用 XSL

指定在內容物件遺失主要內容時是否繼續進行發佈工作。

指定 ignore 將跳過內容物件並繼續進行發佈工作。

指定 fail (預設值) 時，發佈工作將立即失敗。

onlyForeignContent

XML 束 (從發佈結構建立)

指定是否將所有參考的動態文件、圖像與零件清單包含在 XML 束中。

指定 no 將包含所有動態文件、圖像與零件清單。指定 yes (預設值) 將僅包含未從與相同產品相關聯的主要資訊結構參考的內容。

發佈至束的發佈結構會使用對其資訊結構束的參考來存取內容，且該發佈結構會單獨發佈。

此參數僅用於將發佈結構發佈至 XML 束。

onPvzMissingTranslation

HTML

PDF

XML 束

使用 XSL

當發佈資訊或發佈參考 PVZ 檔案 (連結至包含已翻譯內容的 .c3di 檔案) 的結構時，此參數會在 PVZ 檔案遺失語言特定表示所需內容時指定要採取的動作。

指定 warning 將報告 WVS 監視器中遺失的內容，但繼續進行發佈。(預設值。)

指定 fail 將報告 WVS 監視器中遺失的內容，且發佈工作會失敗。

指定 error 將繼續進行發佈，但會在 WVS 記錄檔中產生錯誤。

指定 fatal 將使發佈請求失敗並停止發佈，並在 WVS 記錄檔中產生嚴重錯誤。

onPartListItemMissing

HTML

PDF

XML 束

使用 XSL

指定是否包含具有一或多個遺失零件的零件清單。例如，零件清單可能有十個項目，但其中一個項目可能會被篩選出來。

指定 fail 將報告 WVS 監視器中遺失的零件，且發佈工作會失敗。

指定 message 將報告 WVS 監視器中遺失的零件，但繼續進行發佈。

指定 ignore 將略過 WVS 監視器中無訊息的遺失零件。

onPartListWithoutParts

HTML

PDF

XML 束

使用 XSL

指定是否發佈沒有零件的零件清單，例如套用篩選器時。

指定 Ignore 將繼續發佈空的零件清單，且不產生任何訊息。

指定 Warning (預設值) 將繼續進行發佈，但會為每個空的零件清單產生警告。

指定 Error 將繼續進行發佈，但會在 WVS 記錄檔中產生錯誤。

指定 Fatal 將使發佈請求失敗並停止發佈，並在 WVS 記錄檔中產生嚴重錯誤。

partListImageSource

XML 束

指定如何處理零件清單中包含附件的圖形動態文件。

指定 postPublishOnly 將僅包含連結至圖形的後發佈內容。如果沒有後發佈內容存在，此參數將不會包含任何圖形。

指定 originalOnly 將僅包含原始圖形。

指定 preferPostPublish (預設值) 將使用後發佈內容 (如果有的話)。否則，將會包含原始圖形。

中繼資料將永遠來自原始圖形，即使僅包含後發佈內容，也是如此。

圖形動態文件內容仍然可以使用 primaryFilter、attachmentFilter 與 representationFilter 參數進行篩選。

partListVersion1.5

HTML

PDF

XML 束

使用 XSL

指定發佈零件清單所使用的版本格式︰1.5 或 2.0 或更高版本格式。指定 yes 將使用版本 1.5。指定 false (預設值) 將使用 2.0 或更高版本。

在版本 1.5 中，有效負載中沒有相關的零件資訊，且參考的零件資訊會內嵌在每個零件清單項目中。

在更高的版本中，相關零件資訊 (汰換、全域替代、特定替代或補充取代) 將包含在有效負載中。

PartResources

XML 束

使用 XSL

指定將包括在有效負載內 partThumbnails.zip 中之零件表示的類型。您可以指定圖形縮圖的角色，以及特殊值 PVZ。多個參數值由逗號分隔。

預設值為 THUMBNAIL,THUMBNAIL_SMALL,PVZ。

指定 THUMBNAIL 將選擇縮圖。

指定 THUMBNAIL_SMALL 將選擇小縮圖。

指定 THUMBNAIL3D 將選擇 3D 縮圖。

指定 PVZ 將選擇包含預設表示的 PVZ。

指定 NONE 將排除所有縮圖與 PVZ 檔案。

例如：

THUMBNAIL,THUMBNAIL3D,PVZ

雖然 PVZ 不是一個角色，但它是清單中所允許的特殊值。若指定 PVZ，則 PVZ 檔案的內容由 PvzFilter 參數指定。

要包括在 partThumbnails.zip 中的檔案也可由 thumbnailRole 參數指定。

如需有關 partThumbnails.zip 以及如何處理縮圖參數的詳細資訊，請參閱有效負載與資訊清單

如需有關 partThumbnails.zip 以及如何處理縮圖參數的詳細資訊，請參閱Customizing Windchill Service Information Manager and Windchill Service Parts (自訂 Windchill Service Information Manager and Windchill Service Parts)中的有效負載與資訊清單。

preferAdapter

XML 束

指定是否使用 Arbortext PE 伺服器上的 PTC 伺服器連線轉接器擷取結構的內容。

指定 yes 將在 Arbortext PE 伺服器上使用轉接器。指定 no (預設值) 會將有效負載中結構的內容從 Windchill 傳送至 Arbortext PE 伺服器。預設為 no。

在任一種情況下，都可能會傳送有效負載中的某些內容，並會使用轉接器擷取某些內容。

primaryFilter

XML 束

為圖形動態文件的主要內容指定篩選器，以決定是否將其包括在有效負載中。會將符合規格的圖形發行到有效負載。

您可以指定以逗號分隔的檔案副檔名清單。預設值衍生自 ContentFilter 參數。

* 萬用字元允許所有主要內容。

您可以隱抑主要圖形內容，但仍允許使用有效負載中的關聯表示與附件。

PvzFilter

XML 束

使用 XSL

指定將包括在零件的 PVZ 檔案中的檔案類型。PVZ 會包括在有效負載內的 partThumbnails.zip 檔案中。若 PartResources 參數值包括 PVZ，則會套用此參數。您可以指定 PVZ 支援的圖形檔案類型，或針對 PVZ 中的內容指定的角色。多個參數值由逗號分隔。

+|- extension or role,
extension or role,...

+ 為選用，因為假設值依預設是包含項目。使用 - 將僅指定排除項目。

例如：

png,jpg 會包括 PVZ 中的所有 PNG 與 JPG 檔案。

pvs,ol 會包括 PVZ 中的所有 PVS 與 OL 檔案。

-png,THUMBNAIL3D 會排除所有 PNG 檔案及所有 3D 縮圖。

如需有關 partThumbnails.zip 以及如何處理縮圖參數的詳細資訊，請參閱有效負載與資訊清單

representationFilter

HTML

PDF

XML 束

使用 XSL

指定要包括在有效負載中的表示類型。指定主要類型及其相關附件檔案副檔名。符合規格的表示會包含在有效負載中。

使用下列格式指定：

[-][*|primary,
primary,...]:
[-]extension,
extension,...[|...]

多個主要類型由逗號分隔。會在關聯表示副檔名的清單之後加上冒號。使用分隔號分隔多個規格。

例如，規格 c3di:jpg,gif 會將主要 c3di 表示與附件類型 jpg 或 gif 相匹配。空白副檔名清單不會匹配任何表示。

在另一個範例中，篩選器會指定主要表示類型 c3di 與 tiff。要包含的表示附件類型必須在冒號後指定。

c3di:png,jpg,gif|
tiff:imap

您可以使用萬用字元 *，但同時必須遵循更多其他具體規格。下列範例包含所有主要類型的指定附件類型：

*:png,tiff,jpg

- 可排除主要類型的所有表示。例如：

-pvz

篩選器規格開頭可以使用 - 排除字元來排除指定的類型。在下列範例中，只會針對 png 或 jpg 主要表示類型排除 pvz 表示。其他所有內容都會允許使用。

-png,jpg:pvz

- 也可以排除主要類型的指定檔案副檔名。例如，下列範例僅會排除 pvz 附件或是 png 或 jpg：

png,jpg: -pvz

您可以透過指定主要類型的空字串來篩選沒有主要類型的物件。例如，您可以使用 :png 指定 png 表示。

savedFilter

HTML

PDF

XML 束

使用 XSL

指定要在將結構序列化為有效負載時套用的選項與變體篩選器名稱。指定先前儲存之篩選器的名稱。

structuresUseAuthored
Language

HTML

PDF

XML 束

使用 XSL

指定要在結構加工品中使用編寫的語言還是目標語言。

指定 false 將針對物件屬性使用目標語言翻譯 (如果可用)。

指定 true 將針對物件屬性使用編寫語言值。

預設值是

• true (對於束輸出與使用 XSL 時)。

• false (用於 PDF)。

thumbnailRole

HTML

PDF

XML 束

使用 XSL

指定將包括在有效負載內 partThumbnails.zip 中之零件表示的類型。指定在發佈時要包括之圖形縮圖的角色。預設值為空字串。

指定 THUMBNAIL 將選擇縮圖角色。

指定 THUMBNAIL_SMALL 將選擇小縮圖角色。

指定 PVZ 將選擇包含預設表示的 PVZ。

要包括在 partThumbnails.zip 中的檔案也可由 PartResources 參數指定。

如需有關 partThumbnails.zip 以及如何處理縮圖參數的詳細資訊，請參閱有效負載與資訊清單

useApexExpression

HTML

PDF

XML 束

使用 XSL

指定有效負載中的運算式是否為 APEX 格式。

設定為 yes 可指定運算式使用 APEX 格式，設定為 no (預設值) 可指定運算式使用 ATO 格式。

usePseudoTranslation

HTML

PDF

XML 束

使用 XSL

指定是否以翻譯的特殊格式發佈可本地化屬性的來源內容。

指定 yes 將使用來源內容。指定 no (預設值) 將使用翻譯。

設定為 yes 時，適用以下狀況：

• 如果屬性可本地化，但不存在已翻譯的值，則將由 [source-value] 表示屬性值的翻譯結果。

• 如果屬性可本地化且存在已翻譯的值，則將由 [[source-value]] 表示已翻譯的屬性值。

參數名稱

輸出

描述

可覆寫(支援在增量發佈期間變更值)

applicabilitySyntax

PDF

XML 束

使用 XSL

指定有效負載中適用性運算式使用之適用性語法的名稱。指定在 Arbortext PE 伺服器上註冊的名稱。沒有預設值。

如需有關適用性的詳細資訊，請參閱發佈中的文字間適用性。

否

artifactDirectory

HTML

PDF

XML 束

使用 XSL

指定儲存發佈期間建立之有效負載加工品的壓縮複本所在目錄以進行疑難排解。

目錄必須是 Arbortext PE 伺服器上的有效、可寫入目錄。

是

disableInlineApplic
Filtering

PDF

使用 XSL

指定是否為 PDF 與使用 XSL 輸出啟用依據文字間運算式的篩選。指定 true (預設值) 可禁用文字間適用性，而指定 false 可將其啟用。

否

disableStructure
ApplicabilityConverter

HTML

PDF

XML 束

使用 XSL

指定是否轉換在結構及輔助集合檔案中找到的適用性運算式。

針對束輸出，預設值為 false。在此情況下，轉換由 structureSourceApplicSyntaxstructureTargetApplicSyntax 控制

針對 PDF 發佈，此參數預設為 true。

否

htmlLogVerbosityLevel

HTML

PDF

XML 束

使用 XSL

指定包含在已傳回至 WVS 之 HTML 版事件記錄中的訊息層級。訊息。指定層級及更高層級的訊息會包含在記錄檔中。值為 info、warning、error 或 fatal。如果此參數未指定或有無效值，則預設為 warning。

所有訊息會始終包含在 XML 版且已傳回至 WVS 的記錄中。

是

includeMilestoneTimes
InHtmlLog

HTML

PDF

XML 束

使用 XSL

指定是否在傳回至 WVS 的 HTML 版事件記錄中包括用於發行里程碑活動的事件時間資訊。每個里程碑項目都包含活動完成的時間。

此記錄檔也可從 Arbortext PE 伺服器的「交易封存」中找到。里程碑活動的清單位於此表格之後。

是

reportMore
Applicability
ParseErrors

PDF

使用 XSL

指定是否要在失敗之前報告文字間適用性的其他適用性運算式問題。預設值 false 會導致發佈在發現第一個有問題的運算式之後立即失敗。設定為 true 可在發佈工作失敗之前，收集盡可能多的適用性運算式問題。

否

resultBaseName

HTML

PDF

XML 束

使用 XSL

指定定義表示之基礎檔案名稱的字串。字串可能包含稱為 key 的一或多個字串替代模式，會在發行及取代為替代值期間對其進行評估。金鑰可以表示 WVS 替代金鑰、服務 Worker 參數與所發行之服務結構根的屬性。

依預設，會使用根物件 ID 做為 PDF 與 XSL 輸出的基礎名稱束的 pubstructXsl 樣式表名稱。

使用 {key} 格式指定金鑰，其中 key 是 WVS 替代金鑰、服務 Worker 參數 (開頭為 com.ptc.arbortext)，或服務結構屬性根的屬性名稱 (例如名稱、編號或狀態)。參數值範例：

{name}_myrep_
{EPM_NUMBER}_{state}

您可以為 {key} 提供的 WVS 替代金鑰有：

• EPM_NAME - 所發行的文件名稱。

• EPM_NUMBER - 所發行的文件編號。

• EPM_TYPE - 文件的子類型。

• AUTHORING_APP - 文件的編寫應用程式。

• OUTPUT_TYPE - 要產生的輸出類型。

• PARAM_SET_NAME - 所發行之發行規則中 param-set 的名稱。

如果 {key} 是未在發行規則 (或 pubspec.xml) 中定義的 Worker 參數名稱，則會使用該參數的預設值。

此參數不會定義輸出檔案的檔案副檔名。此外，如果表示包含 PDF，不會影響表示內的 PDF。

如果 {key} 是所發行之根零件的屬性，則屬性必須在 manifest_attset.xml 中配置，才能顯示在有效負載的 manifest.xml 檔案中。

如需詳細資訊，請參閱定義屬性集。

是

rootApplicability
Expression

PDF

使用 XSL

指定要在發佈期間套用至服務結構與內容的適用性運算式。運算式語法必須符合結構與 XML 文字內容中的語法。

發佈會將篩選器套用至發佈結構及其動態文件。您可以針對服務結構，使用工具列中的「篩選器」動作集建立篩選器，並儲存它以使其可供未來的發佈工作使用。但是，rootApplicabilityExpression 發佈規則參數會覆寫篩選器。

若未指定此值，會從使用者使用「篩選器」動作集設定的篩選器衍生值。

XSL 轉換樣式表必須包含適用性運算式，才能將其複製到 DITA 圖中。

如需有關適用性的詳細資訊，請參閱發佈中的適用性。

服務應用程式資訊位於Customizing Windchill Service Information Manager and Windchill Service Parts (自訂 Windchill Service Information Manager and Windchill Service Parts)中。

否

structureSource
ApplicSyntax

HTML

PDF

XML 束

使用 XSL

指定用於服務結構、零件清單及其他已收集檔案中適用性運算式之來源適用性語法的名稱。指定在 Arbortext PE 伺服器上註冊的名稱。如未指定，則會使用 applicabilitySyntax 的值。如未指定 applicabilitySyntax，則預設值為 ATO。

如需有關適用性的詳細資訊，請參閱發佈中的適用性。

否

structureTarget
ApplicSyntax

HTML

PDF

XML 束

使用 XSL

指定要在發佈期間套用於服務結構、零件清單及其他已收集檔案中適用性運算式之目標適用性語法的名稱。指定在 Arbortext PE 伺服器上註冊的名稱。如未指定，則會使用 applicabilitySyntax 的值。如果未指定 applicabilitySyntax，則針對束輸出，預設值為 APEX，而針對其他輸出類型，預設值則為 ATO。

如需有關適用性的詳細資訊，請參閱發佈中的文字間適用性。

否

stylesheet

HTML

PDF

XML 束

使用 XSL

指定用於設定輸出樣式之束或出版品的樣式表。您可以使用絕對路徑或名稱指定樣式表。

系統會使用 Arbortext PE 伺服器上文件類型的 catalog 路徑解析名稱，且該名稱會符合所要發佈之主題的文件類型。

如需有關文件類型與樣式表的資訊，請參閱 Arbortext Editor and Publishing Engine 文件集。

如果主題擁有樣式表關聯處理指示，會將其略過。

否

useRestricted
TransactionArchive

PDF

XML 束

使用 XSL

指定是否使用交易封存的替代位置。指定 1 將使用替代交易封存。

替代交易封存可用於將包含敏感資訊的交易儲存在僅具有權限的使用者可以存取的位置。交易封存會在 Arbortext Publishing Engine 伺服器上配置。請參閱Configuring Servigistics Arbortext Publishing Engine (配置 Servigistics Arbortext Publishing Engine)中的 Arbortext PE 伺服器文件。

是

usingxsl.destination

使用 XSL

指定放置 XSL 發行之輸出的位置。指定可從 Arbortext Publishing Engine 存取之可寫入資料夾的絕對路徑。如果資料夾與現有目錄衝突，會將其覆寫。

是

usingxsl.stylesheet

使用 XSL

指定要在發佈 XSL 期間使用的 .xsl 樣式表。此樣式表會預期文件類型符合 pubstructXsl 轉換之輸出的來源文件或「要套用樣式的經解析文件」(RDS)。

輸出會放置在由 usingxsl.destination 指定的位置。只會將 composer 記錄與具有發行工作相關資訊的資訊清單傳回到 Windchill。

欲自訂 XSL 輸出，請將發行規則用於發行子系統。例如，欲防止 href 屬性變更為本機路徑 (從 WC URI 路徑)，請新增下列發行規則：

com.ptc.arbortext.
pe.publish
/dontModifyHref=yes

Arbortext Editor and Publishing Engine 支援 XSL 輸出功能。

否

variable:compose::
debug

HTML

PDF

XML 束

使用 XSL

指定 1、true 或 on 可增加發行請求期間記錄到 composer 記錄的資訊數。

依預設，會將錯誤與警告資訊訊息放在 composer 事件記錄中。

此外，您可以在 Arbortext Publishing Engine 上啟動 atitrace.exe，並且它可對傳送至該視窗的輸出進行偵錯，進而捕捉低層級追蹤資訊。此動作會由 Arbortext Publishing Engine 管理員執行。

是

variable:_sis::
archiveTransaction

HTML

PDF

XML 束

使用 XSL

指定是否使用交易封存在 Arbortext PE 伺服器上儲存發佈加工品。指定 1 將封存交易。預設的 0 不會封存交易，但 Arbortext PE 伺服器的組態可能還是會封存它。

是

里程碑	活動
有效負載解壓縮完成	將有效負載解壓縮到 Arbortext PE 伺服器上的暫時目錄中的時間。
預先服務子系統處理完成	處理組態檔案 pubspec.xml 中的值、決定轉接器設定及其他預先處理活動。
服務子系統完成	配管組態檔案 Service.ccf 已執行，且發行結構及其內容已轉換。
發行子系統完成	發行子系統已執行。活動由正在執行的發行類型決定。
包子系統完成	如果正在發佈束，則包含在內。轉換時間以產生剩餘束內容、將其封裝，並將其置於目的地位置。

參數名稱

輸出

描述

可覆寫(支援在增量發佈期間變更值)

altDestination

XML 束

指定 Arbortext Publishing Engine 放置束的替代目錄。此位置與 Windchill 伺服器作業系統相容，並會指定為裝載點、UNC 路徑，或由裝載的磁碟機代號指定。例如：

/local/mnt/bundles

是

boilerplate

XML 束

為配套指定將解壓縮至 destination 目錄之固定版型 zip 檔案的名稱。

固定版型檔案的路徑透過在 Arbortext PE 伺服器中搜尋 set libpath 規格來決定。您必須有對檔案的讀取權限，並將其命名為與此參數值相同的名稱。預設為 boilerplate.zip。

否

bundleName

XML 束

指定將放置所產生之束的束子目錄的名稱。名稱後面會附加 _timestamp。預設值為 bundle。

束子目錄會放在 destination 參數所指定的目錄中。

束名稱字元可以是數字、字母及某些特殊字元，如 . (句號)、- (破折號) 與 _ (底線)。不支援的字元 (例如 \ / : * ? " < > |) 會使用適當的 %xx HEX 值逸出。

不支援左右單引號與雙引號，而且將會使用 %xx HEX 值逸出。

是

destination

XML 束

指定 Arbortext Publishing Engine 放置束輸出的目錄。此位置位於指定為實體或對應磁碟機的 Arbortext PE 伺服器。目錄必須事先建立。沒有預設值。

指定 bundleName 將建立束的這個目錄的子目錄。

是

DMPmapSchema

XML 束

指定您要用於驗證之結構描述的路徑 (相對或絕對)。預設值會相對於 DMPmap\DMPmap.xsd 假設路徑。

指定相對路徑時將會使用包含指定結構描述檔案的 Arbortext Publishing Enginedoctypes 搜尋路徑下的第一個位置。

如果找不到結構描述，Arbortext Publishing Engine composer 事件記錄會捕捉錯誤訊息，且指定的 DMPmapSchema 參數值會顯示在訊息中。

否

saveCopy

XML 束

指定是否將束檔案儲存在 zip 檔案中，以進行疑難排解。指定 true 以啟用。預設為 false。

使用 artifactDirectory 參數指定目錄。束檔案名稱將從 saveCopyName 的值進行建構。

是

saveCopyName

XML 束

指定束檔案的基礎檔案名稱。基礎名稱後面會附加 _timestamp.zip。

預設值為 bundle_saveCopy。

會將檔案放在由 artifactDirectory 參數指定的目錄中。

基礎名稱字元可以是數字、字母及某些特殊字元，如 . (句號)、- (破折號) 與 _ (底線)。其他字元 (例如 Windows 檔案名稱中不支援的字元 (\ / : * ? " < > |)) 會取代為適當的 % hex 值。

不支援左右單引號與雙引號。

是

validate

XML 束

指定是否根據由 DMPmapSchema 參數所指定的結構描述驗證 DMPmap.xml。DMPmap.xml 是由束發佈請求所產生的檔案。

指定 yes 可驗證。預設為 no。

若設定為 yes，如果無法驗證輸出，則發行會失敗。

預設 DMPmap.xsl 樣式表所產生的 DMPmap.xml 不會對預設 DMPmap\DMPmap.xsd 進行驗證。

Arbortext Publishing Engine composer 事件記錄會捕捉錯誤訊息，並且包含用於驗證之結構描述的絕對路徑

如果通過驗證，「資訊」訊息會顯示在事件記錄中，確認驗證已通過，且包含結構描述的絕對路徑。

否

參數名稱

輸出

描述

可覆寫(支援在增量發佈期間變更值)

contentMetadaTokens

HTML

PDF

XML 束

使用 XSL

指定要從資訊清單複製到發佈結構標示的中繼資料標記值。指定以逗號分隔的中繼資料標記值清單。萬用字元 * (預設值) 表示全部包含。空值或 - 表示不提供任何值。此參數僅支援版本 2.0 或更高版本的發佈結構。

否

disableStructureTitleAndDescriptionCreator

PDF

指定服務應用程式是否還原發佈結構的 Title 與 Description 元素。若設定為 false，服務應用程式會將 Title 與 Description 元素 (若這些元素不存在) 插入發佈結構。若設定為 true (預設值)，不會進行任何變更。

否

graphicTransform

HTML

PDF

XML 束

使用 XSL

指定套用至從動態文件和零件清單參考之圖形的圖形轉換。每個轉換規則都會採用下列格式：

graphic-type,
graphic-type,...
:target-type,
target-type,...
[|...]

其中，graphic-type 與 target-type 是圖形檔案副檔名。

使用分隔號 | 分隔多個規格。

預設值為：

tif,drw,eps,svg:png,-

每個 graphic-type 都會轉換為每個 target-type。

針對 graphic-type，* 萬用字元符合所有檔案格式，而 + 符號符合適合網頁的格式。

如果您不想轉換圖形檔案，請針對 target-type 指定 - 排除字元。

在下列範例中，會將所有適合網頁的格式簡單地複製到有效負載，然後將剩餘所有圖形格式轉換為 JPG 格式。

+:-|*:jpg

如果沒有適用於圖形類型的轉換規則，則其不會轉換。會按順序處理轉換，因此必須在其他規格之後使用萬用字元。例如，在 *:-|tif:jpg 中，萬用字元會取代第二個轉換規則中的圖形類型，並使整個規格與 *:- 對等。在此情況下，會複製所有圖形且不會執行任何轉換。

Service 應用程式 pubspec.xml 檔案會套用預設值。

如需有關圖形格式的資訊，請參閱圖形檔案格式與媒體物件和圖形轉換支援。

您可以指定如何使用一組 transformImage 參數處理束中的零件清單圖形轉換。

是

Outputclass

HTML

PDF

XML 束

使用 XSL

將 outputclass 屬性的值指定為輸出 DITA 圖中的根節點。該值由 XSL 轉換樣式表使用。

否

partlistBundleCcfParam.
convertAttachments

XML 束

指定是否必須轉換零件清單圖形附件。設定為 true (預設值) 可轉換零件清單圖形附件。設定為 false 可使用其原生格式保留零件清單圖像附件。

圖形轉換使用 graphicTransform 參數做為預設值。

是

partlistBundleCcfParam.
partMetadataTokens

XML 束

指定要從參考零件檔案複製到零件清單標示的零件中繼資料標記值。指定以逗號分隔的中繼資料標記值清單。預設值為 number,orgName,servicekit,name。

萬用字元 * 表示全部包含。空值或 - 表示不提供任何值。此參數僅支援 2.0 或更高版本的零件清單。

所有可用零件中繼資料標記值的清單︰name,number,orgName,ServiceEffectivity,LogicalExpression,beginSerialNumberRange,endSerialNumberRange,beginDateRange,endDateRange,effTarget,effContextReference。

是

partlistBundleCcfParam.
sbomMetadataTokens

XML 束

指定要從參考零件檔案複製到零件清單標示的 SBOM 中繼資料標記值。指定以逗號分隔的中繼資料標記值清單。預設值為 number,orgName,servicekit,name。

萬用字元 * 表示全部包含。空值或 - 表示不提供任何值。此參數僅支援 2.0 或更高版本的零件清單。

所有可用 SBOM 中繼資料標記值的清單︰name,number,orgName,servicekit,ServiceEffectivity,LogicalExpression,beginSerialNumberRange,endSerialNumberRange,beginDateRange,endDateRange,effTarget,effContextReference。

是

partlistBundleCcfParam.
transformImage

XML 束

指定是否必須轉換零件清單圖像。若設定為 true，則可根據 transformImageTypes 的值轉換零件清單圖形。設定為 false (預設值) 可改用 graphicTransform 所指定的值。

此參數不會影響在動態文件中參考的圖形，其使用 graphicTransform 參數。

是

partlistBundleCcfParam.
transformImageTypes

XML 束

指定零件清單中要從原始來源轉換之主要圖像類型，以及每個主要類型的關聯附件類型。預設值為 *，其表示會處理每個 IMAGE 元素，並可將其轉換為一或多個其他 IMAGE 元素。

指定主要檔案副檔名或 *，後跟選用冒號 : 及以逗號分隔的附件檔案副檔名清單。多個規格將使用分隔號 | 進行分隔。

語法如下所示：

primary_ext:
attach_ext
[|primary_ext:
attach_ext]

primary_ext 可以是 * 或以逗號分隔的一或多個檔案副檔名。

attach_ext 是以逗號分隔的一或多個檔案副檔名。

例如：

png,tif:imap|cgm|ldf

如果指定的主要類型符合多個來源類型，則會將找到的第一個類型當做主要類型使用，並會略過剩餘的類型。例如，如果您只想要一個點陣格式，而相對於 tif 更喜歡 png，並且還想在可能的情況下包括 imap 附件，則請指定 png,tif:imap。

其他範例：

png:imap|*

jpg:tif|png|gif|eps|
svg|tif|bmp

此參數不會影響從動態文件參考的圖形，其使用 graphicTransform 參數。

您必須指定支援的圖形轉換格式。如需有關圖形格式的資訊，請參閱圖形檔案格式與媒體物件和圖形轉換支援。

是

partlistBundleCcfParam.
transformImage
AllowedConversions

XML 束

針對零件清單圖像，指定允許的輸出圖形格式的清單及其關聯來源格式。依照如下所示進行指定：

output1:
source1,source2

多個規格使用分隔號 | 分隔。

例如：

png:tif,cgm|
jpg:tif,pvz

圖形轉換會以指定來源格式的順序執行。指定輸出格式會以列出輸出格式的順序從來源轉換。

例如，如果指定 png:tif,cgm，會先從 TIFF 來源圖形產生 PNG 圖形，然後再產生 CGM 圖形。如果不存在 TIFF 或 CGM 來源圖形，則不會產生任何 PNG 圖形。

如果未設定此參數，預設行為是將圖形轉換為所有支援的輸出。

如需有關圖形格式的資訊，請參閱圖形檔案格式與媒體物件和圖形轉換支援。

是

partlistBundleCcfParam.
transformImage
DisableConversions

XML 束

指定是否禁用零件清單圖像轉換。若設定為 true，會禁用零件清單圖形轉換。只有在它們是主要或附屬內容的情況下，才會包含圖形。

如果設定為 false (預設值)，則允許轉換圖形。轉換將使用 transformImageAllowedConversions 參數的規格。

是

partlistStylesheet

HTML

PDF

XML 束

使用 XSL

指定 XSL 樣式表，Arbortext Publishing Engine 將會使用該 XSL 樣式表將泛用 XML 格式的零件清單轉換為與 com.ptc.arbortext.pe/stylesheet 的文件類型相容的文件類型。

您可以在 Arbortext PE 伺服器上指定樣式表的名稱或絕對路徑。系統會使用 Arbortext PE 伺服器上文件類型目錄的 catalog 路徑解析名稱。依預設，它會尋找服務應用程式 partlist 文件類型。

否

pubstructXsl

HTML

PDF

XML 束

使用 XSL

指定 XSL 樣式表，Arbortext Publishing Engine 將會使用該 XSL 樣式表將泛用 XML 格式的服務結構轉換為與 com.ptc.arbortext.pe/stylesheet 的文件類型相容的文件類型。

您可以在 Arbortext PE 伺服器上指定樣式表的名稱或絕對路徑。系統會使用 Arbortext PE 伺服器上文件類型目錄的 catalog 路徑解析名稱。依預設，它會尋找服務應用程式 pubstruct 文件類型。

針對 PDF 或使用 XSL，此樣式表應該將發佈結構轉換為可以發佈的文件類型。針對束輸出，此樣式表應該將服務結構轉換為 InService (DMPmap) 所預期的格式。

否

suppressPipeline
InfoMessages

HTML

PDF

XML 束

使用 XSL

指定是否記錄服務配管中「資訊」與以下層級 (例如「追蹤」或「偵錯」) 的訊息。嚴重、錯誤以及警告訊息仍然包含在內。

指定 true (預設值) 將不記錄詳細資訊配管訊息。指定 false 將允許記錄詳細資訊配管訊息。

指定 false 會對效能產生重大影響。僅針對疑難排解用途使用它，必要時，建立較小的測試案例。

當 compose::verbose 變數設定為任何值時，會略過此參數。

是

topicCCfParam.
disableApplicability
Converter

XML 束

指定是否在主題中尋找與轉換適用性運算式。指定 false (預設值) 將啟用適用性轉換。指定 true 將禁用適用性轉換。

使用 topicCcfParam.SourceApplicabilitySyntax 和 topicCcfParam.TargetApplicabilitySyntax 定義運算式。

否

topicCCfParam.
sourceApplicability
Syntax

XML 束

指定束主題中適用性運算式使用之適用性語法的名稱。指定在 Arbortext PE 伺服器上註冊的名稱。如未指定，則會使用 applicabilitySyntax 的值。如未指定 applicabilitySyntax，則預設值為 ATO。

否

topicCCfParam.
targetApplicability
Syntax

XML 束

指定在服務子系統完成處理後，主題中適用性運算式使用之適用性語法的名稱。指定在 Arbortext PE 伺服器上註冊的名稱。如未指定，則會使用 applicabilitySyntax 的值。如未指定 applicabilitySyntax，則預設值為 APEX。

否

topicCCfParam.
disableMetadata
Replacer

XML 束

指定是否針對 XML 主題禁用資訊元素中繼資料取代。此參數控制是否在束發佈期間使用 XML 主題內所找到之中繼資料中的值取代資訊元素內容。指定 false 將啟用中繼資料取代。指定 true (預設值) 將禁用中繼資料取代。

否

topicCCfParam.
disableProfiling
Converter

XML 束

指定是否針對 XML 主題禁用設定檔轉換。此參數控制是否在束發佈期間轉換 XML 主題中的設定檔標示。指定 false 將啟用設定檔轉換。指定 true (預設值) 將禁用設定檔轉換。

設定檔屬性由 topicCCfParam.profilingAttribute 指定。

否

topicCCfParam.
profilingAttribute

XML 束

指定要用於設定檔篩選的屬性。指定屬性的本機 localName，或指定命名空間及本機名稱 ({uriNamespace}localName) 的 URI。

預設會從下列內容建立 applic 屬性：

{http://arbortext.ptc.com/namespace
/applicability/profiling}applic

否

topicCCfParam.
removeProfilingMarkup

XML 束

指定是否從 XML 主題中移除設定檔標示。此參數控制是否在發佈期間移除 XML 主題中的設定檔標示。指定 true 將移除 XML 主題中的設定檔標示。指定 false (預設值) 將保留設定檔標示。

設定檔屬性由 topicCCfParam.profilingAttribute 指定。

否

參數名稱	輸出	描述
APPConfigFile	PDF	如果您要使用 Arbortext APP 產生 PDF，請指定 APP 組態檔 (.3sppdf)。在 Arbortext PE 伺服器上指定檔案的絕對路徑。