EaBIM

标题: Vault中的文件版本和关联 [打印本页]

作者: 萧闫子 时间: 2014-1-14 10:35
标题: Vault中的文件版本和关联

Doug的博客中又出了一篇新文章，该文章的目的是解释Vault中的几个让人困惑的概念：文件的版本和文件的关联。简单地说，就是用GetLatestFileAssociationsByMasterIds来返回最新的文件结构树，用GetFileAssociationsByIds返回指定版本的文件结构树。

下面是原文：

File Associations - Part 1

Welcome to part 1 in my 2 part series on file associations.  This post will focus only on the associations seen in the base version of Vault.  The next post will go over Vault Workgroup concepts like revisions and lifecycle states.

Introduction:
For base vault we have 2 concepts that are simple on their own, but start to get complex when you mix them together.
The first concept is File Versions.  Every time you edit a file, you get a new version. Simple.
The second concept is File Associations. Files can be linked to each other in a parent/child relationship.  This allows you to create dependency trees.  Again, simple.

Now let's mix the concepts together.  A file association is between one version of a file and another.  This means that the dependency tree might change for each version of a file.

Here is where the confusion starts. You have a big chunk of data and multiple ways of traversing the data. The good news is that the API has some built in tools to help you.

Example:
Let's go through a simple example. First we upload 2 new files, A and B. A is the parent of B. This is what things look like in Vault:

Next we will check out B and check it back in with a new file, C. B is the parent of C. Our view now looks like this:

If we start at A and want to get the entire dependency tree, base Vault gives you 2 two types of traversals:

Snapshot in time: You want to view the tree exactly as it looked when it was uploaded. GetFileAssociationsByIds in the Document Service is the function that will give you this view. If you started with file A and wanted all children, you would get this result:

登录/注册后可看大图
Get latest: You want to get the most recent version of all the files involved. GetLatestFileAssociationsByMasterIds in the Document Service is the function that will give you this view. If you started with file A and wanted all children, you would get this result:

登录/注册后可看大图

That's all you need to know for base Vault. My next post will go over the Revision and Lifecycle concepts and how they relate to file associations.

File Associations - Part 2

Welcome to part 2 in my 2 part series on File Associations. In part 1, I went over the concepts in base Vault. In this part, I will go over concepts added by Vault Workgroup.

New concepts:
Again we have 2 concepts that are simple on their own, but become complex when added to everything else.

First we have Revisions, which is a way to give meaning to a set of versions. For purposes of this posting, I'll be using alpha characters for revisions and numeric characters for versions.

The next concept is Release States, which is a way of saying that a file is completed if it is in a certain lifecycle state. At the API level, there is a boolean property on LfCycState which tells if the state is a release state or not. A lifecycle definition usually has only one release state, but it is possible to have 0 or multiple release states. For the purposes of this posting, release states will have a darker color than the other states.

One final note: The Vault clients are set up to update files associations only with the physical file changes. If it's just a change to the Vault data (for example, changing lifecycle state) then the new file version points to the same files that the old version did.

Example:
Let's go over an example. Here we have 2 files, a parent and a child. Both files have gone through revision and lifecycle changes. The arrows represent direct associations between the file versions.

The Vault API provides 5 ways to traverse this data. In all these cases, we are starting at the Parent and asking for the entire dependency tree.

Get Latest - no release bias

登录/注册后可看大图

This is useful for CAD engineers who want the latest version of all the files so that they can work on them.
At the API level, you call GetLatestFileAssociationsByMasterIds in the Document Service and pass in 'false' for the releasedBiased parameter.
Get Latest - release bias

登录/注册后可看大图

This is useful for people outside the CAD department who are not interested in the 'work in progress' data. They just want to see the latest completed product.
At the API level, you call GetLatestFileAssociationsByMasterIds in the Document Service and pass in 'true' for the releasedBiased parameter.
Snapshot in Time by Version

登录/注册后可看大图

This is useful in cases where you don't care about revisions. The result is what you would get in base Vault, you only get the direct relationships between file versions.
At the API level, you call GetFileAssociationsByIds in the Document Service.
Snapshot in Time by Revision - no release bias

登录/注册后可看大图

This gives you the latest version within a revision, regardless of the lifecycle state.
At the API level, you call GetRevisionFileAssociationsByIds in the Document Service and pass in 'false' for the releasedBiased parameter.
Snapshot in Time by Revision - release bias

登录/注册后可看大图

This gives you the latest release version within a revision. If no release version exists, the latest one in the revision is returned.
At the API level, you call GetRevisionFileAssociationsByIds in the Document Service and pass in 'true' for the releasedBiased parameter.

Putting it All Together:
You should be properly confused by now. However there are a rule that will simplify things.

Rule: When dealing with revisions, think in terms of revisions. Don't think in terms of versions.

Behind the scenes, revisions only care about 2 versions: the latest version in the revision and the latest release version in the revision. Many times these 2 are the same thing. When thinking in terms of revisions, you need to forget about all other versions.

