Teamcenter_NX集成开发：UF_UGMGR_invoke_pdm_server函数的使用

之前了解到通过UFUN函数UF_UGMGR_invoke_pdm_server可以调用Teamcenter ITK函数，从而可以获取及编辑Teamcenter对象。UFUN中有样例代码，但是就是不知道怎么使用，今天下午看了帮助文档，想到需要把ITK的USER_invoke_pdm_server函数进行注册，就进行测试，没想到给写通了。在此记录代码调试过程，转载请注明出处。

注意事项：

　　1-需要了解Teamcenter Handler注册过程。

　　2-Teamcenter开发方面可以参考微信公众号：PLMCODE

NX工程代码：

  1 //================================
  2 // UF_UGMGR_invoke_pdm_server
  3 //================================
  4 //tcnx_project
  5
  6 // Mandatory UF Includes
  7 #include <uf.h>
  8 #include <uf_object_types.h>
  9 #include <uf_draw.h>
 10 #include <uf_part.h>
 11 #include <uf_ugmgr.h>
 12
 13 #include <NXSigningResource.cpp>
 14
 15 // Internal Includes
 16 #include <NXOpen/ListingWindow.hxx>
 17 #include <NXOpen/NXMessageBox.hxx>
 18 #include <NXOpen/UI.hxx>
 19 #include <NXOpen/LogFile.hxx>
 20
 21 // Internal+External Includes\
 22 #include <NXOpen/Annotations.hxx>
 23 #include <NXOpen/Assemblies_Component.hxx>
 24 #include <NXOpen/Assemblies_ComponentAssembly.hxx>
 25 #include <NXOpen/Body.hxx>
 26 #include <NXOpen/BodyCollection.hxx>
 27 #include <NXOpen/Face.hxx>
 28 #include <NXOpen/Line.hxx>
 29 #include <NXOpen/NXException.hxx>
 30 #include <NXOpen/NXObject.hxx>
 31 #include <NXOpen/Part.hxx>
 32 #include <NXOpen/PartCollection.hxx>
 33 #include <NXOpen/Session.hxx>
 34
 35 #include <NXOpen/PDM_SoaConnectionHandle.hxx>
 36 #include <NXOpen/PDM_PdmSession.hxx>
 37 #include <NXOpen/PDM_PdmSearch.hxx>
 38 #include <NXOpen/PDM_PdmFile.hxx>
 39 #include <NXOpen/PDM_PdmNavigatorNode.hxx>
 40 #include <NXOpen/PDM_PdmPart.hxx>
 41 #include <NXOpen/PDM_PdmSearchManager.hxx>
 42 #include <NXOpen/PDM_SoaQuery.hxx>
 43 #include <NXOpen/PDM_SearchResult.hxx>
 44
 45 #include <NXOpen/PrintPDFBuilder.hxx>
 46 #include <NXOpen/PlotManager.hxx>
 47 #include <NXOpen/Drawings_DrawingSheet.hxx>
 48 #include <NXOpen/NXObjectManager.hxx>
 49
 50 // Std C++ Includes
 51 #include <iostream>
 52 #include <sstream>
 53 #include <vector>
 54 #include <string>
 55 #include <algorithm>
 56 #include <tchar.h>
 57 #include <atlconv.h>
 58 #include <shellapi.h>
 59
 60 #include <windows.h>
 61 #undef CreateDialog
 62 #pragma comment(lib,"shell32.lib")
 63
 64 #define CREATION_DATE       1
 65 #define MODIFICATION_DATE   2
 66 #define MAX_UGMGR_NAME_LEN 1024
 67
 68 using namespace NXOpen;
 69 using std::string;
 70 using std::exception;
 71 using std::stringstream;
 72 using std::endl;
 73 using std::cout;
 74 using std::cerr;
 75
 76 NXOpen::ListingWindow *lw = NULL;
 77 NXOpen::NXMessageBox *mb = NULL;
 78
 79 #define UF_CALL(X) (report_error( __FILE__, __LINE__, #X, (X)))
 80 int report_error(char *file, int line, char *call, int code)
 81 {
 82     if (code){
 83         stringstream errmsg;
 84         errmsg << "Error " << code << " in " << file << " at line " << line << endl;
 85         errmsg << call << endl;
 86         cerr << errmsg.str();
 87         throw NXOpen::NXException::Create(code);
 88     }
 89     return(code);
 90 }
 91
 92 void print(const NXString &);
 93 void print(const string &);
 94 void print(const char*);
 95 int invokePdmServer();
 96 int invokePdmServer()
 97 {
 98     int _errCode = 0;
 99     _errCode = UF_CALL(UF_UGMGR_initialize(0, NULL));
100
101     char        part_name[MAX_UGMGR_NAME_LEN + 1] = "000015200AA000000";
102     int         output_code = -1;
103     char*       date = NULL;
104
105     _errCode = UF_CALL(UF_UGMGR_invoke_pdm_server(CREATION_DATE, part_name, &output_code, &date));
106     print("\nAfter calling UF_UGMGR_invoke_pdm_server()\n");
107     print("Part          : " + string(part_name));
108     print("creation date : " + string(date));
109     print("output_code   : " + std::to_string(output_code) + "\n\n");
110     UF_free(date);
111     date = NULL;
112
113     UF_UGMGR_terminate();
114     return _errCode;
115 }
116
117 extern "C" DllExport void ufusr( char *parm, int *returnCode, int rlen )
118 {
119     try
120     {
121         invokePdmServer();
122         return;
123     }
124     catch (const NXException& e1)
125     {
126         UI::GetUI()->NXMessageBox()->Show("NXException", NXOpen::NXMessageBox::DialogTypeError, e1.Message());
127     }
128     catch (const exception& e2)
129     {
130         UI::GetUI()->NXMessageBox()->Show("Exception", NXOpen::NXMessageBox::DialogTypeError, e2.what());
131     }
132     catch (...)
133     {
134         UI::GetUI()->NXMessageBox()->Show("Exception", NXOpen::NXMessageBox::DialogTypeError, "Unknown Exception.");
135     }
136 }
137
138 extern "C" DllExport int ufusr_ask_unload()
139 {
140     return (int)NXOpen::Session::LibraryUnloadOptionImmediately;// 调试用
141     //return (int)NXOpen::Session::LibraryUnloadOptionAtTermination;// 程序发布用
142     //return (int)NXOpen::Session::LibraryUnloadOptionExplicitly;
143 }
144
145 void print(const NXString &msg)
146 {
147     if (!lw->IsOpen()) lw->Open();
148     lw->WriteLine(msg);
149 }
150 void print(const string &msg)
151 {
152     if (!lw->IsOpen()) lw->Open();
153     lw->WriteLine(msg);
154 }
155 void print(const char * msg)
156 {
157     if (!lw->IsOpen()) lw->Open();
158     lw->WriteLine(msg);
159 }

