Tutorial

Appschef.com adalah SAAS dari Indonesia yang dibuat menggunakan Ruby on Rails. Berikut ini langkah – langkah untuk menggunakan Appschef API dari Aplikasi Ruby on Rails 3.2 dengan gem w_platform:

  • Signup dan Daftarkan produk / aplikasi Anda di http://appschef.com
  • Login ke Apsschef.com dan dapatkan API_KEY untuk produk / aplikasi yang anda daftarkan
  • Edit Gemfile aplikasi Rails anda dan tambahkan code berikut:
gem 'w_platform', :git => 'git@github.com:febyartandi/w_platform.git'
  • Di terminal run:
$ bundle install
$ rails generate w_initializer install
  • Kemudian Edit file config/w_platform.yml sesuai dengan konfigurasi aplikasi Anda, berikut contohnya:
common: &default_settings
w_api_url_users: /api/users/
w_api_url_get_active_session: /api/login
#nama aplikasi / produk Anda
app_name: w_factory_operations
development:
<< *default_settings
# link ke website appschef
appschef_url: https://appschef.com
# ganti dengan Api key produk / aplikasi Anda
api_key: xxxxxxxxxxxxxxxxxxxxxxxx
# link ke website Anda
app_url: http://localhost:3000
# protokol yang digunakan ( pilihan bisa http atau https )
protocol: https
#nama controller dan action yang dijadikan root (“/”) di Aplikasi Anda
root_controller: home
root_action: index
  • Definisikan “key” untuk setiap fitur yang ada di aplikasi Anda.

Untuk menentukan fitur apa saja yang ada di Aplikasi Anda, Appschef mengharuskan anda untuk membuat daftar fitur dan “key” sebagai representatifnya. List itu harus anda buat dalam excell dan upload ke Appschef.com.

Kemdian setelah itu anda definisikan fitur tersebut di aplikasi anda dengan edit file config/w_features.yml, berikut contohnya:

home:
index: wfo_home_index
projects:
new: wfo_project_new
show: wfo_project_show

Keterangan:

home, Projects => Nama Controller

index, new, show => Nama Action

wfo_home_index  => Contoh  ‘key’ untuk fitur “home/index”

  • Mount Routes WPlatform dengan edit config/routes.rb dan tambahkan code berikut:
mount WPlatform::Engine => “/”, :as => “w_platform”
  • Include WPlatformHelper dan tambahkan before filter untuk check access user ke fitur yang ada di Aplikasi Anda. Sebagai contoh Anda dapat Edit application_controller.rb dan tambahkan 2 line berikut:
include WPlatformHelper
before_filter :check_user_access
  • Langkah terakhir, Run server aplikasi Anda, kemdian login dari server appschef dan pilih untuk membuka Aplikasi Anda.

Tips

  • Anda dapat mendefinisikan controllers dan actions yang tidak memerlukan check authentikasi dengan cara berikut ini:
before_filter :check_user_access_but_skip_some_actions
protected
def check_user_access_but_skip_some_actions
check_user_access([{:controller_name => “about”, :action_name => “index”}])
end
  • Anda dapat menggunakan helper yang tersedia, yaitu:

current_user_platform =>return has semua result data yang diberikan oleh Appschef server

current_company => return hash data company

current_products => return has data products

current_features => return hash fitur – fitur yang boleh diakases user

  • Menambahkan link logout
<%= link_to “Logout”, w_platform.new_authentication_session_cleaner_path, :confirm => “Anda yakin untuk logout ? ?”%>

Bug Report

Jika Anda menemukan bug dalam tutorial ini atau gem w_platform, harap hubungi saya melalui email ke: feby.a@wgs.co.id

Terima kasih.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

Tag Cloud

%d bloggers like this: