allscripts_api 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ae946e7adbf4299a037926c915fd33ff7bf57543
-  data.tar.gz: a2b9a11e36131641c5c338375a57d0decd12880c
+  metadata.gz: cbdb760abff22c5ef1e82fe9275340348c746361
+  data.tar.gz: '059566e9ec3065e974ebb87f48782f76ec99b32a'
 SHA512:
-  metadata.gz: 24e68dfd0b893788d198956362c1f6c0f26bace7e3bcd18239f59e353595517c25ba09eaf774f48229c7257bc825f6b57abd03fdc53901da5745ef810f99e129
-  data.tar.gz: ca99389bd969d11db5bd789e7068dcce5e1a8e363ddf13909998cb7a3a2690ac079b63d114a0ccaca3881c2930f8796f82049726573e18f892221835a14d1613
+  metadata.gz: 0bc7c7a80ebdbbf862781ee03b29c836ac0bd80ea9c853b34d80cb8778bb676a1f0b872cf1aadeffc9ef03025d56ff51c73d7cdaed954829978401fe42a3c048
+  data.tar.gz: 75e34e7c0385837cdb9d0e59af2d2c504f61671f72e0b266f9e0a825facba7d697c4c7234a71700f2b4cd8d02fc086c9f05603dbe4a52431d6dc3a930c5cd142

data/lib/allscripts_api/client.rb

@@ -14,7 +14,7 @@ module AllscriptsApi
     attr_writer :sso_token
 
     # hardcoded to use the JSON endpoint
-    ENDPOINT = "/Unity/UnityService.svc/json".freeze
+    ENDPOINT = "/UnityService.svc/json".freeze
 
     # Instantiation of the Client
     #

data/lib/allscripts_api/documents/document_sender.rb

@@ -20,7 +20,7 @@ module AllscriptsApi
       #       owner_code: "TW0001",
       #       first_name: "Allison",
       #       last_name: "Allscripts",
-      #       document_type: "sEKG",
+      #       document_type: "sEKG", # Document_Type_DE dictionary
       #       organization_name: "New World Health"
       #     }
       #   ds = AllscriptsApi::Documents::DocumentSender.new(client, pdf, "test.pdf", document_params)

data/lib/allscripts_api/named_magic_methods.rb

@@ -21,6 +21,34 @@ module AllscriptsApi
       results["getproviderinfo"]
     end
 
+    # a wrapper around GetProviders
+    #
+    # @param security_filter [String] optional EntryCode of the Security_Code_DE dictionary for the providers being sought. A list of valid security codes can be obtained from GetDictionary on the Security_Code_DE dictionary.
+    # @param name_filter [String] optional If specified, will filter for providers with a lastname or entrycode that match. Defaults to %.
+    # @param show_only_providers_flag [String] optional (Y/N) Indicate whether or not to return only users that are also Providers. Defaults to Y.
+    # @param internal_external [String] optional I for Internal (User/providers that are internal to the enterprise). E for External (Referring physicians). Defaults to I.
+    # @param ordering_authority [String] optional Show only those users with an ordering provider level of X (which is a number)
+    # @param real_provider [String] optional Whether an NPI (National Provider ID) is required (Y/N). Y returns only actual providers. Default is N.
+    # @return [Array<Hash>, Array, MagicError] a list of providers
+    def get_providers(security_filter = nil,
+                      name_filter = nil,
+                      show_only_providers_flag = "Y",
+                      internal_external = "I",
+                      ordering_authority = nil,
+                      real_provider = "N")
+      params =
+        MagicParams.format(
+          parameter1: security_filter,
+          parameter2: name_filter,
+          parameter3: show_only_providers_flag,
+          parameter4: internal_external,
+          parameter5: ordering_authority,
+          parameter6: real_provider
+        )
+      results = magic("GetProviders", magic_params: params)
+      results["getprovidersinfo"]
+    end
+
     # a wrapper around GetPatientProblems
     #
     # @param patient_id [String] patient id
@@ -50,6 +78,24 @@ module AllscriptsApi
       results["getpatientproblemsinfo"]
     end
 
+
+    # a wrapper around GetResults
+    #
+    # @param patient_id [String] patient id
+    # @param since [String] Specify a date/time combination to return only results that have been modified on or after that date/time. For example, 2014-01-01 or 2015-01-14 08:44:28.563. Defaults to nil
+    # @return [Array<Hash>, Array, MagicError] a list of found results (lab/imaging),
+    # an empty array, or an error
+    def get_results(patient_id,
+                    since = nil)
+      params = MagicParams.format(
+        user_id: @allscripts_username,
+        patient_id: patient_id,
+        parameter1: since
+      )
+      results = magic("GetResults", magic_params: params)
+      results["getresultsinfo"]
+    end
+
     # a wrapper around GetSchedule, returns appointments scheduled under the
     # the user for a given date range
     #
@@ -71,7 +117,7 @@ module AllscriptsApi
     # @param patient_id [String] patient id
     # @param encounter_type [String] encounter type to filter on from Encounter_Type_DE
     # @param when_or_limit [String] filter by specified date
