Project

updox

0.0
No commit activity in last 3 years
No release in over 3 years
updoxweinfuse/updoxHomepageDocumentationSource CodeBug TrackerWiki
Ruby wrapper for the Updox API
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
27,332
Stars
0
Forks
0
Watchers
10
 Releases
Current version
1.0.2
Total releases
15
First release
2020-01-21
Latest release
2020-12-29
 Issues
Open Issues
1
Closed Issues
0
Total Issues
1
Issue Closure Rate
0%
 Pull Requests
Open Pull Requests
0
Closed Pull Requests
0
Merged Pull Requests
37
Pull Request Acceptance Rate
100%
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2020-03-12
Reverse Dependencies
0

 Dependencies

Development

bundler
>= 1, < 3
byebug
~> 11
minitest
~> 5.0
rake
~> 13.0
webmock
~> 3.1
yard
~> 0.9

Runtime

hashie
~> 3.5
httparty
~> 0.17
 Project Readme

CircleCI

Updox

Ruby API wrapper for Updox

Installation

Add this line to your application's Gemfile:

gem 'updox'

And then execute:

$ bundle

Or install it yourself as:

$ gem install updox

Usage

Setup

Make sure you're configured!

auth = Updox::Models::Auth.new

response = auth.ping # No authentication needed!

response = auth.ping_with_application_auth # Check if you're app auth is working!

Practice

The practice is what Updox calls 'Account' access so anywhere the account_id is required is relating back to this practice instance.

Create

practice = Updox::Models::Practice.new(name: 'LOL LTD', account_id: '0001', active: true)
practice.create

List

practices = Updox::Models::Practice.query.practices

Find

practice = Updox::Models::Practice.find('0001')

Location

Create

location = Updox::Models::Location.new(active: true, name: 'My Location', code: 'ML01', id: '27')
location.save(account_id: practice.account_id)

# Bulk
Location.sync([l0, l1], account_id: practice.account_id)

Query

locations = Updox::Models::Location.query(account_id: '0001')

Find

There is no find in the api, we are doing a ruby find on the query - so use the cached_query option if you are doing a bunch of lookups

location = Updox::Models::Location.find(27, account_id: '0001')

cached_query_results = Updox::Models::Location.query(account_id: '0001')

10.times do |id|
  Updox::Models::Location.find(id, account_id: '0001', cached_query: cached_query_results)
end

Exists?

See note on Location#find method about caching

Updox::Models::Location.exists?(27, account_id: '0001')

cached_query_results = Updox::Models::Location.query(account_id: '0001')

10.times do |id|
  Updox::Models::Location.exists?(id, account_id: '0001', cached_query: cached_query_results)
end

Calendar

See Location for simliar #query, #find and #exists? methods

Create

calendar = Updox::Models::Calendar.new(active: true, title: 'My Calendar', id: 'C1')
calendar.create(account_id: practice.account_id)

Patient

Create

patient = Updox::Models::Patient.new(id: 'X0001', internal_id: 'X0001', first_name: 'Brian', last_name: 'Brianson', mobile_number: 5126914360, active: true)
patient.save(account_id: practice.account_id)

# Bulk
Patient.sync([p0, p1, p2], account_id: practice.account_id)

Appointment

Create

appointment = Updox::Models::Appointment.new(id: 'A0001', calendar_id: calendar.id, date: Time.now + 20, duration: 60, location_id: location.id, patient_id: patient.id)
appointment.save(account_id: practice.account_id)

# Bulk
Appointment.sync([appt0, appt1, appt2], account_id: practice.account_id)

Response

By default we usually return Updox::Models::Model.from_response

This class throws if throw an exception on non 200 responses with a parsed error.

Updox usually returns a 200 with error information even on things like Unauthorized. So you may have to check the updox status via successful? method.

If HTTP 200 it adds helper methods and converts each to the respective class.

The raw response is stored in the resulting model but you can get the raw response by setting config option to false

response = Updox::Models::Practice.query
response.practices # Has the practices as Updox::Models::Practice model
response.items # Same as practices, always exists on any model if alias is broken
response.item  # If there is no array, we populate this object

response.successful? # Indicates Updox successful indication
response.response_code? # Indicates Updox response code
response.response_message? # Indicates Updox response message

response.response # Raw HTTParty response is here

Configuration

Updox.configure do |c|
  c.application_id       = ENV['UPDOX_APP_ID']
  c.application_password = ENV['UPDOX_APP_PASS']
  c.api_endpoint = Updox::Connection::PROD_ENDPOINT # Defaults to Updox QA endpoint
  c.parse_responses = false # Defaults to true
  c.failure_action = :raise # Defaults to do nothing and allows lambdas
end

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake test to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/WeInfuse/updox.