So let's redo the dependency tree for 4 and 5, this time viewing things in terms of revisions.

Snapshot in Time by Revision - no release bias

登录/注册后可看大图
Snapshot in Time by Revision - release bias

登录/注册后可看大图

There, much better.

文章来源：http://blog.csdn.net/barbarahan

作者: JHXT杰西卡 时间: 2014-2-13 10:15
了解

作者: 飞天舞 时间: 2014-2-18 14:32
路过！！！
帮顶……

作者: 入樽 时间: 2014-2-18 14:33
顶！！！！！！！！！！！！！！！！！！！！！！！！！

作者: 悠悠筱荷 时间: 2014-2-21 14:49
顶！！！！！！！！！！！！！！！！！！！！！！！！！

作者: 孙雅 时间: 2014-2-25 10:57
顶！！！！！！！！！！！！！！！！！！！！！！！！！

作者: 大头佬 时间: 2014-2-25 10:59
路过！！！
帮顶……

作者: 黑超BB 时间: 2014-2-25 11:01
路过！！！
不发表意见……

作者: NetBeetle 时间: 2014-2-25 11:02
顶起来…………

作者: 苦田辛君 时间: 2014-2-25 11:05
路过！！！
帮顶……

作者: 严英华 时间: 2014-2-25 11:06
顶！！！！！！！！！！！！！！！！！！！！！！！！！

作者: codywu 时间: 2014-2-25 11:09
顶起来…………

作者: 江枫 时间: 2014-2-25 11:11
路过！！！
不发表意见……

作者: 野风 时间: 2014-2-25 11:12
顶起来…………

作者: 入樽 时间: 2014-2-25 11:15
顶起来…………

作者: 烈火ivk 时间: 2014-2-25 11:16
(*^__^*) 嘻嘻……

作者: 江枫 时间: 2014-2-25 11:19
路过！！！
帮顶……

作者: 毫半字 时间: 2014-2-25 11:21
顶!!!!!!!!!!

作者: 车奴 时间: 2014-2-25 11:23
路过！！！
帮顶……

作者: AK47 时间: 2014-2-25 11:25
顶!!!!!!!!!!

作者: 冰雨 时间: 2014-2-25 11:27
顶......
楼下跟上.....

作者: 悠悠筱荷 时间: 2014-2-25 11:30
(*^__^*) 嘻嘻……

作者: 卡巴kala 时间: 2014-2-25 11:32
顶起来…………

作者: 月の月 时间: 2014-2-25 11:36
顶!!!!!!!!!!

作者: 大头佬 时间: 2014-2-25 11:38
顶！！！！！！！！！！！！！！！！！！！！！！！！！

作者: 矮矮 时间: 2014-2-25 11:41
路过！！！
帮顶……

作者: 鹦鹉仔 时间: 2014-2-27 15:38
路过！！！
帮顶……

作者: 沧海冷月 时间: 2014-2-27 15:39
顶起来…………

作者: 影馨 时间: 2014-2-27 15:40
顶起来…………

作者: 代号蓝牙 时间: 2014-3-4 14:03
顶！！！！！！！！！！！！！！！！！！！！！！！！！

作者: AK47 时间: 2014-3-4 14:07
(*^__^*) 嘻嘻……

作者: lw7511 时间: 2014-3-5 16:17
路过！！！
不发表意见……

作者: cocacola 时间: 2014-3-5 16:19
路过！！！
不发表意见……

作者: codywu 时间: 2014-3-5 16:24
(*^__^*) 嘻嘻……

作者: bin 时间: 2014-3-5 16:25
路过！！！
帮顶……

作者: 鹦鹉仔 时间: 2014-3-10 12:22
谢谢BIM大神…

作者: 月之影 时间: 2014-3-11 10:40
谢谢！！！
帮顶……

作者: 大奔KY 时间: 2014-3-11 10:42
谢谢！！！
帮顶……

作者: bin 时间: 2014-3-11 10:48
顶起来…………

作者: dison 时间: 2014-3-12 14:17
路过！！！
帮顶……

作者: ★の风の☆ 时间: 2014-3-12 14:19
顶起来…………

作者: lw7511 时间: 2014-3-12 14:22
顶!!!!!!!!!!

作者: 野风 时间: 2014-3-12 14:23
路过！！！
不发表意见……

作者: 鹦鹉仔 时间: 2014-3-12 14:27
路过！！！
帮顶……

作者: codywu 时间: 2014-3-12 14:29
顶起来…………

作者: 拉登 时间: 2014-3-12 14:31
顶!!!!!!!!!!

作者: cocacola 时间: 2014-3-12 14:36
顶起来…………

作者: AK47 时间: 2014-3-13 12:33
顶起来…………

作者: 拉登 时间: 2014-3-13 12:36
路过！！！
不发表意见……

作者: 老鼠仔CH 时间: 2014-3-13 12:40
路过！！！
帮顶……

