处理收到的交付的最佳做法
上载收到的交付文件的最佳做法
要导入包 ZIP 文件,必须先上载收到的交付。
• 如果收到的 ZIP 文件很大,可通过在
Windchill 服务器上保存 ZIP 文件并选择
“附加新外部存储”选项
来提高上载速度。
• 如果您的 Windchill 服务器位于群集环境中,请确保可从所有的群集层获得接收的 ZIP 文件。
• 建议审阅发件人提供的所有内容清单文件或离线查看器。要审阅离线查看器,应在导入之前解压缩文件系统上的 ZIP 文件。对于上载而言,需要使用原始的 ZIP 文件。要审阅内容清单文件,应上载 ZIP 文件并从收到的交付审阅内容清单。
使用映射定义的最佳做法
在将源系统信息转换成目标系统上的有效信息时,映射定义是一种很有用的工具。映射定义能够将作为向导提供的属性 (如上下文、文件夹和生命周期模板) 以及具有重大业务意义的本地管理属性 (如拥有组织、生命周期状态和安全标签) 映射至某个系统。
• 使用“收到的交付导入预览”操作,以便在导入已收到的交付数据之前建立映射定义。
• 同时使用预览和映射定义,以便将信息从预览窗口直接复制到映射定义中的源系统信息。
• 在建立映射定义之前考虑类型定义、属性定义和版本控制方案定义不一致问题,并对其加以解决。
◦ 权衡是将信息从源系统直接添加到配置中 (例如创建名称相同的文件夹) 还是定义映射更为有效。
◦ 建议使用生命周期模板映射,因此它代表对象在导入之后所遵循的业务流程。在目标系统中,对象基本上无需遵循与源系统中相同的业务流程,因此最佳做法是定义一个不对对象启动工作流进程的生命周期模板映射。
▪ 如果希望维持与源系统生命周期模板的相关性或只是针对从发送系统导入的信息使用基本生命周期,请映射到源系统的基本生命周期模板表示。
▪ 仅在应针对导入对象启动工作流时,才映射到高级生命周期模板。
▪ 使用高级生命周期时,其应与不向对象引入更改的工作流进程相关联,因为如果再次导入对象,目标系统上的所有更改都会被覆盖。
• 尽量避免从特定源系统导入第一个收到的交付后更改映射。更改映射定义可能导致数据组织出现问题。
• 使用“收到的交付导入预览”窗口“上下文相关信息”部分的“源值”字段中提供的文本来填充映射属性的源系统信息。
• 定义映射的用户应对系统中的相关对象 (如文件夹位置、生命周期模板等) 具有适当授权。
• 定期审阅映射定义以移除或更改不正确或已过时的映射定义。
• 在每个选项卡上保存更改以确保数据不会丢失。
• 同时使用“收到的交付导入预览”操作和“定义映射”操作,因为这样您便可以从“收到的交付导入预览”窗口复制信息并将其粘贴到相应映射定义的源系统信息中。
版本映射的最佳做法
隐式映射或保留源系统中的版本信息是一项关键决策,因为版本信息表示关键业务信息。
• 保留源系统中的版本信息时,目标系统中还必须包含针对基于文件和基于状态的修订版本序列的相同版本方案的定义。有关详细信息,请参阅
对象编号和版本化。
• 建议目标系统中配置的对象版本控制特性与源系统中配置的特性相匹配。
• 在导入包之前,请确定源系统中是否存在可用的版本控制方案。建议不要在复制数据后更改版本控制方案,因为这可能会导致日后导入过程中出现不可预测的结果或冲突。
• 在开始导入之前,请使用“导入收到的交付”或“收到的交付导入预览”对话框来验证版本映射的配置是否已正确设置。
• 当源系统将基于文件或基于状态的序列与历史定义配合使用时,建议不要使用源系统中的版本信息,且不进行隐式映射。
有关版本映射的详细信息,请参阅
定义收到的交付版本映射。
导入收到的交付对象的最佳做法
• 可使用若干属性来控制已收到的交付导入性能。属性可控制已收到的交付导入如何被管理。导入可按顺序处理,也可使用事务处理或线程进行处理。可设置下列属性以最大化性能:
◦ wt.ixb.import.noOfParallelImportPaths:设置用于平行导入的事务处理数量。
使用多个事务处理有益于已收到的交付导入性能,因为若导入过程中有任何问题,都可导致导入的部分成功。导入对象作为任何成功事务处理的一部分,对已授权用户可用。在调整后可以重新尝试未成功的事务处理。默认情况下,此属性设置为 1。如果 wt.ixb.tag.apply.TransactionTag.enableCount 属性设置为高于 75,000,则该属性被设置为 4。
◦ wt.ixb.tag.apply.TransactionTag.enableCount:根据已收到的交付文件中的对象数量,设置阈值以分为多个事务处理。
如果站点使用一个以上事务处理来导入已收到的交付文件,则必须为此属性设置值以确定每个事务处理中的最大对象数量。值是在包含于交付文件的对象数中测量的,包括对象之间的链接。例如,如果值设置为 3000 而交付包含 5500 个对象,则导入需分为两个事务处理。默认情况下,此属性设置为 75000。
◦ wt.ixb.import.maxThreads:设置事务处理内使用的线程数量。
使用多个线程可对已收到的交付导入性能具有最重大的影响。线程共享相同的数据库连接,若达到阈值则可影响性能。对象数也可影响性能,对象数越多,使用多个线程时性能改进越好。一般情况下,一个线程足以用于增量包交付。初始包交付可从多个线程获益,尤其是在导入时间窗口为小窗口时。默认情况下,此属性设置为 1。
| wt.ixb.import.maxThreads 属性的值可与 wt.ixb.import.noOfParallelImportPaths 属性结合使用,来决定用于导入的事务处理数量。 • 单一事务处理情景:如果 wt.ixb.import.noOfParallelImportPaths 属性设置为 1,则 wt.ixb.import.maxThreads 属性的值是用于导入的线程总数。 • 多个事务处理情景:如果 wt.ixb.import.noOfParallelImportPaths 值设置为大于 1,则 wt.ixb.import.maxThreads 属性的值为每个导入事务处理所用的线程数量。 |
◦ wt.ixb.import.batchSize:设置线程的批处理大小。
批处理大小对已收到的交付导入性能影响较小。可设置属性以确定每个导入批处理中的对象数。默认情况下,此属性设置为 10000。
• 导入期间同样使用您在“收到的交付导入预览”窗口中选择的“导入到”选项。
• 如果导入时要保存解决方案,请使用“在此导入进程中,保存您所提供的最新解决方案”选项,因为这样您便可以在导入同一源系统中的另一个接收的交付时重用这些选择。
• 如果导入时要重用先前保存的解决方案,请选择“使用先前保存的解决方案”选项。
• 收到的交付导入成功完成后,审阅导入汇总报告。
• 收到的交付导入通过 RDImportExecutorQueue 进行处理。有关详细信息,请参阅
出厂设置后台队列。
• 收到的交付导入成功后,可移除与该交付关联的已上载 ZIP 文件以改善存档性能。如果导入成功,可将 com.ptc.windchill.rd.cleanupFilesOnSuccessfulImport 属性设置为“真”来自动移除 ZIP 文件。
审阅收到的交付日志文件的最佳做法
日志文件可从收到的交付信息页面获得,其中包含在审阅和导入操作期间发现的所有项的详细信息。可以使用这些日志文件来调查在导入进程中遇到的警告和错误、标识导入的对象和链接,以及查找导入时存在冲突或因冲突而被跳过的对象。有关详细信息,请参阅
审阅收到的交付导入日志。