graphdb-workbench-tests 3.2.1 → 3.3.0-RC2

package/cypress-security.config.js

@@ -1,8 +1,15 @@
-const {defineConfig} = require('cypress');
+import { defineConfig } from 'cypress';
+import setupPlugins from './plugins/index.js';
 
 const isCoverage = process.env.COVERAGE === 'true';
 
-module.exports = defineConfig({
+const loadCodeCoverage = async (on, config) => {
+    const mod = await import('@bahmutov/cypress-code-coverage/plugin');
+    const plugin = ('default' in mod) ? mod.default : mod;
+    plugin(on, config);
+};
+
+export default defineConfig({
     projectId: 'v35btb',
     fixturesFolder: 'fixtures',
     screenshotsFolder: 'report/screenshots',
@@ -19,10 +26,10 @@ module.exports = defineConfig({
         },
         // We've imported your old cypress plugins here.
         // You may want to clean this up later by importing these.
-        setupNodeEvents(on, config) {
-            require('./plugins')(on, config);
+        async setupNodeEvents(on, config) {
+            setupPlugins(on, config);
             if (isCoverage) {
-                require('@bahmutov/cypress-code-coverage/plugin')(on, config)
+                await loadCodeCoverage(on, config);
             }
             return config;
         },

package/e2e-flaky/import/import-user-data-batch-operations.spec.js

@@ -1,7 +1,7 @@
 import {ModalDialogSteps} from "../../steps/modal-dialog-steps";
 import {ImportSettingsDialogSteps} from "../../steps/import/import-settings-dialog-steps";
-import {MainMenuSteps} from "../../steps/main-menu-steps";
 import {ImportUserDataSteps} from "../../steps/import/import-user-data-steps";
+import {HeaderSteps} from '../../steps/header-steps.js';
 
 const bnodes = `_:node0 <http://purl.org/dc/elements/1.1/title> "A new book" ;
                     \t<http://purl.org/dc/elements/1.1/creator> "A.N.Other" .`;
@@ -146,7 +146,7 @@ describe('Import user data: Batch operations', {retries: {runMode: 2}}, () => {
         ModalDialogSteps.clickOnConfirmButton();
         // Then the files should be deleted
         ImportUserDataSteps.getResources().should('have.length', 0);
-        MainMenuSteps.openHomePage();
+        HeaderSteps.openHomePage();
         ImportUserDataSteps.visit();
         ImportUserDataSteps.getResources().should('have.length', 0);
     });

package/e2e-legacy/explore/class-relationships/class-relationships.spec.js

@@ -44,6 +44,8 @@ describe('Class relations screen validation', () => {
         // Diagram should be visible and showing 10 classes
         ClassRelationshipsSteps.getDependenciesDiagram().should('be.visible').within(() => {
             cy.get('.group').should('have.length', 10);
+            // Ensure only one SVG/viewBox is rendered
+            cy.get('svg').should('have.length', 1);
         });
     });
 

package/e2e-legacy/explore/visual-graph/graphs-config.spec.js

@@ -189,7 +189,7 @@ describe('Graphs config', () => {
         // When I click on cancel
         VisualGraphSteps.cancelSaveConfig();
         // Then I expect to be redirected to configs list view
-        cy.url().should('eq', Cypress.config('baseUrl') + '/graphs-visualizations');
+        cy.url().should('include', Cypress.config('baseUrl') + '/graphs-visualizations');
     });
 
     it('Should not allow config creation without a name', () => {
@@ -349,7 +349,7 @@ describe('Graphs config', () => {
         // When I click cancel without changing the query
         VisualGraphSteps.cancelSaveConfig();
         // Then I expect to be redirected to configs list without confirmation
-        cy.url().should('eq', Cypress.config('baseUrl') + '/graphs-visualizations');
+        cy.url().should('include', Cypress.config('baseUrl') + '/graphs-visualizations');
         // And I open it for edit
         VisualGraphSteps.editConfig(graphConfigName);
         checkEditorWithQuery(QUERY_START);
@@ -372,7 +372,7 @@ describe('Graphs config', () => {
         ModalDialogSteps.clickOnConfirmButton();
         // Then I expect to be redirected to configs list page
         ModalDialogSteps.getDialog().should('not.exist');
-        cy.url().should('eq', Cypress.config('baseUrl') + '/graphs-visualizations');
+        cy.url().should('include', Cypress.config('baseUrl') + '/graphs-visualizations');
     });
 
     it('Should prevent leaving with confirmation when expand query is changed', () => {
@@ -454,7 +454,7 @@ function saveGraphConfig(graphConfigName) {
     // Then I expect a success notification
     ApplicationSteps.getSuccessNotifications().should('be.visible');
     // And I should be redirected to configs list view
-    cy.url().should('eq', Cypress.config('baseUrl') + '/graphs-visualizations');
+    cy.url().should('include', Cypress.config('baseUrl') + '/graphs-visualizations');
     // And the new config should be present in the list
     VisualGraphSteps.getGraphConfig(graphConfigName).should('be.visible');
 }

package/e2e-legacy/explore/visual-graph/visual-graph-node-labels.spec.js

@@ -2,6 +2,8 @@ import { LicenseStubs } from "../../../stubs/license-stubs";
 import { VisualGraphSteps } from "../../../steps/visual-graph-steps";
 import { HtmlUtil } from "../../../utils/html-util";
 
+const LONG_LABEL = 'A looooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooong label for Node Four'
+
 /**
  * RDF snippet with the necessary data to test all possible label scenarios:
  * 1. (ex:node1) Node with a plain text label;
@@ -19,7 +21,7 @@ const RDF_SNIPPETS_WITH_NODE_LABELS_DATA =
     'ex:node1 rdfs:label "Node One" .\n' +
     'ex:node2 rdfs:label "Node<br>Two" .\n' +
     'ex:node3 rdfs:label "Node\\nThree" .\n' +
-    'ex:node4 rdfs:label "A longer label for Node Four" .\n' +
+    `ex:node4 rdfs:label "${LONG_LABEL}" .\n` +
     '\n' +
     '# Relationships Between Nodes\n' +
     'ex:node1 ex:connectedTo ex:node2 .\n' +
@@ -60,9 +62,19 @@ describe("Node Basics", () => {
         VisualGraphSteps.getNodeLabel('http://example.com/node3').should('have.html', 'Node<br>Three');
 
         // The label of ex:node4 to be displayed with a long label (no truncation).
-        VisualGraphSteps.getNodeLabel('http://example.com/node4').should('have.html', 'A longer label for Node Four');
+        VisualGraphSteps.getNodeLabel('http://example.com/node4').should('have.html', LONG_LABEL);
 
         // The label of ex:node4 should be truncated with ellipsis because it has a long label.
         HtmlUtil.verifyEllipsis(VisualGraphSteps.getNodeLabel('http://example.com/node4'));
+
+        // When: I disable the "Truncate long labels" setting.
+        VisualGraphSteps.openVisualGraphSettings();
+        VisualGraphSteps.getTruncateLabelsCheckbox().should('be.checked');
+        VisualGraphSteps.toggleTruncateLabelsCheckbox();
+        VisualGraphSteps.getTruncateLabelsCheckbox().should('not.be.checked');
+        VisualGraphSteps.saveSettings();
+
+        // Then, I expect to see a full non-truncated label for ex:node4.
+        HtmlUtil.verifyNoEllipsis(VisualGraphSteps.getNodeLabel('http://example.com/node4'));
     });
 });

package/e2e-legacy/explore/visual-graph/visual.graph.spec.js

@@ -1,7 +1,9 @@
-import {VisualGraphSteps} from "../../../steps/visual-graph-steps";
-import {ApplicationSteps} from "../../../steps/application-steps";
-import {LicenseStubs} from "../../../stubs/license-stubs";
-import {AutocompleteStubs} from "../../../stubs/autocomplete/autocomplete-stubs";
+import {VisualGraphSteps} from '../../../steps/visual-graph-steps';
+import {ApplicationSteps} from '../../../steps/application-steps';
+import {LicenseStubs} from '../../../stubs/license-stubs';
+import {AutocompleteStubs} from '../../../stubs/autocomplete/autocomplete-stubs';
+import {MainMenuSteps} from '../../../steps/main-menu-steps.js';
+import HomeSteps from '../../../steps/home-steps.js';
 
 const FILE_TO_IMPORT = 'wine.rdf';
 const VALID_RESOURCE = 'USRegion';
@@ -24,6 +26,16 @@ describe('Visual graph screen validation', () => {
         cy.deleteRepository(repositoryId);
     });
 
+    context('Embedded', () => {
+        it('Should not show main manu, header and footer in embedded mode', () => {
+            cy.visit('/graphs-visualizations?uri=http:%2F%2Fwww.w3.org%2FTR%2F2003%2FPR-owl-guide-20031209%2Fwine%23Chardonnay&embedded')
+            VisualGraphSteps.verifyPageLoaded();
+            MainMenuSteps.getMainMenu().should('not.exist');
+            HomeSteps.getPageFooter().should('not.exist');
+            HomeSteps.getPageHeader().should('not.exist');
+        });
+    });
+
     context('When autocomplete is disabled', () => {
         it('Test notification when autocomplete is disabled', () => {
             cy.visit('graphs-visualizations');
@@ -57,8 +69,8 @@ describe('Visual graph screen validation', () => {
         it('Test search for a valid resource', {
             retries: {
                 openMode: 0,
-                runMode: 1
-            }
+                runMode: 1,
+            },
         }, () => {
             AutocompleteStubs.spyAutocompleteStatus();
             VisualGraphSteps.visit();
@@ -72,7 +84,7 @@ describe('Visual graph screen validation', () => {
             VisualGraphSteps.verifyPageLoaded();
             VisualGraphSteps.searchForResourceAndOpen(VALID_RESOURCE, VALID_RESOURCE);
             // Verify redirection to existing visual graph
-            cy.url().should('match', /USRegion$/);
+            cy.url().should('include', 'USRegion');
         });
 
         it('Test default graph state', () => {
@@ -125,7 +137,7 @@ describe('Visual graph screen validation', () => {
                 // Verify that the default settings are as follows:
                 // Maximum links to show: 20
                 VisualGraphSteps.getLinksNumberField().and('have.value', '20');
-               // Update default 20
+                // Update default 20
                 VisualGraphSteps.updateLinksLimitField('1001')
                     .then(() => {
                         // Try to put invalid value such as 1001
@@ -207,8 +219,8 @@ describe('Visual graph screen validation', () => {
             VisualGraphSteps.getNodes().and('have.length', 4);
             // Click once on node different than parent one with the mouse
             cy.get('.node-wrapper circle').eq(1)
-            // The wait is needed because mouseover event will result in
-            // pop-up of menu icons only if nodes are not moving
+                // The wait is needed because mouseover event will result in
+                // pop-up of menu icons only if nodes are not moving
                 .should('be.visible').wait(5000)
                 .trigger('mouseover', {force: true});
             // Select remove function
@@ -233,7 +245,7 @@ describe('Visual graph screen validation', () => {
             cy.get('.incontext-search-rdf-resource input').should('be.visible');
         });
 
-      it('Test expand collapsed node which has connections with double click', () => {
+        it('Test expand collapsed node which has connections with double click', () => {
             VisualGraphSteps.openUSRegionUri();
             VisualGraphSteps.toggleInferredStatements(false);
 

package/e2e-legacy/guides/autocomplete/enable-autocomplete-guide.spec.js

@@ -0,0 +1,49 @@
+import {GuideSteps} from '../../../steps/guides/guide-steps.js';
+import {GuideDialogSteps} from '../../../steps/guides/guide-dialog-steps.js';
+import {MainMenuSteps} from '../../../steps/main-menu-steps.js';
+import {AutocompleteSteps} from '../../../steps/setup/autocomplete-steps.js';
+import {GuidesStubs} from '../../../stubs/guides/guides-stubs.js';
+
+describe('Enable autocomplete guide steps', () => {
+    let repositoryId;
+
+    beforeEach(() => {
+        repositoryId = 'enable-autocomplete-guide-' + Date.now();
+        GuidesStubs.stubEnableAutocompleteGuide();
+        cy.createRepository({id: repositoryId});
+        cy.presetRepository(repositoryId);
+
+        GuideSteps.visit();
+        GuideSteps.verifyGuidesListExists();
+        cy.wait('@getGuides');
+        GuideSteps.runFirstGuide()
+    });
+
+    afterEach(() => {
+        cy.deleteRepository(repositoryId);
+    });
+
+    it('Should enable autocomplete', () => {
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Enable autocomplete — 1/5');
+        GuideDialogSteps.assertDialogWithContentIsVisible('The following steps show how to use the Autocomplete index view to enable the autocomplete index.');
+        GuideDialogSteps.clickOnNextButton();
+
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Enable autocomplete — 2/5');
+        GuideDialogSteps.assertDialogWithContentIsVisible('Click on the Setup menu.');
+        MainMenuSteps.clickOnMenuSetup();
+
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Enable autocomplete — 3/5');
+        GuideDialogSteps.assertDialogWithContentIsVisible('Click on the Autocomplete menu.');
+        MainMenuSteps.clickOnSubmenuAutocomplete();
+
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Enable autocomplete — 4/5');
+        GuideDialogSteps.assertDialogWithContentIsVisible('Click on the checkbox to enable the index.');
+        AutocompleteSteps.enableToggleAutocomplete();
+
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Enable autocomplete — 5/5');
+        GuideDialogSteps.assertDialogWithContentIsVisible('Wait until indexing finished.');
+
+        GuideDialogSteps.clickOnCloseButton();
+        GuideDialogSteps.assertDialogIsClosed();
+    });
+});

package/e2e-legacy/guides/class-hierarcy/class-hierarchy-guide.spec.js

@@ -0,0 +1,89 @@
+import {GuideSteps} from '../../../steps/guides/guide-steps.js';
+import {GuideDialogSteps} from '../../../steps/guides/guide-dialog-steps.js';
+import {MainMenuSteps} from '../../../steps/main-menu-steps.js';
+import {GuidesStubs} from '../../../stubs/guides/guides-stubs.js';
+import ClassViewsSteps from '../../../steps/class-views-steps.js';
+
+describe('Class hierarchy guide steps', () => {
+    let repositoryId;
+    const FILE_TO_IMPORT = 'swapi-dataset.ttl';
+
+    beforeEach(() => {
+        repositoryId = 'class-hierarchy-guide-' + Date.now();
+        GuidesStubs.stubClassHierarchyGuide();
+        cy.createRepository({id: repositoryId});
+        cy.presetRepository(repositoryId);
+        cy.importServerFile(repositoryId, FILE_TO_IMPORT);
+
+        GuideSteps.visit();
+        GuideSteps.verifyGuidesListExists();
+        cy.wait('@getGuides');
+        GuideSteps.runFirstGuide();
+    });
+
+    afterEach(() => {
+        cy.deleteRepository(repositoryId);
+    });
+
+    it('Should test class hierarchy', () => {
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Class hierarchy instances — 1/7');
+        GuideDialogSteps.assertDialogWithContentIsVisible('Click on voc:Sentient to show its instances.');
+        ClassViewsSteps.selectClassElement('voc:Sentient');
+
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Class hierarchy instances — 2/7');
+        GuideDialogSteps.assertDialogWithContentIsVisible('The side panel shows the first 1,000 instances of the clicked class, voc:Sentient.');
+        GuideDialogSteps.clickOnNextButton();
+
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Class hierarchy instances — 3/7');
+        GuideDialogSteps.assertDialogWithContentIsVisible('https://swapi.co/resource/aleena/47 is an instance of the class voc:Sentient.');
+        GuideDialogSteps.assertDialogWithContentIsVisible('This is planet');
+        GuideDialogSteps.clickOnNextButton();
+
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Class hierarchy instances — 4/7');
+        GuideDialogSteps.assertDialogWithContentIsVisible('This link shows the number of instances for the selected class, voc:Sentient. Click on the link to open the SPARQL editor with a preloaded query that selects all instances.');
+        ClassViewsSteps.clickInstanceCountLink();
+
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Class hierarchy instances — 5/7');
+        GuideDialogSteps.assertDialogWithContentIsVisible('This SPARQL query selects all instances of the class voc:Sentient. The query was entered automatically when you clicked on the view instances link.');
+        GuideDialogSteps.clickOnNextButton();
+
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Class hierarchy instances — 6/7');
+        GuideDialogSteps.assertDialogWithContentIsVisible('The table shows the results. Note that in this particular case, the query was executed automatically.');
+        GuideDialogSteps.assertDialogWithContentIsVisible('Do not worry — there will be a dedicated section on the SPARQL editor later in the guide.');
+        GuideDialogSteps.clickOnNextButton();
+
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Class hierarchy instances — 7/7');
+        GuideDialogSteps.assertDialogWithContentIsVisible('You can close the panel by clicking on the X icon.');
+        ClassViewsSteps.closeInfoSidePanel();
+
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Explore the class hierarchy — 1/7');
+        GuideDialogSteps.assertDialogWithContentIsVisible('The following steps show how to use the Class hierarchy view to inspect the class hierarchy and gain an insight on what the dataset contains.');
+        GuideDialogSteps.clickOnNextButton();
+
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Explore the class hierarchy — 2/7');
+        GuideDialogSteps.assertDialogWithContentIsVisible('Click on the Explore menu.');
+        MainMenuSteps.clickOnExplore();
+
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Explore the class hierarchy — 3/7');
+        GuideDialogSteps.assertDialogWithContentIsVisible('Click on the Class hierarchy menu.');
+        MainMenuSteps.clickOnSubmenuClassHierarchy();
+
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Explore the class hierarchy — 4/7');
+        GuideDialogSteps.assertDialogWithContentIsVisible('The biggest circle shows all top-level classes. Every class may have subclasses shown as smaller circles within their parent class. The size of each circle indicates the proportion of RDF resources that belong to that class. Thus, bigger circles are classes that have more instances.');
+        GuideDialogSteps.clickOnNextButton();
+
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Explore the class hierarchy — 5/7');
+        GuideDialogSteps.assertDialogWithContentIsVisible('This is some extra content here');
+        GuideDialogSteps.clickOnNextButton();
+
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Explore the class hierarchy — 6/7');
+        GuideDialogSteps.assertDialogWithContentIsVisible('The class voc:Sentient is a parent class that has subclasses. Zoom inside to have a better view by scrolling up with the mouse inside the circle.');
+        GuideDialogSteps.clickOnNextButton();
+
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Explore the class hierarchy — 7/7');
+        GuideDialogSteps.assertDialogWithContentIsVisible('Within voc:Sentient are subclasses like voc:Human (humanoids), voc:Droid (mechanical intelligences), voc:Gungan (the Gungan species), and voc:Yodasspecies (Yoda’s lineage), highlighting the diverse forms of sentient life.');
+
+        GuideDialogSteps.clickOnCloseButton();
+        GuideDialogSteps.assertDialogIsClosed();
+    });
+});

package/e2e-legacy/guides/class-relations/class-relations-guide.spec.js

@@ -0,0 +1,76 @@
+import {GuideSteps} from '../../../steps/guides/guide-steps.js';
+import {GuideDialogSteps} from '../../../steps/guides/guide-dialog-steps.js';
+import {MainMenuSteps} from '../../../steps/main-menu-steps.js';
+import {GuidesStubs} from '../../../stubs/guides/guides-stubs.js';
+
+describe('Class relations guide steps', () => {
+    let repositoryId;
+    const FILE_TO_IMPORT = 'swapi-dataset.ttl';
+    const SECOND_FILE_TO_IMPORT = 'wine.rdf';
+
+    beforeEach(() => {
+        repositoryId = 'class-relations-guide-' + Date.now();
+        GuidesStubs.stubClassRelationsGuide();
+        cy.createRepository({id: repositoryId});
+        cy.presetRepository(repositoryId);
+        cy.importServerFile(repositoryId, FILE_TO_IMPORT);
+        cy.importServerFile(repositoryId, SECOND_FILE_TO_IMPORT, {context: 'http://wine.org/'});
+
+        GuideSteps.visit();
+        GuideSteps.verifyGuidesListExists();
+        cy.wait('@getGuides');
+        GuideSteps.runFirstGuide();
+    });
+
+    afterEach(() => {
+        cy.deleteRepository(repositoryId);
+    });
+
+    it('Should test class relations guide steps', () => {
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Explore the class relationships — 1/5');
+        GuideDialogSteps.assertDialogWithContentIsVisible('The following steps show how to use the Class relationships view to explore how classes are connected and understand the relationships between different types of data in your dataset.');
+        GuideDialogSteps.clickOnNextButton();
+
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Explore the class relationships — 2/5');
+        GuideDialogSteps.assertDialogWithContentIsVisible('Click on the Explore menu.');
+        MainMenuSteps.clickOnExplore();
+
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Explore the class relationships — 3/5');
+        GuideDialogSteps.assertDialogWithContentIsVisible('Click on the Class relationships menu.');
+        MainMenuSteps.clickOnSubmenuClassRelationships();
+
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Explore the class relationships — 4/5');
+        GuideDialogSteps.assertDialogWithContentIsVisible('This view shows how data instances from different classes are connected based on real RDF statements.');
+        GuideDialogSteps.clickOnNextButton();
+
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Explore the class relationships — 5/5');
+        GuideDialogSteps.assertDialogWithContentIsVisible('Some extra info');
+        GuideDialogSteps.clickOnNextButton();
+
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Class relationships');
+        GuideDialogSteps.assertDialogWithContentIsVisible('Each connection line varies in thickness based on the number of links, color based on the class with more incoming links, and direction as links may go both ways (from class A to class B and vice versa).');
+        GuideDialogSteps.clickOnNextButton();
+
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Class relationships');
+        GuideDialogSteps.assertDialogWithContentIsVisible('Click on any connection line in the diagram to see the top predicates used between those two classes. This helps to understand what kind of relationships link them.');
+        GuideDialogSteps.clickOnNextButton();
+
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Class relationships');
+        GuideDialogSteps.assertDialogWithContentIsVisible('If the repository contains more than one named graph, you can filter the view by opening the All graphs dropdown (next to the toolbar) and selecting the graph to explore.');
+        GuideDialogSteps.clickOnNextButton();
+
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Class relationships');
+        GuideDialogSteps.assertDialogWithContentIsVisible('The left panel shows all classes, sorted by number of links, displaying both incoming and outgoing connections.');
+        GuideDialogSteps.clickOnNextButton();
+
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Class relationships');
+        GuideDialogSteps.assertDialogWithContentIsVisible('A green background behind a class name in the list indicates that it is currently shown in the diagram.');
+        GuideDialogSteps.clickOnNextButton();
+
+        GuideDialogSteps.assertDialogWithTitleIsVisible('Class relationships');
+        GuideDialogSteps.assertDialogWithContentIsVisible('Use the + / – icons next to each class name to add or remove it from the diagram display.');
+
+        GuideDialogSteps.clickOnCloseButton();
+        GuideDialogSteps.assertDialogIsClosed();
+    });
+});

package/e2e-legacy/guides/connectors/connectors-guide.spec.js

@@ -0,0 +1,152 @@
+import {GuideSteps} from '../../../steps/guides/guide-steps.js';
+import {GuideDialogSteps} from '../../../steps/guides/guide-dialog-steps.js';
+import {GuidesStubs} from '../../../stubs/guides/guides-stubs.js';
+import {ConnectorsSteps} from '../../../steps/setup/connectors-steps.js';
+
+describe('Connectors guide', () => {
+    let repositoryId;
+
+    beforeEach(() => {
+        repositoryId = 'connectors-guide-' + Date.now();
+        cy.createRepository({id: repositoryId});
+        cy.presetRepository(repositoryId);
+    });
+
+    afterEach(() => {
+        cy.deleteRepository(repositoryId);
+    });
+
+    describe('General connectors guide steps', () => {
+        const instanceName = 'LuceneConnector';
+        beforeEach(() => {
+            GuidesStubs.stubConnectorsGuide();
+            cy.createConnector(repositoryId, 'lucene', instanceName);
+
+            GuideSteps.visit();
+            GuideSteps.verifyGuidesListExists();
+            cy.wait('@getGuides');
+            GuideSteps.runFirstGuide();
+        });
+        it('Should test connectors steps', () => {
+            GuideDialogSteps.assertDialogWithTitleIsVisible('Connectors');
+            GuideDialogSteps.assertDialogWithContentIsVisible('GraphDB Connectors let you integrate external components and services with your repository data. They extend what your applications can do and stay automatically in sync with repository updates.');
+            GuideDialogSteps.clickOnNextButton();
+
+            GuideDialogSteps.assertDialogWithTitleIsVisible('Connectors');
+            GuideDialogSteps.assertDialogWithContentIsVisible('Specific GraphDB Connectors provide different connection possibilities.');
+            GuideDialogSteps.clickOnNextButton();
+
+            GuideDialogSteps.assertDialogWithTitleIsVisible('Connectors');
+            GuideDialogSteps.assertDialogWithContentIsVisible('Each section represents a single connector instance. For every instance, you can use the buttons on the right to copy, repair, or delete it.');
+            GuideDialogSteps.clickOnNextButton();
+
+            GuideDialogSteps.assertDialogWithTitleIsVisible('Connectors');
+            GuideDialogSteps.assertDialogWithContentIsVisible('To view the configuration of a connector, click on its name. This will expand the connector details.');
+            ConnectorsSteps.expandConnector('Lucene', instanceName);
+
+            GuideDialogSteps.assertDialogWithTitleIsVisible('Connectors');
+            GuideDialogSteps.assertDialogWithContentIsVisible('The creation parameters for luc:createConnector define how a connector instance is created. They are provided in a JSON object with parameter names as keys. Some parameters are required, others optional, and values can be simple types, lists, or objects');
+            GuideDialogSteps.clickOnNextButton();
+
+            GuideDialogSteps.assertDialogWithTitleIsVisible('Connectors');
+            GuideDialogSteps.assertDialogWithContentIsVisible('A parameter can define how an instance is created. Its value may be a simple type, a list, or an object, and it can be required or optional.');
+            GuideDialogSteps.clickOnNextButton();
+
+            GuideDialogSteps.assertDialogWithTitleIsVisible('Connectors');
+            GuideDialogSteps.assertDialogWithContentIsVisible('Click on View SPARQL Query to view the connector creation query.');
+            ConnectorsSteps.viewSPARQLQuery('Lucene', instanceName);
+
+            GuideDialogSteps.assertDialogWithTitleIsVisible('Connectors');
+            GuideDialogSteps.assertDialogWithContentIsVisible('The dialog displays the SPARQL query used to create the connector. You can copy it to execute manually or integrate it into automation scripts.');
+            GuideDialogSteps.clickOnNextButton();
+
+            GuideDialogSteps.assertDialogWithTitleIsVisible('Connectors');
+            GuideDialogSteps.assertDialogWithContentIsVisible('Click on close button to close the dialog');
+            ConnectorsSteps.closeSPARQLQueryDialog();
+
+            GuideDialogSteps.assertDialogWithTitleIsVisible('End of guide');
+            GuideDialogSteps.assertDialogWithContentIsVisible('This guide has ended.');
+        });
+    });
+
+    describe('Lucene connector guide steps', () => {
+        const instanceName = 'NamedIndividuals';
+        beforeEach(() => {
+            GuidesStubs.stubLuceneConnectorsGuide();
+            cy.createConnector(repositoryId, 'lucene', instanceName);
+
+            GuideSteps.visit();
+            GuideSteps.verifyGuidesListExists();
+            cy.wait('@getGuides');
+            GuideSteps.runFirstGuide();
+        });
+        it.only('Should test Lucene connector steps', () => {
+            GuideDialogSteps.assertDialogWithTitleIsVisible('Lucene connector');
+            GuideDialogSteps.assertDialogWithContentIsVisible('The Lucene Connector in GraphDB enables extremely fast keyword and faceted (aggregation) searches. Unlike traditional setups where indexing is handled externally, this connector stays automatically synchronized with your repository data, ensuring accurate and up-to-date search results at all times.');
+            GuideDialogSteps.clickOnNextButton();
+
+            GuideDialogSteps.assertDialogWithTitleIsVisible('Lucene connector');
+            GuideDialogSteps.assertDialogWithContentIsVisible('This is the Lucene connector named NamedIndividuals. You can copy, restart, or delete it using the icons on the right.');
+            GuideDialogSteps.clickOnNextButton();
+
+            GuideDialogSteps.assertDialogWithTitleIsVisible('Lucene connector');
+            GuideDialogSteps.assertDialogWithContentIsVisible('Click on NamedIndividuals to view its configuration.');
+            ConnectorsSteps.expandConnector('Lucene', instanceName);
+
+            GuideDialogSteps.assertDialogWithTitleIsVisible('Lucene connector');
+            GuideDialogSteps.assertDialogWithContentIsVisible('The fields define exactly what parts of each entity will be synchronized as well as the specific details on the connector side. The field is the smallest synchronization unit, and it maps a property chain from GraphDB to a field in Lucene. The fields are specified as a list of field objects. At least one field object is required.');
+            GuideDialogSteps.clickOnNextButton();
+
+            GuideDialogSteps.assertDialogWithTitleIsVisible('Lucene connector');
+            GuideDialogSteps.assertDialogWithContentIsVisible('The Field name defines the mapping on the connector side and is specified as a string. It is also used at query time to reference the field.');
+            GuideDialogSteps.clickOnNextButton();
+
+            GuideDialogSteps.assertDialogWithTitleIsVisible('Lucene connector');
+            GuideDialogSteps.assertDialogWithContentIsVisible('The Property chain defines the mapping on the GraphDB side. A property chain is a sequence of triples where the entity IRI is the subject of the first triple, its object is the subject of the next triple, and so on. A single-element property chain corresponds to a direct property. Property chains are specified as a list of IRIs, with at least one required.');
+            GuideDialogSteps.clickOnNextButton();
+
+            GuideDialogSteps.assertDialogWithTitleIsVisible('Lucene connector');
+            GuideDialogSteps.assertDialogWithContentIsVisible('The Indexed option determines whether the field is searchable with Lucene queries. By default, indexing is enabled.');
+            GuideDialogSteps.clickOnNextButton();
+
+            GuideDialogSteps.assertDialogWithTitleIsVisible('Lucene connector');
+            GuideDialogSteps.assertDialogWithContentIsVisible('The Stored option determines whether the field’s values are stored in Lucene. By default, fields are stored (true).');
+            GuideDialogSteps.clickOnNextButton();
+
+            GuideDialogSteps.assertDialogWithTitleIsVisible('Lucene connector');
+            GuideDialogSteps.assertDialogWithContentIsVisible('The Analyzed option determines whether literal fields are processed by the analyzer when indexed. IRIs are never analyzed. By default, fields are analyzed (true).');
+            GuideDialogSteps.clickOnNextButton();
+
+            GuideDialogSteps.assertDialogWithTitleIsVisible('Lucene connector');
+            GuideDialogSteps.assertDialogWithContentIsVisible('The Multivalued option specifies whether multiple values for RDF properties are synchronized to Lucene. True by default; if false, only a single value is synchronized.');
+            GuideDialogSteps.clickOnNextButton();
+
+            GuideDialogSteps.assertDialogWithTitleIsVisible('Lucene connector');
+            GuideDialogSteps.assertDialogWithContentIsVisible('The Facet option specifies whether the field is available for faceted searches in Lucene. Managed by the facet option (boolean, true by default).');
+            GuideDialogSteps.clickOnNextButton();
+
+            GuideDialogSteps.assertDialogWithTitleIsVisible('Lucene connector');
+            GuideDialogSteps.assertDialogWithContentIsVisible('The Languages option defines which RDF literal languages are mapped to the connector. You can provide a list of language ranges to include specific languages, or an empty range to include literals without a language tag.');
+            GuideDialogSteps.clickOnNextButton();
+
+            GuideDialogSteps.assertDialogWithTitleIsVisible('Lucene connector');
+            GuideDialogSteps.assertDialogWithContentIsVisible('The Types option specifies RDF types of entities to synchronize, given as a list of IRIs (at least one required).Special values: $any: sync entities with at least one RDF type.$untyped: sync entities even if they have no RDF type.');
+            GuideDialogSteps.clickOnNextButton();
+
+            GuideDialogSteps.assertDialogWithTitleIsVisible('Lucene connector');
+            GuideDialogSteps.assertDialogWithContentIsVisible('Click on View SPARQL Query to view the Lucene connector creation query.');
+            ConnectorsSteps.viewSPARQLQuery('Lucene', instanceName);
+
+            GuideDialogSteps.assertDialogWithTitleIsVisible('Lucene connector');
+            GuideDialogSteps.assertDialogWithContentIsVisible('The dialog displays the SPARQL query used to create the Lucene connector. You can copy it to execute manually or integrate it into automation scripts.');
+            GuideDialogSteps.clickOnNextButton();
+
+            GuideDialogSteps.assertDialogWithTitleIsVisible('Connectors');
+            GuideDialogSteps.assertDialogWithContentIsVisible('Click on close button to close the dialog');
+            ConnectorsSteps.closeSPARQLQueryDialog();
+
+            GuideDialogSteps.assertDialogWithTitleIsVisible('End of guide');
+            GuideDialogSteps.assertDialogWithContentIsVisible('This guide has ended.');
+        });
+    });
+});