ruby-jss 1.3.3 → 1.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ee61895968b4dc50815f33bdd50cd54c1a1fcad700243f4be3cded694c11f745
-  data.tar.gz: a7a3ce9847874fa7c26c859f6fa26e5a8802b60f42c300f347e2c40b5c38d949
+  metadata.gz: ef0484427943d39089bb11eb73af827c5137d79550c34ea5fdf7ca683c7c69f0
+  data.tar.gz: '09abd63abb133ee6c34aa2fcb9ae8ccc3e11b3248061ee410223bd8f25f5a7ae'
 SHA512:
-  metadata.gz: f95b9d7f49983c9899a18b7e1edb6130250e402a5284e65a9ae64829176d2c3f5fe3d35584cf6dcee85b7486e1a037c8a5ae3ef58b72d169f4ac05cebb5d8858
-  data.tar.gz: 1b5131ec5bec8b940c4daf1403f9595a4749b0b5d36cfc7bf07a2aca0adbee2446ff44dfe078e8e1651f5fa25ed6725d763ec0f5798d06ec16d70b57ea466b86
+  metadata.gz: 962236f6ca861fbfa3f706df0d8d977f15fb1436238f7d9c061ae8043c4148b956fc187a9858f9444b8461cc7d707067278e6a9030c676af26febdc565b0cd0f
+  data.tar.gz: 7f7027d207de8ea3fd3d1c010483a9e261d4962857ec48ac6f4df0ba4d38526720ff3700078900e1df2182f191a0aaf7c3284ef3438714e1fbc9118f3aeb03ca

data/CHANGES.md

@@ -4,6 +4,53 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## \[1.4.1] - 2020-10-01
+
+### Added
+
+  - Support for JP API connections to https://tryitout.jamfcloud.com/, the open API test server provided by Jamf. It uses internal tokens, so the /auth endpoint is disabled. Now as with the Classic API, `Jamf::Connection.connect`  will accpt any name & password when connecting to that host.
+
+## \[1.4.0] - 2020-09-14
+
+### Added
+
+  - Class JSS::VPPAccount, implementing the 'vppacconts' endpoint.
+
+  - Constant JSS::APP_STORE_COUNTRY_CODES, a Hash with keys being the official country names used by the App Store, and values being the two-letter codes for those names. This static Hash is derived from a Jamf Pro API end point, and will be updated as needed. These codes are used by JSS::VPPAccount
+
+  - Module Method JSS.country_code_match(str) whic allows you to filter the JSS::APP_STORE_COUNTRY_CODES Hash to only those key-value pairs that include the given string.
+
+  - Mixin Class Method VPPable.all_vpp_device_assignable, returns a Hash of Hashes showing the total, used, and remaining licenses for all members of the target class that are VPP-assignable by device.
+
+  - Scopable::Scope#in_scope?(machine) Given a JSS::Computer or MobileDevice, or an identifier for one, it is in the scope? WARNING: For scopes that include Jamf Users or User Groups as targets or exclusions, this method may return an incorrect value. See the discussion in the comments/documentation for the Scopable::Scope class under `IMPORTANT - Users & User Groups in Targets and Exclusions`
+
+  - Scopable::Scope#scoped_machines returns a Hash of ids=>names for all machines in this scope. WARNING:  This must instantiate all machines in the target class. It will still be slow, at least the first time for each target class. On the upside, the instantiated machines will be cached, so generating this list for other scopes with the same target class will be much much faster. In tests, with 1600 Computers in the JSS, it took about 7 minutes the first time, but less than 1 second after caching.
+  See also the warning for #in_scope? above, which applies here as well.
+
+  - JSS::Policy objects support 'Policy Retry' via the getter/setter methods #retry_event, #retry_attempts, and #notify_failed_retries. You can only set these values if the #frequency is :once_per_computer. To turn off policy-retry, either set the retry_event to :none, or set the retry_attempts to 0
+
+### Changed
+
+  - Prettier XML for JSS::APIObject#ppx
+
+  - Improved JSS::Validate.boolean. Accepts: true, false, 'true', 'false', 'yes', 'no', 't','f', 'y', or 'n' as Strings or Symbols, case insensitive
+
+  - The JSS::MacApplication class is more fully implemented
+
+  - JSS::Scopable::Scope now uses the word 'targets' consistently to match the UI's 'Targets' tab.  The previous word 'inclusions' still works as before.
+
+  - When using the Jamf module to access the Jamf Pro API, the minumum JamfPro version is now 10.23.0. WARNING: Like the Jamf Pro API itself, the Jamf module that accesses it is in beta and may have breaking changes at any time.
+
+### Fixed
+
+  - JSS::ExtensionAttribute: when used as a display field in an AdvancedSearch, the name of the EA in the search result Hash comes from the API as a String (turned into a Symbol) that is the EA name with colons removed and spaces & dashes turned to underscores. Previously ruby-jss didn't remove the colons
+
+  - Used an XML workaround for the common classic API bug where an XML array comes as a single-item JSON hash. This time in the JSS::User class's user_groups method.
+
+  - The Jamf Pro API endpoints for /v1/device-enrollment changed to /v1/device-enrollments and /v1/device-enrollment/sync/<id> changed to /v1/device-enrollments/<id>/syncs.  /v1/devive-enrollments/syncs.
+
+  - The Jamf Pro API endpoint for bulk-deleting Departments changed from 'delete-departments' to 'delete-multiple'
+
 ## \[1.3.3] - 2020-08-07
 
 ### Fixed

