最近工作中经常使用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 3 #include 4 #include 5 #include 6 #include 7 #include 8 #include 9 #include 10 11 // Internal+External Includes 12 #include 13 #include 14 #include 15 #include 16 #include 17 #include 18 #include 19 #include 20 #include 21 #include 22 #include 23 #include 24 25 #include 26 #include 27 #include 28 #include 29 #include 30 31 // Std C++ Includes 32 #include 33 #include 34 #include 35 #include 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 ) 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 ) 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 ) 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 ) 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 ) 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 ) 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 "默认配置规则:" 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 ) 196 std::cout 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 ){ 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文件夹目录:" 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: " endl; 243 cerr endl; 244 } 245 catch (const exception& e2){ 246 cerr "Exception: " endl; 247 } 248 catch (...){ 249 cerr "Unknown Exception: " endl; 250 } 251 }
View Code
调试截图:
NX版本配置规则截图:
版本规则解释:
Teamcenter对象介绍:中文是自动翻译的,不准确。详细请看帮助文档:Siemens 文档: Teamcenter Integration for NX
服务器租用托管,机房租用托管,主机租用托管,https://www.e1idc.com