企业管理 > Windchill 数据加载 > 数据加载和 LoadFromFile 框架简介 > 现有加载方法
  
现有加载方法
了解您的系统可用何种方法进行加载的最好办法是查看 loadFiles.csvmapfile.txt 文件。以下是有关可用于在系统中加载数据的方法的简明目录。给出了完整的方法路径,以方便您在 JavaDoc 中查找它们。
wt.doc.LoadDoc.createGeneral - 加载常规文档;添加一个内容文件并缓存创建的“常规”以添加额外内容。
* 
用于支持现有系统的旧方法。
wt.doc.LoadDoc.createSpec - 加载规范文档;添加一个内容文件并缓存创建的“规范”以添加额外内容。
* 
用于支持现有系统的旧方法。
wt.doc.LoadDoc.beginCreateWTDocument - 加载 WTDocument、子类型和全局属性。支持版本控制,允许创建文档的特定版本和小版本。有关详细信息,请参阅 wt.doc.LoadDoc.beginCreateWTDocument 详细信息部分。
wt.load.LoadContent.createContentURL - 将一个内容 URL 添加到缓存的内容载体。
wt.load.LoadContent.createContentFile - 将一个内容文件添加到缓存的内容载体。
wt.load.LoadContent.setDefaultDirectory - 设置一个存放内容的默认目录。在下一 setDefaultDirectory 或数据文件结束前有效。
wt.load.LoadContent.setDefaultURL - 设置一个可通过其找到内容的默认 URL 部分。在下一 setDefaultURL 或数据文件结束前有效。
wt.folder.LoadFolder.createCabinet - 创建一个文件柜。主要用于初始化系统。创建用户时自动创建用户文件柜。
wt.folder.LoadFolder.createSubFolder - 创建一个子文件夹。
wt.folder.LoadFolder.createFolderShortcut - 创建一个文件夹快捷方式。
wt.load.LoadUser.createUser - 创建一个新用户。
wt.load.LoadUser.createGroup - 创建一个新组。
wt.load.LoadUser.createUserGroup - 将用户添加到组中。
wt.load.LoadUser.createDomain - 创建一个新域。
wt.load.LoadUser.createAccessRule - 添加一条访问规则。
wt.part.LoadPart.createPart - 创建一个部件。
wt.part.LoadPart.createPartDocDescribes - 通过创建 WTPartDescribeLink 使 WTPart 与 WTDocument 相关联。
wt.part.LoadPart.createPartDocLink - 在部件和文档之间创建一个链接 (WTPartDescribeLink 或 WTPartReferenceLink)。创建的关联类型取决于文档的子类型。
wt.part.LoadPart.addPartToAssembly - 将部件以“使用”关系添加到装配中。
wt.part.LoadPart.createPartDocReference - 在部件和现有文档之间创建“引用”关系。
wt.part.LoadPart.beginCreateWTPart - 加载 WTPart、子类型和全局属性。支持版本控制,允许创建部件的特定版本和小版本。有关详细信息,请参阅 wt.part.LoadPart.beginCreateWTPart 详细信息部分。
wt.index.LoadIndexRule.createIndexRule - 创建用于搜索的索引规则。
wt.lifecycle.LoadLifeCycle.createLifeCycleTemplate - 创建一个生命周期模板。
wt.project.LoadProject.createIndirectRoleHolder - 创建一个角色至角色映射。
wt.project.LoadProject.createRoleHolder - 创建一个角色与参与者之间的映射。
wt.project.LoadProject.createActorRoleHolder - 创建一个角色至操作者角色映射。操作者角色派生出用户,例如“创建者”。
wt.lifecycle.LoadLifeCycle.createCriterion - 创建生命周期阶段的允许条件。
wt.lifecycle.LoadLifeCycle.createPhaseTemplateBegin 和 wt.lifecycle.LoadLifeCycle.createPhaseTemplateEnd - 创建一个阶段。
wt.project.LoadProject.createProjectBegin 和 wt.project.LoadProject.createProjectEnd - 创建一个项目。
* 
不要使用默认管理员帐户来创建项目上下文。而应使用作为组织 (您要在其中创建上下文) 项目创建者的帐户。此外,也不要将默认管理员帐户作为上下文的团队成员进行添加。有关详细信息,请参阅事前准备
wt.lifecycle.LoadLifeCycle.createWTAclEntry - 创建生命周期阶段的专用访问控制。
wt.content.LoadDataFormat.createDataFormat - 添加加载内容文件中使用的数据格式。
wt.effectivity.LoadEffectivity.createConfigurationItem - 加载一个配置项。配置项对于批号有效性和序列号有效性是必选项,但对于日期有效性是可选项。
wt.effectivity.LoadEffectivity.createWTDatedEffectivity - 加载一个日期有效性。该有效性将与最后加载的 WTPart 对象关联。
wt.effectivity.LoadEffectivity.createWTSerialNumberedEffectivity - 加载一个序列号有效性。该有效性将与最后加载的 WTPart 对象关联。
wt.effectivity.WTLotEffectivity.createWTLotEffectivity - 加载一个批有效性。该有效性将与最后加载的 WTPart 对象关联。
wt.inf.team.ix.LoadSharedTeam - 加载一个共享团队。可将共享团队加载到组织上下文中,并可使用它来集中进行团队管理。有关详细信息,请参阅 wt.inf.team.ix.LoadSharedTeam 详细信息部分。
wt.org.LoadUserPicture.update - 加载图片,并将图片与系统中用户的配置文件相关联。有关详细信息,请参阅 wt.org.LoadUserPicture.update 详细信息部分。
wt.doc.LoadDoc.beginCreateWTDocument 详细信息
wt.doc.LoadDoc.beginCreateWTDocument 方法支持版本控制,进而允许以指定版本和小版本创建文档。多个文档版本暗示顺序关系。例如,后续批加载运行可“见缝插针”,但这一点是通过附加到前一版本的最新小版本实现的。
如果将更新的小版本添加到前一版本,则新版本将附加到新的最新小版本。例如:
加载集 1 (E.1, A.1, C.2) 产生 (A.1, C.2, E.1)。
C.2 的前置任务为 A.1,E.1 的前置任务为 C.2。
加载集 2 (B.1, A.2., C.1, C.3) 将产生 (A.1, A.2, B.1, C.1, C.2, C.3, E.1)。
B.1 的前置任务为 A.2,C.1 的前置任务为 B.1,E.1 的前置任务为 C.3。
B.1 的小版本历史记录显示 A.2 和 A.1
C.1 的小版本历史记录显示 B.1、A.2 和 A.1
E.1 的小版本历史记录显示 C.3、C.2、C.1、B.1、A.2 和 A.1
任何添加的新版本或小版本会继续将前置任务链接更改为前一版本的新的最新小版本。
* 
版本控制支持次序中的间隙。
有效版本控制示例为:(A.1,A.3,B.2,B.5,E.4,E.5)
wt.part.LoadPart.beginCreateWTPart 详细信息
方法 wt.part.LoadPart.beginCreateWTPart 支持版本控制。这允许部件以指定的版本和小版本创建。多个部件版本暗示顺序关系。例如,后续批加载运行可“见缝插针”,但这一点是通过附加到前一版本的最新小版本实现的。如果将更新的小版本添加到前一版本,则新版本将附加到新的最新小版本。
例如:加载集 1 (E.1, A.1, C.2) 产生 (A.1, C.2, E.1)。
各个版本的先前版本:C.2 是 A.1,而 E.1 是 C.2。加载集 2 (B.1, A.2, C.1, C.3) 产生 (A.1, A.2, B.1, C.1, C.2, C.3, E.1)。
B.1 的前置任务为 A.2,C.1 的前置任务为 B.1,E.1 的前置任务为 C.3。
B.1 的小版本历史记录显示 A.2 和 A.1
C.1 的小版本历史记录显示 B.1、A.2 和 A.1
E.1 的小版本历史记录显示 C.3、C.2、C.1、B.1、A.2 和 A.1
任何添加的新版本或小版本会继续将前置任务链接更改为前一版本的新的最新小版本。
* 
版本控制支持次序中的间隙。
有效版本控制示例为:(A.1,A.3,B.2,B.5,E.4,E.5)
如果不按顺序加载版本并将关系加载到这些部件中,在排序数据时应该了解以下几点:
关系自前置任务标识的版本转发至新版本。例如,在按顺序的情况下,您可以创建参考文档 2 或说明与其存在关系的部件 1 A.1。如果经过修订得到部件 1 B.1,那么 A.1 的关系会复制到它,所以它同样与文档 2 存在关系。
如果关系是在已经创建了新版本之后创建的,则它们不会被转发。例如,如果创建了部件 1 A.1 和 B.1,然后创建部件 A.1 对文档 2 的关系,则部件 1 B.1 不会自动将对文档 2 的关系复制到其中。如果您要创建这种关系,则必须显式创建。
来自前置任务的关系不会累积。(这一点将进一步阐明此列表中的第一点。) 只从某一标识的先前版本复制关系,而不是从累积的先前版本。如果创建与文档 2 相关的部件 1 B.1 和与文档 3 相关的部件 1 A.1,则部件 1 C.1 仅继承与文档 2 的关系。
鉴于这些基本规则,您可以想象出其他情况。在对创建的版本或小版本及其关系进行排序时,请仔细考虑您的计划以确保可以获得期望的结果。
wt.inf.team.ix.LoadSharedTeam 的详细信息
加载文件必须包含一组用于定义团队的标记。例如,假定您要导入带有下列信息的共享团队:
共享团队名称:设计团队
说明:公司团队成员负责设计
所有者:执行加载的用户。默认情况下,执行加载操作的用户成为所有者。如果想要设置另一个所有者,则 csvsharedTeamOwner 标记中要包括该用户的 UID。
邀请:欢迎加入设计团队!
启用并扩展共享团队
用于执行加载操作的 XML 文件的内容如下:
<?xml version="1.0"?>
<!DOCTYPE NmLoader SYSTEM "standardX20.dtd">

