Showing posts with label bpm portal integration. Show all posts
Showing posts with label bpm portal integration. Show all posts

Monday, December 9, 2013

Webcenter Portal (Spaces) and Oracle BPM Integration - Part 2


Blog ini melanjutkan Webcenter Portal (Spaces) and Oracle BPM Integration - Part 1. Sekilas review, blog ini akan menjelaskan bagaimana caranya mengintegrasikan workspace yang ada di Oracle BPM ke dalam Webcenter Portal. Hal ini diperlukan apabila anda mengimplementasi Portal dan BPM bersamaan, tapi ingin BPM diakses melalui Portal. Sebelum membaca blog ini, silahkan terlebih dahulu membaca Part1-nya agar dapat lebih memahami langkah-langkah yang dilakukan dari awal :)

Prerequisite:


  • Webcenter Portal, Oracle BPM dan Webcenter Content sudah terinistall (tutorial ini menggunakan versi 11.1.1.7 untuk ketiga sistem)
  • Basic knowledge untuk navigasi ke folder-folder instalasi masing-masing komponen diatas :)
  • Membaca dan mengeksekusi Webcenter Portal (Spaces) and Oracle BPM Integration - Part 1

Langsung saja kita lanjutkan.

1. Masuk ke folder oracle_common/common/bin dan jalankan ./config.sh

2. Configuration Wizard terbuka. Pilih 'Extend my domain using an existing extension template'. Pilih template bpm yang ada di folder /templates/applications/oracle.bpm.spaces_template_11.1.1.jar. Ini akan meng-extend dan meng-include jar yang diperlukan oleh Webcenter Spaces anda untuk menjalankan workspace BPM. Lokasi template biasanya ada di: ~/Oracle_WC1/common/templates/applications/oracle.bpm.spaces_template_11.1.1.jar

3. Layar configuration summary akan terbuka, pilih Extend untuk meng-extend domain anda.
4. Progress screen tentunya :)
5. Copy folder berikut:
~/Oracle/Middleware/Oracle_SOA1/bpm/process_spaces/
ke ~/Oracle/Middleware/process_spaces. Edit file process-portal-install.properties. Berikut adalah contoh untuk environment yang saya gunakan. Anda dapat sesuaikan berdasarkan environment anda (Cluster, Database Name dsb). Pastikan property extendSoa = false.
################################################
# BPM Process Portal installation properties   #
################################################

#  Flag to decide whether to extend existing BPM domain or create a new one.
#  Set extendSoa to true, if the webcenter space and the SOA server are running in the same domain  
#  Set extendSoa to false, if the webcenter space and the SOA server are running in different domains
extendSoa=false

#  Flag to decide whether install will prompt for passwords or read them from this file
promptForPasswords=false

#
#  Setting up domain global trust
#  Provide information to set up trusted domains between the webcenter domain and the SOA domain
#
#  Flag to control whether to set domain realm password or not, set to true if extendSoa is false
wcSetDomainRealmPassword=true
#  This is the password to setup trusted domains. Same password should be set on BPM domain as well
wcDomainRealmPassword= password
wc.server.port=8888

#
#  Information of SOA server to which webcenter space is connected.
#

#  BPM Schema and MDS details
#  Provide the SOA MDS database and schema details here
bpmDBUser=DEV_SOAINFRA
bpmDBPassword= password
bpmDBType=ORACLE
bpmDBDriver=oracle.jdbc.OracleDriver
bpmDBUrl=jdbc:oracle:thin:@ORACLEDB:1521:ORCL


bpmMDSUser=DEV_MDS
bpmMDSPassword=password

#
#  BPM Runtime details
#  Provide the BPM server weblogic and admin credential here
#

