Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Panel
bgColorWhite
titleTable of Contents


Info

How to Get Started with CDS Designer UI

If you’re new to CDS Designer UI and need to get set up, the following guides may be helpful:


Deck of Cards
idConcepts

Anchor
GettingStarted
GettingStarted

Getting Started

This is your CDS Designer UI guide. No matter how experienced you are or what you want to achieve, it should cover everything you need to know — from navigating the interface , to making the most of different features.

Anchor
WhatIsCDS
WhatIsCDS

What is CDS Designer UI?

Section


Column
width70%

CDS Designer UI is a framework to automate the resolution of resources for instantiation and any config provisioning operation, such as day0, day1, or day2 configuration.

CDS has a both design-time and run-time activities; during design time, the Designer can define what actions are required for a given service, along with anything comprising the action. The design produce produces a CBA Package. Its content is driven from by a catalog of reusable data dictionarydictionaries and component components, delivering a reusable and simplified self-service experience.

CDS modelling modeling is mainly based on the TOSCA standard, using JSON as a representation.


Column
width30%


Anchor
WhatIsNew
WhatIsNew

What's new?


Section


Column
width270px33%

Create full CBA packages from built-in forms without programingprogramming




Column
width25%33%

Import old packages for edit and collaboration



Column
width25%33%

Create sophisticated package workflows in a no-code graphical designer





Section


Column
width25%33%

Customizable CBA Package actions


Column
width25%33%

Easily create and manage lists of data via interface (Data Dictionary, controller catalog, and config management)


Column
width25%33%

Integration between CDS UI and SDC Services





Anchor
OverviewOfCDS
OverviewOfCDS

Overview of CDS Interface

Full CDS UI screens are available in InVision Marvel App


Image Modified
  1. CDS main menu: Access all CDS module list lists including Packages, Data Dictionary, Controller Catalog, etc.
  2. Profile: Access user profile information
  3. Module Title: See the current module name and the total number of items in the module list
  4. Module list: View all active items in the module and tools for search and filtering

Anchor
CBAPackages
CBAPackages

CBA Packages

Anchor
PackageList
PackageList

  • Package List

It gives you quick access to all and most recent created/edit packages

Image Modified


  1. Module Tabs: Access All, Deployed, Under Construction, or Archived packages
  2. Search: search Search for a package by title
  3. Filter: Filter packages by package tags
  4. Package Sort: Sort packages by recent or alphanumeric (name) or version
  5. List PaginatorPagination: navigate between package list pages
  6. Create Package: Create a new CBA package
  7. Import-Package: Import other packages that are created previously on CDS Editor or Designer or created by other/current user
  8. Package box: It shows a brief detail of the package and give gives access to some actions of the package
  9. Deployed package indicator
  10. Package name and version
  11. More menu: Access a list of actions including Clone, Archive, Download, , and Delete
  12. Last modified: Shows user name and date and time of last modifications made in the package
  13. Package Description
  14. Package Tags
  15. Collaborators: See who's collaborating to edit in the package
  16. Configuration button: Go directly to package configuration
  17. Designer Mode: It indicates package mode (Designer, Scripting, and Generic scripting) and by clicking on it, it will load to the mode screen


Anchor
CreateNewCBAPackage
CreateNewCBAPackage

Create a New CBA Package

Anchor
UserFlow
UserFlow

  • User Flow

Image Modified

Anchor
CreateNewPackage
CreateNewPackage

  • Create a New Package

You can create a new CBA Package by create creating a new custom package or by import a package file that is already created before.

Info

Create/Import-Package

You can’t create/import a CBA package that has the same name and version of an existing package. Packages can be in the same name but in different version numbernumbers (ex., Package one v1.0.0 & Package one v1.0.1).


Create a New Custom CBA Package

From the Packages page, click on the Create Package button to navigate to Package Configuration

Image Modified

Anchor
MetaData
MetaData

2. In MetaData Tab, select Package Mode, enter package Name, Version, Description, and other configurations

Image Modified

3. Once you are fill in all required inputs, you can save this package by click clicking the Save button in the Actions menu

Image Modified

4. When Package Info Box: It is on top of configurations tabs and it appears after you save a package for the first time, package info box will appear on top of configuration tabs.

Image Modified

5. You can continue adding package configuration or go directly to the Designer Mode screen from Package info boxinfobox

6. All changes will be saved when you click on the Save button

7. To close the package configuration and go back to the Package list, navigate to the top left in breadcrumb and click the CBA Packages link or click on the Packages link in the Main menu.

Anchor
TemplateMapping
TemplateMapping

You can create as many templates using artifact-mapping-resource or/and artifact-template-velocity.

Image Added

  1. Template name
  2. Template Section: Where you include template attributes
  3. Manage Mapping: Here the automapping process occurs to template attributes to refer to the data dictionary that will be used to resolve a particular resource.


Template Section

Image Added

  1. Template Type: Template is defined by one of three templates (Velocity, Jinja, Kotlin)
  2. Import Template Attributes/Parameters: You can add attributes by Import attribute list file or by
  3. Insert Template Attributes/Parameters Manually: You can insert Attributes manually in the code editor. Code editor validates attributes according to the pre-selected template type


Import Template Attributes

Image Added

After import attributes, you can add/edit/delete attributes in the code editor.

Image Added


Manage Mapping Section

Image Added

  1. Use current Template Instance: You can use attributes from the Template section
  2. Upload Attributes List: In case you don’t have existing attributes in the Template section or have different attributes, you can upload the attributes list


Once you select the source of attributes, you get a confirmation of success fetching.

Image Added

Then the Mapped Table appears to show the Resource Dictionary reference.

Image Added

When you finish the creation process, you must click on the Finish button (1) to submit the template, or you can clear all data by click on the Clear button (2).

Image Added

Anchor
Scripts
Scripts

Allowed file type: Kotlin, Jython, Ansible

To add script file/s, you have two options:

  1. Create Script
  2. Import File

Image Added

 

Create a Script File

  1. File Name: Add the script filename
  2. Script Type: Choose script type (Kotlin, Jython, Ansible)
  3. Script Editor: Enter the script file content

Image Added

After you type the script, click on the Create Script button to save it

Image Added

By adding script file/s, you can:

  1. Edit file: You can edit each script file from the code editor
  2. Delete file

Image Added

Anchor
Definitions
Definitions

To define a data type that represents the schema of a specific type of data, you have to enrich the package to automatically generate all definition files:

  1. Enrich Package: from the package details box, click on the Enrich button

Image Added


  Once you successfully enrich the package, all definition files will be listed.

Image Added


By adding definition file/s, you can:

  1. Delete file

Image Added

Anchor
DSL_Properties
DSL_Properties

In order to populate the system information within the package, you have to provide dsl_definitions

Image Added


Anchor
TopologyTemplate
TopologyTemplate

  • Topology Template

Here you can manually add your package:

  1. Workflows that define an overall action to be taken on the service
  2. Node/Component template that is used to represent a functionality along with its contracts, such as inputs, outputs, and attributes

Image Added




Next: How to create a “Hello World” Package with CDS Designer UI? The Resource Resolution Type



Info
titleCDS GUI Overall UX/UI Design

Sketch - CDS Designer UI, CDS Resource Dictionary, CDS Controller Catalog, etc..