Presentation at Oracle OpenWorld 2011

1. Extending Oracle
E-Business Suite
with
Ruby on Rails

2. Raimonds Simanovskis
github.com/rsim
@rsim
.com

3. Why to extend
Oracle
E-Business
Suite?

4. Customize or extend
functionality

5. Embed EBS data in
other systems

6. Simplify and make
usable

7. Simplify and make
usable

8. Simplify and make
usable

9. How to extend
Oracle
E-Business
Suite?

10. Release 11, 1998
Custom
Forms, Reports,
PL/SQL
PL/SQL

11. Self-Service Web
Applications 11, 1998
PL/SQL generated
web pages
PL/SQL

12. Self-Service Web
Applications 11i, 2000
PL/SQL => JSP
Java

13. OA Framework 11i,
~2005
JSP => full MVC
framework
Java

14. OA Framework 12,
2007
or maybe move to
ADF?
“My general advice is to stick with OAF so
long as you are working with the E-Business
Suite, and wait until you move to the Fusion
Applications before moving to ADF” Java
-- Steven Chan

15. Oracle E-Business
Suite today
ADF?
Java
“Extending Oracle E-Business Suite with
Oracle ADF and Oracle SOA Suite”
APEX?
PL/SQL
“New Whitepaper: Extending E-Business Suite
12.1.3 using Oracle Application Express”

16. Do not blindly
trust what
Oracle is
recommending...

17. Many Open-Source
Web Technologies
CSS 3
Raphaël.js

18. What is
Ruby on
Rails?

19. Ruby is
object-oriented
dynamic
programming language
simple from outside
Yukihiro
Matsumoto
or “Matz” powerful inside

20. Ruby on Rails
Web applications development framework
Developed in Ruby
Extracted from 37signals Basecamp application
Open source software
Focused on developer productivity
Agile software development approach

21. Main principles
DRY - Don’t Repeat Yourself
Convention over Configuration
Opinionated software

22. MVC Architecture
Request Router Database
SQL
Browser
Response
Action Active
Controller Record
Action
View

23. Active Record (Model)
class CreatePosts < ActiveRecor::Migration
def self.up
create_table :posts do |t| CREATE TABLE posts (
t.string :title id NUMBER(38) NOT
t.text :body NULL,
t.timestamps title VARCHAR2(255),
end body CLOB,
end created_at DATE,
end updated_at DATE
);
CREATE SEQUENCE posts_seq;
class Post < ActiveRecord::Base
# nothing here!
end
post = Post.new
post.title = "First post"
post.save
post = Post.find(1)
puts post.name # output: "First post"

24. Action Controller
class PostsController < ApplicationController
def index
@posts = Post.all
end
def show
@post = Post.find(params[:id])
end
def new
@post = Post.new
end
# ...
end

25. Action View
<h1>Posts</h1>
<% @posts.each do |post| %>
<h2><%= post.title %></h2>
<h3>Created at <%= post.created_at %></h3>
<p><%= post.body %></p>
<% end %>

26. ActiveRecord
Oracle enhanced
adapter

27. Multi-platform support
oracle_enhanced adapter
Ruby 1.8.7 Ruby 1.9.2 JRuby
ruby-oci8 ruby-oci8 JDBC

28. Oracle Data Types
Ruby Rails Oracle
Fixnum :integer NUMBER
Float :float NUMBER
BigDecimal :decimal NUMBER, DECIMAL
Time :datetime DATE
Time :time DATE
Date :date DATE
String :string VARCHAR2
String :text CLOB
String :binary BLOB
True/FalseClass :boolean NUMBER(1), CHAR(1)

29. Existing database
schemas
class Employee < ActiveRecord::Base
set_table_name "hr_employees"
set_primary_key "employee_id"
set_sequence_name "hr_employee_s"
set_date_columns :hired_on, :birth_date_on
set_datetime_columns :last_login_time
set_boolean_columns :manager, :active
ignore_table_columns :attribute1, :attribute2
end

30. PL/SQL calls from Ruby
(old way)
require "oci8"
conn = OCI8.new("hr","hr","xe")
cursor = conn.parse <<-EOS
BEGIN
:return := test_uppercase(:p_string);
END;
EOS
cursor.bind_param(':p_string',"xxx",String)
cursor.bind_param(':return',nil,String,4000)
cursor.exec
puts cursor[':return']
cursor.close

31. ruby-plsql library
gem install ruby-plsql
require "ruby-plsql"
plsql.connect! "hr","hr","xe"
puts plsql.test_uppercase('xxx')

32. ruby-plsql library
plsql.connect! "hr","hr","xe"
plsql.test_uppercase('xxx') # => "XXX"
plsql.test_uppercase(:p_string => 'xxx') # => "XXX"
plsql.test_copy("abc", nil, nil) # => { :p_to => "abc",
# :p_to_double => "abcabc" }
plsql.test_copy(:p_from => "abc", :p_to => nil, :p_to_double => nil)
# => { :p_to => "abc",
# :p_to_double => "abcabc" }
plsql.hr.test_uppercase('xxx') # => "XXX"
plsql.test_package.test_uppercase('xxx') # => 'XXX'
plsql.hr.test_package.test_uppercase('xxx') # => 'XXX'
plsql.logoff

33. class Employee < ActiveRecord::Base
set_create_method do
plsql.employees_pkg.create_employee(
:p_first_name => first_name,
ActiveRecord :p_last_name => last_name,
:p_employee_id => nil
)[:p_employee_id]
with end
set_update_method do
PL/SQL plsql.employees_pkg.update_employee(
:p_employee_id => id,
:p_first_name => first_name,
CRUD )
:p_last_name => last_name
procedures end
set_delete_method do
plsql.employees_pkg.delete_employee(
:p_employee_id => id
)
end
end

34. Demo

35. Ruby on Rails on Oracle
E-Business Suite
Request Router
Browser Oracle EBS Database
Response
XXAPP schema
Action additional
Controller application tables
EBS module
EBS module
EBS module
schemas
EBS module
Action schemas
schemas
schemas
View APPS schema
XXAPP_% views
Active XXAPP_% packages
Record

36. Additional
Ruby libraries
database_loader
oracle_ebs_authentication
ruby-plsql-spec

37. Deployment options
Application source
Apache Java app sever
Application WAR file
Ruby mod_passenger
JRuby Gems
Application Application

38. References

39. Rails on Oracle
E-Business Suite
mytime
mydata
crmdata

46. Why Rails?
Fast agile / iterative development
Test-driven development support
Flexible HTML/CSS/JavaScript front-end
Easy to put on top of legacy applications
Libraries for all new “cool” technologies
Open-source with liberal license

47. More information
Demo app source code:
https://github.com/rsim/rails_ebs_demo
http://github.com/rsim/oracle-enhanced
http://blog.rayapps.com