usps-imis-api 0.15.3 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6192c91d6014b89e3cb78b0afc8b05cb0cd8f44352bdbeb6fe55ac99d02bf9d4
-  data.tar.gz: f37891d8dabf058351c6dae8bc12f54b5c8752acdac352b52a1fc27add15b749
+  metadata.gz: 361559cb3f665d7f221b5783652cbfd95db8d217e1bb882dc6e171cb864cb7f6
+  data.tar.gz: b7a096a763c9ae01c23d60e80aac6d2ceb11b789314dc94f9f379db775cba039
 SHA512:
-  metadata.gz: 25d2d665ce5a3e323977de8c2308fad23284ef1fa3fb93b56b68f0e649978214d3cd296e4a4792f23eb09a9992fee3412344097055088191cecc64f8ffc13c58
-  data.tar.gz: e79ca2364a98b9394a21c2c213e35cfb956c75990a790baa99ae49f4441e652aa573bee3b4247aaa224f2b8684cec64a5f12b935ee72d41538cbfcef7430f9bd
+  metadata.gz: 8370f2fc2e3b9d416fc79ea96f29a03f6cc904101fda60c8bae222c134094f439c3f12b211d844290fbdf50bccfd5ced67b2a5a6daccabaedd71b2fb6e96a984
+  data.tar.gz: 33f55ebc156713e025a93ad1db4d8b1d5846af59fb56dabacd1d8730857066309e0882b6a602efb7b0ef9e3e6e30328e31350c02ec477bcbadc5800f657206d4

data/lib/usps/imis/api.rb

@@ -255,6 +255,22 @@ module Usps
         @panels ||= Panels.all(self)
       end
 
+      # Build a +GroupMembership+ wrapper for a group, using this instance as its parent +Api+
+      #
+      # @param group_id [String] Full group identifier, e.g. +COMMITTEE/SQUADRON525+
+      #
+      # @return [Usps::Imis::GroupMembership]
+      #
+      def group_membership(group_id) = GroupMembership.new(self, group_id:)
+
+      # Convenience for committee groups — pass the bare committee code
+      #
+      # @param code [String, Symbol] Committee code, e.g. +SQUADRON525+ or +NAV+
+      #
+      # @return [Usps::Imis::GroupMembership]
+      #
+      def committee(code) = group_membership("COMMITTEE/#{code}")
+
       # Used by the CLI wrappers to reduce authentication requests
       #
       def auth_token

data/lib/usps/imis/command_line/formatters.rb

@@ -17,6 +17,8 @@ module Usps
 
         # rubocop:disable Metrics/MethodLength,Metrics/AbcSize
         def simplify(data)
+          return simplify_details(data) if details?(data)
+
           data = data.to_a if data.is_a?(Query)
           data = data.map { it.is_a?(Models::Base) ? it.data : it } if data.is_a?(Array)
           data = data.data if data.is_a?(Models::Base)
@@ -48,6 +50,15 @@ module Usps
           data
         end
 
+        def details?(data)
+          data.is_a?(GroupMembership::Detail) || (data.is_a?(Array) && data.any? && data.all?(GroupMembership::Detail))
+        end
+
+        def simplify_details(data)
+          format = force_raw_output? ? :raw : :properties
+          data.is_a?(Array) ? data.map(&format) : data.public_send(format)
+        end
+
         def force_raw_output? = options[:raw] || RAW_HASH_RESPONSE_OPTIONS.any? { options[it] }
 
         # :nocov:

data/lib/usps/imis/command_line/options.yml

@@ -12,6 +12,12 @@ Subcommands:
     option:
       type: string
       short: P
+  group:
+    description: Interact with a member's positions in a Group (e.g. `%{green:COMMITTEE/NOM}`)
+    value: id
+    option:
+      type: string
+      short: G
   query:
     description: Run an IQA or Business Object Query
     value: name
@@ -56,23 +62,28 @@ Options:
       - type: string
         short: u
 
-  Business Object or Panel:
+  Business Object, Panel, or Group:
     create:
-      - Send a %{cyan:POST} request
+      - Send a %{cyan:POST} request (for a Group, add a position)
       - short: C
     delete:
