Class: Api::V2::LotResource

Inherits:
BaseResource
  • Object
show all
Defined in:
app/resources/api/v2/lot_resource.rb

Overview

TODO:

The below POST example is not currently supported by the API, but is included here for reference. This is because received_at is a required field in the model, but is not included in the resource. See Y25-236.

Note:

Access this resource via the /api/v2/lots/ endpoint.

Note:

This resource supports retrieval and creation of lots but does not allow modification after creation.

Provides a JSON:API representation of Lot.

A Lot represents a received batch of consumables (eg. tag plates) that can be assumed to share some level of QC. A lot can be generated from Gatekeeper.

For more information about JSON:API, see the JSON:API Specifications or the JSONAPI::Resources package for Sequencescape's implementation of the JSON:API standard.

Examples:

GET request to fetch all lots

GET /api/v2/lots/

GET request to fetch a specific lot by ID

GET /api/v2/lots/123/

POST request to create a new lot

POST /api/v2/lots/
{
  "data": {
    "type": "lots",
    "attributes": {
      "lot_number": "ABC123"
      // "received_at": "11"
    },
    "relationships": {
      "lot_type": {
        "data": { "type": "lot_types", "id": "1" }
      },
      "user": {
        "data": { "type": "users", "id": "1" }
      },
      "template": {
        "data": { "type": "tag_layout_templates", "id": "3" }
      }
      // "tag_layout_template": {
      //     "data": { "type": "tag_layout_templates", "id": "1"}
      // }
    }
  }
}

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods inherited from BaseResource

apply_includes, creatable_fields, default_includes, #fetchable_fields, inclusions, resolve_relationship_names_to_relations, updatable_fields

Instance Attribute Details

#lot_number ⇒ String

Note:

This field is required when creating a lot.

Returns The lot number.

Returns:

  • (String) —

    The lot number.



68
 
# File 'app/resources/api/v2/lot_resource.rb', line 68

attribute :lot_number, write_once: true

#lot_type ⇒ LotTypeResource

Note:

This relationship is required when creating a lot.

The type of lot, which governs the behaviour of a Lot.

Returns:



118
 
# File 'app/resources/api/v2/lot_resource.rb', line 118

has_one :lot_type

#lot_type_name ⇒ String? (readonly)

Retrieves the name of the lot type associated with this lot.

e.g. 'Pre Stamped Tags'

Returns:

  • (String, nil) —

    The name of the lot type, or nil if no lot type is set.



72
 
# File 'app/resources/api/v2/lot_resource.rb', line 72

attribute :lot_type_name, readonly: true

#tag_layout_template ⇒ TagLayoutTemplateResource (readonly)

Note:

This relationship is loaded only when explicitly included.

A tag layout template associated with this lot, used for specific processing workflows. This represents the same entity as template above, but is only relevant when template_type is TagLayoutTemplate.

Returns:



140
 
# File 'app/resources/api/v2/lot_resource.rb', line 140

has_one :tag_layout_template, eager_load_on_include: false

#template ⇒ TemplateResource

Note:

This relationship is required when creating a lot.

The template associated with this lot, which may vary depending on the lot type. This is a polymorphic relationship, meaning it can be linked to different entity types (TagLayoutTemplate, Tag2LayoutTemplate and Labware/PlateTemplate at time of writing).

Returns:



132
 
# File 'app/resources/api/v2/lot_resource.rb', line 132

has_one :template, polymorphic: true

#template_name ⇒ String? (readonly)

Retrieves the name of the template associated with this lot. See template association below for more details.

e.g. 'TSsc384-PCR2-nCoV-2019/V3/B'

Returns:

  • (String, nil) —

    The name of the template, or nil if no template is set.



76
 
# File 'app/resources/api/v2/lot_resource.rb', line 76

attribute :template_name, readonly: true

#user ⇒ UserResource

Note:

This relationship is required when creating a lot.

The user who created or registered this lot.

Returns:



124
 
# File 'app/resources/api/v2/lot_resource.rb', line 124

has_one :user

#uuid ⇒ Object (readonly)

A filter to return only lots with the given UUID.

Examples:

Filtering lots by UUID

GET /api/v2/lots?filter[uuid]=11111111-2222-3333-4444-555555666666


63
 
# File 'app/resources/api/v2/lot_resource.rb', line 63

attribute :uuid, readonly: true

Instance Method Details

#tag_layout_template_id ⇒ String?

Retrieves the template ID for the associated tag layout template.

Returns:

  • (String, nil) —

    The template ID, or nil if no template is set.



106
107
108
 
# File 'app/resources/api/v2/lot_resource.rb', line 106

def tag_layout_template_id
  template_id
end