NCGS handover questions

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

The fieldworker form for a tree delivery: a consignment with lines, recipient, tags and acknowledgement.

What it captures

Questions

Consignment

  • Which site is this delivery attempt for? (required)
    • The site the trees were handed over at.
    • Help: Pick the destination site, including when no trees were handed over. Any registered site is allowed, even one not yet cleared for planting.
  • Which delivery round is this part of? (required)
    • The delivery round this handover belongs to.
    • Help: Usually today’s delivery round.
  • What was the outcome of this attempt to deliver the trees? (required)
  • Who received the trees? (required)
    • The person who took charge of the trees, and their role.
    • Help: Pick the person from the people list and their role. For a nursery delivery to a Nova planting site, pick the implementing partner. Do not write names.
  • Which nursery dispatch supplied the trees for this delivery?
    • The batch packed at the nursery for this site that these trees arrived in, if there was one.
    • Help: Pick the dispatch packed for this site. Leave empty if the nursery did not pack the trees for this site first; you then name the nursery.
  • Which nursery supplied the trees? (required)
    • The nursery that supplied the trees, recorded with its nursery role.
    • Help: Only when no dispatch is named: pick the nursery from the list of enrolled nurseries. Its role is nursery. When you named a dispatch, the trees came from its nursery and nothing more is asked.
  • On what date were the trees handed over? (required)
    • The day the recipient took charge of the trees.
    • Help: Today, unless you are entering a paper record.
  • Record the species and container size of the trees in this delivery. (required)
    • One line per species or cultivar and container size.
    • Help: Add one line for each species or cultivar and bag size, as on the nursery delivery note. Do not record single trees here.
  • Scan each tag handed over with the trees.
    • The number on each pre-printed tag handed over with the trees. A tag belongs to a tree once it is fixed to it.
    • Help: Or type the number on the tag. Never more tags than trees.
  • Photograph the recipient’s signed acknowledgement. (required)
    • Recipient’s acknowledgement: photograph the recipient’s signed acknowledgement.
    • Help: Stick a new QR sticker on the signed form first, photograph it, then scan the sticker. The office scans the whole document later.
  • Take a photo of the trees handed over. (required)
    • Stock photograph: a photo of the trees handed over.
    • Help: A new photo, taken now with location on.
  • Any other photo or document (optional).
    • Any other photo or document, such as the nursery’s delivery note.
    • Help: Any other photo or document, such as the nursery’s delivery note.
  • Who made this observation? (filled automatically) (required)
    • The person who made this record.
    • Help: Filled in from your login.
  • In which role did you make this observation? (required)
  • Date and time recorded (filled automatically) (required)
    • When the delivery was recorded.
    • Help: Filled in automatically.
  • Capture-device latitude (decimal degrees) (required)
    • Where the phone was when the record was made.
    • Help: Filled in automatically from the device location when this record is saved.
  • Capture-device longitude (decimal degrees) (required)
    • Where the phone was when the record was made.
    • Help: Filled in automatically from the device location when this record is saved.
  • How was this information first recorded? (required)
    • Whether this was entered on the app or copied from a paper form.
    • Help: Choose the original capture method. If you are now entering a paper form, choose paper rather than the app used to transcribe it.
    • Choices: NCGS Capture Channels: Dedicated app, Paper, transcribed

Agent role

  • Which person or organisation? (required)
    • The enrolled person or organisation, never a name; the role they act in comes from their enrolment.
    • Help: Pick them from the people register. Never type a name. Their role comes from their enrolment; nothing to choose.

Consignment line

  • Which species or cultivar? (required)
    • The species or cultivar of these trees, as on the nursery label.
    • Help: Pick the cultivar if the nursery label names one. If it is not in the list, ask a supervisor to add it; do not pick another.
  • How many trees of this species and container size were handed over? (required)
    • How many trees of this species and size.
    • Help: Record the quantity against the nursery delivery note. Record how many were alive in the separate living-trees question.
  • How many of these trees were alive when the recipient took them? (required)
    • The living trees on this line the recipient confirms having received.
    • Help: Count only the trees the recipient confirms were alive. Dead trees never count as delivered.
  • How many of these living trees did the recipient say were in poor condition?
    • How many of the line’s living trees the recipient reported in poor condition.
    • Help: For example root-bound, wilted or with broken stems. Leave as 0 if none.
  • What is the capacity of each nursery bag or pot on this line? (litres) (required)
    • The size of the bag or pot the trees are in.
    • Help: Use the labelled container capacity, for example 10 or 20 litres, not the amount of water in it.

Evidence item

  • What this item is: the recipient’s signed acknowledgement (fixed by the form). (required)
  • Take the photo. (required)
    • The photo, kept by its content address.
    • Help: Use the camera. For a document, photograph its first page with its QR sticker showing.
  • Scan the QR sticker you put on the document.
    • The UUID on the QR sticker put on the paper document, so the office’s later scan can be linked to this photo.
    • Help: Only for a document: stick a new QR sticker on its first page before you photograph it. The office scans the whole document later.