-      - Send a %{cyan:DELETE} request
+      - Send a %{cyan:DELETE} request (for a Group, remove a position)
       - short: D
     all:
       - Send a %{cyan:GET} request for all records for a member
       - short: A
 
-  Panel:
+  Panel or Group:
     ordinal:
-      - Ordinal ID within a Panel
+      - Ordinal ID within a Panel, or position sequence number within a Group
       - type: integer
         short: r
 
+  Group:
+    roles:
+      - List the Group's role (position) catalog
+      - short: K
+
   Query:
     page:
       - Specific page number from a query to return

data/lib/usps/imis/command_line/options_parser.rb

@@ -14,7 +14,7 @@ module Usps
         CONFLICTING_OPTION_GROUPS = [
           %i[certificate id uuid],
           %i[certificate record_id uuid],
-          %i[object panel query mapper map] + SOLO_FLAGS,
+          %i[object panel group query mapper map] + SOLO_FLAGS,
           %i[field fields map query],
           %i[raw include_ids],
           %i[raw jsonl csv],
@@ -29,7 +29,9 @@ module Usps
           *(SOLO_FLAGS + QUERY_FLAGS + %i[mapper map field fields certificate]).map { [:create, it] },
           *(SOLO_FLAGS + QUERY_FLAGS + %i[mapper map field fields certificate data raw]).map { [:delete, it] },
           *(SOLO_FLAGS + QUERY_FLAGS + %i[mapper map object]).map { [:ordinal, it] },
-          *(SOLO_FLAGS + %i[certificate]).map { [:data, it] }
+          *(SOLO_FLAGS + %i[certificate]).map { [:data, it] },
+          *(SOLO_FLAGS + QUERY_FLAGS + %i[object panel mapper map create delete all ordinal data field fields])
+            .map { [:roles, it] }
         ].freeze
 
         attr_reader :options
@@ -111,8 +113,11 @@ module Usps
         end
 
         def pre_process_options!
+          # Empty STDIN (e.g. /dev/null under a web server or cron) is not data
+          #
           # :nocov:
-          @options[:data] = read_stdin if stdin?
+          stdin_data = read_stdin if stdin?
+          @options[:data] = stdin_data unless stdin_data.to_s.strip.empty?
           # :nocov:
 
           @options[:data] = JSON.parse(@options[:data]) if @options[:data]

data/lib/usps/imis/command_line/performers.rb

@@ -15,6 +15,7 @@ module Usps
           in mapper:, **extra then perform_mapper(mapper, **extra)
           in object:, **extra then perform_object(object, **extra)
           in panel:, **extra then perform_panel(panel, **extra)
+          in group:, **extra then perform_group(group, **extra)
           in query:, **extra then perform_query(query, **extra)
           in business_objects: true then api.business_objects
           in auth_token: true then api.auth_token
@@ -34,6 +35,7 @@ module Usps
             in mapper: true then converted[:mapper] = api.mapper
             in object: then converted[:object] = api.on(object)
             in panel: then converted[:panel] = api.panels.public_send(panel)
+            in group: then converted[:group] = api.group_membership(group)
             else # Nothing to convert
             end
 
@@ -77,6 +79,29 @@ module Usps
           end
         end
 
+        # Group positions are addressed by their sequence number, passed as +ordinal+
+        #
+        def perform_group(group, **options)
+          case options
+          in roles: true then group.roles.map(&:to_h)
+          in delete: true, ordinal: then group.remove(ordinal)
+          in create: true, data: then group.add(group_data(data, 'role'), **group_dates(data))
+          in ordinal:, data: then group.expire(ordinal, on: group_data(data, 'expires_on'))
+          in ordinal: then group.find_detail(ordinal)
+          else group.details
+          end
+        end
+
+        def group_data(data, key)
+          data.transform_keys(&:to_s).fetch(key) do
+            raise Errors::CommandLineError, "Group data must include #{key.inspect}"
+          end
+        end
+
+        def group_dates(data)
+          data.transform_keys(&:to_s).slice('effective_on', 'expires_on').transform_keys(&:to_sym)
+        end
+
         def perform_query(query, **options)
           kwargs = options.slice(:page_size, :offset)
           kwargs.merge!(options[:data]) if options[:data]

