Class: Api::V2::QcFileResource

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

Overview

Note:

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

Note:

This resource cannot be modified after creation: its endpoint will not accept PATCH requests.

Provides a JSON:API representation of QcFile which contains the QC data previously added to a piece of Labware. The file contents are stored in the database using the DbFile model.

}

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

Examples:

POST request

POST /api/v2/qc_files/
{
  "data": {
      "type": "qc_files",
      "attributes": {
          "filename": "a_test_file.csv",
          "contents": "Hello"
      },
      "relationships": {
          // "asset": {
          //     "data": {
          //         "type": "labware",
          //         "id": 26
          //     }
          // }
      }
  }

GET request for all QcFile resources

GET /api/v2/qc_files/

GET request for a QcFile with ID 123

GET /api/v2/qc_files/123/

GET request for all QcFile resources associated with a Plate with ID 123

GET /api/v2/plates/123/qc_files/

Instance Attribute Summary collapse

Class Method 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

#content_type ⇒ String (readonly)

Returns The content type, or MIME type, of the QC file.

Returns:

  • (String) —

    The content type, or MIME type, of the QC file.



50
 
# File 'app/resources/api/v2/qc_file_resource.rb', line 50

attribute :content_type, readonly: true

#contents ⇒ String

Returns The String contents of the QC file. This is usually the CSV data for the QC file. This can only be written once on creation.

Returns:

  • (String) —

    The String contents of the QC file. This is usually the CSV data for the QC file. This can only be written once on creation.



90
 
# File 'app/resources/api/v2/qc_file_resource.rb', line 90

attribute :contents, write_once: true

#created_at ⇒ DateTime (readonly)

Returns The date and time the QC file was created.

Returns:

  • (DateTime) —

    The date and time the QC file was created.



54
 
# File 'app/resources/api/v2/qc_file_resource.rb', line 54

attribute :created_at, readonly: true

#filename ⇒ String

Returns The filename of the QC file. This can only be written once on creation.

Returns:

  • (String) —

    The filename of the QC file. This can only be written once on creation.



101
 
# File 'app/resources/api/v2/qc_file_resource.rb', line 101

attribute :filename, write_once: true

#labware ⇒ LabwareResource

Returns The Labware which this QcFile belongs to.

Returns:



70
 
# File 'app/resources/api/v2/qc_file_resource.rb', line 70

has_one :labware, relation_name: :asset, foreign_key: :asset_id, write_once: true

#size ⇒ Integer (readonly)

Returns The size of the QC file in bytes.

Returns:

  • (Integer) —

    The size of the QC file in bytes.



58
 
# File 'app/resources/api/v2/qc_file_resource.rb', line 58

attribute :size, readonly: true

#uuid ⇒ String (readonly)

Returns The UUID of the bulk transfers operation.

Returns:

  • (String) —

    The UUID of the bulk transfers operation.



62
 
# File 'app/resources/api/v2/qc_file_resource.rb', line 62

attribute :uuid, readonly: true

Class Method Details

.create(context) ⇒ Object 



104
105
106
107
 
# File 'app/resources/api/v2/qc_file_resource.rb', line 104

def self.create(context)
  opts = { uploaded_data: context.slice(:filename, :tempfile) }
  new(QcFile.new(opts), context)
end

Instance Method Details

#filter_uuid ⇒ Object

Filter the QcFile resources by UUID.

Examples:

GET request with UUID filter

GET /api/v2/qc_files?filter[uuid]=12345678-1234-1234-1234-123456789012


80
 
# File 'app/resources/api/v2/qc_file_resource.rb', line 80

filter :uuid, apply: ->(records, value, _options) { records.with_uuid(value) }