Skip to content

xhoy/otrs_connector

 
 

Repository files navigation

otrs_connector

otrs_connector connects to the OTRS API, with some modifications that opens up more of the OTRS/ITSM internals. By default only the ticketing system is opened to the external API in OTRS. Please see my other github project, rails_otrs to download the latest OTRS modifictions so that this will work correctly.

otrs_connector supports OTRS 3.2.9 (tested)

This gem makes extensive use of ActiveModel and ActiveSupport (json encoding/decoding). It is tested with both Rails 3.0.x and Rails 3.1.x and should work with 3.2.x

How to install

or Add to your gemfile:

gem 'otrs_connector'

Configuration Options

Put these in your environment configuration, change based on your setup:

OTRS.user = 'rails'
OTRS.password = 'rails'
OTRS.api_url = 'http://localhost/otrs/json.pl'

The username/password should be setup as agents in your OTRS setup. Make sure the agent has proper permissions to access what you need from the API. The API url is the custom API interface file described above. This will change once 3.1 support is added

OTRS side of

install the IPhone handle package (doc.otrs.org/3.0/en/html/adminarea-package-manager.html) make make sure you have the right permissions in otrs in sysconfig:

iPhone::API::Object###TicketObject => (MoveList|MoveTicket|TicketGet|Ticket|NumberLookup|TicketSearch)

These are minimal needs (not tested any further).

Usage

1.9.3-p0 :006 > OTRS::Ticket.search(:TicketNumber => "100001")
=> 2
1.9.3-p0 :005 > OTRS::Ticket.find(2)
=> #<OTRS::Ticket:0xabb9c84 ..... >
more to come…

Contributing to otrs_connector

  • Check out the latest master to make sure the feature hasn’t been implemented or the bug hasn’t been fixed yet.

  • Check out the issue tracker to make sure someone already hasn’t requested it and/or contributed it.

  • Fork the project.

  • Start a feature/bugfix branch.

  • Commit and push until you are happy with your contribution.

  • Make sure to add tests for it. This is important so I don’t break it in a future version unintentionally.

  • Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.

Copyright © 2012 Brian Goff. See LICENSE.txt for further details.

About

Connect your rails app to OTRS/ITSM

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Ruby 100.0%