ADAPT - Document / DocumentCorrelation Discussion

Plan

Plan

Strategic

"This is how we will manage part/all of our crop this season"

Grower, or other actor involved in strategic planning for the operation.

Recommendation

REC

Tactical

"This is what I think we should do now/soon"

This document is not always acted upon; it is acted upon via a work order, upon approval.

Some jurisdictions require a reason for making the recommendation, including supporting documentation, a guarantee that alternatives were considered, etc.

An individual with the expertise / licensing necessary to recommend a course of action.

Work Order

WO

Tactical

"This is what we will do now/soon"

An individual with authority to order the work done.

Work Record

WR

Tactical /
Historical

"This is what actually happened in the field"

May be automatically generated; otherwise, an operator that performed the task.

Setup Catalog /
Machine Setup File 

Setup

All

"This is the information you need in order for us to exchange data"

Grower, or other actor involved in managing the grower's production data.

Prescription

Rx

Id

Integer

1

This ID uniquely identifies this object within the scope of a particular instance of an ADAPT ApplicationDataModel. This ID can be associated with one or more unique identifiers (e.g., a UUID or GUID) by means of a CompoundIdentifier object.

Description

String

1

An informative name for the document: "High-input soybeans," or "Fungicide spray recommendation for river bottom cornfields," or "Spraying Back 40")

TimeScopeIds

Integer

Oct 22, 2015 Done. Important! This allows embedding both CropSeason/ TimingEvent AND specific dates (such as Authorization date) in a document.

GrowerID

Integer

20150819: ADAPT group agreed to keep GrowerID on documents, PLUS link a person to documents through a PersonRole object, with the role of Grower. This makes it easier to separate the business entity from the person.

Oct 22, 2015 Implemented making this optional to accommodate incoming data where this is unknown; as discussed w group.

PersonRoleIds

Integer

20150819: Agreed to handle this in documents via PersonRole objects.

FarmIDs

Integer

Is this an attribute here, or pulled up from the "child" WorkItem(s) via helper method?

FieldIDs

Integer

Is this an attribute here, or pulled up from the "child" WorkItem(s) via helper method?

CropZoneIDs

Integer

0..n

Is this an attribute here, or pulled up from the "child" WorkItem(s) via helper method?

Version

Integer

0..1

20150520: Proposed by @Stuart Rhea (Unlicensed) as a means of the FMIS enabling an audit trail; we're not directly implementing an audit trail in the data model.

CreatedDateTime

DateTime

1

When was this document / object / record created?

ModifiedDateTime

DateTime

1

When was the last time someone made changes to this document / object / record?

What would the meaning of "Modified" be in a work record? There are some valid things that could be done to a work record (e.g., adding context items) that seem legitimate.

CropIds

Integer

0..*

IMPORTANT: We're going to have difficulty mapping different sources' crop lists. We need to discuss how to map among them, because crop is more than just another Geopolitical-context-dependent enumeration. Also, the case can be made that there could be more than one crop in each document. Discussion is needed.

EstimatedArea

Double

0..1

Used for creating a non-spatial plan. (The implementation in ADAPT may vary.)

NoteIds

Integer

0..*

A list of references to ReferenceNote objects.

PersonRoleIds

Integer

0..n

A list of IDs of PeopleRole objects that describe "who" is involved and what their role is in the collection of data.

WorkItemIds

In the case of the Work Record, there should be at most one work item.

GuidanceIds

Integer

0..n

ReferenceLayerIds

Integer

0..n

e.g., Obstacle Locations (a.k.a. flags, passible and impassible boundaries) 

DocumentCorrelations

  (not attribute, resolved by helper method)

IF we are to follow the pattern here that is used elsewhere in the model, this should not be an attribute but instead an helper method that queries based on the "parent" attribute in the Attachment.

ContextItems

ContextItem

0..n

A list of references to ContextItem objects

For example: OSHA, EPA-WPS, etc.

ProductIds

Integer

0..n

Assumed to be referenced in WorkItem objects in Plan, Rec, WO, WR?

MachineIds

Integer

0..n

Environmental Conditions

Complex

0..n

Requirement for Mix Crop Protection Product

Field Conditions

Complex

0..n

Requirement for Mix Crop Protection Product 

Package Data
(for packaged crop protection products) 

Complex

0..n

Requirement for Mix Crop Protection Product 

LoggedData

LoggedData

0..*

Summaries

Summary

0..*

Id

CompoundIdentifier