Module: AllscriptsApi::NamedMagicMethods

Included in:
Client
Defined in:
lib/allscripts_api/named_magic_methods.rb

Overview

A collection of named convenience methods that map to Allscripts magic actions. These methods are included in AllscriptsApi::Client and can be accessed from instances of that class.

Instance Method Summary collapse

Instance Method Details

#get_dictionary(dictionary_name) ⇒ Array<Hash>, ...

a wrapper around GetDictionary, which returnsentries from a specific dictionary.

a “TableName” value from get_list_of_dictionaries an empty array, or an error

Parameters:

  • dictionary_name (String) —

    the name of the desired dictionary,

Returns:

  • (Array<Hash>, Array, MagicError) —

    a list dictionary entries,



160
161
162
163
164
165
166
167
 
# File 'lib/allscripts_api/named_magic_methods.rb', line 160

def get_dictionary(dictionary_name)
  params = MagicParams.format(
    user_id: @allscripts_username,
    parameter1: dictionary_name
  )
  results = magic("GetDictionary", magic_params: params)
  results["getdictionaryinfo"]
end

#get_encounter_list(patient_id = "", encounter_type = "", when_or_limit = "", nostradamus = 0, show_past_flag = "Y", billing_provider_user_name = "") ⇒ Array<Hash>, ...

a wrapper around GetEncounterList

Parameters:

  • patient_id (String) (defaults to: "") —

    patient id

  • encounter_type (String) (defaults to: "") —

    encounter type to filter on from Encounter_Type_DE

  • when_or_limit (String) (defaults to: "") —

    filter by specified date

  • nostradamus (String) (defaults to: 0) —

    how many days to look into the future. Defaults to 0.

  • show_past_flag (String) (defaults to: "Y") —

    show previous encounters, “Y” or “N”. Defaults to Y

  • billing_provider_user_name (String) (defaults to: "") —

    filter by user name (if specified)

Returns:

  • (Array<Hash>, Array, MagicError) —

    a list of encounters



124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
 
# File 'lib/allscripts_api/named_magic_methods.rb', line 124

def get_encounter_list(patient_id = "", encounter_type = "",
                       when_or_limit = "", nostradamus = 0,
                       show_past_flag = "Y",
                       billing_provider_user_name = "")
  params =
    MagicParams.format(
      user_id: @allscripts_username,
      patient_id: patient_id,
      parameter1: encounter_type, # from Encounter_Type_DE
      parameter2: when_or_limit,
      parameter3: nostradamus,
      parameter4: show_past_flag,
      parameter5: billing_provider_user_name,
    )
  results = magic("GetEncounterList", magic_params: params)
  results["getencounterlistinfo"]
end

#get_list_of_dictionaries ⇒ Array<Hash>, ...

a wrapper around GetListOfDictionaries, which returns list of all dictionaries

an empty array, or an error

Returns:

  • (Array<Hash>, Array, MagicError) —

    a list of found dictionaries,



147
148
149
150
151
 
# File 'lib/allscripts_api/named_magic_methods.rb', line 147

def get_list_of_dictionaries
  params = MagicParams.format(user_id: @allscripts_username)
  results = magic("GetListOfDictionaries", magic_params: params)
  results["getlistofdictionariesinfo"]
end

#get_patient_problems(patient_id, show_by_encounter = "N", assessed = nil, encounter_id = nil, filter_on_id = nil, display_in_progress = nil) ⇒ Array<Hash>, ...

a wrapper around GetPatientProblems

an empty array, or an error

Parameters:

  • patient_id (String) —

    patient id

  • show_by_encounter (String) (defaults to: "N") —

    Y or N (defaults to N)

  • assessed (String) (defaults to: nil)
  • encounter_id (String) (defaults to: nil) —

    id for a specific patient encounter

  • filter_on_id (String) (defaults to: nil)
  • display_in_progress (String) (defaults to: nil)

Returns:

  • (Array<Hash>, Array, MagicError) —

    a list of found problems,



62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
 
# File 'lib/allscripts_api/named_magic_methods.rb', line 62