# Specify the BPM server URL (t3://<bpmHost>:<bpmRuntimePort>) in the case of a single
# BPM server, ex- t3://myHost:8001
# In case of BPM Cluster provide the ',' separated list of BPM servers URL's (t3://<host1>:<port1>,<host2>:<port2>,...)
# for all the servers in the Cluster . Example: t3://myHost1:8001,myHost2:8002,myHost3:8003
bpmServerURL=t3://SOABPM1:8001

bpmAdminUser=weblogic
bpmAdminPassword=Passw0rd01


#
#  Information of the Webcenter server where process BPM process portal would be installed
#

#
#  Webcenter spaces installation details
#  Provide the webcenter space server information
#
#  Provide the oracle home location of the webcenter install (e.g. /Oracle/Middleware/Oracle_WC)
#  in wcOracleHome
wcOracleHome=/u01/app/oracle/product/fmw/wc
#  Provide the Webcenter domain name in wcDomainName
#  --if extendSoa flag has been set to true, Webcenter domain name should be the same as SOA domain name
#  --if extendSoa flag has been to false, Webcenter domain name will be different from SOA domain name
wcDomainName=domain_name



#Mention Whether the webcenter install is configured for cluster or not;
#pass 'true' if in cluster mode, 'false' otherwise
isWebcenterClusterConfig=false

#Required if 'isWebcenterClusterConfig' is set to true
# Specify the name of the webcenter spaces Cluster
wcSpacesClusterName=

#  Webcenter's weblogic installation details
wcHost=SOABPM1
wcAdminPort=7701
wcAdminUser=weblogic
wcAdminPwd= password

#In the case of a single server environment,
#specify the name of the Webcenter Spaces Managed server. In a clustered environment,
#specify the name of any one of the Spaces managed servers that is part of the Cluster.
wcManagedServerName=WC_Spaces


#Flag to control whether to configure services
wcConfigServices=true

#content server details
wcContentServerName=SOABPM1
wcContentServerPort=4444
wcContentSpacesRoot=/WebCenter0809
wcContentAdminUser=weblogic

#discussion server details
wcDiscussionServerUrl=http://SOABPM1:8890/owc_discussions
wcDiscussionAdminUser=weblogic


6. Jalankan ant script dengan memasukkan command berikut:


7. Build successful akan muncul apabila konfigurasi yang anda buat di tahap nomor 5 sudah benar.
8. PENTING!! Edit lagi file konfig di langkah nomor 5. Pastikan value extendSoa=true. Jalankan kembali script dengan mengeksekusi perintah di step nomor 6 dan hasil berikut muncul:



9. Restart Seluruh Managed Server dan Admin Server anda.

10. Masuk ke Weblogic Server /em. Navigasi ke server Webcenter Portal Anda. Pilih Application Configuration -> Service Configuration dan layar berikut akan muncul. Cek di bagian Content Repository, pastikan bahwa koneksi portal-content-server berhasil dibuat dan menjadi active connection.
11. Klik koneksi tersebut, ganti Administrator User Name menjadi user name admin anda (dalam kasus saya weblogic).
12. Cek juga di Discussion and Announcement, koneksi baru, portal-discussions berhasil juga dibuat.
13. Kedua tahap diatas menandakan bahwa konfigurasi anda berhasil dan BPM Workspace sudah dapat diakses melalui Spaces!

14. Log in ke dalam spaces dan anda akan menemukan Spaces baru bernama Process Spaces. Ini adalah BPM workspace yang telah terintegrasi ke dalam portal. Disini anda dapat log in, membuat task baru, membuka task yang di-assign kepada anda dan melakukan proses approval layaknya fungsionalitas yang ada di BPM.

Apabila anda membuat project BPM baru dan mendeploynya ke soa_infra, maka otomatis project/process ini akan muncul juga di Process Workspace yang ada di Webcenter Spaces. Akses user untuk menggunakan aplikasi di BPM sekarang sudah dapat diarahkan melalui portal!

Selamat! Anda berhasil mengintegrasikan BPM Workspace dan Spaces Anda.
Semoga membantu. See u in the next blog!