-    # @param nostradamus [String] how many days to look into the future. Defaults to 0. 
+    # @param nostradamus [String] how many days to look into the future. Defaults to 0.
     # @param show_past_flag [String] show previous encounters, "Y" or "N". Defaults to Y
     # @param billing_provider_user_name [String] filter by user name (if specified)
     # @return [Array<Hash>, Array, MagicError] a list of encounters
@@ -120,6 +166,30 @@ module AllscriptsApi
       results["getdictionaryinfo"]
     end
 
+    # a wrapper around GetServerInfo, which returns
+    # the time zone of the server, unity version and date
+    # and license key
+    #
+    # @return [Array<Hash>, Array, MagicError]  local information about the
+    # server hosting the Unity webservice.
+    def get_server_info
+      params = MagicParams.format(user_id: @allscripts_username)
+      results = magic("GetServerInfo", magic_params: params)
+      results["getserverinfoinfo"][0] # infoinfo is an Allscript typo
+    end
+
+    def last_logs(errors_only = "N", show_wand = "N", how_many = 10, start_time = "", end_time = "")
+      params =
+        MagicParams.format(
+          parameter1: errors_only,
+          parameter2: show_wand,
+          parameter3: how_many,
+          parameter4: start_time,
+          parameter5: end_time
+        )
+      results = magic("LastLogs", magic_params: params)
+    end
+
     private
 
     def format_date_range(start_date, end_date)

data/lib/allscripts_api/orders/order.rb

@@ -44,12 +44,40 @@ module AllscriptsApi
           builder.field("id" => "orderdeferralunit", "value" => "Days")
           builder.field("id" => "orderstatusreason", "value" => "")
           builder.field("id" => "encounter", "value" => encounter_id.to_s)
+          builder.field("id" => "orderintorext", "value" => "External/Internal for referral only")
           builder.orderlinkedproblems
           builder.clinicalquestions
         end
 
         builder.to_xml
       end
+
+
+      # Builder for get order workflow xml
+      #
+      # @param order_id [String] order dictionary ID
+      # @param order_trans_id [String] the provider's Allscripts id
+      # @param order_category [DateTime] determines what order field data to send back.
+      # @param encounter_id [String|Nil] an encounter id, used when
+      # ordering to current encounter
+      # @return [String] xml formatted for
+      # {AllscriptsApi::OrderingMethods#save_order}
+      def self.build_xml_for_order_workflow(order_id,
+                                            order_category,
+                                            problem_id = "",
+                                            problem_trans_id = "0",
+                                            order_trans_id = "0")
+        builder = Nokogiri::XML::Builder.new
+        builder.saveorderxml do
+          builder.field("id" => "order_id", "value" => order_id)
+          builder.field("id" => "order_transid", "value" => order_trans_id)
+          builder.field("id" => "order_category", "value" => order_category)
+          builder.field("id" => "problem_id", "value" => problem_id)
+          builder.field("id" => "problem_transid", "value" => problem_trans_id)
+        end
+
+        builder.to_xml
+      end
     end
   end
 end

data/lib/allscripts_api/orders/ordering_methods.rb

@@ -13,7 +13,7 @@ module AllscriptsApi
       # Immunization, InstructionOrder, ProcedureOrder,
       # Referral, SuppliesOrder.
       #
-      # xml can be constructed with {AllscriptsApi::Order.build_xml}
+      # xml can be constructed with {AllscriptsApi::Orders::Order.build_xml}
       #
       # @param patient_id [String]
       # @param xml [String] xml containing saveorderxml fields and values
@@ -39,6 +39,32 @@ module AllscriptsApi
         )
         magic("SaveOrder", magic_params: params)
       end
+
+      # a wrapper around GetOrderWorkflow
+      #
+      # @param patient_id [String] patient id
+      # @param xml_string [String] xml from build_xml_for_order_workflow method
+      # @param order_trans_id [String] order_activity_header.ID when calling for an existing order
+      # @param order_category [String] determines what order field data to send back.
+      # @param problem_id [String] problem dictionary id
+      # @param problem_trans_id [String] problem_header id
+      # @return [Array<Hash>, Array, MagicError] a list of encounters
+      def get_order_workflow(patient_id, xml_string,
+                             order_trans_id = "0", order_category = "ProcedureOrder",
+                             problem_id = "", problem_trans_id = "")
+        params =
+          MagicParams.format(
+            user_id: @allscripts_username,
+            patient_id: patient_id,
+            parameter1: xml_string,
+            parameter2: order_trans_id,
+            parameter3: order_category,
+            parameter4: problem_id,
+            parameter5: problem_trans_id
+          )
+        results = magic("GetOrderWorkflow", magic_params: params)
+        results["getorderworkflow"]
+      end
     end
   end
 end

data/lib/allscripts_api/version.rb

@@ -2,5 +2,5 @@
 
 module AllscriptsApi
   # gem version declaration
-  VERSION = "0.7.0".freeze
+  VERSION = "0.8.0".freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: allscripts_api
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Chase
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-06-01 00:00:00.000000000 Z
+date: 2018-07-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday