diff --git a/README.md b/README.md index cd10fa3..4837f47 100644 --- a/README.md +++ b/README.md @@ -26,4 +26,5 @@ Access UX design resource and documentation for Syndesis. ## Customizations +* ### [API Connector](designs/apiconnector/apiconnector.md) * ### [Technical Extension](designs/technical_extensions/tech_ext.md) diff --git a/designs/apiconnector/apiconnector.md b/designs/apiconnector/apiconnector.md new file mode 100644 index 0000000..e714122 --- /dev/null +++ b/designs/apiconnector/apiconnector.md @@ -0,0 +1,90 @@ +# API Client Connector + +## Upload Swagger + +First step is for user to upload a swagger file either via url or file upload. + +![Image of choosing connection](img/uploadswaggerfile.png) + +1. At anytime, the user can cancel this workflow by selecting "cancel" button in toolbar. +1. The main steps of the workflow are shown in the bar along the top of the screen. User can always see all of the primary steps in the flow at all times. +1. User can click on info icon if they aren't sure how to upload a swagger/need more info on swagger files. Content to show upon click is still TBD. Either link to a new page or popover - depends on length of content. +1. User can upload a file via 2 different ways - either by inputting the URL of file or by uploading a swagger file +1. If uploading, user selects file via "choose file" button +1. Select next to move onto next step. Will be disabled until a file is uploaded. + +![Image of choosing connection](img/uploadswaggerurl.png) + +1. If user selects URL option, user must input the url for the swagger file via the input field. "Next" button will also be disabled until a url in inserted. + +![Image of choosing connection](img/validationerror.png) + +1. **Validation Error**: If url or file uploaded isn't a supported swagger type, then user will get an error message in form on inline notification. Won't be triggered until user selects "next" button. +1. Input field will be highlighted in red if error occurs. + +## Review Swagger Actions + +![Image of choosing connection](img/reviewswaggerfile.png) + +1. User can review a summary of the actions associated with the swagger file in this step. +1. Select 'Next" button to move onto next step. + +## Security + +**Please Note:** This step is still TBD and is a placeholder until more research is done on security of an API client connector. + +![Image of choosing connection](img/security.png) + +1. User selects authentication type via a list of options + +![Image of choosing connection](img/securityconfigure.png) + +1. When selecting a radio button, progressive disclosure will review appropriate fields user needs to fill out for each authentication type. +1. Select "next" button when done. Will be disabled until fields are filled in. + + +## General Connector Info + +The last step is for user to review general info of swagger file. + +![Image of choosing connection](img/generalconnecterinfo.png) + +1. User must upload an icon for connector. If no icon is uploaded, will use a default icon. +1. General info will be auto-populated from swagger file. User can update info if they wish. +1. Select "next" to move to next step +1. At this step the user can complete the workflow and select "create connector" in toolbar. + +## API Connector List + +User can view all API client connectors created within the Customizations section. + +![Image of choosing connection](img/connectorlist.png) + +1. API client Connector is a section found within Customizations. User can get here by selecting the tab at top of page. +1. To create a new API connector, user clicks on button to go through workflow. +1. API connectors shown in a list view. Info shown includes name, short description, and number of times the connector is used in an integration. + - User also has ability to delete a connector from the list. + - If a connector is in use when a user deletes it, a popup will appear stating it's in use and user has to confirm deletion. + - Clicking on a connector list item will take user to the details page. +1. User can use the filter tool to quickly find a specific connector + +## Empty State + +First time user comes to this page, there will be no API client connectors, so must show an empty state + +![Image of choosing connection](img/emptystate.png) + +1. User can click on link for help docs +1. User selects button to create an API client connector. Will launch workflow + +## API Connector Details + +Upon clicking on a connector item within the list on API client connector page, user will be taken to a details page of that specific connector. + +![Image of choosing connection](img/connectordetails.png) + +1. Breadcrumbs for user to navigate back to previous pages. +1. Preview tile of connector. +1. User can inline edit general info. Triggered by selecting pencil icon. + +**Please Note:** This page isn't final. Will work closely with Stan to make sure all details page throughout app are consistent. diff --git a/designs/apiconnector/img/connectordetails.png b/designs/apiconnector/img/connectordetails.png new file mode 100644 index 0000000..1f16f01 Binary files /dev/null and b/designs/apiconnector/img/connectordetails.png differ diff --git a/designs/apiconnector/img/connectorlist.png b/designs/apiconnector/img/connectorlist.png new file mode 100644 index 0000000..79b4450 Binary files /dev/null and b/designs/apiconnector/img/connectorlist.png differ diff --git a/designs/apiconnector/img/emptystate.png b/designs/apiconnector/img/emptystate.png new file mode 100644 index 0000000..3a63144 Binary files /dev/null and b/designs/apiconnector/img/emptystate.png differ diff --git a/designs/apiconnector/img/generalconnecterinfo.png b/designs/apiconnector/img/generalconnecterinfo.png new file mode 100644 index 0000000..ea4cbc7 Binary files /dev/null and b/designs/apiconnector/img/generalconnecterinfo.png differ diff --git a/designs/apiconnector/img/reviewswaggerfile.png b/designs/apiconnector/img/reviewswaggerfile.png new file mode 100644 index 0000000..5ababea Binary files /dev/null and b/designs/apiconnector/img/reviewswaggerfile.png differ diff --git a/designs/apiconnector/img/security.png b/designs/apiconnector/img/security.png new file mode 100644 index 0000000..f1ecf56 Binary files /dev/null and b/designs/apiconnector/img/security.png differ diff --git a/designs/apiconnector/img/securityconfigure.png b/designs/apiconnector/img/securityconfigure.png new file mode 100644 index 0000000..337f5ca Binary files /dev/null and b/designs/apiconnector/img/securityconfigure.png differ diff --git a/designs/apiconnector/img/uploadswaggerfile.png b/designs/apiconnector/img/uploadswaggerfile.png new file mode 100644 index 0000000..8889e2b Binary files /dev/null and b/designs/apiconnector/img/uploadswaggerfile.png differ diff --git a/designs/apiconnector/img/uploadswaggerurl.png b/designs/apiconnector/img/uploadswaggerurl.png new file mode 100644 index 0000000..cdd5d8b Binary files /dev/null and b/designs/apiconnector/img/uploadswaggerurl.png differ diff --git a/designs/apiconnector/img/validationerror.png b/designs/apiconnector/img/validationerror.png new file mode 100644 index 0000000..0ac96d1 Binary files /dev/null and b/designs/apiconnector/img/validationerror.png differ