Webcenter Portal (Spaces) and Oracle BPM Integration - Part 1

Blok kali ini akan membahas bagaimana cara mengintegrasikan Oracle BPM Workspace ke dalam Webcenter Portal (Spaces). Apabila kita membangun aplikasi BPM yang berjalan di BPM workspace & Portal, akan terdapat 2 workspace, 1 portal dan 1 bpm workspace. Hal ini tentu tidak praktis, karena portal harusnya menjadi gerbang utama tempat user mengakses semua aplikasi, akan tetapi BPM workspace mempunyai URL sendiri yang berjalan di tempat yang berbeda dengan portal. 

Karena set up untuk proses ini cukup panjang, maka saya akan membagi blog menjadi 2 bagian. Bagian 1 ini akan menjelaskan persiapan yang diperlukan sebelum integrasi. Perlu diingat bahwa meskipun ini namanya 'Persiapan' dan terdengar sepele, tapi tahap ini harus dikerjakan terlebih dahulu agar tahap berikutnya dapat berjalan.

Problem:
  • Webcenter Portal dan BPM sudah terinstall, tapi memiliki URL yang berbeda. Akses ingin dilakukan melalui 1 gerbang yaitu Webcenter Portal.


Solution:
  • Menggabungkan workspace BPM ke dalam Webcenter Portal

Result:
  • User dapat mengakses BPM workspace melalui portal. Seluruh capability workspace BPM seperti inbox, initiate Process, Approve, Reject dsb dapat dilakukan melalui Webcenter Portal.
  • BPM composer juga dapat berjalan di Portal

Prerequisite:
  • Webcenter Portal, Oracle BPM dan Webcenter Content sudah terinistall (tutorial ini menggunakan versi 11.1.1.7 untuk ketiga sistem)
  • Basic knowledge untuk navigasi ke halaman-halaman administrasi masing-masing komponen diatas :)
Untuk memungkinkan hal diatas di portal, ikuti langkah-langkah dibawah ini. PENTING: langkah-langkah ini harus diikuti step by step sebelum anda masuk ke bagian inti yang saya jelaskan di Part 2.

1. Kita mulai dari webcenter Content. Buka Advanced Component Manager -> show All Components


2. Di bagian Disabled Components, klik Enable untuk komponen Folders_g
3. Lakukan hal yang sama untuk komponen WebCenterConfigure
4. Pastikan 2 komponen diatas masuk ke bagian Enabled Components berikut komponen dibawah:
- Dynamic Converter
- InboundRefinerySupport
- ZipRenditionManagement
5. Buka Applet User Admin. Add User baru dengan Authorization Type = Local dan nama PersonalSpaces
6. Untuk User tersebut, buat juga Role baru dengan menekan tombol Add Role
7. Beri nama PersonalSpaces untuk Name dari role baru tersebut
8. Lakukan Step 5-7, beri nama user dan role-nya ProcessPortal
9. Add Role = Process Portal
10. Masuk ke weblogic server /console. Masuk ke security realm yang anda gunakan. Buat Group baru dengan nama ProcessPortalUser
11. Masuk ke weblogic server /em. Masuk ke farm domain anda, navigasi ke instance Content Server anda. Masukkan filter IP address yang sesuai, dan masukkan Intradoc Server anda. Dalam contoh ini saya menggunakan 4444
12. Masuk ke instance Webcenter Portal anda. Add Repository Connection ke Webcenter Content dengan memasukkan detail berikut. PENTING!! Server Port harus sama dengan nilai yang anda masukkan di tahap 11.

13. Restart Admin Server, SOA Server dan Spaces anda.

Oke. Tahap persiapan sudah selesai :)
Untuk lanjut ke tahap inti dari integrasi, kita akan lanjut ke blog berikutnya: Webcenter Portal (Spaces) and Oracle BPM Integration - Part 2.
Selamat Mencoba!