0.0
No commit activity in last 3 years
No release in over 3 years
The allscripts_api gem wraps a set of Allscripts APIs, including but not limited to Unity. The gem focuses on JSON endpoints instead of SOAP.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

>= 0.12.2
 Project Readme

AllscriptsApi, an Allscripts Unity Client

Gem Version Coverage Status Build Status Inline docs Maintainability security

AllscriptsApi is a simple ruby wrapper around the Allscripts Unity API. This gem specifically focuses on the JSON functionality of the API and will not support SOAP. Additionally, allscripts_api focuses on being simple to use and understand. There are no DSLs, or behind the scenes magic. The code aims to be well documented, readable, and straightforward to use in your own application. The docs are available here

Installation

Add this line to your application's Gemfile:

gem 'allscripts_api'

And then execute:

$ bundle

Or install it yourself as:

$ gem install allscripts_api

Usage

The client can be used either with ahead of time configuration and instantiated with AllscriptsApi.connect, or by directly calling AllscriptsApi::Client.new, and passing your applications credentials.

Optional Configuration

You may configure the client beforehand with the following config block. If you are using Rails, this will go in cofig/initializers. However, the code does not rely on ActiveSupport and can be configured ahead of time in and Ruby application.

AllscriptsApi.configure do |config|
  config.app_name = 'YOUR_APP_NAME_HERE'
  config.app_username = 'YOUR_APP_USERNAME_HERE'
  config.app_password = 'YOUR_APP_PASSWORD_HERE'
  config.unity_url = 'CHOSEN_UNITY_URL'
end

If you have configured you application ahead of time, you can test your set up now.

client = AllscriptsApi.connect
client.get_token

If this works, the client should set a token, and you should see it printed to the console. If it fails for any reason, it will raise GetTokenError, and dump the response body of the GetToken call to Unity.

Assuming a successful call to GetToken, next authenticate the test user to that token.

client.get_user_authentication("avhana", "password01")

This call will return a MagicError if it fails.

Directly Building the Client

If you want to use the gem from the console, or without ahead of time configuration, you may do so as follows.

  client =
    AllscriptsApi::Client.new(unity_url, app_name, app_username, app_password)
  client.get_token
  client.get_user_authentication("avhana", "password01")

As you can see, after the initial call, usage is the same. That is because AllscriptsApi.connect returns an instance of AllscriptsApi::Client. You can find the documentation for AllscriptsApi.connect here.

Code of Conduct

In order to have a more open and welcoming community of contributors and users, Avhana Health will enforce a Code of Conduct, which follows v1.4 of the Contributors Covenant.

Contributing

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

License

This gem is provided as is under the MIT license, Copyright (c) 2018 Avhana Health, Inc.