def get_patient_problems(patient_id,
                         show_by_encounter = "N",
                         assessed = nil,
                         encounter_id = nil,
                         filter_on_id = nil,
                         display_in_progress = nil)
  params = MagicParams.format(
    user_id: @allscripts_username,
    patient_id: patient_id,
    parameter1: show_by_encounter,
    parameter2: assessed,
    parameter3: encounter_id,
    parameter4: filter_on_id,
    parameter5: display_in_progress
  )
  results = magic("GetPatientProblems", magic_params: params)
  results["getpatientproblemsinfo"]
end

#get_provider(provider_id = nil, user_name = nil) ⇒ Array<Hash>, ...

a wrapper around GetProvider

Parameters:

  • provider_id (String) (defaults to: nil) —

    optional Allscripts user id

  • user_name (String) (defaults to: nil) —

    optional Allscripts user_name

Returns:

  • (Array<Hash>, Array, MagicError) —

    a list of providers



14
15
16
17
18
19
20
21
22
 
# File 'lib/allscripts_api/named_magic_methods.rb', line 14

def get_provider(provider_id = nil, user_name = nil)
  params =
    MagicParams.format(
      parameter1: provider_id,
      parameter2: user_name
    )
  results = magic("GetProvider", magic_params: params)
  results["getproviderinfo"]
end

#get_providers(security_filter = nil, name_filter = nil, show_only_providers_flag = "Y", internal_external = "I", ordering_authority = nil, real_provider = "N") ⇒ Array<Hash>, ...

a wrapper around GetProviders

Parameters:

  • security_filter (String) (defaults to: nil) —

    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.

  • name_filter (String) (defaults to: nil) —

    optional If specified, will filter for providers with a lastname or entrycode that match. Defaults to %.

  • show_only_providers_flag (String) (defaults to: "Y") —

    optional (Y/N) Indicate whether or not to return only users that are also Providers. Defaults to Y.

  • internal_external (String) (defaults to: "I") —

    optional I for Internal (User/providers that are internal to the enterprise). E for External (Referring physicians). Defaults to I.

  • ordering_authority (String) (defaults to: nil) —

    optional Show only those users with an ordering provider level of X (which is a number)

  • real_provider (String) (defaults to: "N") —

    optional Whether an NPI (National Provider ID) is required (Y/N). Y returns only actual providers. Default is N.

Returns:

  • (Array<Hash>, Array, MagicError) —

    a list of providers



33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
 
# File 'lib/allscripts_api/named_magic_methods.rb', line 33

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

#get_results(patient_id, since = nil) ⇒ Array<Hash>, ...

a wrapper around GetResults

an empty array, or an error

Parameters:

  • patient_id (String) —

    patient id

  • since (String) (defaults to: nil) —

    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

Returns:

  • (Array<Hash>, Array, MagicError) —

    a list of found results (lab/imaging),



88
89
90
91
92
93
94
95
96
97
 
# File 'lib/allscripts_api/named_magic_methods.rb', line 88

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

#get_schedule(start_date, end_date) ⇒ Array<Hash>, ...

a wrapper around GetSchedule, returns appointments scheduled under the the user for a given date range

Parameters:

  • start_date (Date) —

    start date inclusive

  • end_date (Date) —

    end date inclusive

Returns:

  • (Array<Hash>, Array, MagicError) —

    a list of scheduled appointments, an empty array, or an error



105
106
107
108
109
110
111
112
113
 
# File 'lib/allscripts_api/named_magic_methods.rb', line 105

def get_schedule(start_date, end_date)
  params =
    MagicParams.format(
      user_id: @allscripts_username,
      parameter1: format_date_range(start_date, end_date)
    )
  results = magic("GetSchedule", magic_params: params)
  results["getscheduleinfo"]
end

#get_server_info ⇒ Array<Hash>, ...

a wrapper around GetServerInfo, which returns the time zone of the server, unity version and date and license key

server hosting the Unity webservice.

Returns:

  • (Array<Hash>, Array, MagicError) —

    local information about the



175
176
177
178
179
 
# File 'lib/allscripts_api/named_magic_methods.rb', line 175

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

#last_logs(errors_only = "N", show_wand = "N", how_many = 10, start_time = "", end_time = "") ⇒ Object 



181
182
183
184
185
186
187
188
189
190
191
 
# File 'lib/allscripts_api/named_magic_methods.rb', line 181

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