Skip to content

Commit e11e704

Browse files
committed
Catalog readme
1 parent d9dc454 commit e11e704

8 files changed

+120
-0
lines changed

Catalog/Images/AppPackages_Window.png

58.8 KB
Loading

Catalog/Images/DeleteDialog.png

58.3 KB
Loading
483 KB
Loading

Catalog/Images/ExportDialog.png

50.4 KB
Loading

Catalog/Images/LCAEditor_1_0_0_13.gif

1.26 MB
Loading
119 KB
Loading

Catalog/MANIFEST.yml

+84
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
# [Required]
2+
# Possible values for the Catalog item that can be deployed on a DataMiner System:
3+
# - automationscript: If the Catalog item is a general-purpose DataMiner Automation script.
4+
# - lifecycleserviceorchestration: If the Catalog item is a DataMiner Automation script designed to manage the life cycle of a service.
5+
# - profileloadscript: If the Catalog item is a DataMiner Automation script designed to load a standard DataMiner profile.
6+
# - userdefinedapi: If the Catalog item is a DataMiner Automation script designed as a user-defined API.
7+
# - adhocdatasource: If the Catalog item is a DataMiner Automation script designed for an ad hoc data source integration.
8+
# - chatopsextension: If the Catalog item is a DataMiner Automation script designed as a ChatOps extension.
9+
# - connector: If the Catalog item is a DataMiner XML connector.
10+
# - slamodel: If the Catalog item is a DataMiner XML connector designed as DataMiner Service Level Agreement model.
11+
# - enhancedservicemodel: If the Catalog item is a DataMiner XML connector designed as DataMiner enhanced service model.
12+
# - visio: If the Catalog item is a Microsoft Visio design.
13+
# - solution: If the Catalog item is a DataMiner Solution.
14+
# - testingsolution: If the Catalog item is a DataMiner Solution designed for automated testing and validation.
15+
# - samplesolution: If the Catalog item is a DataMiner Solution used for training and education.
16+
# - standardsolution: If the Catalog item is a DataMiner Solution that is an out-of-the-box solution for a specific use case or application.
17+
# - dashboard: If the Catalog item is a DataMiner dashboard.
18+
# - lowcodeapp: If the Catalog item is a DataMiner low-code app.
19+
# - datatransformer: If the Catalog item is a Data Transformer.
20+
# - dataquery: If the Catalog item is a GQI data query.
21+
# - functiondefinition: If the Catalog item is a DataMiner function definition.
22+
# - scriptedconnector: If the Catalog item is a DataMiner scripted connector.
23+
# - bestpracticesanalyzer: If the Catalog item is a DataMiner Best Practices Analysis file.
24+
25+
type: 'automationscript'
26+
27+
# [Required]
28+
# The ID of the Catalog item.
29+
# All registered versions for the same ID are shown together in the Catalog.
30+
# This ID can not be changed.
31+
# If the ID is not filled in, the registration will fail with HTTP status code 500.
32+
# If the ID is filled in but does not exist yet, a new Catalog item will be registered with this ID.
33+
# If the ID is filled in but does exist, properties of the item will be overwritten.
34+
# Must be a valid GUID.
35+
id: 'e30c5a15-9a8f-465b-83d0-d1de77aa3396'
36+
37+
# [Required]
38+
# The human-friendly name of the Catalog item.
39+
# Can be changed at any time.
40+
# Max length: 100 characters.
41+
# Cannot contain newlines.
42+
# Cannot contain leading or trailing whitespace characters.
43+
title: 'Low Code App Editor'
44+
45+
# [Optional]
46+
# General information about the Catalog item.
47+
# Max length: 100,000 characters
48+
# Currently not shown in the Catalog UI but will be supported in the near future.
49+
short_description: 'An interactive Automation script to export, and do some general edits to the low-code apps of a DataMiner System.'
50+
51+
# [Optional]
52+
# A valid URL that points to the source code.
53+
# A valid URL
54+
# Max length: 2048 characters
55+
source_code_url: 'https://github.com/SkylineCommunications/Low-Code-App-Editor'
56+
57+
# [Optional]
58+
# A valid URL that points to documentation.
59+
# A valid URL
60+
# Max length: 2048 characters
61+
# Currently not shown in the Catalog UI but will be supported in the near future.
62+
documentation_url: 'https://github.com/SkylineCommunications/Low-Code-App-Editor/blob/main/README.md'
63+
64+
# [Optional]
65+
# People who are responsible for this Catalog item. Might be developers, but this is not required.
66+
# Format: 'name <email> (url)'
67+
# The name is required; max 256 characters.
68+
# The email and url are optional, and should be in valid email/URL formats.
69+
owners:
70+
- name: 'Arne Maes'
71+
email: 'arne.maes@skyline.be'
72+
url: 'https://github.com/ArneMaes0'
73+
74+
# [Optional]
75+
# Tags that allow you to categorize your Catalog items.
76+
# Max number of tags: 5
77+
# Max length: 50 characters.
78+
# Cannot contain newlines.
79+
# Cannot contain leading or trailing whitespace characters.
80+
tags:
81+
- 'Generic'
82+
- 'Automation Script'
83+
- 'Low-Code App'
84+
- 'LCA'

Catalog/README.md

+36
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
# Low Code App Editor
2+
3+
[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=SkylineCommunications_Low-Code-App-Extensions&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=SkylineCommunications_Low-Code-App-Extensions)
4+
5+
An interactive Automation script to import, export, and do some general edits to the low-code apps of a DataMiner System.
6+
7+
![Overview](Images/LCAEditor_1_0_0_13.gif)
8+
9+
## Installation
10+
11+
> [!IMPORTANT]
12+
> After the deploy you'll need to manually replace on of the references.
13+
>
14+
> C:\Skyline DataMiner\ProtocolScripts\WebApiLib.dll needs to be C:\Skyline DataMiner\Webpages\API\bin\WebApiLib.dll
15+
16+
## Use Cases
17+
18+
### Exporting Apps
19+
You can export apps using this feature, which gathers all the necessary files for the selected apps and creates a .dmapp package. This package can then be installed on another system. The exported package is saved to the following directory: C:\Skyline DataMiner\Documents\DMA_COMMON_DOCUMENTS\Low Code Apps Exports.
20+
21+
Below is an overview of the available options for exporting a low-code app:
22+
23+
> [!NOTE] Note:
24+
> When exporting an app from one DMA to another, ensure that the versions match, for example GQI versions, to avoid compatibility issues.
25+
>
26+
27+
![Editor](Images/ExportDialog.png)
28+
29+
## Editing Apps
30+
You can edit various aspects of your low-code app's general information in this section. Additionally, you have the option to import pages and panels from other apps within the system to enhance functionality. The features you can manage here include the app's name, description, and sections. You can also define who can edit the app by selecting editors and specify access permissions by assigning viewers. Furthermore, you can expand the app's capabilities by integrating pages and panels from other apps.
31+
32+
> [!WARNING]
33+
> When you add users to the editors/viewers list, there is no check if the users that you add actually exist.
34+
>
35+
36+
![Editor](Images/EditorDialog_1_0_0_13.gif)

0 commit comments

Comments
 (0)