data/lib/usps/imis/errors/ambiguous_detail_error.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Usps
+  module Imis
+    module Errors
+      # Exception raised when multiple membership details match the given
+      # reference — retry with the detail's +sequence_number+ or full +id+
+      #
+      class AmbiguousDetailError < Error
+        attr_reader :group_id, :ref, :matches
+
+        def initialize(group_id, ref, matches)
+          @group_id = group_id
+          @ref = ref
+          @matches = matches
+          super(message)
+        end
+
+        def message
+          "Multiple membership details match #{ref.inspect} for group #{group_id}: " \
+            "#{matches.map(&:id).join(', ')}"
+        end
+      end
+    end
+  end
+end

data/lib/usps/imis/errors/detail_not_found_error.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Usps
+  module Imis
+    module Errors
+      # Exception raised when no membership detail matches the given reference
+      #
+      class DetailNotFoundError < Error
+        attr_reader :group_id, :ref
+
+        def initialize(group_id, ref)
+          @group_id = group_id
+          @ref = ref
+          super(message)
+        end
+
+        def message = "No membership detail matches #{ref.inspect} for group #{group_id}"
+      end
+    end
+  end
+end

data/lib/usps/imis/errors/unknown_role_error.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Usps
+  module Imis
+    module Errors
+      # Exception raised when assigning a role that is not in the group's role catalog
+      #
+      class UnknownRoleError < Error
+        attr_reader :group_id, :role_id
+
+        def initialize(group_id, role_id)
+          @group_id = group_id
+          @role_id = role_id
+          super(message)
+        end
+
+        def message = "Role #{role_id} is not in the role catalog for group #{group_id}"
+      end
+    end
+  end
+end

data/lib/usps/imis/group_membership/detail.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+module Usps
+  module Imis
+    class GroupMembership
+      # Read-only view of one +MembershipDetails+ entry — a single held
+      # position (job) on a group — wrapping the raw API hash.
+      #
+      class Detail
+        # Placeholder used by iMIS for unset dates
+        #
+        UNSET_DATE = '0001-01-01T00:00:00'
+
+        # The raw API hash for this detail
+        #
+        attr_reader :raw
+
+        def initialize(raw)
+          @raw = raw
+        end
+
+        # Composite identifier, e.g. +COMMITTEE/SQUADRON525:31092:372094+
+        #
+        def id = raw['GroupMemberDetailId']
+
+        # Server-assigned integer key (the trailing element of +id+); matches
+        # the legacy +CsCommittee.SequenceNumber+
+        #
+        def sequence_number
+          return if id.nil?
+
+          id.split(':').last.to_i
+        end
+
+        # Namespaced role identifier, e.g. +COMMITTEE:SCDR+
+        #
+        def role_id = raw.dig('Role', 'RoleId')
+
+        # Bare position code, e.g. +SCDR+
+        #
+        def role_code = role_id&.split(':')&.last
+
+        # Display title, e.g. +Squadron Commander+
+        #
+        def role_name = raw.dig('Role', 'Name')
+
+        # Term start; +nil+ when unset
+        #
+        def effective_date = parse_date(raw['EffectiveDate'])
+
+        # Term end; +nil+ while the term is open
+        #
+        def expiration_date = parse_date(raw['ExpirationDate'])
+
+        # Whether iMIS considers the position currently held (the server
+        # recalculates this from the term dates on every save)
+        #
+        def active? = !!raw['IsActive']
+
+        # Whether the term has already ended by +on+ -- unlike +active?+, a future-dated term has not
+        #
+        # @param on [Date] Date to check against (defaults to today)
+        #
+        def ended?(on = Date.today) = !expiration_date.nil? && expiration_date < on
+
+        # Whether +ref+ identifies this detail: an +Integer+ matches
+        # +sequence_number+; a +String+ / +Symbol+ matches +id+, +role_id+,
+        # or +role_code+ exactly.
+        #
+        def matches?(ref)
+          return sequence_number == ref if ref.is_a?(Integer)
+
+          [id, role_id, role_code].include?(ref.to_s)
+        end
+
+        def to_h = raw
+
+        # Simplified data, as returned by the CLI
+        #
+        def properties
+          {
+            'id' => id,
+            'sequence_number' => sequence_number,
+            'role_id' => role_id,
+            'role_code' => role_code,
+            'role_name' => role_name,
+            'effective_date' => effective_date&.iso8601,
+            'expiration_date' => expiration_date&.iso8601,
+            'active' => active?
+          }
+        end
+
+      private
+
+        def parse_date(value)
+          return if value.nil? || value.to_s.empty? || value == UNSET_DATE
+
+          Date.parse(value)
+        end
+      end
+    end
+  end
+end

