服务工作器参数

参数名称

输出类型

说明

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 (默认值) 将使用属性值的源文本继续发布。

configurableLinkFilter

XML 束

指定可配置文档筛选器的名称，以将其设置为可配置文档的筛选器。

contentFilter

HTML

PDF

XML 束

使用 XSL

为 AttachmentFilter 和 PrimaryFilter 指定将用作后退默认筛选器规范的文件扩展名。

您可以指定以逗号分隔的文件扩展名列表。默认值为 * 通配符，其允许所有的图形动态文档和它们的附件。

要专门为图形动态文档覆盖此值，请参阅 AttachmentFilter 和 PrimaryFilter 参数。

describeLinkFilter

XML 束

指定说明文档筛选器的名称，以将其设置为说明文档的筛选器。

emitAttachments

HTML

PDF

XML 束

使用 XSL

指定是否在有效载荷中包括图形动态文档或 WTDocuments (附属内容) 的附件。

指定 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 工作器日志文件中包括发布里程碑的事件性能信息。指定 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 和 Windchill Service Parts》)中的有效载荷和内容清单。

payloadCache

XML 束

指定有效负载是否缓存在 Windchill 临时文件夹的 SISPayloadCache 子文件夹中。将值设置为 yes 或 true，以将有效负载存储在临时文件夹中。默认值为 false。

PTC 建议使用此参数进行故障排除，而非定期发布。

preferAdapter

XML 束

指定是否使用 Arbortext Publishing Engine 服务器上的 PTC Server connection 适配器检索结构内容。

指定 yes 将使用 Arbortext Publishing Engine 服务器上的适配器。指定 no (默认值) 可将有效负载中的结构内容从 Windchill 发送至 Arbortext Publishing Engine 服务器。默认值为 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 和如何处理缩略图参数的详细信息，请参阅有效载荷和内容清单

referenceLinkFilter

XML 束

指定参考文档筛选器的名称，以将其设置为参考文档的筛选器。

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 Publishing Engine 服务器上注册的名称。无默认值。

有关适用性的详细信息，请参阅发布中的内嵌适用性。

否

artifactDirectory

HTML

PDF

XML 束

使用 XSL

指定发布期间创建的有效载荷制品的压缩副本所在目录，以用于故障排除。

该目录必须是 Arbortext Publishing Engine 服务器上有效且可写的目录。

是

disableInlineApplic Filtering

PDF

使用 XSL

指定是否要为 PDF 和 XSL 输出启用基于内嵌适用性表达式的筛选。指定 true (默认值) 可禁用内嵌适用性，而指定 false 可将其启用。

否

disableStructure ApplicabilityConverter

HTML

PDF

XML 束

使用 XSL

指定是否转换结构和辅助集合文件中的适用性表达式。

对于束输出，默认值为 false。此时，转换由 structureSourceApplicSyntaxstructureTargetApplicSyntax 控制

对于 PDF 发布，此参数的默认值为 true。

否

enableChecksumOnMetadata

XML 束

指定校验和值，以跟踪参考部件的属性或服务有效性中的任何更改。更改部件的属性或服务有效性时，默认值 true 可添加校验和值。

否

htmlLogVerbosityLevel

HTML

PDF

XML 束

使用 XSL

指定被包含在返回到 WVS 的事件日志的 HTML 版本中的消息级别。消息。指定级别和高于指定级别的消息会包括在日志中。值为 info、warning、error 或 fatal。如果此参数未被指定或具有无效值，则默认为 warning。

所有消息都始终包含在同样返回到 WVS 的日志的 XML 版本中。

是

includeMilestoneTimes InHtmlLog

HTML

PDF

XML 束

使用 XSL

指定是否在已返回至 WVS 的事件日志的 HTML 版本中包括发布里程碑活动的事件时间信息。每个里程碑条目包含活动完成的时间。

此日志也可从 Arbortext Publishing Engine 服务器的“事务存档”中获得。在此表格后有一个里程碑活动列表。

是

reportMore Applicability ParseErrors

PDF

使用 XSL

指定是否在失败前为内嵌适用性报告其他的适用性表达式问题。默认值 false 可在发现第一个有问题的表达式后使发布立即失败。设置为 true，可在发布作业失败之前尽可能多的收集适用性表达式问题。

否

resultBaseName

HTML

PDF

XML 束

使用 XSL

指定用于定义表示的基础文件名的字符串。该字符串可包含一个或多个称为 key 的字符串替换模式，会在发布或使用替换值替换它时对它进行评估。键可表示 WVS 替换键、服务工作器参数和正在发布的服务结构的根属性。

默认情况下，会将根对象 ID 用作 PDF 和 XSL 输出的基础名称或束的 pubstructXsl 样式表名称。

使用 {key} 格式指定一个键，其中 key 为 WVS 替换键、服务工作器参数 (以 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 的名称。

如果 {键} 是未在发布规则 (或 pubspec.xml) 中定义的工作器参数名称，则将使用该参数的默认值。

此参数不定义输出文件的文件扩展名。此外，如果表示包含 PDF，则表示中的 PDF 不会受到影响。

如果 {键} 为正在发布的根部件的属性，则该属性必须在 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 和 Windchill Service Parts》)中进行了介绍。

否

structureSource ApplicSyntax

HTML

PDF

XML 束

使用 XSL

指定用于服务结构、部件列表和其他已收集文件中适用性表达式的源适用性语法名称。指定在 Arbortext Publishing Engine 服务器上注册的名称。如果未指定，则将使用 applicabilitySyntax 的值。如果未指定 applicabilitySyntax，则默认值为 ATO。

有关适用性的详细信息，请参阅发布中的适用性。

否

structureTarget ApplicSyntax

HTML

PDF

XML 束

使用 XSL

指定要在发布期间应用于服务结构、部件列表和其他已收集文件中的适用性表达式的目标适用性语法名称。指定在 Arbortext Publishing Engine 服务器上注册的名称。如果未指定，则将使用 applicabilitySyntax 的值。如果未指定 applicabilitySyntax，则对于束输出，默认值为 APEX，而对于其他输出类型，默认值则为 ATO。

有关适用性的详细信息，请参阅发布中的内嵌适用性。

否

stylesheet

HTML

PDF

XML 束

使用 XSL

指定用于定义输出样式的束或发布的样式表。您可以使用绝对路径或名称指定样式表。

系统会使用 Arbortext Publishing Engine 服务器上文档类型的 catalog 路径解析名称，该文档类型与所发布主题的文档类型匹配。

有关文档类型和样式表的信息，请参见 Arbortext Editor and Publishing Engine 文档。

如果该主题具有一个样式表关联处理指令，则会忽略该指令。

否

useRestricted TransactionArchive

PDF

XML 束

使用 XSL

指定是否使用事务存档的替代位置。指定 1 将使用替代事务存档。

替代事务存档可用于将包含敏感信息的事务存储在仅具有权限的用户可以访问的位置。事务存档在 Arbortext Publishing Engine 服务器上进行配置。请参阅 Configuring Arbortext Publishing Engine 中的 Arbortext Publishing Engine 文档。

是

usingxsl.destination

使用 XSL

指定 XSL 发布输出的放置位置。指定一个可从 Arbortext Publishing Engine 访问的到可写入文件夹的绝对路径。如果文件夹与现有目录冲突，会将其覆盖。

是

usingxsl.stylesheet

使用 XSL

指定要在发布 XSL 期间使用的 .xsl 样式表。此样式表期望源文档的文档类型与 pubstructXsl 变换的输出或“用于定义样式的解析文档”(RDS) 相匹配。

输出会置于 usingxsl.destination 指定的位置处。仅创作者日志和带有发布作业相关信息的内容清单会返回到 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 可提高在发布请求期间记录到创作者日志中的信息量。

默认情况下，错误和警告信息消息位于创作者事件日志中。

另外，还可以在 Arbortext Publishing Engine 上启动 atitrace.exe，然后调试被发送到该窗口的输出，同时捕获低级别的追踪信息。此操作将由 Arbortext Publishing Engine 管理员执行。

是

variable:_sis:: archiveTransaction

HTML

PDF

XML 束

使用 XSL

指定是否使用事务存档在 Arbortext Publishing Engine 服务器上存储发布制品。指定 1 将对事务进行存档。默认值 0 不会对事务进行存档，但 Arbortext Publishing Engine 服务器上的配置可能会对其进行存档。

是

里程碑	活动
有效负载解压缩完成	将有效负载解压缩至 Arbortext Publishing Engine 服务器上临时目录的时间。
预服务子系统处理完成	处理配置文件 pubspec.xml 中的值、确定适配器设置和其他预处理活动。
服务子系统完成	已执行管道配置文件 Service.ccf，且已变换发布结构及其内容。
发布子系统完成	已执行发布子系统。活动由正在执行的发布类型确定。
束子系统完成	如果有束正在发布中，则包括在内。涵盖生成剩余束内容、将其打包并置于目标位置所需的时间。

参数名称

输出

说明

可重写 (增量发布期间支持值的更改)

altDestination

XML 束

指定 Arbortext Publishing Engine 放置束的替代目录。此位置与 Windchill 服务器 OS 兼容，并会指定为安装点、UNC 路径或由安装的驱动器盘符指定。例如：

/local/mnt/bundles

是

boilerplate

XML 束

指定解压缩至 destination 目录的束的样板文件压缩文件名称。

通过在 Arbortext Publishing Engine 服务器上搜索 set libpath 规范来确定样板文件的路径。文件需要具有读取权限，并且要与此参数值命名为相同的名称。默认值为 boilerplate.zip。

否

bundleName

XML 束

指定已生成束所在的束子目录的名称。名称附有 _timestamp。默认值为 bundle。

束子目录位于由 destination 参数指定的目录下。

