Feature: Programmable surveys

AWX Feature Spec - Programmable Surveys

User Persona

Administrator delegating jobs to user Delegated automation user

Usage Cases

High-level:

• Administrator wants to present to the user a list of builds to choose to deploy.
• Administrator wants to present to the user a verified list of configuration parameters to push to the chosen network devices.
• Adminsitrator wants to present survey chocies that depend on prior survey choices, such as a choice to select an AWS region based on 'AWS' being a prior survey answer.

API Considerations

We must keep the survey JSON specification stable, or CLEARLY notify users when it changes. This may require a v2 survey spec.

http://json-schema.org/ may be of use.

UI/UX Considerations

Larger surveys should have options to collapse questions until needed. (c.f. https://github.com/ansible/awx/issues/290)

Docs

Should have sample survey examples

QA Suggestions

Notes

Updates/Changelog

2017-09-06: initial/updated spec 2017-09-25: added note about collapsible surveys