23. Working with Sparkin
Quick Start Screencast:
Overview:
Sparkin is a user friendly and flexible environment in OpKey which enables you to create requirements/scenarios quickly while adding prebuilt clauses (Given, When & Then) & create Function libraries corresponding to those statements and execute Sparkin to analyze execution result.
Sparkin includes core concepts of classic Gherkin along with a user friendly, flexible interface which enables user to create requirements/scenarios quickly than the Gherkin editor. Users need not to follow any syntax as it offers prebuilt clauses as Given, When, & Then. Further, you need to map those statements with Function Libraries. You can use data from Global Data Repository and associate with statements.
Getting started with Sparkin:
Let us see how to create a Sparkin file. There are two methods of creating Sparkin file:
Select desired folder, click on Create New icon & select Sparkin from the list of artifacts.
Alternatively, right click on the selected folder, click on Create New option and then click on Sparkin.
Enter name of the Sparkin file & open it. A Sparkin file has been created but there is no data.
Here, you can view the user interface of the Sparkin. From here, you can add scenarios, statements & comments under clauses (Given, When & Then), add data from Global data repository, add tags and do more.
Adding Scenario:
There is a default scenario named as Background, added already. You can add other scenarios as required.
However, you can add Paragraphs in this default scenario but you cannot add data or map GDR data.
So, let us add a new scenario. Click on Add Scenario icon.
A new scenario has been added.
Enter its Title & Description of the Scenario.
Navigate to the Feature tab under dockable panel and mention Feature & Description which is optional.
Adding Paragraph in scenario:
Creating & Mapping Function Library with Sparkin Clauses:
Click on the checkbox corresponding to the added Clause statement (like Given).
A popup window of Step Associator appears as follows:
Here, you can create a new Function Library file in selected folder, create new folder & select an existing Function Library.
If you have created Function Libraries in a folder then Function Library will be created with the respective statement within desired folder.
This Function Library will also contain input parameters as per the data added in placeholder. You can separate multiple data entries by adding “and’ keyword. For example: <a> and <b>
Now, open your associated Function Library, add test steps by recording or manually.
Click on other statement checkboxes (When & Then), associate Function Libraries and add data to them as described above.
Mapping GDR Data with Clauses:
Now, you can provide data to the added statements from the Global Data Repository.
Click on Click to Associate with Global data Repository button.
An Step Associator window containing Global Data Repository file & folder, opens.
Here, you can create a new Global Data Repository file in selected folder, create new folder & select an existing Global Data Repository.
You can click on the Open Associated Global data Repository link to open the associated Global data Repository.
You can perform other tasks (Add Paragraph, Delete Paragraph, Copy, Paste, Move Up, Move Down, Associate with Global data Repository & Open Associated Global data Repository) by using respective button.
Let us add tags and tag values.
Verify all added scenarios & Paragraphs and Save the Sparkin file changes.
Click on state and change its state to Published.
Dockable Panel –
There are 4 tabs in dockable panel in Sparkin module namely UsedBy, AuditTrails, Feature and Tags. They provide details about the corresponding Sparkin.
UsedBy –
This dockable panel provides details about all the other artifacts which use it. Given details include Name, Full Path, Description, and Component Type.
AuditTrails –
It provides the entire audit history details of the function library. The given details include Task, Field, OldValue, NewValue Time Stamp, and ByUser.
Feature –
Here, you can mention Feature & Description of the added scenario.
Execution Status –
Here, you can view the execution status details about the execution sessions. It includes Session Name, Executed From, Executed By, Execution Time, Executed On and Status.
Let us now execute the Sparkin by using Run Now or Debug Now button.