Tích hợp FileNet với IBM Content Manager, Phần 3: Triển khai thực hiện các trình diễn công việc dựa vào Component Integrator

Tích hợp FileNet với IBM Content Manager, Phần 3: Triển khai thực hiện các trình diễn công việc dựa vào Component Integrator Giới thiệu về FileNet P8 Component Integrator Hãy đọc tất cả các bài viết trong loạt bài này 1. Phân tích, thiết kế và mô hình hóa khi sử dụng FileNet Business Process Manager và IBM Content Manager. 2. Triển khai thực hiện các thực thể nghiệp vụ Java và lớp cổng (gateway) cho dữ liệu trong kho lưu trữ của IBM Content Manager. 3. Triển khai thực hiện các trình diễn công việc dựa vào Component Integrator. 4. Tạo một quy trình các yêu cầu bồi thường bảo hiểm tự động bằng Vùng làm việc FileNet. FileNet P8 Component Integrator giúp cho có khả năng tương tác với một thực thể bên ngoài được gọi là một thành phần có thể hoặc là một đối tượng Java hoặc Java Messaging System (JMS - Hệ thống thông điệp Java). Bạn có thể sử dụng nó để nhập khẩu các lớp Java và quản lý giao tiếp giữa máy quy trình và các giao diện. Component Integrator bao gồm các bộ điều hợp là các giao diện để giao tiếp các sự kiện từ máy quy trình đến các thực thể bên ngoài như là các đối tượng Java. Các bộ điều hợp tương tác với các kiểu các thành phần khác nhau từ một bước của dòng công việc. Hình 1 cho thấy các bước mà bạn cần thực hiện để tạo một hàng đợi thành phần Java trong Component Integrator. Hình 1. Các bước để tạo ra một trình diễn công việc thành phần Java trong Component Integrator Như được thể hiện trong biểu đồ trên, bước đầu tiên là cấu hình và triển khai thành phần (1). Bạn có thể sử dụng Bàn điều khiển cấu hình quy trình P8 của FileNet (FileNet P8 Process Configuration Console) để tạo ra một hàng đợi thành phần (2 và 3). Tiếp theo, triển khai các tệp jar cần thiết cho thành phần trên máy chủ Máy Ứng dụng và đăng ký thành phần trong Process Task Manager (Nhà quản lý nhiệm vụ quy trình) (4 và 5). Process Designer (Nhà thiết kế quy trình) lấy thông tin cấu hình từ Máy Quy trình (Process Engine) (6). Sau đó tạo các định nghĩa dòng công việc. Bạn có thể tạo ra một bước thành phần và chọn thành phần và phương thức đã đăng ký để gọi. Bạn cũng cần phải xác định các trường dòng công việc sẽ được chuyển qua làm các tham số cho phương thức trong thời gian chạy (7). Các định nghĩa dòng công việc (các yêu cầu cho công việc) sau đó được chuyển tới các hàng đợi của Máy Quy trình (8). Hình 2 mô tả sự tương tác trong thời gian chạy giữa Component Integrator và các dịch vụ của Máy Ứng dụng như là nhà quản lý thành phần, các hàng đợi của máy quy trình và một thực thể tùy chỉnh được hiển thị trong cùng hình đó. Khi quy trình dòng công việc được thực hiện, Component Manager lấy yêu cầu từ các hàng đợi thành phần và gọi các thành phần thông qua các bộ điều hợp. Với mỗi bước trong dòng công việc, chuỗi các sự kiện chung sau đây sẽ diễn ra. Đầu tiên, thông tin được gửi đến thành phần qua bộ điều hợp. Sau đó, thành phần thực hiện công việc của mình và tương tác với thực thể tùy chỉnh. Cuối cùng, kết quả công việc được lưu trong bước này. Hình 2. Sự tương tác trong thời gian chạy của Component Integrator Chúng ta sẽ giới thiệu cách Component Integrator làm việc trước khi chúng ta triển khai thực hiện trình diễn công việc của Component Integrator. Chúng ta định nghĩa một hoạt động quy trình liên kết các giá trị tham số với một phương thức thành phần. Khi sử dụng các hoạt động quy trình, chúng ta có thể chuyển các giá trị của các trường mục công việc đến một phương thức thành phần. Khi một dòng công việc đang chạy có một mục công việc đạt đến một bước thành phần (một thành phần đã được tạo ra như là một bước trong một dòng công việc), Component Integrator tự động thực hiện một loạt các hoạt động. Phương thức này tự động đọc các giá trị của trường mục công việc, chờ một đáp ứng từ phương thức thành phần, cập nhật các giá trị của trường mục công việc theo bất kỳ các thay đổi nhận được từ việc thực hiện phương thức thành phần này, lưu mục công việc và mở khóa nó. Cuối cùng, phương thức hoàn thành bước này bằng cách gửi mục công việc tới một bước tiếp theo. Về đầu trang Triển khai thực hiện Component Integrator dựa trên trình diễn công việc Bây giờ bạn cần có một sự hiểu biết cơ bản về cách triển khai thực hiện một trình diễn công việc dựa vào Component Integrator. Đây là lúc xem xét năm bước chính sau đây để hoàn thành việc triển khai thực hiện này. 1. Triển khai một lớp Java tùy chỉnh. 2. Sử dụng Process Configuration Console (Bàn điều khiển cấu hình quy trình) để tạo ra một hàng đợi thành phần và định nghĩa các hoạt động của hàng đợi thành phần. 3. Sử dụng Process Task Manager (Nhà quản lý nhiệm vụ quy trình) để bắt đầu và kết thúc Component Manager (Nhà quản lý thành phần) và bắt đầu và ngừng các thành phần. 4. Sử dụng Nhà thiết kế quy trình (Process Designer) để tạo ra một quy trình nghiệp vụ và thêm hàng đợi thành phần Java đã đăng ký vào quy trình. 5. Sử dụng Vùng làm việc FileNet để xác nhận hợp lệ quy trình nghiệp vụ. Trong phần 2, bạn đã tạo ra Các thực thể nghiệp vụ Java (Java Business Entities) cho kho lưu trữ IBM Content Manager cũng như lớp cổng cho các phương thức hoạt động của Các thực thể nghiệp vụ Java. Bây giờ bạn sẽ đăng ký lớp cổng vào Component Integrator để tạo ra một hàng đợi thành phần. Sau đó, bạn có thể sử dụng tất cả các phương thức hoạt động trong định nghĩa quy trình. Sau đó, quy trình nghiệp vụ có thể tự do tương tác với kho lưu trữ IBM Content Manager qua hàng đợi thành phần này. Các phần sau mô tả cách làm điều đó. Về đầu trang Triển khai một lớp Java tùy chỉnh Có ba phần cho lớp Java tùy chỉnh.  Các thực thể nghiệp vụ Java.  Lớp cổng (gateway).  Tệp cấu hình và lớp Dịch vụ ủy quyền và xác thực thực Java (JAAS-Java Authentication and Authorization Service). Các thực thể nghiệp vụ Java và lớp cổng đã được triển khai thực hiện trong Phần 2. Ở đây bạn chỉ cần tạo tệp cấu hình và lớp JAAS. Tại sao bạn cần tệp cấu hình và các lớp JAAS? Lý do là FileNet P8 Component Integrator sử dụng JAAS để thực hiện xác thực. Bạn nên tạo ra mô đun xác thực JAAS và tệp cấu hình đăng nhập cho lớp các thực thể nghiệp vụ Java. Để cấu hình JAAS, bạn cần hoàn thành 5 bước sau đây: 1. Đầu tiên, tạo một lớp LoginModule cho hệ thống mà lớp tuỳ chỉnh truy cập vào. Bạn có thể làm theo Hướng dẫn của Nhà phát triển mô đun đăng nhập và Hướng dẫn xác thực JAAS để tạo ra các lớp LoginModule. SampleLoginModule.java triển khai thực hiện việc xác thực bên dưới mong muốn. Xác thực người dùng của SampleLoginModule chỉ đơn giản kiểm tra xem tên và mật khẩu mà người sử dụng nhập vào đã có giá trị cụ thể chưa. Mã nguồn của SampleLoginModule được hiển thị dưới đây. Liên kết 1. Mã loginModule mẫu - SampleLoginModule.java public class SampleLoginModule implements LoginModule { private Subject m_subject; private CallbackHandler m_callbackHandler; private Map m_sharedState; private Map m_options; private String m_username = null; private boolean m_validSession = true; // testUser's SamplePrincipal private SamplePrincipal m_principal; public void initialize(Subject subject, CallbackHandler callbackHandler, Map sharedState, Map options) { this.m_subject = subject; this.m_callbackHandler = callbackHandler;; this.m_options = options; this.m_sharedState = sharedState; } public boolean login() throws LoginException { if (m_callbackHandler == null) { throw new LoginException("Error: no CallbackHandler available to get authentication information"); } String password = null; m_username = (String)m_sharedState.get("javax.security.auth.login.name"); password = (String)m_sharedState.get("javax.security.auth.login.password"); if (m_username == null) { Callback[] callbacks = null; callbacks = new Callback[3]; callbacks[0] = new TextOutputCallback(TextOutputCallback.INFORMATION, "Sample Authentication"); callbacks[1] = new NameCallback("user name:"); callbacks[2] = new PasswordCallback("password:", false); try { m_callbackHandler.handle(callbacks); m_username = ((NameCallback)callbacks[1]).getName(); char[] tmpPassword = ((PasswordCallback)callbacks[2]).getPassword(); if (tmpPassword != null) password = new String(tmpPassword); else password = null; ((PasswordCallback)callbacks[2]).clearPassword(); m_sharedState.put("javax.security.auth.login.name",m_username); m_sharedState.put("javax.security.auth.login.password", password); } catch (java.io.IOException ioe) { throw new LoginException(ioe.toString()); } catch (UnsupportedCallbackException uce) { throw new LoginException("Error: no CallbackHandler available to get authentication information"); } } try { } catch (Exception e) {; throw new LoginException(e.toString()); } m_validSession = true; return (m_validSession); } ... } SamplePrincipal.java là một lớp mẫu triển khai thực hiện giao diện java.security.Principal. Nó thường do SampleLoginModule sử dụng. Liên kết 2. Mã mẫu chính - SamplePrincipal.java public class SamplePrincipal implements Principal, java.io.Serializable { private String name; public SamplePrincipal( String name ) { if( name == null ) throw new NullPointerException( "illegal null input" ); this.name = name; } public String getName() { return name; } public String toString() { return ("SamplePrincipal: " + name); } public boolean equals( Object o ) { if( o == null ) return false; if( this == o ) return true; if( !(o instanceof SamplePrincipal) ) return false; SamplePrincipal that = (SamplePrincipal) o; if( this.getName().equals( that.getName() ) ) return true; return false; } public int hashCode() { return name.hashCode(); } ... } 2. Thứ hai, tạo ra một tệp jar để sắp xếp lớp Java tùy chỉnh và các lớp LoginModule tương ứng. Bạn cần phải gói các lớp LoginModule của JAAS và lớp cổng vào trong tệp jar này. Để cho thuận tiện, bạn cũng có thể tải tệp jar có tên ICMOperations.jar từ phần Tải về. 3. Sau đó, tạo ra một tệp Cấu hình đăng nhập JAAS chứa một phần LoginContext. Các mã sau đây cho thấy tệp cấu hình đăng nhập này. Bạn có thể thêm văn bản vào tệp cấu hình JAAS mặc định của bộ định tuyến (Router) FileNet taskman.login.config . Tệp này nằm trong thư mục filenet_installation_directory/AE/Router. Bạn có thể nhận được tệp taskman.login.config trong phần Tải về. Liên kết 3. Cấu hình JAAS Sample { filenet.vw.server.VWLoginModule required; com.ibm.cm.businesslogic.operations.jaas.SampleLoginModule required debug=true; }; 4. Tiếp theo, triển khai tệp Cấu hình đăng nhập JAAS, tệp JAR tùy chỉnh và các tệp JAR cần thiết bằng cách sao chép các tệp này vào vị trí triển khai trên máy chủ Máy Ứng dụng. Trên thực tế, bạn cũng có thể sao chép các tệp này vào bất kỳ vị trí nào bạn muốn. Nói chung, nó sẽ là thư mục filenet_installation_directory/AE/Workplace/WEB-INF/lib. 5. Cuối cùng, kết thúc Component Manager và chỉ rõ tệp JAR tùy chỉnh mà bạn đã tạo ra như là một trong các thư viện Java cần thiết trong Component Manager. Trong Hình 3, chúng ta thêm tệp JAR ICMOperation.jar và cũng như các tệp JAR có liên quan. Bạn có thể tải các tệp JAR relatedJARFiles.zip trong phần Tải về. Hình 3. Thêm tệp JAR và các tệp JAR có liên quan vào Component Manager Lưu ý: Nếu lớp Java đã bao gồm các mô đun phụ thuộc không nằm trong tệp JAR cũng như không nằm trong các thư viện cần thiết hiện có, thì cần chỉ rõ các tệp jar chứa các mô dun phụ thuộc làm các thư viện cần thiết. Do các thực thể nghiệp vụ Java đang sử dụng OOAPI của Content Manager để giao tiếp với kho lưu trữ của Content Manager, bạn nên lập danh mục cơ sở dữ liệu trước khi thực hiện chúng. Hãy tham khảo hướng dẫn này để thực hiện danh mục đó Về đầu trang Tạo một hàng đợi thành phần và định nghĩa các hoạt động hàng đợi thành phần Bạn sử dụng Bàn điều khiển cấu hình nghiệp vụ để tạo và cấu hình một hàng đợi thành phần cho lớp Java hoặc hàng đợi JMS tùy chỉnh đã triển khai. Chỉ có một lớp hoặc hàng đợi JMS mới có thể được kết hợp với một hàng đợi thành phần của Máy Quy trình duy nhất. Tuy nhiên, bạn có thể cấu hình nhiều hàng đợi thành phần cho bất kỳ lớp hoặc hàng đợi JMS cụ thể nào bằng cách gán các tên khác nhau cho các hàng đợi thành phần bổ sung. Để có các hướng dẫn, xem Cấu hình các hàng đợi phần hàng (Configuring Component Queues). Trong hệ thống Yêu cầu bồi thường bảo hiểm tự động của Công ty ABC, bạn có thể chỉ đăng ký một thành phần Java, thật dễ dàng để thiết kế quy trình nghiệp vụ bằng cách sử dụng Nhà thiết kế quy trình (Process Designer). Bây giờ bạn sẽ đăng ký một hàng đợi thành phần mới theo từng bước một. Trước tiên, khởi chạy Bàn điều khiển cấu hình quy trình của Bàn làm việc FileNet và đăng ký các lớp bổ sung cho thành phần Java này. Hình 4 cho thấy bước này. Nếu tệp JAR của thành phần Java có một số tệp jar hoặc các tệp lớp Java có liên quan, bạn nên đăng ký chúng trước khi tạo ra các hàng đợi thành phần Java mới . Hình 4. Thêm tệp JAR và các tệp JAR có liên quan vào Component Manager Sau khi đăng ký một số tệp jar bổ sung, bạn tạo một hàng đợi thành phần Java mới. Bạn có thể chỉ định bất kỳ tên nào muốn. Hình 5 cho thấy bước này. Hình 5. Tạo một hàng đợi thành phần Java mới Bây giờ, chọn bộ điều hợp Java cho hàng đợi thành phần Java. Bạn có thể chọn tệp jar trong đó có lớp Java tùy chỉnh và lớp cấu hình JAAS. Trong trường hợp của chúng ta, đó là tệp ICMOperation.jar. Bạn cũng nên chọn lớp Java tùy chỉnh trưng ra tất cả các phương thức hoạt động. Trong trường hợp tương tự, đó là tệp ICMOperation.class. Hình 6 cho thấy bước này. Hình 6. Cấu hình các tệp bộ điều hợp Java Trong bước này, thiết lập các đặc tính bộ điều hợp Java và ủy quyền JAAS như tên người dùng, mật khẩu và ngữ cảnh cấu hình. Trong trường hợp này, nhập vào cấu hình sau như Hình 7 cho thấy. Hình 7. Cấu hình các đặc tính bộ điều hợp Java và và ủy quyền JAAS Trong Hình 8, thiết lập các phương thức hoạt động mà bạn muốn trưng ra. Chỉ các phương thức chung mới có thể được trưng ra. Hình 8. Cấu hình các hoạt động. Cuối cùng, lưu hàng đợi thành phần đã tạo ra. Hình 9 cho thấy bước này. Hình 9. Lưu hàng đợi thành phần đã tạo ra Bây giờ bạn đã tạo ra một hàng đợi thành phần có thể trưng ra tất cả các phương thức/hàm của các thực thể nghiệp vụ Java. Về đầu trang Làm mới tất cả các cấu hình Sau khi bạn đã tạo ra hàng đợi thành phần mới, hãy làm mới tất cả các cấu hình bằng Process Task Manager (Nhà quản lý nhiệm vụ quy trình) để làm cho hàng đợi thành phần đã tạo có sẵn trong Component Manager. Hình 10 cho thấy bước này. Hình 10. Làm mới tất cả các cấu hình Bây giờ bạn có thể nhìn thấy hàng đợi thành phần đã tạo ra có sẵn trong nhà quản lý thành phần, như Hình 11 cho thấy. Hình 11. Hàng đợi thành phần mới có sẵn trong Component Manager Sau tất cả các cấu hình này, bạn có thể trực tiếp sử dụng hàng đợi thành phần mới này trong quy trình nghiệp vụ. Bạn có thể thấy các phương thức hàng đợi thành phần có sẵn trong Nhà thiết kế quy trình (Process Designer). Hình 12 cho thấy các phương thức hàng đợi thành phần. Hình 12. Hàng đợi thành phần đã tạo ra ICMOperations có sẵn trong Nhà thiết kế quy trình Về đầu trang Kết luận Trong phần 3, bạn đã đăng ký các đối tượng thực thể nghiệp vụ Java của hệ thống Yêu cầu bồi thường bảo hiểm tự động của công ty ABC đã tạo ra của bạn vào FileNet P8 Component Integrator, đã sử dụng Process Task Manager để xử lý hàng đợi thành phần mới và đã làm cho hàng đợi thành phần này có sẵn cho quy trình nghiệp vụ. Phần 4 sẽ mô tả cách sử dụng FileNet Business Process Designer (Nhà thiết kế quy trình nghiệp vụ FileNet) để triển khai thực hiện một định nghĩa dòng công việc để sử dụng hàng đợi thành phần vừa mới được tạo và cách thực hiện quy trình nghiệp vụ này.