Evidence item

  • What this item is: a photograph of the stock (fixed by the form). (required)
  • Take the photo. (required)
    • The photo, kept by its content address.
    • Help: Use the camera.
  • Photo latitude (from the photo)
    • Latitude of the place the photograph was taken, as recorded with it.
    • Help: Filled in from the location you capture after the photo.
  • Photo longitude (from the photo)
    • Longitude of the place the photograph was taken, as recorded with it.
    • Help: Filled in from the location you capture after the photo.

Evidence item

Build your own instrument

Instrument NCGS tree delivery form (the standard’s generated form)
standard release 0.7.0-dev
submission identifier field KEY
export timezone +02:00
links survey layer yes

Downloads: form-fields.csv, form-choices.csv

Record structure

Fields

Field Type Group Question Personal or media Resolved by
record.deliveryAttemptOutcome select_one record.deliveryAttemptOutcome What was the outcome of this attempt to deliver the trees?
record.deviceLatitude decimal Capture-device latitude (decimal degrees)
record.deviceLongitude decimal Capture-device longitude (decimal degrees)
record.handoverDate date On what date were the trees handed over?
record.hasEvidence.contentCid file record.hasEvidence Take the photo. media field
record.hasEvidence.documentTag string record.hasEvidence Scan the QR sticker you put on the document.
record.hasEvidence.evidenceType select_one record.hasEvidence.evidenceType record.hasEvidence What does this photo or document show?
record.hasEvidence.photoLatitude decimal record.hasEvidence Photo latitude (from the photo)
record.hasEvidence.photoLongitude decimal record.hasEvidence Photo longitude (from the photo)
record.hasLine.containerSizeLitres decimal record.hasLine What is the capacity of each nursery bag or pot on this line? (litres)
record.hasLine.lineQuantity integer record.hasLine How many trees of this species and container size were handed over?
record.hasLine.lineSpecies picker record.hasLine Which species or cultivar?
record.hasLine.livingTreesConfirmed integer record.hasLine How many of these trees were alive when the recipient took them?
record.hasLine.poorQualityTreesReported integer record.hasLine How many of these living trees did the recipient say were in poor condition?
record.issuedTag string Scan each tag handed over with the trees.
record.observedAt dateTime Date and time recorded (filled automatically)
login text Who made this observation? (filled automatically); In which role did you make this observation? personal field Agent from the people register; Role from the people register
record.receivedDispatch picker Which nursery dispatch supplied the trees for this delivery?
record.recipientAcknowledgement.contentCid file Take the photo. media field
record.recipientAcknowledgement.documentTag string Scan the QR sticker you put on the document.
record.recipientRole.agent agent Which person or organisation? Agent picked from the enrolled agents
record.recordsActivity picker Which delivery round is this part of?
record.recordsSite picker Which site is this delivery attempt for?
record.stockPhoto.contentCid file Take the photo. media field
record.stockPhoto.photoLatitude decimal Photo latitude (from the photo)
record.stockPhoto.photoLongitude decimal Photo longitude (from the photo)
record.suppliedBy.agent agent Which person or organisation? Agent picked from the enrolled agents

Personal field: True when the field’s value is personal data (a login, a name, a phone number): the survey layer records that the question was answered and never the answer (ADR-0007).

Choices

record.deliveryAttemptOutcome

Value Label Maps to
delivery-handed-over delivery-handed-over Handed over
delivery-nobody-available delivery-nobody-available Nobody was there to receive them
delivery-refused delivery-refused The recipient refused them
delivery-site-not-ready delivery-site-not-ready The site was not ready
delivery-no-access delivery-no-access We could not get in

record.hasEvidence.evidenceType

Value Label Maps to
site-photo site-photo Site photograph
tree-photo tree-photo Tree photograph
ground-cover-photo ground-cover-photo Ground-cover photograph
stock-photo stock-photo Stock photograph
delivery-note delivery-note Nursery delivery note
recipient-acknowledgement recipient-acknowledgement Recipient acknowledgement
attendance-register attendance-register Attendance register
site-agreement-document site-agreement-document Site agreement
on-screen-signature on-screen-signature On-screen signature
recorded-consent recorded-consent Recorded consent
agreement-notice agreement-notice Agreement notice
interview-notes interview-notes Interview notes
report-document report-document Report
database-export database-export Ledger export

This page explains the standard and does not decide conformance: only the released corpus does. It describes dataRequirements/shape2form/handover-ui-shapes.ttl, dataRequirements/shape2form/handover-annotations.ttl, questionRegister/question-register.jsonld, dataRequirements/instruments/tree-handover/mapping.ttl, dataRequirements/instruments/tree-handover/form-fields.csv, dataRequirements/instruments/tree-handover/form-choices.csv, ontology/ncgs-ontology.ttl at standard version 0.7.0-dev.