data/lib/jamf/api/connection.rb

@@ -48,7 +48,7 @@ module Jamf
     RSRC_BASE = 'uapi'.freeze
 
     # The API version must be this or higher
-    MIN_JAMF_VERSION = Gem::Version.new('10.15.0')
+    MIN_JAMF_VERSION = Gem::Version.new('10.23.0')
 
     HTTPS_SCHEME = 'https'.freeze
 

data/lib/jamf/api/connection/token.rb

@@ -44,6 +44,15 @@ module Jamf
       # transaction authorization.
       AUTH_TOKEN_PFX = 'jamf-token '.freeze
 
+      # Recognize the tryitout server, cuz its /auth endpoint
+      # is disabled, and it needs no tokens
+      JAMF_TRYITOUT_HOST = "tryitout#{Jamf::Connection::JAMFCLOUD_DOMAIN}".freeze
+
+      JAMF_TRYITOUT_TOKEN_BODY = {
+        token: 'This is a fake token, tryitout.jamfcloud.com uses internal tokens',
+        expires: 2000000000000
+      }.freeze
+
       # @return [String] The user who generated this token
       attr_reader :user
 
@@ -81,7 +90,9 @@ module Jamf
         @timeout = params[:timeout] || Jamf::Connection::DFT_TIMEOUT
         @ssl_options = params[:ssl_options] || {}
 
-        if params[:pw]
+        if @base_url.host == JAMF_TRYITOUT_HOST
+          init_jamf_tryitout
+        elsif params[:pw]
           init_from_pw params[:pw]
         elsif params[:token_string]
           init_from_token_string params[:token_string]
@@ -90,6 +101,15 @@ module Jamf
         end
       end # init
 