Teamcenter Handler工程代码：

 1 //======================================
 2 // libA2CustStudy_register_callbacks
 3 //======================================
 4
 5 //=======================
 6 // libA2CustStudy.h
 7 //=======================
 8 #ifndef TCHANDLER_STUDY_H
 9 #define TCHANDLER_STUDY_H
10
11 #pragma once
12 #include <bom/bom.h>
13 #include <ict/ict_userservice.h>
14 #include <epm\epm_access_control.h>
15 #include <epm\epm_task_template_itk.h>
16 #include <epm\epm.h>
17 #include <epm\epm_toolkit_iman_utils.h>
18 #include <epm/epm_toolkit_tc_utils.h>
19 #include <pie/sample_err.h>
20 #include <tc/tc.h>
21 #include <tc/iman.h>
22 #include <tccore/custom.h>
23 #include <tccore/aom_prop.h>
24 #include <user_exits/user_exits.h>
25 #include <tccore/workspaceobject.h>
26
27 #include <tccore/aom.h>
28 #include <tccore/item.h>
29 #include <base_utils/Mem.h>
30
31 #include "register_custom_user_service.h"
32
33
34 #ifdef __cplusplus
35 extern "C"
36 {
37 #endif
38
39     extern DLLAPI int libA2CustStudy_register_callbacks();
40     int libA2CustStudy_invoke_pdm_server(int *decision, va_list args);
41
42 #ifdef __cplusplus
43 }
44 #endif
45
46 #endif

 1 //=======================
 2 // libA2CustStudy.cpp
 3 //=======================
 4 #include "libA2CustStudy.h"
 5
 6 #define CUST_TCHANDLER_STUDY "libA2CustStudy"
 7
 8 extern DLLAPI int libA2CustStudy_register_callbacks()
 9 {
10     int stat = ITK_ok;
11     stat = CUSTOM_register_exit(CUST_TCHANDLER_STUDY, "USER_invoke_pdm_server", (CUSTOM_EXIT_ftn_t)libA2CustStudy_invoke_pdm_server);
12     stat == ITK_ok ? printf("(libA2CustStudy.dll)-函数libA2CustStudy_invoke_pdm_server返回值为ITK_ok,注册成功!!!\n") : printf("(libA2CustStudy.dll)-函数libA2CustStudy_invoke_pdm_server返回值不等于ITK_ok,注册失败!!!\n");
13     return stat;
14 }

 1 //=======================
 2 // lib_register_custom.cpp
 3 //=======================
 4 #include "libA2CustStudy.h"
 5
 6 #define CREATION_DATE     1
 7 #define MODIFICATION_DATE 2
 8
 9 #ifdef __cplusplus
