add new documentation page

add new documentation page with section for mapping existing rules to example events and resulting aggregations.

Author: vasile-baluta

README.md

@@ -46,9 +46,10 @@ Visit [Eiffel Community](https://eiffel-community.github.io) to get started and
 1. [**Understanding rules**](wiki/markdown/rules.md)
     - [**Introduction**](wiki/markdown/rules.md#Introduction)
     - [**Rule set up**](wiki/markdown/rules.md#Rule-set-up)
-    - [**Existing rules files**](wiki/markdown/existing-rules-files.md)
     - [**MergeResolverRules**](wiki/markdown/merge-resolver-rules.md)
     - [**History Rules**](wiki/markdown/history-rules.md)
+    - [**Existing rules files**](wiki/markdown/existing-rules-files.md)
+    - [**Mapping Rules To Aggregations**](wiki/markdown/mapping-rules-to-aggregations.md)
 1. [**Step by Step Aggregation on Eiffel events**](wiki/markdown/step-by-step-aggregation.md)
     - [**ArtifactCreatedEvent Aggregation**](wiki/markdown/artifact-created-event-aggregation.md)
     - [**TestCaseTriggeredEvent Aggregation**](wiki/markdown/test-case-triggered-event-aggregation.md)

src/integrationtests/resources/features/SourceChangeFlowIT.feature

@@ -19,7 +19,7 @@
 Feature: Source change flow integrationtest
    Scenario: Send eiffel events for source change flow and make sure EI is triggering on REST-POST subscriptions
     Given the rules "src/test/resources/SourceChangeObjectRules.json"
-    And the events "src/test/resources/TestSourceChangeObject.json"
+    And the events "src/test/resources/TestSourceChangeObjectEvents.json"
     And the upstream input "src/test/resources/UpstreamEventsForSourceChange.json"
     And the resulting aggregated object "src/test/resources/aggregatedSourceChangeObject.json";
     And the expected aggregated object ID is "sb6efi4n-25fb-4d77-b9fd-5f2xrrefe66de47"

src/test/java/com/ericsson/ei/flowtests/FlowSourceChangeObject.java

@@ -47,12 +47,12 @@
 import com.fasterxml.jackson.databind.node.ObjectNode;
 
 @RunWith(SpringJUnit4ClassRunner.class)
-@TestExecutionListeners(listeners = {DependencyInjectionTestExecutionListener.class, FlowSourceChangeObject.class})
+@TestExecutionListeners(listeners = { DependencyInjectionTestExecutionListener.class, FlowSourceChangeObject.class })
 @SpringBootTest(classes = App.class)
 public class FlowSourceChangeObject extends FlowTestBase {
 
     private static final String RULES_FILE_PATH = "src/test/resources/SourceChangeObjectRules.json";
-    private static final String EVENTS_FILE_PATH = "src/test/resources/TestSourceChangeObject.json";
+    private static final String EVENTS_FILE_PATH = "src/test/resources/TestSourceChangeObjectEvents.json";
     private static final String AGGREGATED_OBJECT_FILE_PATH = "src/test/resources/aggregatedSourceChangeObject.json";
     private static final String AGGREGATED_OBJECT_ID = "sb6efi4n-25fb-4d77-b9fd-5f2xrrefe66de47";
     private static final String UPSTREAM_FILE = "UpstreamEventsForMockedSourceChange.json";

src/test/resources/TestSourceChangeObject.json renamed to src/test/resources/TestSourceChangeObjectEvents.json

@@ -0,0 +1,10 @@
+When writing subscriptions it is important that you know the structure of the aggregated object. In this section we present how example aggregated objects look like in relation to our existing rules.
+
+
+[**Artifact Rules**](https://github.com/eiffel-community/eiffel-intelligence/blob/master/src/main/resources/ArtifactRules.json) will result in an [**Artifact Object**](https://github.com/eiffel-community/eiffel-intelligence/blob/master/src/test/resources/AggregatedDocumentInternalCompositionLatestIT.json) based on following [**events**](https://github.com/eiffel-community/eiffel-intelligence/blob/master/src/test/resources/ArtifactFlowTestEvents.json) from message bus and following historical [**events**](https://github.com/eiffel-community/eiffel-intelligence/blob/master/src/test/resources/upStreamInput.json) from event repository.
+
+
+[**Source Change Rules**](https://github.com/eiffel-community/eiffel-intelligence/blob/master/src/main/resources/SourceChangeObjectRules.json) will result in [**Source Change Object**](https://github.com/eiffel-community/eiffel-intelligence/blob/master/src/test/resources/aggregatedSourceChangeObject.json) based on following [**events**](https://github.com/eiffel-community/eiffel-intelligence/blob/master/src/test/resources/TestSourceChangeObjectEvents.json) from message bus.
+
+
+[**Test Execution Rules**](https://github.com/eiffel-community/eiffel-intelligence/blob/master/src/main/resources/TestExecutionObjectRules.json) will result in [**Test Execution Object**](https://github.com/eiffel-community/eiffel-intelligence/blob/master/src/test/resources/aggregatedTestActivityObject.json) based on following [**events**](https://github.com/eiffel-community/eiffel-intelligence/blob/master/src/test/resources/TestExecutionTestEvents.json) from message bus.

wiki/markdown/mapping-rules-to-aggregations.md

@@ -51,6 +51,7 @@
                 <item name="Merge Resolver Rules" href="merge-resolver-rules.html" />
                 <item name="History Rules" href="history-rules.html" />
                 <item name="Existing Rules" href="existing-rules-files.html" />
+                <item name="Mapping Rules To Aggregations" href="mapping-rules-to-aggregations.html" />
             </item>
             <item collapse="true" name="Step-by-step aggregation" href="step-by-step-aggregation.html">
                 <item name="ArtifactCreatedEvent aggregation" href="artifact-created-event-aggregation.html" />