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