Consignment

Pre-release. This site describes standard version 0.7.0-dev, which is in development and may change before version 1.0.0.

The record produced by a delivery: lines of species or cultivar, quantity and container size, a recipient as an agent in a role (ADR-0007), a delivery date, the pre-printed tags issued, the recipient’s acknowledgement and a photograph of the stock, and the recorder’s capture provenance (ADR-0004). It contains no tree individuals and claims no state of any thing (ADR-0003); a tree individual is created later, tied to its consignment, when it becomes distinguishable.

Properties

Consignment

Property Required Repeatable Value Message
capture channel yes no NCGS Capture Channels: Dedicated app, Paper, transcribed
delivery attempt outcome no no NCGS Delivery Outcomes: Handed over, Nobody was there to receive them, The recipient refused them, The site was not ready, We could not get in
delivery date yes no date A consignment has exactly one delivery date, the anchor of a delivered-only tree’s horizons.
device latitude yes no decimal
device longitude yes no decimal
has evidence no yes Evidence item A consignment’s evidence items are evidence items.
has line no yes Consignment line A consignment carries lines of species or cultivar, quantity and container size.
observed at yes no dateTime
observer yes no Agent A consignment names exactly one observer by IRI, never a literal (ADR-0004, ADR-0007).
observer role yes no NCGS Observer Roles: Fieldworker, Supervisor A delivery is recorded by a fieldworker or supervisor.
recipient no no Agent role A consignment names at most one recipient, as an agent IRI and a role (ADR-0007).
records activity yes no Tree delivery activity A consignment records exactly one tree delivery activity.
records site yes no Site A consignment is delivered to exactly one site.
tag issued no yes string An issued tag identifier is a single token, the same form as a tree’s tag number.

Consignment supply

Property Required Repeatable Value Message
received dispatch no no Dispatch record A consignment names at most one dispatch it received.
supplied by yes no Agent role A consignment names exactly one supplying nursery, as an agent IRI and a role (ADR-0007).

Also required of other records: Restatement

Property Required Repeatable Value Message
restatement reason no no string
restates no no any value A record restates at most one earlier record (ADR-0018).

Rules

  • A consignment cannot yield more tree individuals than it carried: the trees referencing it never outnumber the trees in its lines (ADR-0003).
  • A consignment carries a geotagged photograph of the stock at delivery.
  • A consignment carries no tree state and no tree: alive, condition, care, cause of death, canopy or stem measurements belong to an observation of a tree individual, and species, tag, position and stratum to the tree itself, never to a delivery (ADR-0003). Any property whose domain is a tree state, tree individual or tree observation is refused.
  • A consignment counts as delivered only with the recipient’s signed acknowledgement as an evidence item; a delivery nobody signed for is not a delivery.
  • A consignment creates no tree individuals; a tree comes into being later, when it is tagged, planted or observed (ADR-0003).
  • A consignment handed over names exactly one recipient, carries at least one line and at least two evidence items: the recipient’s acknowledgement and a photograph of the stock.
  • A failed delivery attempt delivers no trees: it carries no line and issues no tag.
  • Instance data must not use the standard’s namespace https://nova.org.za/ncgs/ (ADR-0002: instances are urn:uuid: IRIs).
  • The recipient of a consignment is a landowner, site manager, steward, owner, government department, municipality or the implementing partner.
  • The tags issued with a consignment never outnumber the trees in its lines (ADR-0003: a tag is the bearer of one tree’s identity).
  • A consignment receives only a dispatch to its own site, from its own nursery, packed before the delivery.
  • A dispatch is received by at most one consignment handed over; failed delivery attempts before it may name it too.
  • The supplier of a consignment is a nursery: an agent in the nursery role (ADR-0007).
  • A record moves to another site only by a supervisor’s or an office analyst’s correction in one role, observed at one zoned time, to a registered site current when it moves, and with each thing its restatement group introduced before it withdrawn or replaced by the move or a correction before it (ADR-0027).
  • A restatement is a record of the same type as the record it restates (ADR-0018).
  • A restatement is about the same site as the record it restates, or follows in its restatement group, unless a supervisor’s or an office analyst’s correction moves it (ADR-0018, ADR-0027).
  • A restatement is observed after the record it restates: it is the later observation that governs (ADR-0018).
  • A restatement says why the fact is restated, in a sentence or more (ADR-0018).
  • A site registration never moves: its correction registers the site its original registered, and a site registered in error is replaced (ADR-0027).

Checked by

Consignment line

One species or cultivar at one container size in a consignment, with the number of trees.

Properties

Property Required Repeatable Value Message
container size (litres) yes no decimal A consignment line records the container size of its trees.
living trees confirmed yes no integer A consignment line carries the number of living trees the recipient confirms having received; dead stock is never counted as delivered.
number of trees yes no integer A consignment line carries a positive number of trees.
poor-quality trees reported no no integer
species or cultivar of the line yes no Concept A consignment line names exactly one species or cultivar from the register. There is no free-text other.

Rules

  • A consignment line carries no tree state and no tree: alive, condition, care, cause of death, canopy or stem measurements belong to an observation of a tree individual, and tag, position and stratum to the tree itself, never to a delivery (ADR-0003). Any property whose domain is a tree state, tree individual or tree observation is refused.
  • A species listed under NEMBA category 1a or 1b may never be handed over, whatever its approval status (ADR-0009).
  • A withdrawn species or cultivar may not be handed over.
  • Instance data must not use the standard’s namespace https://nova.org.za/ncgs/ (ADR-0002: instances are urn:uuid: IRIs).
  • The living trees confirmed on a consignment line never outnumber the line’s trees.
  • The species or cultivar on a consignment line must be a concept in the NCGS species scheme (no free-text other).

Checked by

This page explains the standard and does not decide conformance: only the released corpus does. It describes ontology/ncgs-ontology.ttl, dataRequirements/handover-shapes.ttl, dataRequirements/common-shapes.ttl, methodologies/applicability-shapes.ttl at standard version 0.7.0-dev.