首页 > 其他分享 >Teamcenter_NX集成开发:UF_UGMGR函数的使用

Teamcenter_NX集成开发:UF_UGMGR函数的使用

时间:2023-03-23 20:44:53浏览次数:54  
标签:UF errCode UGMGR NX Teamcenter part folder include

最近工作中经常使用Teamcenter、NX集成开发的情况,因此在这里记录UF_UGMGR函数的使用。使用UF_UGMGR相关函数需要有Teamcenter使用经验,理解Teamcenter中文件夹、伪文件夹、零组件、零组件版本、数据集、关系、表单、命名引用等对象。

相关的可以看帮助中 Teamcenter Integration for NX的内容 及 UF_UGMGR Overview 介绍的数据模型及使用方法、注意事项。

主要操作:

1-初始化UGMGR环境成功后就可以连接到Teamcenter。

2-获取指定ID编码零组件标识和Latest Working(没记错的话应该是最新版本)版本ID。

3-UF_UGMGR相关函数使用

  1 // Mandatory UF Includes
  2 #include <uf.h>
  3 #include <uf_object_types.h>
  4 #include <uf_ugmgr.h>
  5 #include <uf_part.h>
  6 #include <uf_disp.h>
  7 #include <uf_modl.h>
  8 #include <uf_obj.h>
  9 #include <uf_assem.h>
 10 
 11 // Internal+External Includes
 12 #include <NXOpen/Annotations.hxx>
 13 #include <NXOpen/Assemblies_Component.hxx>
 14 #include <NXOpen/Assemblies_ComponentAssembly.hxx>
 15 #include <NXOpen/Body.hxx>
 16 #include <NXOpen/BodyCollection.hxx>
 17 #include <NXOpen/Face.hxx>
 18 #include <NXOpen/Line.hxx>
 19 #include <NXOpen/NXException.hxx>
 20 #include <NXOpen/NXObject.hxx>
 21 #include <NXOpen/Part.hxx>
 22 #include <NXOpen/PartCollection.hxx>
 23 #include <NXOpen/Session.hxx>
 24 
 25 #include <NXOpen/PDM_PdmSession.hxx>
 26 #include <NXOpen/PDM_SoaConnectionHandle.hxx>
 27 #include <teamcenter/soa/client/Connection.hxx>
 28 #include <teamcenter/services/core/DatamanagementService.hxx>
 29 #include <teamcenter/soa/common/Version.hxx>
 30 
 31 // Std C++ Includes
 32 #include <iostream>
 33 #include <sstream>
 34 #include <stdio.h>
 35 #include <stdlib.h>
 36 
 37 using namespace NXOpen;
 38 using namespace Teamcenter::Soa::Client;
 39 using namespace Teamcenter::Services::Core;
 40 using std::string;
 41 using std::exception;
 42 using std::stringstream;
 43 using std::endl;
 44 using std::cout;
 45 using std::cerr;
 46 
 47 static int indent_level = 0;
 48 
 49 #define CHECK( func_ ) \
 50     ifail = (func_); \
 51 if (ifail != 0) {\
 52 printf("ERROR: %s returned %d", # func_, ifail); \
 53 return ifail;}
 54 
 55 #define PRINT( content_ ) \
 56 { int ii; \
 57 for (ii = 0; ii < indent_level; ii++) \
 58 { printf("  "); } \
 59     printf content_; \
 60     printf("\n"); }
 61 
 62 static int  list_in_part(UF_UGMGR_tag_t part)
 63 {
 64     int _errCode = 0;
 65     UF_UGMGR_tag_t*  revisions;
 66     int              i, j, k;
 67     int              count;
 68     int              dep_count;
 69     int              rev_count;
 70     char**           names;
 71     char**           file_types;
 72     char**           file_names;
 73     char             part_name[MAX_FSPEC_SIZE + 1];
 74     char             revision_id[UF_UGMGR_NAME_SIZE + 1];
 75     char             part_number[UF_UGMGR_NAME_SIZE + 1];
 76     if (part == UF_UGMGR_null_tag)
 77         return -1;
 78 
 79     _errCode = UF_UGMGR_ask_part_number(part, part_number);// 获取零组件ItemID
 80     PRINT(("Part: %s", part_number));
 81     indent_level++;
 82     _errCode = UF_UGMGR_list_part_revisions(part, &rev_count, &revisions);// 获取零组件所有版本
 83     for (j = 0; j < rev_count; j++)
 84     {
 85         _errCode = UF_UGMGR_ask_part_revision_id(revisions[j], revision_id);// 获取版本ID
 86         _errCode = UF_UGMGR_encode_part_filename(part_number, revision_id, "", "", part_name);// encode文件名
 87         PRINT(("Rev.: %s - Type: %s", revision_id, "master"));
 88         indent_level++;
 89 
 90         _errCode = UF_UGMGR_ask_dependent_files(part_name, &dep_count, &names);// 获取关联文件
 91         for (k = 0; k < dep_count; k++)
 92             PRINT(("Dependent files: %s", names[k]));
 93 
 94         indent_level--;
 95         if (dep_count > 0)
 96             UF_free_string_array(dep_count, names);
 97 
 98         _errCode = UF_UGMGR_list_part_rev_files(revisions[j], &count, &file_types, &file_names);// 列出版本下数据集
 99         for (i = 0; i < count; i++)
100         {
101             _errCode = UF_UGMGR_encode_part_filename(part_number, revision_id, file_types[i], file_names[i], part_name);// 根据ItemID、版本、文件类型、文件名encode成新的文件名
102             PRINT(("Rev.: %s - Type: %s, Name: %s", revision_id, file_types[i], file_names[i]));
103             indent_level++;
104             _errCode = UF_UGMGR_ask_dependent_files(part_name, &dep_count, &names);// 获取关联文件
105             for (k = 0; k < dep_count; k++)
106                 PRINT(("Dependent files: %s", names[k]));
107 
108             indent_level--;
109             if (dep_count > 0)
110                 UF_free_string_array(dep_count, names);
111         }
112         if (count > 0){
113             UF_free_string_array(count, file_types);
114             UF_free_string_array(count, file_names);
115         }
116     }
117     indent_level--;
118     UF_free(revisions);
119     revisions = NULL;
120     return _errCode;
121 }
122 
123 static int list_in_folder(UF_UGMGR_tag_t folder)
124 {    
125     int _errCode = 0;
126     char folder_name[UF_UGMGR_NAME_SIZE + 1];
127     if (folder == UF_UGMGR_null_tag) return -1;
128 
129     _errCode = UF_UGMGR_ask_folder_name(folder, folder_name);// 获取文件夹名称
130     PRINT(("Folder: %s", folder_name));
131     indent_level++;
132 
133     UF_UGMGR_object_type_t object_type;
134     int root_folder_contents_count = 0;
135     UF_UGMGR_tag_t * folder_contents = NULL;
136     _errCode = UF_UGMGR_list_folder_contents(folder, &root_folder_contents_count, &folder_contents);// 列出文件夹下的所有文件
137     for (int idx = 0; idx < root_folder_contents_count; idx++)
138     {
139         _errCode = UF_UGMGR_ask_object_type(folder_contents[idx], &object_type);// 获取文件类型
140         switch (object_type)
141         {
142         case UF_UGMGR_type_folder:
143             list_in_folder(folder_contents[idx]);// 是文件夹
144             break;
145         case UF_UGMGR_type_part:
146             list_in_part(folder_contents[idx]);// 是零组件
147             break;
148         default:
149             printf("Invalid object type found");
150             break;
151         }
152     }
153     UF_free(folder_contents);
154     folder_contents = NULL;
155     indent_level--;
156     return _errCode;
157 }
158 
159 void do_it()
160 {
161     int _errCode = 0;
162 
163     tag_t partTag = NULL_TAG;
164     UF_PART_load_status_t error_status;
165     UF_UGMGR_tag_t database_part_tag = NULL_TAG;
166     UF_UGMGR_tag_t part_revision = NULL_TAG;
167     UF_UGMGR_tag_t root_folder_tag = NULL_TAG;
168     UF_UGMGR_tag_t user_folder_tag = NULL_TAG;
169 
170     char current_rule[UF_UGMGR_NAME_BUFSIZE] = { 0 };
171     char revision_id[UF_UGMGR_NAME_BUFSIZE] = { 0 };
172     char export_dir_name[MAX_FSPEC_BUFSIZE] = { 0 };
173     char encoded_name[MAX_FSPEC_BUFSIZE] = { 0 };
174     char user_role[UF_UGMGR_ROLE_BUFSIZE] = { 0 };
175 
176     _errCode = UF_UGMGR_ask_part_tag("000000000AA000082", &database_part_tag);// 获取编码为000000000AA000082的部件标识
177     _errCode = UF_UGMGR_ask_config_rule(current_rule);// 获取默认配置规则
178     std::cout << "默认配置规则:" << current_rule << std::endl;
179     _errCode = UF_UGMGR_set_config_rule("Latest Working");// 设置配置规则
180     _errCode = UF_UGMGR_ask_configured_rev(database_part_tag, &part_revision);// 获取配置版本
181     _errCode = UF_UGMGR_ask_part_revision_id(part_revision, revision_id);// 获取版本ID
182 
183     _errCode = UF_UGMGR_ask_root_folder(&root_folder_tag);// 获取用户根文件夹,即HOME文件夹标识
184     _errCode = UF_UGMGR_ask_user_folder("infodba", &user_folder_tag);// 获取用户文件夹
185     _errCode = UF_UGMGR_ask_user_role(user_role);// 获取用户角色
186 
187     std::cout << "\n=================用户文件夹下文件=================" << std::endl;
188     _errCode = list_in_folder(root_folder_tag);// 列出该文件夹下地下所有文件夹和零组件
189     std::cout << "=================用户文件夹下文件=================\n" << std::endl;
190 
191     int config_rules_count = 0;
192     char ** config_rules = NULL;
193     _errCode = UF_UGMGR_list_config_rules(&config_rules_count, &config_rules);// 列出所有配置规则,并打印到控制台
194     std::cout << "\n=================所有配置规则=================" << std::endl;
195     for (int idx = 0; idx < config_rules_count; idx++)
196         std::cout << config_rules[idx] << std::endl;
197     UF_free(config_rules);
198     config_rules = NULL;
199     std::cout << "=================所有配置规则=================\n" << std::endl;
200 
201     int file_count = 0;
202     char** file_types = NULL;
203     char** file_names = NULL;
204     _errCode = UF_UGMGR_list_part_rev_files(part_revision, &file_count, &file_types, &file_names);// 列出版本下所有数据集文件
205     if (file_count <= 0) return;
206 
207     for (int idx = 0; idx < file_count; idx++){
208         if (file_names[idx] == NULL) continue;
209 
210         _errCode = UF_UGMGR_encode_part_filename("000000000AA000082", revision_id, file_types[idx], file_names[idx], encoded_name);// encode组成文件名
211         _errCode = UF_PART_open(encoded_name, &partTag, &error_status);// NX后台打开
212         _errCode = UF_UGMGR_ask_export_directory(partTag, export_dir_name);// 获取export文件夹目录
213         std::cout << "临时export文件夹目录:" << export_dir_name << std::endl;
214         _errCode = UF_PART_free_load_status(&error_status);
215         _errCode = UF_PART_close(partTag, 1, 1);
216     }
217     if (file_count > 0){
218         UF_free_string_array(file_count, file_names);
219         UF_free_string_array(file_count, file_types);
220     }
221     file_types = NULL;
222     file_names = NULL;
223 }
224 
225 //===================
226 // Entry Point
227 //===================
228 int main(int argc, char* argv[])
229 {
230     try{
231         int _errCode = 0;
232         const char** consolePara = (const char**)(argv);
233         logical is_active;
234         _errCode = UF_is_ugmanager_active(&is_active);// 判断ugmanager环境是否已经初始化
235         if (!is_active)
236             _errCode = UF_UGMGR_initialize(argc, consolePara);// 初始化ugmanager环境
237         do_it();
238         _errCode = UF_UGMGR_terminate();
239         return _errCode;
240     }
241     catch (const NXException& e1){
242         cerr << "NXException: " << e1.ErrorCode() << endl;
243         cerr << e1.Message() << endl;
244     }
245     catch (const exception& e2){
246         cerr << "Exception: " << e2.what() << endl;
247     }
248     catch (...){
249         cerr << "Unknown Exception: " << endl;
250     }
251 }
View Code

 

调试截图:

 

NX版本配置规则截图:

 

 

版本规则解释:

 

Teamcenter对象介绍:中文是自动翻译的,不准确。详细请看帮助文档:Siemens 文档: Teamcenter Integration for NX

 

标签:UF,errCode,UGMGR,NX,Teamcenter,part,folder,include
From: https://www.cnblogs.com/huangym1/p/17246405.html

相关文章

  • Nginx面试
    1Nginx负载均衡算法nginx的upstream目前支持4种方式的分配0)、轮询(默认)每个请求按时间顺序逐一分配到不同的后端服务器,如果后端服务器down掉,能自动剔除。1)、wei......
  • ASEMI代理NXP汽车芯片MCIMX6S5DVM10ACR
    编辑-Zi.MX6Solo/6DualLite消费品应用处理器MCIMX6S5DVM10ACR处理器代表了以多媒体为重点的集成产品的最新成就,提供了低成本的高性能处理以及低功耗的优化。 该处理......
  • PCF7939MA/CABC0800-ASEMI代理NXP汽车芯片
    编辑-ZNXP汽车芯片PCF7939MA/CABC0800参数描述:型号:PCF7939MA/CABC0800制造商:NXPSemiconductors种类:NFC/RFID标签和应答器存储容量:456b工作频率:125kHz最大工作温......
  • Nginx安装部署
    title:Nginx安装部署date:2022-10-26tags:-Linux-Nginxcategories:-运维-Nginxkeywords:'Linux,Nginx'description:Nginx安装部署cover:https://q......
  • 源码安装nginx,平滑升级nginx,nginx认证和访问控制
    Nginx是俄罗斯人编写的十分轻量级的HTTP服务器是一个高性能的HTTP和反向代理服务器,同时也是一个IMAP/POP3/SMTP代理服务器【官方网站:http://nginx.org】源码安装Nginx#......
  • onnx模型获取每一层的属性
    importonnx#加载ONNX模型model_path="model.onnx"model=onnx.load(model_path)#遍历模型的图结构,获取每一层的节点属性fornodeinmodel.graph.node:#......
  • Linux 中间件 | Nginx 支持 perl-cgi
    本文环境,AmazonLinuxrelease2,全程用root用户。前提是已经装好了Nginx,并且有--with-http_perl_module模块。没有则参考添加一、首先确认并安装perl-FCGIrpm-q......
  • nginx配置auth_basic登录认证的方法
    有时候我们通过nginx搭建了一台文件服务器,一般来讲是公开的,但我们又希望该服务器不让他人看到,有人可能会搭建一个登录系统,但是太麻烦,也没太大必要,比较简单的做......
  • Nginx 的多进程异步模型要了解下么
    Ngnix是互联网企业使用最为广泛的高性能的反向代理服务器,为何叫反向代理之前也讲过。它可以为后端分布式服务提供负载均衡的功能,它可以将后端多个服务地址聚合为单个地址来......
  • nginx的location与proxy_pass指令超详细讲解及其有无斜杠( / )结尾的区别
    本文所使用的环境信息如下:windows11(主机系统)virtual-box-7.0环境下的ubuntu-18.04nginx-1.22.1(linux)斜杠结尾之争实践中,nginx里最常用的指令就是location和pr......