summaryrefslogtreecommitdiffstats
path: root/docs/platform/byoq.rst
blob: bfd7217fa99a8b881cd94c9c592f4e7239fc332e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
.. This work is licensed under a Creative Commons Attribution 4.0 International License.

Sparky - BYOQ
=======================

*BYOQ* Overview
~~~~~~~~~~~~~~~~~~~~~~~~~

*BYOQ* provides a way for users to build their own traversal queries in A&AI

.. image:: images/aai-ui-byoq.jpg
   :scale: 100 %
   :alt: alternate text
   :align: center

*BYOQ* Features
~~~~~~~~~~~~~~~~~~~~~~~~~
With BYOQ UI, users can:
  * Create queries to extract information using typeahead help functionality
  * The user can view help menus on the DSL syntax
  * The user can view the information in a paginated format (50 results per page)
  * The user can filter down the results in the tabular view on the column headers (exact string matching only)
  * The user can download their results to xslx (500 results at a time)
  * The user can opt to download a range of pages to download to xslx
  * The user can view results in card-based format
  * The user can view results in a tabular-based format
  * The user can view results in a visual format
  * The user can pinch/zoom in the visual format and double click on the elements to get additional info in a modal
  * The user can choose a defaulted format (saved in local storage)
  * The user can view & traverse relationships on an element
  * The user can build a query giving the element and all related elements (1 hop) by clicking >>BYOQ

Navigation to *BYOQ*
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The *BYOQ* view can be reached by clicking on the BYOQ item in the hamburger menu

.. image:: images/byoq-hamburger.JPG
   :scale: 100 %
   :alt: alternate text
   :align: center

How to use *BYOQ*
~~~~~~~~~~~~~~~~~~~~~~~~~~~
1. On the BYOQ page click in the dsl query input box and start creating a query

Typeahead will help with creating connections or filters as the query is being typed out (it can be configured off)

In this case I started from a generic-vnf with a specific filter and selected a few elements directly connected to it
and ran the query

The results can be seen below in card format

.. image:: images/byoq-view-1.JPG
   :scale: 100 %
   :alt: alternate text
   :align: center

2. We have the option to view the output in tabular format

.. image:: images/byoq-view-2.JPG
   :scale: 100 %
   :alt: alternate text
   :align: center

3. As well as visual graph format

.. image:: images/byoq-view-3.JPG
   :scale: 100 %
   :alt: alternate text
   :align: center

4. You can pinch/zoom & drag/drop in the visual view and double clicking an item brings up its details in a modal

.. image:: images/byoq-view-4.JPG
   :scale: 100 %
   :alt: alternate text
   :align: center

5. The user can access the syntax help documentation from the accordions

.. image:: images/byoq-view-5.JPG
   :scale: 100 %
   :alt: alternate text
   :align: center