如何将这个Ruby文件合并到Rails中？

Question

I have this Ruby file:

freshdesk.rb:

 require "rest_client"
 require 'nokogiri'

 class Freshdesk

 # custom errors
 class AlreadyExistedError < StandardError; end
 class ConnectionError < StandardError; end

 attr_accessor :base_url

 def initialize(base_url, username, password)

 @base_url = base_url

 RestClient.add_before_execution_proc do | req, params |
  req.basic_auth username, password
 end
end

# Freshdesk API client support "GET" with id parameter optional
#   Returns nil if there is no response
def self.fd_define_get(name, *args)
  name = name.to_s
  method_name = "get_" + name

define_method method_name do |*args| 
  uri = mapping(name)
  uri.gsub!(/.xml/, "/#{args}.xml") if args.size > 0

    begin
      response = RestClient.get uri
    rescue Exception
      response = nil
    end
  end
end

# Freshdesk API client support "DELETE" with the required id parameter
def self.fd_define_delete(name, *args)
  name = name.to_s
  method_name = "delete_" + name

  define_method method_name do |args|
    uri = mapping(name)
    raise StandardError, "An ID is required to delete" if args.size.eql? 0
    uri.gsub!(/.xml/, "/#{args}.xml")
    RestClient.delete uri
  end
end

# Freshdesk API client support "POST" with the optional key, value parameter
#
#  Will throw: 
#    AlreadyExistedError if there is exact copy of data in the server
#    ConnectionError     if there is connection problem with the server
def self.fd_define_post(name, *args)
  name = name.to_s
  method_name = "post_" + name

  define_method method_name do |args|
    raise StandardError, "Arguments are required to modify data" if args.size.eql? 0
    uri = mapping(name)

    builder = Nokogiri::XML::Builder.new do |xml|
      xml.send(doc_name(name)) {
        args.each do |key, value|
          xml.send(key, value)
        end
      }
    end

    begin 
      response = RestClient.post uri, builder.to_xml, :content_type => "text/xml"

    rescue RestClient::UnprocessableEntity
      raise AlreadyExistedError, "Entry already existed"

    rescue RestClient::InternalServerError
      raise ConnectionError, "Connection to the server failed. Please check hostname"

    rescue RestClient::Found
      raise ConnectionError, "Connection to the server failed. Please check username/password"

    rescue Exception => e3
      raise
    end   

    response   
  end
end

# Freshdesk API client support "PUT" with key, value parameter
#
#  Will throw: 
#    ConnectionError     if there is connection problem with the server
def self.fd_define_put(name, *args)
  name = name.to_s
  method_name = "put_" + name

  define_method method_name do |args|
    raise StandardError, "Arguments are required to modify data" if args.size.eql? 0
    raise StandardError, "id is required to modify data" if args[:id].nil?
    uri = mapping(name)

    builder = Nokogiri::XML::Builder.new do |xml|
      xml.send(doc_name(name)) {
        args.each do |key, value|
          xml.send(key, value)
        end
      }
    end

    begin 
      uri.gsub!(/.xml/, "/#{args[:id]}.xml")
      response = RestClient.put uri, builder.to_xml, :content_type => "text/xml"

    rescue RestClient::InternalServerError
      raise ConnectionError, "Connection to the server failed. Please check hostname"

    rescue RestClient::Found
      raise ConnectionError, "Connection to the server failed. Please check username/password"

    rescue Exception => e3
      raise
    end   

    response   
  end
end

[:tickets, :ticket_fields, :users, :forums, :solutions, :companies].each do |a|
  fd_define_get a
  fd_define_post a  
  fd_define_delete a
  fd_define_put a
end


# Mapping of object name to url:
#   tickets => helpdesk/tickets.xml
#   ticket_fields => /ticket_fields.xml
#   users => /contacts.xml
#   forums => /categories.xml
#   solutions => /solution/categories.xml
#   companies => /customers.xml
def mapping(method_name)
  path = case method_name
    when "tickets" then File.join(@base_url + "helpdesk/tickets.xml")
    when "ticket_fields" then File.join( @base_url, "ticket_fields.xml")
    when "users" then File.join(@base_url, "contacts.xml")
    when "forums" then File.join(@base_url + "categories.xml")
    when "solutions" then File.join(@base_url + "solution/categories.xml")
    when "companies" then File.join(@base_url + "customers.xml")
  end
end

# match with the root name of xml document that freskdesk uses
def doc_name(name)
  doc = case name 
      when "tickets" then "helpdesk_ticket"
      when "ticket_fields" then "helpdesk-ticket-fields"
      when "users" then "user"
      when "companies" then "customer"
      else raise StandardError, "No root object for this call"
    end
  end
end

To use it I do:

client = Freshdesk.new("http://website.freshdesk.com/", "API KEY", "X") 

# example posts a ticket
client.post_tickets(:subject => 'This is from the rails app',:email => "mytestemail@example.com", :description => "This is from the ruby file bitches", :name => "Richard Ahn", :source => 2, :priority => 2, :name => "Joshua Siler")

Then, in my console I do:

$ ruby freshdesk.rb

The information that gets called with client.post_tickets gets posted to my Freshdesk dashboard.

How do I integrate this into my Rails app?

Where do I put the file with the class name FRESHDESK ?

What do I do with:

client = Freshdesk.new 
client.post_tickets 

How do I link this up with a form that the user can submit?

Answer 1

File should go in the lib folder.

Now, to get data from a form, I'll first create a form.

<%= form_for(@client) do |f| %>
  <%= f.label :subject %>
  <%= f.text_field :subject %>
  <%= f.label :name%>
  <%= f.text_field :name %>
  <%= f.label :description %>
  <%= f.text_field :description %>
  ...
<% end %>

and in the controller where the @client POST for new record (create method) enter this code

def create
  client = Freshdesk.new "http://website.freshdesk.com/", "API KEY", "X"
  client.post_tickets(params[:client])
  ...
end