Welcome Guest! Log in


Components are dedicated resources for given technologies, such as Elasticsearch, Microsoft SQL Server, Google Cloud Platform, and more...

Some are already included in default Stambia DI installation and some have to be downloaded separately.

This article gives the basics to install, upgrade, and use Components in Stambia DI 2020 (S20.0.0) and higher

This article is dedicated to Stambia DI 2020 (S20.0.0) or higher Components.

If you are using Stambia DI S17, S18, or S19, please refer to this article instead.

 

What is a Component?

A Component contains all resources required to work on a given technology.

When you want to use a technology such as Elasticsearch, you will use the Elasticsearch Component.

Some Components are already installed in a default Stambia DI Designer installation, which you can use right away.

Some Components requires a dedicated license and are not included in default installation, you have to install them separately.

The complete list can be found in Component download section where you can find the latest version of all Components.

 

What is contained inside a Component?

A Component contains resources such as the following, which will be automatically installed / updated when installing / updating it:

  • Metadata definition files (Technology and Product files)
  • Templates
  • Modules
  • Sample Projects
  • Documentation

 

Download

You can find the Component download page at the following location.

Once you have downloaded the Component you want to install or update, you can lead to the next section.

Installation and upgrade procedure is the same for all Components.

 

Component installation and upgrade

Installation procedure - graphical installation

 

Installing or upgrading a Component in Stambia DI Designer can be performed graphically.

This is the recommended method to install Components.

After having downloaded the archive of the Component you want to install or update, lead to "Help > Install New Software..." menu.

 component installation 01

 

Then click on "Add > Archive" and choose the Component's downloaded archive file.

Optionally specify a "Name" which is only used to give a label to this installation repository.

Then click on "Add".

 

 component installation 02

 

Select the Component to be installed and click on "Next"

 

component installation 03

 

Stambia DI Designer will analyze what will be installed / upgraded and summarize it on the next page.

Click again on "Next" to go to license step, accept the license and finally click on "Finish".

Stambia Designer will install / upgrade the Component and ask to restart.

After having restarted the Component will be installed / upgraded.

 

Additional notes about upgrades

When Stambia DI Designer is starting, it updates the existing Modules if necessary.

If you have Modules in your Stambia DI Designer installation, they will be updated if needed with the latest resources available for the related Component.

For instance, if you upgrade Elasticsearch Component, existing Elasticsearch Modules in current Stambia DI Designer installation will be upgraded automatically.

 

Installation procedure - physical installation

 

Installing or upgrading a Component in Stambia DI Designer can also be performed physically in installation folder.

Note that when using this method you'll not have the possibility to know the main Component version you are using from Stambia DI Designer, but only the version of the related plugins.

This does not have any impact when you want to use a Component, but make it more difficult to follow the Components version you are using.

We recommand to prefer the graphical installation which will guide you to install Components and which will help you to handle dependencies management, for instance, if you are trying to install Components which require a higher Stambia DI version or which need any other Component dependency.

 

To install a Component physically:

  1. Stop your Stambia DI Designer if it is started
  2. Extract the content of the Component archive
  3. Copy the "plugins" folder
  4. Paste it into <Designer Installation directory>/dropins folder
  5. Restart Stambia DI Designer

After having restarted the Component will be installed / upgraded.

 

Example of Stambia DI Designer dropins folder:

D:\apps\stambiaDesigner\dropins\plugins\com.indy.addons.cmis_2.0.0.20200127_131803.jar
D:\apps\stambiaDesigner\dropins\plugins\com.indy.addons.elasticsearch_2.0.0.20200127_131803.jar
D:\apps\stambiaDesigner\dropins\plugins\com.stambia.elasticsearch.2x_1.0.0.20191206_170743.jar
D:\apps\stambiaDesigner\dropins\plugins\com.stambia.elasticsearch.5x_1.0.0.20191206_170743.jar

 

Note that you can have multiple Components in the dropins folder.

If you have already installed a given Component and you want to upgrade it with a later version the procedure is the same as for the installation, Stambia DI Designer will use the latest version of the Components it found inside dropins folder.

 

Additional notes about upgrades

When Stambia DI Designer is starting, it updates the existing Modules if necessary.

If you have Modules in your Stambia DI Designer installation, they will be updated if needed with the latest resources available for the related Component.

For instance, if you upgrade Elasticsearch Component, existing Elasticsearch Modules in current Stambia DI Designer installation will be upgraded automatically.

 

Components usage and resources

Where can I find installed Components and versions?

 

Components installed in Stambia DI Designer can be found in the following menu:

Help > About Stambia Designer > Installation Details > Installed Software

 

You can find the list of installed Components and versions in this page.

 

How to use installed Components?

 

Once you have installed a Component you can start using it.

Depending on the Component you installed you will have different ways to use it.

For instance, if you installed Elasticsearch Component, you can start creating and using an Elasticsearch Metadata as it will now appear in Metadata creation list.

Refer to the getting started and how to articles related to the installed Component to know how to use it.

 

About Sample Projects

 

A Component may contain Sample Projects to demonstrate its usage with Metadata, Mapping and Process examples.

When installing a Component in Stambia DI Designer, Sample Projects which are shipped within will be installed automatically.

You can import a Sample Project in your workspace to play with examples in a few clicks.

 

Go to "Help > Welcome" menu and choose "Samples".

sample projects 01

 

This will open the list of Sample Projects available in current installation, simply click on the project you want to import.

sample projects 02

 

About Internal Resources

 

Components are installing resources such as Technology and Product files or Templates.

Those files are installed in the 'Internal Resources' of Stambia DI Designer.

Those files should not be modified by users to avoid any issue.

However, if you want to look at what is installed, or modify those files locally you can proceed as follow.

 

Click on "Show Internal Resource View" in Project Explorer

internal resources 01

 

You have then here three internal Projects where you can find the internal resources such as Technology Files and Templates.

internal resources 02

 

If you want to override an existing file, such as modifying a Template, you can import the given internal resource file in your local workspace by right clicking on it and importing it.

We advise to avoid doing this unless you really need it, and to contact support team if you have a doubt about it.

Modifying internal resources can lead to instabilities and issues.

 

You can notice that you are overriding an internal resource when there is the pencil icon on a model.

internal resources 03

 

 

You have no rights to post comments

Articles

Suggest a new Article!