Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
indent12px

ADAPT Team - reference this wiki page for help in filling out FAQ answers: /wiki/spaces/ADAPT/pages/74186845

General Questions

Why would I adopt ADAPT instead of using one of these data hubs I've been hearing about?

Lorem ipsum dolor.

Is ADAPT ready for use in a production environment? I still see some open issues on the documentation pages.

...

AgGateway's ADAPT Oversight Committee is currently working on outlining the steps required to implement a "Version 1" of ADAPT - which has a focus on documentation data generated by field computers (MICS) being consumed by business systems (FMIS).

...

What version of Visual Studio does

...

the ADAPT project work in?

You can use either Visual Studio 2015 or Visual Studio 2017 with the ADAPT project.

Visual Studio Community 2017 is a free version available from Microsoft.

How does ADAPT handle localization / "internationalization?" (introduction to "ContextItem" system)

Since ADAPT is focused on supporting field operations based business processes, grower practices typically have local context (e.g., EPA number, ....).  It is important for ADAPT to be able to address this data, but in a way that doesn't require all aspects to be explicit in the model.  Instead, ADAPT uses a data driven "ContextItem" system - definitions of items can be sourced via the internet, anyone can propose a new definition for an item (https://api.contextitem.org/swagger).   

...

"Breaking changes"  are defined in Wiktionary as "a change in one part of a software system that potentially causes other components to fail; occurs most often in shared libraries of code used by multiple applications. Not possible to fix old entries without a breaking change, so remap old to new in import lib."

ADAPT's Branching and Versioning Policy addresses this in the "Major pull requests handling"  section of the policy.  "Any elements which will be removed as part of this major version change must be marked as deprecated for one major version. This provides users with sufficient time to know about changes and fully prepare for the change."  

What are the available plugins?

...

What test data is available for me to test my ADAPT integration / plugin?

1. Sample code in the tree demo - helps a lot to provide data that could be used to test an integration.  https://github.com/ADAPT/ADAPT-Samples/tree/develop/TreeDemo


3. Test utilities directory in the https://github.com/ADAPT/ISOv4Plugin/tree/develop/TestUtilities/Datacards has more real-world data examples (applied to ISO).  Pull in test data into ADAPT, serialize in the ADM plugin - provide sample files (work with it from an ADAPT objects standpoint)

I'm interested in capturing and exchanging data about a particular aspect X of field operations. How can I find out if ADAPT supports it?

For developers - dig into the code. For managers - talk to your developers.  Adaptframework.org has several videos that review various aspects of ADAPT which you may find helpful to answer this question: https://adaptframework.org/adapt-videos/

I'm interested in capturing and exchanging data about a particular aspect of field operations. ADAPT does not currently support it. What do I do now?

Communicate with the ADAPT community (specifically the Technical Committee) on the need. 

  1. There are some rough edges here. Constructive feedback is always helpful.
  2. Technical Committee meetings are Wednesdays @ 10 am CST. Send an e-mail to adapt.feedback@aggateway.org if you are interested in speaking with the Technical Committee about your identified gap in the ADAPT framework.
  3. There may be an opportunity for you to contribute to ADAPT to provide this additional capability within the ADAPT framwork, but it is best to be coordinated with the Technical Committee as there may be a need to agree on the best approach (or there may be a misunderstanding in what ADAPT supports and how it supports it - so your aspect of field operations may be supported in a different way than what you are thinking of).

What software platforms does ADAPT support?

...

When you visit the www.adaptframework.org site, you'll see a link to Model Documentation. That link leads to an ADAPT section in AgGateway's Public wiki space. You'll find a lot of information there. If you want a wiki account, visit the http://aggateway.atlassian.net site. You will see a login screen as shown in the figure below. Click on the "Create an account" link and follow the instructions.

Implementation Questions?

What are CompoundIdentifiers

...

Lorem ipsum dolor

How do I associate a GLN to a Manufacturer?

Andres Ferreyra and interns will address this. 

How do I associate a GTIN to a Product?

Andres Ferreyra and interns will address this.

asdasd

Why are times represented using the TimeScope class in some places, and a datetime timestamp in others?

lorem ipsum

Document and its child classes (Plan, Work Order, etc.) have several attributes (GrowerId, FarmId, FieldId, TimeScopes, etc.) that are also in the LoggedData and Summary objects that have an aggregation relationship with these Document child classes. Are LoggedData and Summary supposed to inherit the values of the parent Document?

No. The data shown in the document is supposed to be the UNION of the data in the child LoggedData / Summary objects. The original intent was for the lists of field references, etc. to serve as metadata that would help find documents of interest. The exception is the GrowerId, which is unique (the others are lists) and should be the same throughout the Document and its children.