From b5143e5f91e36c8e440ffe140ab95c2f00ee9af2 Mon Sep 17 00:00:00 2001 From: wr148d Date: Thu, 18 Mar 2021 15:14:41 -0400 Subject: Updating sparky-be documentation for Honolulu latest features Issue-ID: AAI-3250 Change-Id: I1f96b56434c78b7c0e7ecd88e3efdfe3a032fe63 Signed-off-by: wr148d (cherry picked from commit 93abe123055a04a7af0be9cc38e3f058fa04d4df) --- docs/platform/browse.rst | 100 ++++++++++++++++++++++++ docs/platform/byoq.rst | 85 ++++++++++++++++++++ docs/platform/byoqBuilder.rst | 90 +++++++++++++++++++++ docs/platform/images/aai-ui-browse.JPG | Bin 0 -> 114071 bytes docs/platform/images/aai-ui-byoq-builder.JPG | Bin 0 -> 57142 bytes docs/platform/images/aai-ui-byoq.JPG | Bin 0 -> 88033 bytes docs/platform/images/aai-ui-view-inspect.jpg | Bin 26632 -> 0 bytes docs/platform/images/browse-hamburger.JPG | Bin 0 -> 91534 bytes docs/platform/images/browse-view-1.JPG | Bin 0 -> 89826 bytes docs/platform/images/browse-view-2.JPG | Bin 0 -> 124959 bytes docs/platform/images/browse-view-3.JPG | Bin 0 -> 133363 bytes docs/platform/images/browse-view-4.JPG | Bin 0 -> 275327 bytes docs/platform/images/browse-view-5.JPG | Bin 0 -> 179188 bytes docs/platform/images/browse-view-6.JPG | Bin 0 -> 284004 bytes docs/platform/images/browse-view-7.JPG | Bin 0 -> 280761 bytes docs/platform/images/browse-view-8.JPG | Bin 0 -> 264307 bytes docs/platform/images/browse-view-9.JPG | Bin 0 -> 264713 bytes docs/platform/images/byoq-builder-hamburger.JPG | Bin 0 -> 54300 bytes docs/platform/images/byoq-builder-view-1.JPG | Bin 0 -> 100113 bytes docs/platform/images/byoq-builder-view-2.JPG | Bin 0 -> 115943 bytes docs/platform/images/byoq-builder-view-3.JPG | Bin 0 -> 104511 bytes docs/platform/images/byoq-builder-view-4.JPG | Bin 0 -> 71802 bytes docs/platform/images/byoq-builder-view-5.JPG | Bin 0 -> 95198 bytes docs/platform/images/byoq-builder-view-6.JPG | Bin 0 -> 85844 bytes docs/platform/images/byoq-builder-view-7.JPG | Bin 0 -> 135741 bytes docs/platform/images/byoq-builder-view-8.JPG | Bin 0 -> 54049 bytes docs/platform/images/byoq-hamburger.JPG | Bin 0 -> 68259 bytes docs/platform/images/byoq-view-1.JPG | Bin 0 -> 138409 bytes docs/platform/images/byoq-view-2.JPG | Bin 0 -> 99946 bytes docs/platform/images/byoq-view-3.JPG | Bin 0 -> 70767 bytes docs/platform/images/byoq-view-4.JPG | Bin 0 -> 94925 bytes docs/platform/images/byoq-view-5.JPG | Bin 0 -> 173329 bytes docs/platform/images/specialized-hamburger.JPG | Bin 0 -> 72676 bytes docs/platform/images/specialized-search-1.JPG | Bin 0 -> 107618 bytes docs/platform/images/specialized-search-2.JPG | Bin 0 -> 132834 bytes docs/platform/images/view1.png | Bin 17630 -> 0 bytes docs/platform/images/view2.png | Bin 12247 -> 0 bytes docs/platform/images/view3.png | Bin 104016 -> 0 bytes docs/platform/images/view4.png | Bin 3904 -> 0 bytes docs/platform/images/view5.png | Bin 5625 -> 0 bytes docs/platform/images/view6.jpg | Bin 44408 -> 0 bytes docs/platform/index.rst | 6 +- docs/platform/installation.rst | 19 +++-- docs/platform/specialized.rst | 61 +++++++++++++++ docs/platform/view_inspect.rst | 100 ------------------------ docs/platform/vnfs.rst | 48 ------------ 46 files changed, 352 insertions(+), 157 deletions(-) create mode 100644 docs/platform/browse.rst create mode 100644 docs/platform/byoq.rst create mode 100644 docs/platform/byoqBuilder.rst create mode 100644 docs/platform/images/aai-ui-browse.JPG create mode 100644 docs/platform/images/aai-ui-byoq-builder.JPG create mode 100644 docs/platform/images/aai-ui-byoq.JPG delete mode 100644 docs/platform/images/aai-ui-view-inspect.jpg create mode 100644 docs/platform/images/browse-hamburger.JPG create mode 100644 docs/platform/images/browse-view-1.JPG create mode 100644 docs/platform/images/browse-view-2.JPG create mode 100644 docs/platform/images/browse-view-3.JPG create mode 100644 docs/platform/images/browse-view-4.JPG create mode 100644 docs/platform/images/browse-view-5.JPG create mode 100644 docs/platform/images/browse-view-6.JPG create mode 100644 docs/platform/images/browse-view-7.JPG create mode 100644 docs/platform/images/browse-view-8.JPG create mode 100644 docs/platform/images/browse-view-9.JPG create mode 100644 docs/platform/images/byoq-builder-hamburger.JPG create mode 100644 docs/platform/images/byoq-builder-view-1.JPG create mode 100644 docs/platform/images/byoq-builder-view-2.JPG create mode 100644 docs/platform/images/byoq-builder-view-3.JPG create mode 100644 docs/platform/images/byoq-builder-view-4.JPG create mode 100644 docs/platform/images/byoq-builder-view-5.JPG create mode 100644 docs/platform/images/byoq-builder-view-6.JPG create mode 100644 docs/platform/images/byoq-builder-view-7.JPG create mode 100644 docs/platform/images/byoq-builder-view-8.JPG create mode 100644 docs/platform/images/byoq-hamburger.JPG create mode 100644 docs/platform/images/byoq-view-1.JPG create mode 100644 docs/platform/images/byoq-view-2.JPG create mode 100644 docs/platform/images/byoq-view-3.JPG create mode 100644 docs/platform/images/byoq-view-4.JPG create mode 100644 docs/platform/images/byoq-view-5.JPG create mode 100644 docs/platform/images/specialized-hamburger.JPG create mode 100644 docs/platform/images/specialized-search-1.JPG create mode 100644 docs/platform/images/specialized-search-2.JPG delete mode 100644 docs/platform/images/view1.png delete mode 100644 docs/platform/images/view2.png delete mode 100644 docs/platform/images/view3.png delete mode 100644 docs/platform/images/view4.png delete mode 100644 docs/platform/images/view5.png delete mode 100644 docs/platform/images/view6.jpg create mode 100644 docs/platform/specialized.rst delete mode 100644 docs/platform/view_inspect.rst delete mode 100644 docs/platform/vnfs.rst diff --git a/docs/platform/browse.rst b/docs/platform/browse.rst new file mode 100644 index 0000000..27e9645 --- /dev/null +++ b/docs/platform/browse.rst @@ -0,0 +1,100 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. + +Sparky - Browse +======================= + +*Browse* Overview +~~~~~~~~~~~~~~~~~~~~~~~~~ + +*Browse* provides a way to easily browse the inventory items in A&AI + +.. image:: images/aai-ui-browse.JPG + :scale: 100 % + :alt: alternate text + :align: center + +*Browse* Features +~~~~~~~~~~~~~~~~~~~~~~~~~ +With Browse UI, users can: + * Click on a tile for a configured node-type and view the instance data + * The user can view the information on the subsequent page in a paginated format (50 results per page) + * The user can filter down the results by attributes on the top of the page (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 choose a defaulted format (saved in local storage) + * The user can view & traverse relationships of an element + * The user can build a query giving the element and all related elements (1 hop) by clicking >>BYOQ + +Navigation to *Browse* +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The *Browse* view can be reached by clicking on the Browse icon from the hamburger menu + +.. image:: images/browse-hamburger.JPG + :scale: 100 % + :alt: alternate text + :align: center + +How to use *Browse* +~~~~~~~~~~~~~~~~~~~~~~~~~~~ +1. On the Browse page click a desired node type to view, in this case I chose generic virtual network functions + +.. image:: images/browse-view-1.JPG + :scale: 100 % + :alt: alternate text + :align: center + +2. On the resulting page you can see the results in card format + +.. image:: images/browse-view-2.JPG + :scale: 100 % + :alt: alternate text + :align: center + +3. Or in tabular format + +.. image:: images/browse-view-3.JPG + :scale: 100 % + :alt: alternate text + :align: center + +4. A user could view the relationships of an element on the card format by clicking the relationships button, + +Clicking a relationship will traverse that relationship to the item + +.. image:: images/browse-view-4.JPG + :scale: 100 % + :alt: alternate text + :align: center + +5. A user could view the relationships of an element on the tabular format by clicking the + to expand the row + +Clicking a relationship will traverse that relationship to the item + +.. image:: images/browse-view-5.JPG + :scale: 100 % + :alt: alternate text + :align: center + +6. A user could filter their results by adding filters at the top of the screen + +.. image:: images/browse-view-7.JPG + :scale: 100 % + :alt: alternate text + :align: center + +6. A user could build a query giving the element and all related elements (1 hop) by clicking >>BYOQ + +.. image:: images/browse-view-8.JPG + :scale: 100 % + :alt: alternate text + :align: center + +7. A user could switch between view types using the blue and grey buttons here, they can also set their default view here + +.. image:: images/browse-view-9.JPG + :scale: 100 % + :alt: alternate text + :align: center diff --git a/docs/platform/byoq.rst b/docs/platform/byoq.rst new file mode 100644 index 0000000..bfd7217 --- /dev/null +++ b/docs/platform/byoq.rst @@ -0,0 +1,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 diff --git a/docs/platform/byoqBuilder.rst b/docs/platform/byoqBuilder.rst new file mode 100644 index 0000000..9920f51 --- /dev/null +++ b/docs/platform/byoqBuilder.rst @@ -0,0 +1,90 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. + +Sparky - BYOQ Builder +======================= + +*BYOQ Builder* Overview +~~~~~~~~~~~~~~~~~~~~~~~~~ + +*BYOQ Builder* provides a way to easily create complex queries through a visual builder + +.. image:: images/aai-ui-byoq-builder.jpg + :scale: 100 % + :alt: alternate text + :align: center + +*BYOQ Builder* Features +~~~~~~~~~~~~~~~~~~~~~~~~~ +With BYOQ Builder UI, users can: + * Click on a tile for a configured node-type and view the instance data + +Navigation to *BYOQ Builder* +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The *BYOQ Builder* view can be reached by clicking on the BYOQ Builder hamburger menu item + +.. image:: images/byoq-builder-hamburger.JPG + :scale: 100 % + :alt: alternate text + :align: center + +How to use *BYOQ Builder* +~~~~~~~~~~~~~~~~~~~~~~~~~~~ +1. On the BYOQ Builder page click 'Start Building' to open the modal with all node types, to choose a starting node for your query + +.. image:: images/byoq-builder-view-1.JPG + :scale: 100 % + :alt: alternate text + :align: center + +2. In this example I chose generic-vnf and decided to filter on one of it's properties by clicking options and entering a filter + +.. image:: images/byoq-builder-view-2.JPG + :scale: 100 % + :alt: alternate text + :align: center + +The little blue + box allows for adding OR filter values (but I don't use it here) + +.. image:: images/byoq-builder-view-3.JPG + :scale: 100 % + :alt: alternate text + :align: center + +3. Scroll the modal to the bottom and click submit, you will see the element you chose and a DSL query being built + +.. image:: images/byoq-builder-view-4.JPG + :scale: 100 % + :alt: alternate text + :align: center + +4. From here you can add, remove, or edit via the icons on the node, in this case I choose + for add check a few more nodes in my query path + +.. image:: images/byoq-builder-view-5.JPG + :scale: 100 % + :alt: alternate text + :align: center + +5. After submitting that I can see the query being built at the top and it showing the same visually + +.. image:: images/byoq-builder-view-6.JPG + :scale: 100 % + :alt: alternate text + :align: center + +6. You can continue this process of adding/deleting/editing and adding filters until you have the final query for your desired output. + +At this point you would click Run Query or Manually Edit and Run Query if you want to make manual edits. + +After this is done, your qury will be ran and results returned. + +.. image:: images/byoq-builder-view-7.JPG + :scale: 100 % + :alt: alternate text + :align: center + +.. image:: images/byoq-builder-view-8.JPG + :scale: 100 % + :alt: alternate text + :align: center + diff --git a/docs/platform/images/aai-ui-browse.JPG b/docs/platform/images/aai-ui-browse.JPG new file mode 100644 index 0000000..afc5feb Binary files /dev/null and b/docs/platform/images/aai-ui-browse.JPG differ diff --git a/docs/platform/images/aai-ui-byoq-builder.JPG b/docs/platform/images/aai-ui-byoq-builder.JPG new file mode 100644 index 0000000..c99bc28 Binary files /dev/null and b/docs/platform/images/aai-ui-byoq-builder.JPG differ diff --git a/docs/platform/images/aai-ui-byoq.JPG b/docs/platform/images/aai-ui-byoq.JPG new file mode 100644 index 0000000..d7e406e Binary files /dev/null and b/docs/platform/images/aai-ui-byoq.JPG differ diff --git a/docs/platform/images/aai-ui-view-inspect.jpg b/docs/platform/images/aai-ui-view-inspect.jpg deleted file mode 100644 index bf520ed..0000000 Binary files a/docs/platform/images/aai-ui-view-inspect.jpg and /dev/null differ diff --git a/docs/platform/images/browse-hamburger.JPG b/docs/platform/images/browse-hamburger.JPG new file mode 100644 index 0000000..353acb7 Binary files /dev/null and b/docs/platform/images/browse-hamburger.JPG differ diff --git a/docs/platform/images/browse-view-1.JPG b/docs/platform/images/browse-view-1.JPG new file mode 100644 index 0000000..e42772a Binary files /dev/null and b/docs/platform/images/browse-view-1.JPG differ diff --git a/docs/platform/images/browse-view-2.JPG b/docs/platform/images/browse-view-2.JPG new file mode 100644 index 0000000..6fb328b Binary files /dev/null and b/docs/platform/images/browse-view-2.JPG differ diff --git a/docs/platform/images/browse-view-3.JPG b/docs/platform/images/browse-view-3.JPG new file mode 100644 index 0000000..ca11d58 Binary files /dev/null and b/docs/platform/images/browse-view-3.JPG differ diff --git a/docs/platform/images/browse-view-4.JPG b/docs/platform/images/browse-view-4.JPG new file mode 100644 index 0000000..e3f6b0c Binary files /dev/null and b/docs/platform/images/browse-view-4.JPG differ diff --git a/docs/platform/images/browse-view-5.JPG b/docs/platform/images/browse-view-5.JPG new file mode 100644 index 0000000..5963dbc Binary files /dev/null and b/docs/platform/images/browse-view-5.JPG differ diff --git a/docs/platform/images/browse-view-6.JPG b/docs/platform/images/browse-view-6.JPG new file mode 100644 index 0000000..8af0827 Binary files /dev/null and b/docs/platform/images/browse-view-6.JPG differ diff --git a/docs/platform/images/browse-view-7.JPG b/docs/platform/images/browse-view-7.JPG new file mode 100644 index 0000000..4a7227e Binary files /dev/null and b/docs/platform/images/browse-view-7.JPG differ diff --git a/docs/platform/images/browse-view-8.JPG b/docs/platform/images/browse-view-8.JPG new file mode 100644 index 0000000..c81b00a Binary files /dev/null and b/docs/platform/images/browse-view-8.JPG differ diff --git a/docs/platform/images/browse-view-9.JPG b/docs/platform/images/browse-view-9.JPG new file mode 100644 index 0000000..94d193e Binary files /dev/null and b/docs/platform/images/browse-view-9.JPG differ diff --git a/docs/platform/images/byoq-builder-hamburger.JPG b/docs/platform/images/byoq-builder-hamburger.JPG new file mode 100644 index 0000000..bc49122 Binary files /dev/null and b/docs/platform/images/byoq-builder-hamburger.JPG differ diff --git a/docs/platform/images/byoq-builder-view-1.JPG b/docs/platform/images/byoq-builder-view-1.JPG new file mode 100644 index 0000000..6cf6433 Binary files /dev/null and b/docs/platform/images/byoq-builder-view-1.JPG differ diff --git a/docs/platform/images/byoq-builder-view-2.JPG b/docs/platform/images/byoq-builder-view-2.JPG new file mode 100644 index 0000000..cf81f75 Binary files /dev/null and b/docs/platform/images/byoq-builder-view-2.JPG differ diff --git a/docs/platform/images/byoq-builder-view-3.JPG b/docs/platform/images/byoq-builder-view-3.JPG new file mode 100644 index 0000000..4309e7b Binary files /dev/null and b/docs/platform/images/byoq-builder-view-3.JPG differ diff --git a/docs/platform/images/byoq-builder-view-4.JPG b/docs/platform/images/byoq-builder-view-4.JPG new file mode 100644 index 0000000..60c6fbf Binary files /dev/null and b/docs/platform/images/byoq-builder-view-4.JPG differ diff --git a/docs/platform/images/byoq-builder-view-5.JPG b/docs/platform/images/byoq-builder-view-5.JPG new file mode 100644 index 0000000..17aeaba Binary files /dev/null and b/docs/platform/images/byoq-builder-view-5.JPG differ diff --git a/docs/platform/images/byoq-builder-view-6.JPG b/docs/platform/images/byoq-builder-view-6.JPG new file mode 100644 index 0000000..af800e7 Binary files /dev/null and b/docs/platform/images/byoq-builder-view-6.JPG differ diff --git a/docs/platform/images/byoq-builder-view-7.JPG b/docs/platform/images/byoq-builder-view-7.JPG new file mode 100644 index 0000000..12aa8b6 Binary files /dev/null and b/docs/platform/images/byoq-builder-view-7.JPG differ diff --git a/docs/platform/images/byoq-builder-view-8.JPG b/docs/platform/images/byoq-builder-view-8.JPG new file mode 100644 index 0000000..633ac3d Binary files /dev/null and b/docs/platform/images/byoq-builder-view-8.JPG differ diff --git a/docs/platform/images/byoq-hamburger.JPG b/docs/platform/images/byoq-hamburger.JPG new file mode 100644 index 0000000..5cb427c Binary files /dev/null and b/docs/platform/images/byoq-hamburger.JPG differ diff --git a/docs/platform/images/byoq-view-1.JPG b/docs/platform/images/byoq-view-1.JPG new file mode 100644 index 0000000..1a76fe8 Binary files /dev/null and b/docs/platform/images/byoq-view-1.JPG differ diff --git a/docs/platform/images/byoq-view-2.JPG b/docs/platform/images/byoq-view-2.JPG new file mode 100644 index 0000000..b728f2a Binary files /dev/null and b/docs/platform/images/byoq-view-2.JPG differ diff --git a/docs/platform/images/byoq-view-3.JPG b/docs/platform/images/byoq-view-3.JPG new file mode 100644 index 0000000..e06f965 Binary files /dev/null and b/docs/platform/images/byoq-view-3.JPG differ diff --git a/docs/platform/images/byoq-view-4.JPG b/docs/platform/images/byoq-view-4.JPG new file mode 100644 index 0000000..fbaa143 Binary files /dev/null and b/docs/platform/images/byoq-view-4.JPG differ diff --git a/docs/platform/images/byoq-view-5.JPG b/docs/platform/images/byoq-view-5.JPG new file mode 100644 index 0000000..f460844 Binary files /dev/null and b/docs/platform/images/byoq-view-5.JPG differ diff --git a/docs/platform/images/specialized-hamburger.JPG b/docs/platform/images/specialized-hamburger.JPG new file mode 100644 index 0000000..f5dd42a Binary files /dev/null and b/docs/platform/images/specialized-hamburger.JPG differ diff --git a/docs/platform/images/specialized-search-1.JPG b/docs/platform/images/specialized-search-1.JPG new file mode 100644 index 0000000..f2ed1a2 Binary files /dev/null and b/docs/platform/images/specialized-search-1.JPG differ diff --git a/docs/platform/images/specialized-search-2.JPG b/docs/platform/images/specialized-search-2.JPG new file mode 100644 index 0000000..7061cbd Binary files /dev/null and b/docs/platform/images/specialized-search-2.JPG differ diff --git a/docs/platform/images/view1.png b/docs/platform/images/view1.png deleted file mode 100644 index e5f40d9..0000000 Binary files a/docs/platform/images/view1.png and /dev/null differ diff --git a/docs/platform/images/view2.png b/docs/platform/images/view2.png deleted file mode 100644 index ac66e47..0000000 Binary files a/docs/platform/images/view2.png and /dev/null differ diff --git a/docs/platform/images/view3.png b/docs/platform/images/view3.png deleted file mode 100644 index 2c83f31..0000000 Binary files a/docs/platform/images/view3.png and /dev/null differ diff --git a/docs/platform/images/view4.png b/docs/platform/images/view4.png deleted file mode 100644 index 4ab94f4..0000000 Binary files a/docs/platform/images/view4.png and /dev/null differ diff --git a/docs/platform/images/view5.png b/docs/platform/images/view5.png deleted file mode 100644 index 6813651..0000000 Binary files a/docs/platform/images/view5.png and /dev/null differ diff --git a/docs/platform/images/view6.jpg b/docs/platform/images/view6.jpg deleted file mode 100644 index 68bc264..0000000 Binary files a/docs/platform/images/view6.jpg and /dev/null differ diff --git a/docs/platform/index.rst b/docs/platform/index.rst index cd6c133..03ee895 100644 --- a/docs/platform/index.rst +++ b/docs/platform/index.rst @@ -9,6 +9,8 @@ Sparky is a user interface that currently exists in the AAI ecosystem. Sparky pr :maxdepth: 2 architecture.rst - view_inspect.rst - vnfs.rst + browse.rst + specialized.rst + byoq.rst + byoqBuilder.rst installation.rst diff --git a/docs/platform/installation.rst b/docs/platform/installation.rst index 2541303..368108c 100644 --- a/docs/platform/installation.rst +++ b/docs/platform/installation.rst @@ -40,28 +40,31 @@ Profiles * camel * http | ssl - * portal * fe-dev | fe-prod * oxm-default | oxm-override - * resources | gizmo - * sync + * resources * oxm-schema-dev | oxm-schema-prod + * aai-proxy + * gizmo (retired) + * sync (retired) + * portal (partially retired, only use if needing aaf auth and portal integration) Profile descriptions: * camel - Enables spring-boot camel routing rules * http - Sets Sparky's communication protocol to HTTP * ssl - Sets Sparky's communication protocol to HTTPS - * portal - Adds ONAP portal processing to Sparky's flow + * portal - Adds ONAP portal processing to Sparky's flow (currently removed from oom) * fe-dev - Exposes the static folder for UI development when running Sparky locally (target/static) * fe-prod - Exposes the standard path for the UI in the docker container * oxm-default - Sets the default version and version list of OXM files to be used * oxm-override - Sets a custom version and version list of OXM files to be used * resources - Sparky will use aai-resources (microservice) as the primary source of inventory information - * gizmo - Sparky will use gizmo (microservice) as the primary source of inventory information - * sync - Will cause Sparky to run any configured synchronizers to populate index data in a single large transaction + * gizmo - Sparky will use gizmo (microservice) as the primary source of inventory information (retired) + * sync - Will cause Sparky to run any configured synchronizers to populate index data in a single large transaction (retired) * oxm-schema-dev - Sets the location to find the OXM files within a development environment * oxm-schema-prod - Sets the location to find the OXM files within a deployed environment + * aai-proxy - Proxies call made from the UI to resources or traversal microservices The idea behind the profiles is to create a simple approach to adjusting runtime behavior without needing to edit large xml files (see **Spring Beans** below). Ahead of running Sparky, some of the profiles will need to be edited to work within your environment (e.g. set where your custom OXM files need to be loaded from). @@ -156,7 +159,9 @@ Execute: npm start -By default the local instance of the UI will be served to ``http(s)://localhost:8001/``. +By default the local instance of the UI will be served to ``http(s)://localhost:8001/#/browse``. + +If deploying through OOM use {host}:30220/services/aai/webapp/index.html#/browse Deploy sparky-fe ================ diff --git a/docs/platform/specialized.rst b/docs/platform/specialized.rst new file mode 100644 index 0000000..5487ccf --- /dev/null +++ b/docs/platform/specialized.rst @@ -0,0 +1,61 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. + +Sparky - Specialized Search +======================= + +*Specialized Search* Overview +~~~~~~~~~~~~~~~~~~~~~~~~~ + +*Specialized Search* provides a way to easily filter the inventory items in A&AI + +.. image:: images/aai-ui-specialized-search.jpg + :scale: 100 % + :alt: alternate text + :align: center + +*Specialized Search* Features +~~~~~~~~~~~~~~~~~~~~~~~~~ +With Specialized Search UI, users can: + * Click on a radio button for a configured node-type and add filters to run and view instance data + * The user can view the information on the subsequent page in a paginated format (50 results per page) + * The user can filter down the results by attributes on the top of the page (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 choose a defaulted format (saved in local storage) + * The user can view relationships of an element + * The user can build a query giving the element and all related elements (1 hop) by clicking >>BYOQ + +Navigation to *Specialized Search* +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The *Specialized Search* view can be reached by clicking on the hamburger menu item Specialized Search + +.. image:: images/specialized-hamburger.JPG + :scale: 100 % + :alt: alternate text + :align: center + +How to use *Specialized Search* +~~~~~~~~~~~~~~~~~~~~~~~~~~~ +1. On Specialized Search a user can select an element type + +.. image:: images/specialized-search-1.JPG + :scale: 100 % + :alt: alternate text + :align: center + +2. Then add the desired filter(s) with the input fields in the center, by choosing the attribute key from the dropdown, +entering a value and clicking add filter. Once the filter is added it will be present as a pill. Filters can be removed +by clicking the X on the pill + +.. image:: images/specialized-search-2.JPG + :scale: 100 % + :alt: alternate text + :align: center + +3. When the desired filters are added, a user can hit run to access the results. The subsequent page will be the same as +the resulting page in the browse documentation, just with the filters added. For more information on that screen, please +view the documentation on browse. + diff --git a/docs/platform/view_inspect.rst b/docs/platform/view_inspect.rst deleted file mode 100644 index 81a9c58..0000000 --- a/docs/platform/view_inspect.rst +++ /dev/null @@ -1,100 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International License. - -Sparky - View & Inspect -======================= - -*View & Inspect* Overview -~~~~~~~~~~~~~~~~~~~~~~~~~ - -*View & Inspect* provides a graph based view of elements within AAI. A -single entity is the entry point into each graph, and from that base -element a graph is generated based off relationships. - -.. image:: images/aai-ui-view-inspect.jpg - :scale: 100 % - :alt: alternate text - :align: center - -*View & Inspect* Features -~~~~~~~~~~~~~~~~~~~~~~~~~ -With View & Inspect UI, users can: - * Search for a network or service object using any part of a key attribute name, ID or object type - * Select a node matching suggestion returned in the drop-down list, and view a visual representation of its service hierarchy and related nodes - * View and search for multiple object types - * View the specific attributes of a node or any of its related nodes - -Navigation to *View & Inspect* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -The *View & Inspect* view can be reached by two means: - -1. Main navigation menu -2. Selecting a search result related to an entity instance (e.g. an - entity called readme-entity) - -Using *View & Inspect* -~~~~~~~~~~~~~~~~~~~~~~ - -*View & Inspect* is driven by using the search bar at the top of the UI -to find and select entity instances. Once an instance has been selected, -a request is processed in *Sparky's* backend component that generates a -graph representation of the selected entity. The graph data is returned -to *View & Inspect* and rendered on screen. - -Node Details -^^^^^^^^^^^^ - -Upon node selection, the selected graph node details will appear in a -panel to the right of the graph titled, *Node Details*. - -Interacting with the Graph -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -The graph can be panned by clicking and holding empty space amongst the -graph and moving the mouse. This will pan the entire graph. The graph -can be zoomed in and out by using a mouse scroll wheel. Nodes in the -graph can be select by clicking on them. Nodes in the graph can be moved -by clicking, holding, and dragging them using the mouse. - -How to use *View & Inspect* -~~~~~~~~~~~~~~~~~~~~~~~~~~~ -1. Start typing into the "Search Network" bar and search suggestions will be displayed - as below - -.. image:: images/view1.png - :height: 152px - :width: 250 px - :scale: 100 % - :alt: alternate text - :align: left - -.. image:: images/view2.png - :height: 150px - :width: 269 px - :scale: 100 % - :alt: alternate text - :align: center - -.. image:: images/view3.png - :height: 150px - :width: 245 px - :scale: 100 % - :alt: alternate text - :align: center - -Note: The OXM schema defines the services and resources archetypes and mappings to Java types that are used by A&AI to define the REST endpoints for reading and manipulating the inventory data. The OXM file has been annotated with searchable attributes. Sparky communicates with Synapse (data-router) to update ElasticSearch as entities are created/updated and deleted. - -The related objects are displayed as a graph. The attributes of the selected object are in the "Node Details" tab beside the graph display - -.. image:: images/view4.png - :height: 165px - :width: 298 px - :scale: 100 % - :alt: alternate text - :align: left - -.. image:: images/view5.png - :height: 165px - :width: 280 px - :scale: 100 % - :alt: alternate text - :align: center diff --git a/docs/platform/vnfs.rst b/docs/platform/vnfs.rst deleted file mode 100644 index b047ee4..0000000 --- a/docs/platform/vnfs.rst +++ /dev/null @@ -1,48 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International License. - -Sparky - VNFs -============== - -*VNFs* Overview -~~~~~~~~~~~~~~~ - -*VNFs* is an aggregation-based view that provides aggregate counts of -VNFs based off of provisioning status and orchestration status. - -*VNFs* Features -~~~~~~~~~~~~~~~ -With VNFs UI, users can: - * Search for generic-vnfs by attribute value(s) specified in the search box using suggested search terms. - * View search results aggregated to display: - - A count of the total VNFs returned by the search - - A count of the VNFs for each prov-status values. - * Filter out data to reduce the amount of data displayed to the user. Users can filter data based on: - - Orchestration status - - Provisioning status - - Network function type - - Network function role - -Navigation to *VNFs* -~~~~~~~~~~~~~~~~~~~~ - -1. Main navigation menu -2. Selecting a search result related to an aggregation result (e.g. and - VNFs) - -Using *VNFs* -~~~~~~~~~~~~ - -*VNFs* is driven by using the search bar at the top of the UI to find -and select aggregation queries. Once selected, the aggregation queries -will be sent to the *Sparky* backend component for processing. When a -result set has been determined *VNFs* will render the data - as below: - -Note: The OXM schema defines the services and resources archetypes and mappings to Java types that are used by A&AI to define the REST endpoints for reading and manipulating the inventory data. The OXM file has been annotated with suggestible attributes. Sparky communicates with Synapse (data-router) to update ElasticSearch as entities are created/updated and deleted. - - -.. image:: images/view6.jpg - :height: 150px - :width: 270 px - :scale: 100 % - :alt: alternate text - :align: center -- cgit 1.2.3-korg