+      # Initialize from password
+      def init_jamf_tryitout
+        @token_response_body = JAMF_TRYITOUT_TOKEN_BODY
+        @auth_token = AUTH_TOKEN_PFX + @token_response_body[:token]
+        @expires = Jamf::Timestamp.new @token_response_body[:expires]
+        @login_time = Jamf::Timestamp.new Time.now
+        @valid = true
+      end # init_from_pw
+
       # Initialize from password
       def init_from_pw(pw)
         resp = token_connection(

data/lib/jamf/api/resources/collection_resources/department.rb

@@ -46,7 +46,7 @@ module Jamf
     RSRC_PATH = 'departments'.freeze
 
     # TODO: Jamf - will this be standard for collections?
-    BULK_DELETE_RSRC = 'delete-departments'.freeze
+    BULK_DELETE_RSRC = 'delete-multiple'.freeze
 
     # Object Model / Attributes
     # See APIObject class documentation for details

data/lib/jamf/api/resources/collection_resources/device_enrollment.rb

@@ -52,7 +52,7 @@ module Jamf
 
     RSRC_VERSION = 'v1'.freeze
 
-    RSRC_PATH = 'device-enrollment'.freeze
+    RSRC_PATH = 'device-enrollments'.freeze
 
     # Object Model / Attributes
     # See APIObject class documentation for details
@@ -140,7 +140,7 @@ module Jamf
 
     DEVICES_RSRC = 'devices'.freeze
 
-    SYNC_RSRC = 'sync'.freeze
+    SYNC_RSRC = 'syncs'.freeze
 
     LATEST_RSRC = 'latest'.freeze
 
@@ -279,7 +279,7 @@ module Jamf
         instance_id = valid_id instance_ident, cnx: cnx
         raise Jamf::NoSuchItemError "No DeviceEnrollment instance matches '#{instance_ident}'" unless instance_id
 
-        rsrc = "#{RSRC_VERSION}/#{RSRC_PATH}/#{SYNC_RSRC}/#{instance_id}"
+        rsrc = "#{RSRC_VERSION}/#{RSRC_PATH}/#{instance_id}/#{SYNC_RSRC}"
         rsrc += "/#{LATEST_RSRC}" if latest
       else
         rsrc = "#{RSRC_VERSION}/#{RSRC_PATH}/#{SYNC_RSRC}"

data/lib/jamf/version.rb

@@ -27,6 +27,6 @@
 module Jamf
 
   ### The version of the Jamf module
-  VERSION = '0.0.1'.freeze
+  VERSION = '0.0.3'.freeze
 
 end # module

data/lib/jss/api_object.rb

@@ -1358,7 +1358,10 @@ module JSS
     #
     def ppx
       return nil unless creatable? || updatable?
-      REXML::Document.new(rest_xml).write $stdout, 2
+
+      formatter = REXML::Formatters::Pretty.new(2)
+      formatter.compact = true
+      formatter.write(REXML::Document.new(rest_xml), $stdout)
       puts
     end
 
@@ -1691,4 +1694,7 @@ require 'jss/api_object/user'
 require 'jss/api_object/webhook'
 require 'jss/api_object/printer'
 
+### Other
+require 'jss/api_object/app_store_country_codes'
+
 JSS::APIObject.define_identifier_list_methods

data/lib/jss/api_object/advanced_search.rb

@@ -62,6 +62,7 @@ module JSS
     include JSS::Criteriable
     include JSS::Sitable
 
+
     # Class Constants
     #####################################
 
@@ -85,6 +86,22 @@ module JSS
     #
     attr_reader :search_results
 
+    # @return [Array<String>] the fields to be returned with the search results
+    #
+    # The API delivers these as an array of Hashes,
+    # where each hash has only one key, :name => the name of the fields/ExtAttrib
+    # to display. It should probably not have the underlying Hashes, and just
+    # be an array of names. This class converts it to just an Array of field names
+    # (Strings) for internal use.
+    #
+    # These fields are returned in the @search_results
+    # data along with :id, :name, and other unique identifiers
+    # for each found item. In that data, their names have colons removed, abd
+    # spaces and dashes converted to underscores, and they are
+    # symbolized. See attribute result_display_keys
+    #
+    attr_reader :display_fields
+
     # @return [Array<Symbol>]
     #
     # The search result Hash keys for the {#display_fields} of the search
@@ -95,8 +112,9 @@ module JSS
     # methods are for.
     #
     # However, when those names come back as the Hash Keys of the {#search_results}
-    # they (inconsistently) have spaces and/or dashes converted to underscores, and,
-    # the JSON module converts the keys to Symbols, so they don't match the {#display_fields}.
+    # they (inconsistently) have spaces and/or dashes converted to underscores,
+    # and colons are removed. The JSON module then converts the keys to Symbols,
+    # so they don't match the {#display_fields}.
     #
     # For example, the display field "Last Check-in" might come back as any of these Symbols:
     # - :"Last Check-in"
@@ -147,13 +165,13 @@ module JSS
       # make sure each hash of the search results
       # has a key matching a standard key.
       #
-      @search_results.each do |hash|
-        hash.keys.each do |key|
-          std_key = key.to_s.gsub(/ |-/, '_').to_sym
-          next if hash[std_key]
-          hash[std_key] = hash[key]
-        end
-      end
+      # @search_results.each do |hash|
+      #   hash.keys.each do |key|
+      #     std_key = key.to_s.gsub(':', '').gsub(/ |-/, '_').to_sym
+      #     next if hash[std_key]
+      #     hash[std_key] = hash[key]
+      #   end
+      # end
     end # init
 
     # Public Instance Methods
@@ -231,23 +249,6 @@ module JSS
       end
     end
 
-    # @return [Array<String>] the fields to be returned with the search results
-    #
-    # The API delivers these as an array of Hashes,
-    # where each hash has only one key, :name => the name of the fields/ExtAttrib
-    # to display. It should probably not have the underlying Hashes, and just
-    # be an array of names. This class converts it to just an Array of field names
-    # (Strings) for internal use.
-    #
-    # These fields are returned in the @search_results
-    # data along with :id, :name, and other unique identifiers
-    # for each found item. In that data, their names have
-    # spaces and dashes converted to underscores, and they are
-    # symbolized.
-    #
-    #
-    attr_reader :display_fields
-
     # Set the list of fields to be retrieved with the
     # search results.
     #

data/lib/jss/api_object/app_store_country_codes.rb

@@ -0,0 +1,298 @@
+### Copyright 2020 Pixar
+
+###
+###    Licensed under the Apache License, Version 2.0 (the "Apache License")
+###    with the following modification; you may not use this file except in
+###    compliance with the Apache License and the following modification to it:
+###    Section 6. Trademarks. is deleted and replaced with:
+###
+###    6. Trademarks. This License does not grant permission to use the trade
+###       names, trademarks, service marks, or product names of the Licensor
+###       and its affiliates, except as required to comply with Section 4(c) of
+###       the License and to reproduce the content of the NOTICE file.
+###
+###    You may obtain a copy of the Apache License at
+###
+###        http://www.apache.org/licenses/LICENSE-2.0
+###
+###    Unless required by applicable law or agreed to in writing, software
+###    distributed under the Apache License with the above modification is
+###    distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+###    KIND, either express or implied. See the Apache License for the specific
+###    language governing permissions and limitations under the Apache License.
+###
+###
+
+###
+module JSS
+
+  # Return the names and codes containing a given string
+  # (case insentitive).
+  #
+  # @param str [String] the string to look for, must be >=2 chars long
+  #
+  # @return [Hash] the country names => codes that contain the string.
+  #
+  def self.country_code_match(str)
+    raise ArgumentError, 'Match string must be at least 2 characters long' if str.size < 2
+
+    str = str.to_s.upcase
+    APP_STORE_COUNTRY_CODES.select { |n, c| n.upcase.include?(str) || c.include?(str) }
+  end
+
+  # The official names and two-letter codes for countries known to the App Store.
+  # These were retrieved from the Jamf Pro API endpoint in August 2020.
+  # They should be updated regularly. To do so using the Jamf Module, just
+  # replace this Hash with the one you get from:
+  #    Jamf::AppStoreCountryCodes.codes_by_name
+  #
+  APP_STORE_COUNTRY_CODES = {
+    'Afghanistan' => 'AF',
+    'Aland Islands' => 'AX',
+    'Albania' => 'AL',
+    'Algeria' => 'DZ',
+    'American Samoa' => 'AS',
+    'Andorra' => 'AD',
+    'Angola' => 'AO',
+    'Anguilla' => 'AI',
+    'Antarctica' => 'AQ',
+    'Antigua and Barbuda' => 'AG',
+    'Argentina' => 'AR',
+    'Armenia' => 'AM',
+    'Aruba' => 'AW',
+    'Australia' => 'AU',
+    'Austria' => 'AT',
+    'Azerbaijan' => 'AZ',
+    'Bahamas' => 'BS',
+    'Bahrain' => 'BH',
+    'Bangladesh' => 'BD',
+    'Barbados' => 'BB',
+    'Belarus' => 'BY',
+    'Belgium' => 'BE',
+    'Belize' => 'BZ',
+    'Benin' => 'BJ',
+    'Bermuda' => 'BM',
+    'Bhutan' => 'BT',
+    'Bolivia, Plurinational State of' => 'BO',
+    'Bosnia and Herzegovina' => 'BA',
+    'Botswana' => 'BW',
+    'Bouvet Island' => 'BV',
+    'Brazil' => 'BR',
+    'British Indian Ocean Territory' => 'IO',
+    'Brunei Darussalam' => 'BN',
+    'Bulgaria' => 'BG',
+    'Burkina Faso' => 'BF',
+    'Burundi' => 'BI',
+    'Cambodia' => 'KH',
+    'Cameroon' => 'CM',
+    'Canada' => 'CA',
+    'Cape Verde' => 'CV',
+    'Cayman Islands' => 'KY',
+    'Central African Republic' => 'CF',
+    'Chad' => 'TD',
+    'Chile' => 'CL',
+    'China' => 'CN',
+    'Christmas Island' => 'CX',
+    'Cocos (Keeling) Islands' => 'CC',
+    'Colombia' => 'CO',
+    'Comoros' => 'KM',
+    'Congo' => 'CG',
+    'Congo, the Democratic Republic of the' => 'CD',
+    'Cook Islands' => 'CK',
+    'Costa Rica' => 'CR',
+    "Cote d'Ivoire" => 'CI',
+    'Croatia' => 'HR',
+    'Cuba' => 'CU',
+    'Cyprus' => 'CY',
+    'Czech Republic' => 'CZ',
+    'Denmark' => 'DK',
+    'Djibouti' => 'DJ',
+    'Dominica' => 'DM',
+    'Dominican Republic' => 'DO',
+    'Ecuador' => 'EC',
+    'Egypt' => 'EG',
+    'El Salvador' => 'SV',
+    'Equatorial Guinea' => 'GQ',
+    'Eritrea' => 'ER',
+    'Estonia' => 'EE',
+    'Ethiopia' => 'ET',
+    'Falkland Islands (Malvinas)' => 'FK',
+    'Faroe Islands' => 'FO',
+    'Fiji' => 'FJ',
+    'Finland' => 'FI',
+    'France' => 'FR',
+    'French Guiana' => 'GF',
+    'French Polynesia' => 'PF',
+    'French Southern Territories' => 'TF',
+    'Gabon' => 'GA',
+    'Gambia' => 'GM',
+    'Georgia' => 'GE',
+    'Germany' => 'DE',
+    'Ghana' => 'GH',
+    'Gibraltar' => 'GI',
+    'Greece' => 'GR',
+    'Greenland' => 'GL',
+    'Grenada' => 'GD',
+    'Guadeloupe' => 'GP',
+    'Guam' => 'GU',
+    'Guatemala' => 'GT',
+    'Guernsey' => 'GG',
+    'Guinea' => 'GN',
+    'Guinea-Bissau' => 'GW',
+    'Guyana' => 'GY',
+    'Haiti' => 'HT',
+    'Heard Island and McDonald Islands' => 'HM',
+    'Holy See (Vatican City State)' => 'VA',
+    'Honduras' => 'HN',
+    'Hong Kong' => 'HK',
+    'Hungary' => 'HU',
+    'Iceland' => 'IS',
+    'India' => 'IN',
+    'Indonesia' => 'ID',
+    'Iran, Islamic Republic of' => 'IR',
+    'Iraq' => 'IQ',
+    'Ireland' => 'IE',
+    'Isle of Man' => 'IM',
+    'Israel' => 'IL',
+    'Italy' => 'IT',
+    'Jamaica' => 'JM',
+    'Japan' => 'JP',
+    'Jersey' => 'JE',
+    'Jordan' => 'JO',
+    'Kazakhstan' => 'KZ',
+    'Kenya' => 'KE',
+    'Kiribati' => 'KI',
+    "Korea, Democratic People's Republic of" => 'KP',
+    'Korea, Republic of' => 'KR',
+    'Kuwait' => 'KW',
+    'Kyrgyzstan' => 'KG',
+    "Lao People's Democratic Republic" => 'LA',
+    'Latvia' => 'LV',
+    'Lebanon' => 'LB',
+    'Lesotho' => 'LS',
+    'Liberia' => 'LR',
+    'Libyan Arab Jamahiriya' => 'LY',
+    'Liechtenstein' => 'LI',
+    'Lithuania' => 'LT',
+    'Luxembourg' => 'LU',
+    'Macao' => 'MO',
+    'Macedonia, the former Yugoslav Republic of' => 'MK',
+    'Madagascar' => 'MG',
+    'Malawi' => 'MW',
+    'Malaysia' => 'MY',
+    'Maldives' => 'MV',
+    'Mali' => 'ML',
+    'Malta' => 'MT',
+    'Marshall Islands' => 'MH',
+    'Martinique' => 'MQ',
+    'Mauritania' => 'MR',
+    'Mauritius' => 'MU',
+    'Mayotte' => 'YT',
+    'Mexico' => 'MX',
+    'Micronesia, Federated States of' => 'FM',
+    'Moldova, Republic of' => 'MD',
+    'Monaco' => 'MC',
+    'Mongolia' => 'MN',
+    'Montenegro' => 'ME',
+    'Montserrat' => 'MS',
+    'Morocco' => 'MA',
+    'Mozambique' => 'MZ',
+    'Myanmar' => 'MM',
+    'Namibia' => 'NA',
+    'Nauru' => 'NR',
+    'Nepal' => 'NP',
+    'Netherlands' => 'NL',
+    'Netherlands Antilles' => 'AN',
+    'New Caledonia' => 'NC',
+    'New Zealand' => 'NZ',
+    'Nicaragua' => 'NI',
+    'Niger' => 'NE',
+    'Nigeria' => 'NG',
+    'Niue' => 'NU',
+    'Norfolk Island' => 'NF',
+    'Northern Mariana Islands' => 'MP',
+    'Norway' => 'NO',
+    'Oman' => 'OM',
+    'Pakistan' => 'PK',
+    'Palau' => 'PW',
+    'Palestinian Territory, Occupied' => 'PS',
+    'Panama' => 'PA',
+    'Papua New Guinea' => 'PG',
+    'Paraguay' => 'PY',
+    'Peru' => 'PE',
+    'Philippines' => 'PH',
+    'Pitcairn' => 'PN',
+    'Poland' => 'PL',
+    'Portugal' => 'PT',
+    'Puerto Rico' => 'PR',
+    'Qatar' => 'QA',
+    'Reunion' => 'RE',
+    'Romania' => 'RO',
+    'Russian Federation' => 'RU',
+    'Rwanda' => 'RW',
+    'Saint Barthelemy' => 'BL',
+    'Saint Helena, Ascension and Tristan da Cunha' => 'SH',
+    'Saint Kitts and Nevis' => 'KN',
+    'Saint Lucia' => 'LC',
+    'Saint Martin (French part)' => 'MF',
+    'Saint Pierre and Miquelon' => 'PM',
+    'Saint Vincent and the Grenadines' => 'VC',
+    'Samoa' => 'WS',
+    'San Marino' => 'SM',
+    'Sao Tome and Principe' => 'ST',
+    'Saudi Arabia' => 'SA',
+    'Senegal' => 'SN',
+    'Serbia' => 'RS',
+    'Seychelles' => 'SC',
+    'Sierra Leone' => 'SL',
+    'Singapore' => 'SG',
+    'Slovakia' => 'SK',
+    'Slovenia' => 'SI',
+    'Solomon Islands' => 'SB',
+    'Somalia' => 'SO',
+    'South Africa' => 'ZA',
+    'South Georgia and the South Sandwich Islands' => 'GS',
+    'Spain' => 'ES',
+    'Sri Lanka' => 'LK',
+    'Sudan' => 'SD',
+    'Suriname' => 'SR',
+    'Svalbard and Jan Mayen' => 'SJ',
+    'Swaziland' => 'SZ',
+    'Sweden' => 'SE',
+    'Switzerland' => 'CH',
+    'Syrian Arab Republic' => 'SY',
+    'Taiwan, Province of China' => 'TW',
+    'Tajikistan' => 'TJ',
+    'Tanzania, United Republic of' => 'TZ',
+    'Thailand' => 'TH',
+    'Timor-Leste' => 'TL',
+    'Togo' => 'TG',
+    'Tokelau' => 'TK',
+    'Tonga' => 'TO',
+    'Trinidad and Tobago' => 'TT',
+    'Tunisia' => 'TN',
+    'Turkey' => 'TR',
+    'Turkmenistan' => 'TM',
+    'Turks and Caicos Islands' => 'TC',
+    'Tuvalu' => 'TV',
+    'Uganda' => 'UG',
+    'Ukraine' => 'UA',
+    'United Arab Emirates' => 'AE',
+    'United Kingdom' => 'GB',
+    'United States' => 'US',
+    'United States Minor Outlying Islands' => 'UM',
+    'Uruguay' => 'UY',
+    'Uzbekistan' => 'UZ',
+    'Vanuatu' => 'VU',
+    'Venezuela, Bolivarian Republic of' => 'VE',
+    'Viet Nam' => 'VN',
+    'Virgin Islands, British' => 'VG',
+    'Virgin Islands, U.S.' => 'VI',
+    'Wallis and Futuna' => 'WF',
+    'Western Sahara' => 'EH',
+    'Yemen' => 'YE',
+    'Zambia' => 'ZM',
+    'Zimbabwe' => 'ZW'
+  }.freeze
+
+end # JSS