Appboard/old/data adapter checklist

The adapter checklist is a list of items for the adapter developer to complete in order to formalize a data adapter.

Adapter Checklist

Environment:

• List version(s) of server application tested
• List OS and locale of server application
• Document configuration changes made to server
• Document requirements to connect to server (credentials, libraries, etc.)
• Document options for API connectivity to server and chosen approach
• Provide developer documentation used
• Provide other relevant documentation or procedures used to develop adapter

Adapter basics:

• Document parameters for connecting to server (IP, port, etc.)
• Log common connectivity errors and document behavior/troubleshooting:
  • Server unreachable (disconnect network)
  • Server reachable but not configured properly (if configuration required)
  • Server reachable but missing credentials
  • Other common errors
• Log data source entity/attribute/association discovery if applicable
  • Does discovery occur at system startup?
  • Does discovery block adapter load?
  • Does adapter recover if server unavailable at startup but availability returns?
  • How long to timeout if discovery fails?
  • Does discovery set attribute types / id?

Data retrieval:

• Log data retrieval start/finish
• Log number of records retrieved
• Document options for data retrieval
  • Always retrieve all data?
  • Can data be filtered on server? Did you implement findByQuery? Limitations?
• Briefly describe entities / attributes if non-obvious
• Document how to validate entities / records retrieved in application UI if possible

Support

• Provide application server access for testing
• Provide support for customer problems with adapter