data/lib/usps/imis/group_membership.rb

@@ -0,0 +1,288 @@
+# frozen_string_literal: true
+
+require_relative 'group_membership/detail'
+
+module Usps
+  module Imis
+    # Wrapper for the +GroupMember+ SOA entity — the write path for committee
+    # membership and job (position) assignments.
+    #
+    # iMIS stores one +GroupMember+ document per (group, member) pair, holding
+    # the member's positions as a nested +MembershipDetails+ collection.
+    # Saving is a full-document POST with *replace* semantics: any detail
+    # omitted from the posted document is deleted by the server. Every
+    # mutation here therefore re-fetches the current document, modifies the
+    # complete detail list, and posts it back — never a partial list.
+    #
+    # Single-resource URLs (+api/GroupMember/COMMITTEE%2FSQUADRON525:31092+)
+    # are unusable for committee records — the colon in the composite ID trips
+    # IIS request filtering — so all requests go through the collection URL.
+    #
+    # @example Assign, expire, and remove a squadron job
+    #   membership = api.with(31092).committee('SQUADRON525')
+    #   membership.add('SHIST', effective_on: Date.new(2026, 7, 3))
+    #   membership.expire('SHIST', on: Date.new(2027, 1, 31))
+    #   membership.remove('SHIST')
+    #
+    class GroupMembership
+      include Requests
+
+      # Endpoint for GroupMember documents
+      #
+      API_PATH = 'api/GroupMember'
+
+      # Endpoint for Group definitions (role catalog, stages)
+      #
+      GROUP_API_PATH = 'api/Group'
+
+      # Type discriminators required by the iMIS JSON deserializer when
+      # constructing payloads from scratch
+      #
+      TYPES = {
+        document: 'Asi.Soa.Membership.DataContracts.GroupMemberData, Asi.Contracts',
+        collection: 'Asi.Soa.Membership.DataContracts.GroupMemberDetailDataCollection, Asi.Contracts',
+        detail: 'Asi.Soa.Membership.DataContracts.GroupMemberDetailData, Asi.Contracts',
+        stage: 'Asi.Soa.Membership.DataContracts.GroupStageData, Asi.Contracts',
+        role: 'Asi.Soa.Membership.DataContracts.GroupRoleData, Asi.Contracts',
+        group: 'Asi.Soa.Membership.DataContracts.GroupSummaryData, Asi.Contracts',
+        party: 'Asi.Soa.Membership.DataContracts.PartySummaryData, Asi.Contracts'
+      }.freeze
+
+      # One entry from the group's role (position) catalog
+      #
+      Role = ::Data.define(:role_id, :name)
+
+      # The parent +Api+ object
+      #
+      attr_reader :api
+
+      # Full group identifier, e.g. +COMMITTEE/SQUADRON525+
+      #
+      attr_reader :group_id
+
+      # Tagged logger
+      #
+      attr_reader :logger
+
+      # @param api [Api] Parent to use for making requests
+      # @param group_id [String] Full group identifier, e.g. +COMMITTEE/SQUADRON525+
+      # @param imis_id [Integer, String] iMIS ID to select immediately
+      #
+      def initialize(api = nil, group_id:, imis_id: nil)
+        @api = api || Api.new
+        @group_id = group_id.to_s
+        @api.imis_id = imis_id if imis_id
+        @logger = Imis.logger('GroupMembership', @group_id)
+      end
+
+      # The current member's raw +GroupMember+ document, always fetched fresh
+      #
+      # @return [Hash, nil] +nil+ when the member has no membership in the group
+      #
+      def document = get_json(document_uri).dig('Items', '$values', 0)
+
+      # The current member's held positions in the group
+      #
+      # @return [Array<Detail>]
+      #
+      def details = wrap_details(document)
+
+      # Whether the current member actively holds a matching position
+      #
+      # @param ref [Integer, String, Symbol] See +Detail#matches?+
+      #
+      def held?(ref) = details.any? { it.matches?(ref) && it.active? }
+
+      # The group's role (position) catalog
+      #
+      # @return [Array<Role>]
+      #
+      def roles
+        (group_document.dig('Roles', '$values') || []).map do |entry|
+          Role.new(role_id: entry['RoleId'], name: entry['Name'])
+        end
+      end
+
+      # Assign a position to the current member
+      #
+      # The role must exist in the group's role catalog. Creates the
+      # +GroupMember+ document if the member has no membership in the group yet.
+      #
+      # Safe to retry: if the member already has a term in that role starting on the
+      # same date that hasn't ended, that detail is returned and nothing is saved.
+      #
+      # @param role [String, Symbol] Position code (+SHIST+) or full role ID (+COMMITTEE:SHIST+)
+      # @param effective_on [Date, String] Term start (defaults to today)
+      # @param expires_on [Date, String] Term end (defaults to an open term)
+      #
+      # @return [Detail] The created (or matching existing) detail, with its server-assigned key
+      #
+      def add(role, effective_on: nil, expires_on: nil)
+        entry = catalog_role(role)
+        doc = document || blank_document
+        effective_on = parse_date(effective_on || Date.today)
+
+        if (duplicate = find_duplicate(doc, entry, effective_on))
+          logger.info "#{duplicate.role_id} starting #{effective_on} already exists (#{duplicate.id})"
+          return duplicate
+        end
+
+        existing = detail_ids(doc)
+        doc['MembershipDetails']['$values'] << build_detail(entry, effective_on, expires_on)
+        wrap_details(save(doc)).find { existing.exclude?(it.id) }
+      end
+      alias assign add
+
+      # End the current member's term in a position
+      #
+      # @param ref [Integer, String, Symbol] See +Detail#matches?+
+      # @param on [Date, String] Term end date (defaults to today)
+      #
+      # @return [Detail] The updated detail
+      #
+      def expire(ref, on: Date.today)
+        doc = document
+        target = find_detail(ref, wrap_details(doc))
+        target.raw['ExpirationDate'] = format_date(on)
+        find_detail(target.id, wrap_details(save(doc)))
+      end
+
+      # Remove a position from the current member entirely
+      #
+      # Prefer +expire+ for normal end-of-term flows — +remove+ erases the
+      # record (including from the legacy +CsCommittee+ table).
+      #
+      # @param ref [Integer, String, Symbol] See +Detail#matches?+
+      #
+      # @return [true] Only on success response
+      #
+      def remove(ref) # rubocop:disable Naming/PredicateMethod
+        doc = document
+        target = find_detail(ref, wrap_details(doc))
+        doc['MembershipDetails']['$values'].reject! { it['GroupMemberDetailId'] == target.id }
+        save(doc)
+        true
+      end
+
+      # Find exactly one detail matching +ref+
+      #
+      # When several details match (e.g. a role code the member has held before),
+      # the single one whose term hasn't ended is chosen.
+      #
+      # @param ref [Integer, String, Symbol] See +Detail#matches?+
+      # @param details [Array<Detail>] Details to search (fetched fresh by default)
+      #
+      # @return [Detail]
+      #
+      def find_detail(ref, details = self.details)
+        matches = details.select { it.matches?(ref) }
+        raise Errors::DetailNotFoundError.new(group_id, ref) if matches.empty?
+        return matches.first if matches.one?
+
+        current = matches.reject(&:ended?)
+        raise Errors::AmbiguousDetailError.new(group_id, ref, matches) unless current.one?
+
+        current.first
+      end
+
+      # Ruby 3.5 instance variable filter
+      #
+      def instance_variables_to_inspect = instance_variables - %i[@api @logger @group_document @current_uri]
+
+    private
+
+      def party_id
+        raise Errors::MissingIdError if api.imis_id.nil?
+
+        api.imis_id
+      end
+
+      # The group's own definition document (role catalog, stages, class)
+      #
+      def group_document
+        @group_document ||= get_json(group_uri)
+      end
+
+      def role_prefix = group_document.dig('GroupClass', 'GroupClassId')
+
+      def role_id_for(role)
+        role = role.to_s
+        role.include?(':') ? role : "#{role_prefix}:#{role}"
+      end
+
+      def catalog_role(role)
+        role_id = role_id_for(role)
+        entry = (group_document.dig('Roles', '$values') || []).find { it['RoleId'] == role_id }
+        entry || raise(Errors::UnknownRoleError.new(group_id, role_id))
+      end
+
+      def default_stage_id
+        stages = group_document.dig('AvailableStages', '$values') || []
+        stages.find { it['IsDefault'] }&.dig('Stage', 'GroupStageId') || role_prefix
+      end
+
+      def wrap_details(doc)
+        (doc&.dig('MembershipDetails', '$values') || []).map { Detail.new(it) }
+      end
+
+      def detail_ids(doc) = doc['MembershipDetails']['$values'].map { it['GroupMemberDetailId'] }
+
+      def find_duplicate(doc, role_entry, effective_on)
+        wrap_details(doc).find do |detail|
+          detail.role_id == role_entry['RoleId'] && detail.effective_date == effective_on.to_date && !detail.ended?
+        end
+      end
+
+      def build_detail(role_entry, effective_on, expires_on)
+        {
+          '$type' => TYPES[:detail],
+          'Stage' => { '$type' => TYPES[:stage], 'GroupStageId' => default_stage_id },
+          'EffectiveDate' => format_date(effective_on),
+          'IsActive' => true,
+          'Role' => { '$type' => TYPES[:role], 'RoleId' => role_entry['RoleId'], 'Name' => role_entry['Name'] }
+        }.tap { it['ExpirationDate'] = format_date(expires_on) if expires_on }
+      end
+
+      def blank_document
+        {
+          '$type' => TYPES[:document],
+          'GroupMemberId' => "#{group_id}:#{party_id}",
+          'Group' => { '$type' => TYPES[:group], 'GroupId' => group_id, 'Name' => group_document['Name'] },
+          'Party' => { '$type' => TYPES[:party], 'PartyId' => party_id.to_s, 'Id' => party_id.to_s },
+          'IsActive' => true,
+          'MembershipDetails' => { '$type' => TYPES[:collection], '$values' => [] }
+        }
+      end
+
+      # Accepts date strings (e.g. +2026-07-03+ from the CLI) as well as date objects
+      #
+      def parse_date(value) = value.is_a?(String) ? Date.parse(value) : value
+
+      def format_date(value) = parse_date(value).strftime('%Y-%m-%dT%H:%M:%S')
+
+      def save(doc)
+        @current_uri = URI(File.join(Imis.configuration.hostname, API_PATH))
+        request = Net::HTTP::Post.new(@current_uri)
+        request['Content-Type'] = 'application/json'
+        request.body = JSON.dump(doc)
+        JSON.parse(submit(authorize(request)).body)
+      end
+
+      def get_json(target_uri)
+        @current_uri = target_uri
+        JSON.parse(submit(authorize(Net::HTTP::Get.new(target_uri))).body)
+      end
+
+      def document_uri
+        params = { GroupId: group_id, PartyId: party_id, Limit: 1 }.to_query
+        URI(File.join(Imis.configuration.hostname, "#{API_PATH}?#{params}"))
+      end
+
+      def group_uri = URI(File.join(Imis.configuration.hostname, GROUP_API_PATH, CGI.escape(group_id)))
+
+      # Requests#submit logs the current request URI via this reader
+      #
+      def uri(...) = @current_uri
+    end
+  end
+end

