Version 11.1 by bougault on 2019/05/13 11:37
Show last authors
1 (% class="box warningmessage" id="H5BDraft5D" %)
2 (((
3 **This is a draft**
4 )))
5
6 The goal is to give the Collaboratory.wiki editors a way to add external apps in the Collabs (s)he is managing.  To do so, the user should have access to a list of available apps. This is the **Application Catalogue** and is publicly available and should be crawlable by search engines.
7
8 To feed the catalogue, external application developers need to have access to an **Application Manager** where (s)he is able to register an app. External app developers are registered users. Applications that need to have access to the Collaboratory API have to create OAuth client and manager authentication.
9
10 == External Application Requirements ==
11
12
13 Application are embed in Iframe, external apps have to allow to be embedded under https:~/~/wiki.humanbrainproject.eu domain in their Content Security Policies. The Collaboratory gives the iframe a context parameter via a query string (?ctx={uuid}). The external app has then to handle it to perform further operations.
14
15 == Application Manager ==
16
17
18 **Registering an application form**
19
20 * Title
21 * Description
22 * URL
23 * Category
24 * Visibility (public/private) - private option just hides the app in the list. There is no real visibility management.
25
26 **Search for existing apps**
27
28 * Same features as Application Catalogue
29
30 ==
31 Application Catalogue ==
32
33
34 This is a list where Collab editors can choose an app.
35
36 * The editor adds a new document in the wiki. In the creation template list, there is a “Integrate External App” type that opens the External Application list, the user can search an app and pick one to associate its Collab.
37
38 * Applications in the list are
39 ** Displayed as a flat list, server side generated with all entries
40 ** Selectable
41
42 * Then the user can
43 ** Filter via a text input that provides autocompletion feature
44 ** Filter by categories  (to be defined)
45 ** Sort by some criteria