@indicia-js/remote-drupal NPM

@indicia-js/remote-drupal

Drupal 8 indicia-api module data synchronization functions. Helps to synchronize biological records with Indicia Warehouse (through Indicia API Drupal module).

Usage

import { Sample, Occurrence, Media } from '@indicia-js/core';
import withRemote from '@indicia-js/remote-drupal';

const SampleWithRemote = withRemote(Sample);
const OccurrenceWithRemote = withRemote(Occurrence);
const MediaWithRemote = withRemote(Media);

const sample = new SampleWithRemote();

sample.metadata = {
  survey_id: 1,
  training: true, // optional
  confidential: true, // optional
  sensitive: true, // optional
  release_status: 'R', // optional R-eleased/P-recheck/...
  record_status: 'C', // optional C-omplete/I-ncomplete/...
};

sample.remote.url = '<YOUR_API_HOST_URL>';
sample.remote.headers = {}; // can be an async function

sample.attrs.date = '12/2/2012';
sample.attrs.location = '12.345, -12.345';

var occ = new OccurrenceWithRemote();

sample.occurrences.push(occ);

// Upload to Indicia warehouse
await sample.saveRemote();

Initialization

npm i @indicia-js/remote-drupal

Configuration

You can set human friendly warehouse attribute names (ids) and values for both Sample and Occurrence attributes:

So instead of occurrence.attrs[232] = 12343 one can occurrence.attrs.taxon = 'bee', examples:

// Sample.keys
Occurrence.keys = {
  // no value mapping
  certain: {
    id: 398,
  },
  // object
  taxon: {
    id: 232,
    values: {
      1: 272198,
      bee: 12343,
    },
  },
  // array
  weather: {
    id: 122,
    values: [
      { value: 'sunny', id: 272398 },
      { value: 'rainy', id: 132343 },
    ],
  },
  // function
  colour: {
    id: 251,
    values() {
      return 'some calculated value';
    },
  },
};

API

// all models

model.id: null | Number
model.keys: Object | Function
model.getSubmission() ⇒ Array

// Sample
sample.remote: Object
sample.saveRemote() ⇒ Promise