Welcome Guest! Log in
Stambia versions 2.x, 3.x, S17, S18, S19 and S20 are reaching End of Support January, 15th, 2024. Please consider upgrading to the supported Semarchy xDI versions. See Global Policy Support and the Semarchy Documentation.

The Stambia User Community is moving to Semarchy! All the applicable resources have already been moved or are currently being moved to their new location. Read more…


In this article

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 S17, S18 and S19.

This article is dedicated to Stambia DI S17, S18 and S19 Components.

If you are using Stambia DI 2020 (S20.0.0) or higher, the procedure has changed, please refer to this article instead.

 

What is a Component?

A Component is the sum of 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 is usually composed of the following resources:

  • Addon
  • Templates
  • Sample Projects
  • Documentation

 

Depending on the Component, some might have only some of those resources, they do not necessary need all of them.

On download page the necessary resources for a Component are indicated.

 

Download Component resources

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

Once you have downloaded all the resources for a Component (Addon, Templates, ...) you can lead to the next section.

Installation and upgrade procedure depend of the resources required for a Component.

We explain in this article the basics to install each resource.

Getting started and how to articles related to each Component can give you more information about specific operations and usage about a Component.

 

Installation - Addon

What is an addon?

 

When a Component requires the installation of an addon, you can follow this procedure.

Components which require an addon simply have an addon download part in download page, and it is moreover indicated in the Component overview article.

An addon is an additional resource which must be installed in Stambia DI Designer, and which will install automatically some of the necessary resources for the given Components.

Such as Stambia libraries to communicate with the associated technology.

All Components do not necessarily have an addon, they have one only when necessary.

 

The addon file is a java library named with the following pattern:

com.indy.addons.<technology>_<version>_<date>.jar

 

The installation process is the same for any addon.

 

Where can I find installed addons and versions?

 

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

Help > About Stambia Designer > Installation Details > Plug-ins

 

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

 

Installing an addon - Stambia Designer S18.3.1 to S19.x.x

 

If you are using a Stambia DI Designer version between S18.3.1 and S19.x.x you can follow this procedure to install an addon.

 

  1. Download the plugin(s)
  2. Extract the .zip file(s) to <Designer Installation directory>/dropins folder

    Example of a valid dropins folder:

    d:\apps\stambiaDesigner\dropins\plugins\com.indy.addons.cmis_1.0.5.201610041600.jar
    d:\apps\stambiaDesigner\dropins\plugins\com.indy.addons.elasticsearch_1.0.4.201612161602.jar
    d:\apps\stambiaDesigner\dropins\plugins\com.indy.addons.mongodb_1.0.2.201609081719.jar
    d:\apps\stambiaDesigner\dropins\plugins\com.indy.addons.salesforce_1.0.5.201612061531.jar
    d:\apps\stambiaDesigner\dropins\plugins\com.indy.addons.sap_1.0.9.201610131143.jar
  3. Restart the Designer as usual

 

The addon will be installed at the Designer's start.

 

Installing an addon - Stambia Designer versions prior to S18.3.1

 

If you are using a Stambia DI Designer version prior to S18.3.1 you can follow this procedure to install an addon.

 

  1. Download the plugin
  2. Extract the .zip file(s) and copy paste the addon to <Designer Installation directory>/plugins folder
  3. Restart the Designer (stambia.exe -clean)

 

The addon will be installed at the Designer's start.

 

Installation - Templates

What is a Template?

 

Templates are models of graphical processes that will help Stambia to generate adapted and performant data flows processes for any technology.

You need to import templates in your workspace in order to design your Mappings.

Stambia provides different types of Templates in order to give you the most suitable data integration platform.

All Components do not necessarily have Templates, they have only when necessary.

 

Installing Templates

 

Templates are Stambia Process files which are packed inside archive files named with the following pattern:

templates.<technology>.<date>.zip

 

You can install Templates in your workspace as follow:

  1. Download the Templates archive
  2. Start your Designer
  3. Right click on the Project you want to import the Templates in.
  4. Choose "Import..." in contextual Menu
  5. Choose "General > Archive File"
  6. Select your Templates archive
  7. Click on finish

 

More information about Templates can be found in following article.

 

Note that the "global" Project is used to share Templates amongst all your other Projects, so that all Mappings and Processes can benefit of them. If you install them in another Project than "global", only Mappings and Processes of the current Project will be able to use them.
If you already have in your workspace another version of the Templates you are importing, delete them before importing the new Templates version. Make sure that you have not customized those Templates before removing them.

 

Installation - Sample Projects

What is a Sample Project?

 

Components may have Sample Projects to demonstrate how they work.

A Sample Project is a Stambia Project you can import in your workspace, and which contains Metadata, Mappings and Processes examples about a given subject.

When Sample Projects are available for a Component, you can find them in download page.

 

Installing Sample Projects

 

Sample Projects are usually shipped in an archive file which is usually named with the following pattern:

Demonstration - <technology> - <date>.zi

 

You can install Sample Projects in your workspace as follow:

  1. Download the Sample Project archive
  2. Start your Designer
  3. Right click in Project Explorer
  4. Choose "Import..." in contextual Menu
  5. Choose "General > Existing Projects in Workspace"
  6. Choose "Select an archive file"
  7. Select the Sample Project archive file
  8. Select the Projects to import
  9. Click on finish

 

Component usage and resources

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 resources, 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 technology to know how to use it.

 

Articles

Suggest a new Article!