data/lib/usps/imis/panels/base_panel.rb

@@ -94,16 +94,20 @@ module Usps
         #
         # @return [Usps::Imis::Data] Response data from the API
         #
-        def put(data) = api.on(business_object_name, ordinal: data[:ordinal]).put(payload(data))
+        def put(data)
+          data = data.transform_keys(&:to_sym)
+          api.on(business_object_name, ordinal: data[:ordinal]).put(payload(data))
+        end
         alias update put
 
         # Create a new object in the Panel
         #
-        # @param data [Hash] The record data for the desired object
+        # @param data [Hash] The record data for the desired object (String keys, as parsed from
+        #                    JSON by the CLI, are accepted)
         #
         # @return [Usps::Imis::Data] Response data from the API
         #
-        def post(data) = api.on(business_object_name).post(payload(data))
+        def post(data) = api.on(business_object_name).post(payload(data.transform_keys(&:to_sym)))
         alias create post
 
         # Remove a specific object from the Panel

data/lib/usps/imis/panels/rank.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Usps
+  module Imis
+    module Panels
+      # Panel for accessing the rank and job history business object
+      #
+      class Rank < BasePanel
+        # Payload keys, and the properties they set
+        #
+        PROPERTIES = {
+          job_year: 'JOB_YEAR',
+          job_code: 'JOB_CODE',
+          job_description: 'JOB_DESCRIPTION',
+          job_rank: 'JOB_RANK',
+          past_job_rank: 'PAST_JOB_RANK',
+          rank: 'Rank',
+          rank_status: 'Rank_Status',
+          rank_begin_date: 'RankBeginDate',
+          rank_end_date: 'RankEndDate'
+        }.freeze
+
+        # Payload keys holding dates
+        #
+        DATES = %i[rank_begin_date rank_end_date].freeze
+
+        def business_object_name = 'ABC_ASC_RANK'
+
+      private
+
+        # Only the provided keys are set, since every property is optional
+        #
+        def payload(data)
+          build_payload(data) do |props|
+            PROPERTIES.each do |key, name|
+              props.add(name, property_value(key, data[key])) unless data[key].nil?
+            end
+          end
+        end
+
+        def property_value(key, value)
+          return Integer(value) if key == :job_year
+          return Date.parse(value.to_s).strftime('%Y-%m-%dT00:00:00') if DATES.include?(key)
+
+          value.to_s
+        end
+      end
+    end
+  end
+end

