Catia CAA开发-获取文档属性
0
最
近的项目也快结束了，第一次接触Catia的二次开发，对于一个以前完全没有学过Catia的人来说，当时感觉这似乎是不可能完成的任务。Catia二次开发多数是以VB进行，网上的资料也偏VB居多，而我们偏偏选择了CAA,使用C++开发。网上关于CAA的二次开发相关资料不多，但是CAA自带了很详细的说明文档，类库，和大量示例程序（虽然我至今也仍未跑成功过它的例子）。现在就准备将项目开发过程中一些认为比较重要的部分记录下来。
在项目中，有一个很重要的功能，就是上传Catia文件。普通的上传文档并不困难，但关键在于Catia文件带有相链接的文档，比如CATProduct文件,所以需要在程序中自动找到Catia文件的相链接的文档。
起初，在帮助文档中找到一篇关于Retrieving a Product's Properties的文章，其中介绍了如何打印一个文档的属性。首先它获得文档的根CATIProduct对象，然后获得它的所有孩子GetAllChildren()，这个方法将获得CATIProduct对象的所有孩子，并且不分层次。然后使用CATIAttributesDescription类来获得CATIProduct的属性名，最后通过CATIInstance对象获得属性名对应的属性值，从CATIProduct获得CATIAttributesDescription和CATIInstance对象的操作如下：
CATIProduct *iInstanceProd;
......
CATIAttributesDescription *piAttrDesc = NULL;
iInstanceProd->QueryInterface(IID_CATIAttributesDescription, (void **) &piAttrDesc);
CATIInstance *piInstance = NULL;
rc = iInstanceProd->QueryInterface(IID_CATIInstance, (void **) &piInstance);
接着就可以使用CATIAttributesDescription的List()方法将属性获取到一个CATListValCATAttributeInfos对象中，然后就是对CATListValCATAttributeInfos的一个遍历过程。
CATListValCATAttributeInfos attrInfoList;
piAttrDesc->List(&attrInfoList);
for (int i = 1; i <= attrInfoList.Size(); i++)
{
CATAttributeInfos attrInfo = attrInfoList[i];
const CATUnicodeString& propertyName = https://www.wendangku.net/doc/ac3921505.html,(); //属性名
const CATUnicodeString& valueType = attrInfo.Type()->Name(); //属性类型
CATIValue *pValue = piInstance->GetValue(propertyName); //获得对应属性名的属性值
}
上面方式是在不知道有什么属性的时候将所有属性都获取出来，如果知道属性名称的话，直接通过CATIInstance的GetValue(..)就可以获取该属性名的属性值，比如零部件号的属性名对应的是PartNumber，还有一些用户自定义的参数也可以同样获取到。到这时，我认为通过它能够获得文档的路径，因为里面有一个属性名DefaultRepSource，就是默认的链接文档源，的确在测试中，通过该属性也能获取部分文档的保存路径，但只限于CATPart文件，而对于CATProduct文件却是NULL,找了很多方法，但是通过使用CATIInstance对象来获取CATProduvt孩子中的CATProduct文件地址还是不行。
如何获
得孩子的所有文档路径，只能寻找别的方法。于是发现了CATIxPDMItem这个类，这个类很强大，它可以获得文档的所有属性，还有文档是否需要保存等信息。如何获得CATIxPDMItem的实例，版本不同CAA还是有区别，r_16之上和r_14（r_15没试过）的获取CATIxPDMItem对象方法完全不同，两个版本的CATIxPDMItem的方法也不同，虽然高版本的保留了低版本的方法。至于如何获取CATIxPDMItem对象，r_14版本中需要使用到CATxPDMSession对象，而r-16版本则使用CATxPDMSessionServices的静态方法，这里只说r_16版本的（可以在类库中查找CATIxPDMItem，查看不同版本的获得该对象方法）。
CATIxPDMItem_var mItem;
CATDocument *pDoc;
CATxPDMSessionServices::GetItemFromDocument(pDoc,mItem);
以上方法将pDoc中获得CATIxPDMItem对象。
现在看一下CATIxPDMItem的方法：
GetChildren(CATLISTV(CATBaseUnknown_var)&,CATLISTP(CATMathTransformation)这是保留的低版本中的获取孩子的方法
GetChildrenItems(CATListValCATIxPDMItem_var&,CATLISTP(CATMathTransformation)
两个方法都是获得CATIxPDMItem当前下一层的孩子，但是对于再下一层的孩子无法获得，所以如果要获得所有孩子需要递归或者迭代的方法。
GetDocFileName(CATUnicodeString& ) 该方法可以获得文档的保存路径
GetDocId(CATIDocId* ) CATIDocId是一个很基本的包含文档属性的类，通过它也可以获得文档路径，还有文档类型
GetItemType(CATUnicodeString& ) 获得文档类型，由于在r_14版本中并没有该方法，所以在r_14中需要间接的从CATIDocId获得文档类型
GetProperty(CATUnicodeString&,CATUnicodeString& )获得指定属性名的属性值
SetProperty(CATUnicodeString&,CATUnicodeString& ) 设置指定属性名的值
标准的属性名有：
? CN_PART_NUMBER 零部件号
? CN_REVISION 版本
? CN_DEFINITION 定义
? CN_NOMENCLATURE
? CN_DESCRIPTIONREF 描述
? CN_SOURCE 文档源，通过它也可以获得文档路径，但是我在尝试文档重定位的时候，并未成功？
? 。。。。。
? 下面是获得所有相联子部件的递归函数
[code]
void GetSource(CATIxPDMItem_var mItem)
{
HRESULT rc;
CATUnicodeString strSource;
CATUnicodeString strType;
CATUnicodeString strName;
CATListValCATIxPDMItem_var oChildrenList;
CATLISTP(CATMathTransformation) oChildrenLocationList ;
rc=mItem-> GetChildrenItems( oChildrenList, oChildrenLocationList) ;
if(SUCCEEDED (rc))
{
int n=oChildrenList.Size();
for (int i = 1; i <= n; i++) {
CATIxPDMItem_var item=oChildrenList[i];
if(SUCCEEDED(item->GetItemType(strType)))
{
item->GetDocFileName(strSource) ;
if(strType=="CATPart" )
{
cout<<"CATPart , 文件 "<
else if(strType=="CATProduct" )
{
cout<<"CATProduct , 文件 "<
}
}
}
}
}
[/code]