Folder overview
On Spark, after an Excel file has been uploaded to Spark and the logic is converted to code, it is referred to as a service. The Folder overview screen is used to manage the services within the selected folder.
Multiple versions of a service can be added to an existing service, called service versions.
Clicking from Home into a specific folder opens up the Folder overview page. This page contains the following main sections:
The top left Folder overview pane displays the information entered in Add a new folder and/or modified in Edit folder. The folder can be edited by clicking the ✏️ edit button.
The top right pane can alternate between showing Recent activity or Bookmarks.
Recent activity shows a list of the recent changes made to the services within the folder.
Bookmarks can be used to manage the frequently visited pages relevant to the services within a folder.
The bottom pane is used to manage services and documents in Spark.
In this section, new services or new service versions can be added. Services can be displayed in "Card view" or "List view".
In "Card view", additional information about the service can be seen when hovering over the card.
Documents can include other types of documents that can be uploaded to Spark such as images, PDFs, etc.
Create a service
See Get started in 5 minutes for an overview of this process.
See How to: Create a Spark service for more detailed instructions.
Add new version
Each service can have an unlimited number of service versions.
To quickly create a new version:
Click on the Add a new version button on the "three-dot menu" of the service. Alternatively, drag and drop an Excel file on the service card to start the process.
Spark will prompt to select the Excel file. It is no longer required to use an Excel file that has the same filename as the existing service name.
The remaining steps follow Create a service.
Modify the version parameters
When adding a New version, the Version type and Release notes can be updated to describe the changes made to the version.
Version type
According to Semantic Versioning, there are 3 different types of changes you can make to the version number.
Major version when you make incompatible logical changes.
Minor version when you add functionality in a backward-compatible manner.
Patch version when you make backward-compatible bug fixes.
Although these are guidelines for semantic versioning, they are not mandatory to follow. They exist to ease communication between business users and developers.
Release notes
Write a short summary of changes you have made to the Excel file to document a clear history of changes and improvements.
Other service actions
Additional actions can be performed on the service from the three dot menu.
Activate service, Deactivate service, Archive service
See Active services.
Favorite service
A service set as a Favorite will be shown at the top of the list of services.
Download service
It is recommended to download a specific version of a service from the Version Overview screen which provides more context between different versions.
Delete service
Before a service is deleted, Spark will request confirmation for the delete action. When deleting a service, all service versions will be deleted. It is not possible to delete only 1 version of a service.
Services can only be deleted if you have permission to do so!
View in Files
This will open Files where the service contents are stored. This option is only available if you have access to Files.
Recompile service
This can be used to recompile the Spark service using a particular version of Neuron. This is beneficial to take advantage of changes in the newer versions of the compiler or to use older versions for compatibility and testing purposes. More details can be found in Choose the Neuron compiler version for additional service versions.
Last updated