10 extern "C"
11 {
12 #endif
13
14     int libA2CustStudy_invoke_pdm_server(int *decision, va_list args)
15     {
16         /***********  va_list for USER_invoke_pdm_server ***********/
17         int  input_code = va_arg(args, int);          /* args 1 */
18         char *input_string = va_arg(args, char *);    /* args 2 */
19         int  *output_code = va_arg(args, int *);      /* args 3 */
20         char **output_string = va_arg(args, char **); /* args 4 */
21         /***********************************************************/
22         printf("\t libA2CustStudy_invoke_pdm_server \n\n");
23         *decision = ALL_CUSTOMIZATIONS;
24
25         tag_t             item_tag;
26         int               itkfail;
27         WSO_description_t description;
28         char              createDate[WSO_date_size_c + 1];
29         char              modifyDate[WSO_date_size_c + 1];
30         char              objectName[WSO_date_size_c + 1];
31         char              objectType[WSO_date_size_c + 1];
32         char              ownersName[WSO_date_size_c + 1];
33         char              owning_group_name[WSO_date_size_c + 1];
34         char              last_modify_user_name[WSO_date_size_c + 1];
35         char              object_desc[WSO_date_size_c + 1];
36         *output_code = 0;
37         char tmp_output_string[1024] = { 0 };
38
39         itkfail = ITEM_find_item(input_string, &item_tag);
40         if (itkfail != ITK_ok){
41             printf("Failed to find item %s\n", input_string);
42             *output_code = 1;
43         }
44
45         itkfail = WSOM_describe(item_tag, &description);
46         if (itkfail != ITK_ok){
47             printf("Failed to get description of the item\n");
48             *output_code = 1;
49         }
50
51         printf("ITK USER_invoke_pdm_server() routine :\n");
52         printf("INPUT:\n");
53         printf("input_code    : %d\n", input_code);
54         printf("input_string  : %s\n\n", input_string);
55
56         switch (input_code){
57         case CREATION_DATE:
58         case MODIFICATION_DATE:
59             strcpy_s(object_desc, strlen(description.date_created) + 1, description.description);
60             strcpy_s(createDate, strlen(description.date_created) + 1, description.date_created);
61             strcpy_s(modifyDate, strlen(description.date_modified) + 1, description.date_modified);
62             strcpy_s(objectName, strlen(description.object_name) + 1, description.object_name);
63             strcpy_s(objectType, strlen(description.object_type) + 1, description.object_type);
64             strcpy_s(ownersName, strlen(description.owners_name) + 1, description.owners_name);
65             strcpy_s(owning_group_name, strlen(description.owning_group_name) + 1, description.owning_group_name);
66             strcpy_s(last_modify_user_name, strlen(description.last_modifying_user_name) + 1, description.last_modifying_user_name);
67             sprintf_s(tmp_output_string, "date_created=%s\ndate_modified=%s\nobject_name=%s\nobject_type=%s\nowners_name=%s\nowning_group_name=%s\nlast_modify_user_name=%s\nobject_desc=%s\n",
68                 createDate, modifyDate, objectName, objectType, ownersName, owning_group_name, last_modify_user_name, object_desc);
69             break;
70         default:
71             printf("OUTPUT:该参数 %d 未定义操作!\n", input_code);
72             break;
73         }
74         if (strlen(tmp_output_string) > 0){
75             *output_string = (char*)malloc(sizeof(tmp_output_string));
76             strcpy_s(*output_string, strlen(tmp_output_string) + 1, tmp_output_string);
77             printf("OUTPUT:\n");
78             printf("output_string : %s (%s)\n", *output_string, (input_code == 1) ? "CREATION DATE" : "MODIFICATION DATE");
79             printf("output_code   : %d\n", *output_code);
80         }
81         return ITK_ok;
82     }
83
84 #ifdef __cplusplus
85 }
86 #endif

Teamcenter零组件属性截图：

工程调试运行GIF动图：

2023年03月25日 16点52分发布。转载请注明出处！！！