<NmLoader>
<csvCreateSharedTeam handler="wt.inf.team.ix.LoadSharedTeam.create
SharedTeam">
<csvsharedTeamName>Design Team</csvsharedTeamName>
<csvsharedTeamDescription>Corporate team members responsible for
designs</csvsharedTeamDescription>
<csvsharedTeamOwner></csvsharedTeamOwner>
<csvsharedTeamInvitation>Welcome to the Design Team!</csvshared
TeamInvitation>
<csvsharedTeamEnabled>true</csvsharedTeamEnabled>
<csvsharedTeamExtendable>true</csvsharedTeamExtendable>
</csvCreateSharedTeam>
</NmLoader>
共享团队必须加载到现有组织上下文中。有关共享团队的详细信息,请参阅关于共享团队
wt.org.LoadUserPicture.update 详细信息
要批加载图片并将图片与现有用户的配置文件相关联,下面给出了用来执行加载的 XML 文件内容示例:
<?xml version="1.0"?>
<!DOCTYPE NmLoader SYSTEM "standardX20.dtd">

<NmLoader>
<csvUserPicture handler="wt.org.LoadUserPicture.update">
<csvuserName>User1</csvuserName>
<csvpath>c:\User1.jpeg</csvpath>
</csvUserPicture>
<csvUserPicture handler="wt.org.LoadUserPicture.update">
<csvuserName>User2</csvuserName>
<csvpath>c:\User1.jpeg</csvpath>
</csvUserPicture>
</NmLoader>
* 
这些用户必须已存在于系统中。如果某个图片已经预先与某个用户的配置文件相关联,则系统会删除该旧图片并创建一个新图片。
要简化对加载文件的准备工作,请使用 wt.org.UserPictureLoaderXmlGenUtility 命令行实用程序。此实用程序可为系统中的所有活动用户生成带有占位符图片文件名的默认加载文件。这样您便可以通过修改占位符的值来指定正确的文件名并加载图片数据。