Class: Usps::Imis::Panels::BasePanel

Inherits:
Object
  • Object
show all
Defined in:
lib/usps/imis/panels/base_panel.rb

Overview

Base class for configuring Panels

Direct Known Subclasses

Education, Vsc

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(api = nil, imis_id: nil) ⇒ BasePanel

Returns a new instance of BasePanel.



13
14
15
16
 
# File 'lib/usps/imis/panels/base_panel.rb', line 13

def initialize(api = nil, imis_id: nil)
  @api = api || Api.new
  @api.imis_id = imis_id if imis_id
end

Instance Attribute Details

#api ⇒ Object (readonly)

The parent Api object



11
12
13
 
# File 'lib/usps/imis/panels/base_panel.rb', line 11

def api
  @api
end

Instance Method Details

#delete(ordinal) ⇒ true Also known as: destroy

Remove a specific object from the Panel

Parameters:

  • ordinal (Integer) —

    The ordinal identifier for the desired object

Returns:

  • (true) —

    Only on success response (i.e. blank string from the API)



98
 
# File 'lib/usps/imis/panels/base_panel.rb', line 98

def delete(ordinal) = api.on(business_object, ordinal:).delete

#get(ordinal, *fields) ⇒ Usps::Imis::Data+ Also known as: read

Get a specific object from the Panel

If fields is provided, will return only those field values

Parameters:

  • fields (String) —

    Field names to return

  • ordinal (Integer) —

    The ordinal identifier for the desired object

Returns:



28
 
# File 'lib/usps/imis/panels/base_panel.rb', line 28

def get(ordinal, *fields) = api.on(business_object, ordinal:).get(*fields)

#get_field(ordinal, field) ⇒ Object Also known as: fetch, []

Get a single named field from a Panel for the current member

Parameters:

  • ordinal (Integer) —

    The ordinal identifier for the desired object

  • field (String) —

    Field name to return

Returns:

  • Response data field value from the API



38
 
# File 'lib/usps/imis/panels/base_panel.rb', line 38

def get_field(ordinal, field) = api.on(business_object, ordinal:).get_field(field)

#get_fields(ordinal, *fields) ⇒ Array Also known as: fetch_all

Get named fields from a Panel for the current member

Parameters:

  • ordinal (Integer) —

    The ordinal identifier for the desired object

  • fields (Array<String>) —

    Field names to return

Returns:

  • (Array) —

    Response data from the API



49
 
# File 'lib/usps/imis/panels/base_panel.rb', line 49

def get_fields(ordinal, *fields) = api.on(business_object, ordinal:).get_fields(*fields)

#instance_variables_to_inspect ⇒ Object

Ruby 3.5 instance variable filter



103
 
# File 'lib/usps/imis/panels/base_panel.rb', line 103

def instance_variables_to_inspect = instance_variables - i[@api]

#post(data) ⇒ Usps::Imis::Data Also known as: create

Create a new object in the Panel

Parameters:

  • data (Hash) —

    The record data for the desired object

Returns:



89
 
# File 'lib/usps/imis/panels/base_panel.rb', line 89

def post(data) = api.on(business_object).post(payload(data))

#put(data) ⇒ Usps::Imis::Data Also known as: update

Update an existing object in the Panel

Parameters:

  • data (Hash) —

    The record data for the desired object – including the required ordinal identifier

Returns:



80
 
# File 'lib/usps/imis/panels/base_panel.rb', line 80

def put(data) = api.on(business_object, ordinal: data[:ordinal]).put(payload(data))

#put_field(ordinal, field, value) ⇒ Usps::Imis::Data Also known as: []=

Update a single named field on a business object for the current member

Parameters:

  • ordinal (Integer) —

    The ordinal identifier for the desired object

  • field (String) —

    Name of the field

  • value —

    Value of the field

Returns:



60
 
# File 'lib/usps/imis/panels/base_panel.rb', line 60

def put_field(ordinal, field, value) = api.on(business_object, ordinal:).put_field(field, value)

#put_fields(ordinal, fields) ⇒ Usps::Imis::Data Also known as: patch

Update only specific fields on a Panel for the current member

Parameters:

  • ordinal (Integer) —

    The ordinal identifier for the desired object

  • fields (Hash) —

    Conforms to pattern { field_key => value }

Returns:



70
 
# File 'lib/usps/imis/panels/base_panel.rb', line 70

def put_fields(ordinal, fields) = api.on(business_object, ordinal:).put_fields(fields)