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:



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

has_one :lot_type

#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.

Returns:



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

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 types of templates.

Returns:



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

has_one :template, polymorphic: true

#user ⇒ UserResource

Note:

This relationship is required when creating a lot.

The user who created or registered this lot.

Returns:



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

has_one :user

#uuid ⇒ String (readonly)

Note:

This identifier is automatically assigned upon creation and cannot be modified.

Returns The universally unique identifier (UUID) of the lot.

Returns:

  • (String) —

    The universally unique identifier (UUID) of the lot.



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