作者: 宇航员 时间: 2014-3-13 12:42
顶!!!!!!!!!!

作者: 雁田佬 时间: 2014-3-13 12:46
顶......
楼下跟上.....

作者: 筱雅 时间: 2014-3-13 13:21
(*^__^*) 嘻嘻……

作者: ★の风の☆ 时间: 2014-3-18 11:17
(*^__^*) 嘻嘻……

作者: dgren 时间: 2014-3-18 11:18
顶!!!!!!!!!!

作者: 波罗友 时间: 2014-3-18 11:20
路过！！！
帮顶……

作者: lw7511 时间: 2014-3-18 11:21
顶！！！！！！！！！！！！！！！！！！！！！！！！！

作者: NetBeetle 时间: 2014-3-18 11:23
(*^__^*) 嘻嘻……

作者: bin 时间: 2014-3-18 11:23
(*^__^*) 嘻嘻……

作者: 月之影 时间: 2014-3-18 11:25
(*^__^*) 嘻嘻……

作者: 野风 时间: 2014-3-18 11:27
(*^__^*) 嘻嘻……

作者: 影馨 时间: 2014-3-18 11:28
顶！！！！！！！！！！！！！！！！！！！！！！！！！

作者: levin 时间: 2014-3-18 11:30
(*^__^*) 嘻嘻……

作者: 静儿 时间: 2014-3-26 15:54
顶......
楼下跟上.....

作者: bin 时间: 2014-3-26 15:56
顶！！！！！！！！！！！！！！！！！！！！！！！！！

作者: 悠悠筱荷 时间: 2014-3-26 15:58
顶!!!!!!!!!!

作者: 元劭 时间: 2014-3-26 15:59
顶起来…………

作者: 元劭 时间: 2014-3-26 16:01
(*^__^*) 嘻嘻……

作者: 国产008 时间: 2014-3-26 16:02
(*^__^*) 嘻嘻……

作者: 楚客 时间: 2014-3-26 16:03
顶！！！！！！！！！！！！！！！！！！！！！！！！！

作者: 悠悠筱荷 时间: 2014-3-26 16:07
顶......
楼下跟上.....

作者: 飞天舞 时间: 2014-4-1 10:24
(*^__^*) 嘻嘻……

作者: AK47 时间: 2014-4-1 10:26
顶......
楼下跟上.....

作者: 拉登 时间: 2014-4-1 10:27
路过！！！
不发表意见……

作者: 国产008 时间: 2014-4-1 10:29
顶起来…………

作者: zj1345 时间: 2014-4-1 10:31
顶!!!!!!!!!!

作者: NetBeetle 时间: 2014-4-1 10:32
顶......
楼下跟上.....

作者: gba8297517 时间: 2014-4-8 10:40
顶!!!!!!!!!!

作者: chen_0003 时间: 2014-4-8 10:43
顶起来…………

作者: zj1345 时间: 2014-4-8 10:44
(*^__^*) 嘻嘻……

作者: 教父 时间: 2014-4-8 10:45
顶！！！！！！！！！！！！！！！！！！！！！！！！！

作者: lw7511 时间: 2014-4-8 10:46
路过！！！
帮顶……

作者: 冰雨 时间: 2014-4-8 10:47
顶起来…………

作者: 千里独行 时间: 2014-4-8 10:49
路过！！！
帮顶……

作者: 嫣雨遥 时间: 2014-4-8 10:50
顶......
楼下跟上.....

作者: 宇航员 时间: 2014-4-11 11:04
(*^__^*) 嘻嘻……

作者: NetBeetle 时间: 2014-4-11 11:05
路过！！！
帮顶……

作者: ★の风の☆ 时间: 2014-4-11 11:06
顶起来…………

作者: leowave 时间: 2014-4-11 11:08
路过！！！
不发表意见……

作者: 嫣雨遥 时间: 2014-4-11 11:09
顶......
楼下跟上.....

作者: codywu 时间: 2014-4-11 11:10
(*^__^*) 嘻嘻……

作者: 慕容柔晴 时间: 2014-4-11 11:11
顶!!!!!!!!!!

作者: 泰安oim 时间: 2014-4-11 11:12
顶!!!!!!!!!!

作者: JHXT杰西卡 时间: 2014-4-11 11:14
顶！！！！！！！！！！！！！！！！！！！！！！！！！

作者: 入樽 时间: 2014-4-11 11:15
顶......
楼下跟上.....

作者: 中华！ 时间: 2014-4-11 11:16
路过！！！
帮顶……

作者: 嫣雨遥 时间: 2014-4-11 11:17
顶！！！！！！！！！！！！！！！！！！！！！！！！！

作者: 毫半字 时间: 2014-4-11 11:20
顶......
楼下跟上.....

作者: dgpeihua 时间: 2014-4-11 11:23
路过！！！
不发表意见……

作者: 江枫 时间: 2014-4-14 12:20
顶......
楼下跟上.....

欢迎光临 EaBIM (https://eabim.net/)