data/lib/usps/imis/panels.rb

@@ -3,6 +3,7 @@
 require_relative 'panels/base_panel'
 require_relative 'panels/vsc'
 require_relative 'panels/education'
+require_relative 'panels/rank'
 
 module Usps
   module Imis

data/lib/usps/imis/version.rb

@@ -2,6 +2,6 @@
 
 module Usps
   module Imis
-    VERSION = '0.15.3'
+    VERSION = '0.16.0'
   end
 end

data/lib/usps/imis.rb

@@ -18,6 +18,7 @@ require_relative 'imis/properties'
 require_relative 'imis/blank_object'
 require_relative 'imis/models'
 require_relative 'imis/panels'
+require_relative 'imis/group_membership'
 require_relative 'imis/mocks'
 require_relative 'imis/version'
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: usps-imis-api
 version: !ruby/object:Gem::Version
-  version: 0.15.3
+  version: 0.16.0
 platform: ruby
 authors:
 - Julian Fiander
@@ -120,9 +120,11 @@ files:
 - lib/usps/imis/dependencies.rb
 - lib/usps/imis/error.rb
 - lib/usps/imis/errors/ambiguous_certificate_error.rb
+- lib/usps/imis/errors/ambiguous_detail_error.rb
 - lib/usps/imis/errors/api_error.rb
 - lib/usps/imis/errors/command_line_error.rb
 - lib/usps/imis/errors/config_error.rb
+- lib/usps/imis/errors/detail_not_found_error.rb
 - lib/usps/imis/errors/embedded_model_find_error.rb
 - lib/usps/imis/errors/empty_payload_error.rb
 - lib/usps/imis/errors/locked_id_error.rb
@@ -134,6 +136,9 @@ files:
 - lib/usps/imis/errors/pattern_matching_error.rb
 - lib/usps/imis/errors/response_error.rb
 - lib/usps/imis/errors/unexpected_property_type_error.rb
+- lib/usps/imis/errors/unknown_role_error.rb
+- lib/usps/imis/group_membership.rb
+- lib/usps/imis/group_membership/detail.rb
 - lib/usps/imis/helpers.rb
 - lib/usps/imis/logger.rb
 - lib/usps/imis/logger_formatter.rb
@@ -601,6 +606,7 @@ files:
 - lib/usps/imis/panels.rb
 - lib/usps/imis/panels/base_panel.rb
 - lib/usps/imis/panels/education.rb
+- lib/usps/imis/panels/rank.rb
 - lib/usps/imis/panels/vsc.rb
 - lib/usps/imis/party_data.rb
 - lib/usps/imis/properties.rb