束名称字符可以为数字、字母和一些特殊字符，如 . (句号)、- (划线) 以及 _ (下划线)。不受支持的字符 (如 \ / : * ? " < > |) 将使用相应的 %xx 十六进制值进行转义。

不支持左右两侧的单引号和双引号，将使用 %xx 十六进制值对其进行转义。

是

destination

XML 束

指定 Arbortext Publishing Engine 放置束输出的目录。此位置位于 Arbortext Publishing Engine 服务器上，且被指定为物理或映射驱动器。该目录必须事先创建。无默认值。

指定 bundleName 将为束创建此目录的子目录。

是

DMPmapSchema

XML 束

指定要用于验证的模式的路径 (相对路径或绝对路径)。默认值会相对于 DMPmap\DMPmap.xsd 假定路径。

指定相对路径时将使用包括指定模式文件的 Arbortext Publishing Enginedoctypes 搜索路径下的第一个位置。

如果找不到模式，Arbortext Publishing Engine 创作者事件日志会捕获错误消息，且指定的 DMPmapSchema 参数值会显示在消息中。

否

saveCopy

XML 束

指定是否将束文件保存在 zip 文件中，以便进行故障排除。指定 true 可将其启用。默认值为 false。

使用 artifactDirectory 参数指定目录。束文件名称从 saveCopyName 的值构建而来。

是

saveCopyName

XML 束

指定束文件的基础文件名。基础名称附有 _timestamp.zip。

默认值为 bundle_saveCopy。

文件位于 artifactDirectory 参数指定的目录中。

基础名称字符可以为数字、字母和一些特殊字符，如 . (句号)、- (划线) 以及 _ (下划线)。其他字符 (如 Windows 文件名中不支持的字符 (\ / : * ? " < > |)) 会替换为相应的 % 十六进制值。

不支持左右单引号和双引号。

是

validate

XML 束

指定是否根据 DMPmapSchema 参数指定的模式验证 DMPmap.xml。DMPmap.xml 是由束发布请求生成的文件。

指定 yes 可进行验证。默认值为 no。

如果设置为 yes，则在不能验证输出时，发布会失败。

默认 DMPmap.xsl 样式表所生成的 DMPmap.xml 不会根据默认的 DMPmap\DMPmap.xsd 进行验证。

Arbortext Publishing Engine 创作者事件日志会捕获错误消息，且其包含用于验证的模式的绝对路径

如果验证通过，事件日志中会显示一条“信息”消息确认验证已通过，且其中包含模式的绝对路径。

否

参数名称

输出

说明

可重写 (增量发布期间支持值的更改)

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，* 通配符将匹配所有文件格式，而 + 符号将匹配 web 友好型格式。

对于 target-type，如果不想转换图形文件，请指定 - 排除字符。

在以下示例中，只是将所有 web 友好型格式复制到有效负载中，然后将其余所有图形格式转换为 JPG 格式。

+:-|*:jpg

如果未针对图形类型设定转换规则，则不会进行转换。将按顺序处理转换，因此必须在其他规范后使用通配符。例如，在 *:-|tif:jpg 中，通配符会覆盖第二个转换规则中的图形类型，并使得整个规范与 *:- 对等。在这种情况下，将复制所有图形且不执行任何转换。

默认值会应用在服务应用程序 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,serviceable。

是

partlistBundleCcfParam. sbomMetadataTokens

XML 束

指定要从所参考的部件文件复制到部件列表批注的 SBOM 元数据标记值。指定以逗号分隔的元数据标记值列表。默认值为 number,orgName,servicekit,name。

通配符 * 表示包括全部。空值或 - 表示不提供任何值。此参数仅支持 2.0 或更高版本的部件列表。

所有可用 SBOM 元数据标记值的列表：name,number,orgName,servicekit,ServiceEffectivity,LogicalExpression,beginSerialNumberRange,endSerialNumberRange,beginDateRange,endDateRange,effTarget,effContextReference,serviceable。

是

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 将使用该样式表将通用 XML 形式的部件列表转换为与 com.ptc.arbortext.pe/stylesheet 的文档类型兼容的文档类型。

您可以在 Arbortext Publishing Engine 服务器上指定样式表的名称或绝对路径。系统会使用 Arbortext Publishing Engine 服务器上文档类型目录的 catalog 路径解析名称。默认情况下，其会查找服务应用程序 partlist 文档类型。

否

pubstructXsl

HTML

PDF

XML 束

使用 XSL

指定 XSL 样式表，Arbortext Publishing Engine 将使用该样式表将通用 XML 形式的服务结构转换为与 com.ptc.arbortext.pe/stylesheet 文档类型兼容的文档类型。

您可以在 Arbortext Publishing Engine 服务器上指定样式表的名称或绝对路径。系统会使用 Arbortext Publishing Engine 服务器上文档类型目录的 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 Publishing Engine 服务器上注册的名称。如果未指定，则将使用 applicabilitySyntax 的值。如果未指定 applicabilitySyntax，则默认值为 ATO。

否

topicCCfParam. targetApplicability Syntax

XML 束

指定在服务子系统完成处理后用于主题内适用性表达式的适用性语法名称。指定在 Arbortext Publishing Engine 服务器上注册的名称。如果未指定，则将使用 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	如果要使用 APP 生成 PDF，请指定一个 APP 配置文件 (.3sppdf)。在 Arbortext Publishing Engine 服务器上指定文件的绝对路径。