Skip to content

Commit 87c527b

Browse files
authored
Transfer wiki pages from git wiki to main repo (#102)
* Transfer wiki pages from git wiki to main repo
1 parent f282e36 commit 87c527b

File tree

7 files changed

+724
-1
lines changed

7 files changed

+724
-1
lines changed

README.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,3 +34,15 @@ To get involved, please see [Code of Conduct](./CODE_OF_CONDUCT.md) and [contrib
3434
This repository forms part of the Eiffel Community. Eiffel is a protocol for technology agnostic machine-to-machine communication in continuous integration and delivery pipelines, aimed at securing scalability, flexibility and traceability. Eiffel is based on the concept of decentralized real time messaging, both to drive the continuous integration and delivery system and to document it.
3535

3636
Visit [Eiffel Community](https://eiffel-community.github.io) to get started and get involved.
37+
38+
# Documentation
39+
40+
1. [**GUI Overview**](./wiki/GUI-Overview.md)
41+
1. [**Subscription Handling**](./wiki/Subscription-Handling.md)
42+
- [**Add Subscription**](./wiki/Add-Subscription.md)
43+
1. [**Test Rules**](./wiki/Test-Rules.md)
44+
- [**Rule testing mechanism via "Test Rules" GUI interface**](./wiki/Test-Rules.md#Rule-testing-mechanism-via-Test-Rules-GUI-interface)
45+
- [**Introduction**](./wiki/Test-Rules.md#Introduction)
46+
- [**Aggregated object**](./wiki/Test-Rules.md#Aggregated-object)
47+
- [**Rule set up**](./wiki/Test-Rules.md#Rule-set-up)
48+
- [**The most common operation you would do**](./wiki/Test-Rules.md#The-most-common-operation-you-would-do)

src/main/resources/application.properties

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ ei.backendInstancesFilePath=
2828
ei.eiffelDocumentationUrls={ "EI Frontend GitHub": "https://github.com/eiffel-community/eiffel-intelligence-frontend",\
2929
"EI Backend GitHub": "https://github.com/eiffel-community/eiffel-intelligence",\
3030
"Eiffel Github main page": "https://github.com/eiffel-community/eiffel",\
31-
"Test Rules User Guide": "https://github.com/eiffel-community/eiffel-intelligence/wiki/TestRulesUserGuide" }
31+
"Test Rules User Guide": "https://github.com/eiffel-community/eiffel-intelligence/blob/master/wiki/TestRulesUserGuide.md" }
3232

3333
#### LOGGING #########
3434
logging.level.root: INFO

wiki/Add-Subscription.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
# Add Subscription
2+
3+
This form is used to add subscription through frontend GUI. Here is a description of the elements available on this form.
4+
5+
**Load Subscription Template:** In this dropdown list options are given to select a specific template for the subscription form. Currently, the following options are listed: Jenkins Pipeline Parametrized Job Trigger, REST POST and Mail Trigger.
6+
7+
**SubscriptionName:** A field to give a name to the current subscription. Only letters, underscore and numbers are allowed in this field.
8+
9+
**NotificationType:** A dropdown list with two options, i.e., REST POST and Mail Trigger, depending on how a subscriber want to be notified when a subscription is fulfilled.
10+
11+
**RestPostMediaType:** A dropdown list that provides options for selecting a specific form content type. The options available in the list depends on the selected template type.
12+
13+
**NotificationMessage:** It is used to send a message to a specific client. The format of the message depends on the options selected in the NotificationMessage and RestPostMediaType. A button, “Add Key/Value pair”, in this field may be used to add more messages.
14+
15+
**Authorization:** A list to select authorization type. Currently, only one authorization type is provided which is “BASIC_AUTH”. The option “NO_AUTH” implies that authorization is not required.
16+
17+
**Repeat:** A drop down list to choose either true or false. It depends whether same subscription should be re-triggered for new additions to the aggregated object. If false, the notification will be triggered only the first time when conditions are fulfilled.
18+
19+
**NotificationMeta:** A unique address need to be added for notification.
20+
21+
**Requirement:** It is used to add a requirement, which need to be fulfilled before a subscription is triggered. Requirement is added in the form of a condition (with a specific format). More than one conditions may be added under one requirement by using “Add Condition” button. It should be noted that conditions under one requirement are connected by logical “AND”. Thus all conditions udder one requirement need to be satisfied before a subscription is triggered. More than one requirements may be added by “Add Requirement” button. Requirements are connected by logical “OR”.

wiki/GUI-Overview.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
# GUI Overview
2+
3+
Eiffel Intelligence Frontend GUI can be divided into two parts a navigation window and a work window.
4+
<img src="https://github.com/eiffel-community/eiffel-intelligence-frontend/blob/master/src/main/resources/static/assets/images/GUI_subscription_example.png">
5+
</img>
6+
7+
As the name suggests, navigation window provides its users one click access to the resources to interact with EI. This window contains some buttons. Clicking on any of these buttons result in either opening an interactive form in the work window or opening a new window with some information resource.
8+
9+
A detailed description of the interactive elements present in the navigation window and corresponding interactions in the work window is described in the following pages.

wiki/Home.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
Eiffel Intelligence Frontend provides Eiffel Intelligence (EI) users a simple and easy to use GUI. More precisely, Eiffel Intelligence Frontend allows the configuration of subscription and aggregation rules in Eiffel Intelligence through a graphical interface.
2+
3+
EI has two components, namely Eiffel Intelligence (Backend) and Eiffel Intelligence Frontend. In Eiffel GitHub these two components are represented by two different repositories. Eiffel Intelligence (Backend) implements core functionalities of EI and Eiffel Intelligence Frontend take care of the user interactions through an interface.
4+

wiki/Subscription-Handling.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
# Subscription Handling
2+
3+
Clicking on the Subscription Handling element will display some buttons in main page which help perform a number of subscription related actions. A table may become visible, which is populated by the information about the stored (if any) subscriptions in the connected database. This view is also the default view of the Eiffel Intelligence Frontend, once the authentication (if enabled)is done .
4+
5+
#### _Add Subscription_
6+
This button opens a form with a number of fields to create a subscription through subscription endpoint (POST /subscriptions).
7+
#### _Reload_
8+
This button reloads the data from the database and refresh the data in the subscription table
9+
#### _Bulk Delete_
10+
This button deletes all the selected subscriptions in the table from the database.
11+
#### _Get Template_
12+
This button downloads a subscription template
13+
#### _Upload Subscriptions_
14+
This button help uploads a subscription by opening a file explorer
15+
#### _EI Backend Status_
16+
This button indicates, through its colour, whether a backend instance is connected with frontend or not. The green colour means backend is connected while red means no instance is connected.
17+
#### _Search_
18+
To search subscriptions with matching names in the database (displayed in the table).
19+
20+
**_More Subscriptions related information can be found [here](https://github.com/eiffel-community/eiffel-intelligence/tree/master/wiki/Subscription-API.md) and [here](https://github.com/eiffel-community/eiffel-intelligence/tree/master/wiki/Subscriptions.md)_**

0 commit comments

Comments
 (0)