Frequently Asked Questions

We grouped the frequently asked questions in to the categories Enterprise Architect support, Polarion support, functionality and failing imports/exports.

Enterprise Architect Support

Which versions of Enterprise Architect are supported?

Please see the documentation of the System Requirements.

Does the import & export of data run on a local client only?

We also offer a CLI version (LemonTree.Connect Polarion Automation) which can be utilized in all the most common runner environments.

Feel free to contact us for an discussion on your specific expectations regarding server-side execution as we definitely want to leverage the potential of the used technology:
welcome@lieberlieber.com.

Does LemonTree.Connect work with the EA Cloud Service?

No, EA Cloud Service is not supported. Only direct database connections are supported.

Does LemonTree.Connect work on server-based EA repositories?

Yes, LemonTree.Connect supports the following database systems:

• MySQL (64-bit drivers are required)
• Microsoft SQL Server
• Oracle

Does LemonTree.Connect work with encrypted EA connection strings?

No, LemonTree.Connect does not support encrypted connection strings.

Does LemonTree.Connect work with EA 16 project file formats?

Yes, the SQLite-based QEAX format is supported. However, the QEA file format is not supported, see Why does LemonTree.Connect not work with the QEA file format?.

Why does LemonTree.Connect not work with the QEA file format?

According the Sparx Systems, QEA files should be used when a single user is accessing model data. However, LemonTree.Connect is accessing the model from a different process than EA. EA is blocking the project file and no other process is able to access it due to this restriction. We therefore require the use of QEAX files.

If you have already used a QEA file and don't want to lose data, there is a simple step to convert from QEA to QEAX:

Why do I have to update my configuration after 3.0.0?

With the new version LemonTree.Connect settings have to be migrated. This is as simple as opening the server configuration, double checking your entries and reentering your credentials. After a quick save all settings are migrated and ready to be used with the new connector version.

Polarion Support

How can I configure which Polarion Server is used?

Please see the following guide: Credentials for the Polarion Server. 

Which Polarion server versions are supported?

Please see the documentation of the System Requirements.

What type of login methods are supported for Polarion?

We currently support basic user/password authentication and Personal Access Tokens. This limitation stems from the Polarion WebAPI. Support for SSO is planned for a future update, once our backend transitions to the Polarion REST API.

Functionality

LemonTree.Connect does throw an error or doesn't work as intended, what should I do?

In order analyze the problem, we ideally get the following information from you:

• Polarion server version
• EA version
• An error description / screenshot of the error
• The extended log files (see Logfiles for details)
• The EA project used for the import / export
• The Polarion project used for the import / export

To export a Polarion project along with all its data and configuration, follow the following steps:

• Select the project.
• Open the repository browser:
  
• Select all folders shown in the repository browser and download the folders:
• This will create a zip archive which contains the entire project along with its configuration and all work items.

If you have this information, please open a support ticket at support@lieberlieber.com. 

The EA addin of LemonTree.Connect Polarion does not show up after installation

In this case, the COM registration of the EA addin might have failed during the setup. Please refer to Troubleshooting the Installation for a manual COM registration.

Does LemonTree.Connect write log files and where can I find them?

Yes, LemonTree.Connect does write log files. All log files are located at

%appdata%\LieberLieber\LemonTree.Connect.Polarion\logs

In the main menu of EA, select Specialize > LemonTree.Connect Polarion > Diagnostics > Enable extended logging.
This will create more detailed log files (including a log file called LemonTree.Connect.Polarion.Api.log, which contains API calls to Polarion) for the current EA session (until EA is closed).

To get the log files, use the menu Specialize > LemonTree.Connect Polarion > Diagnostics > Export logs... This will create a zip archive containing all log files.

Polarion Diagnostics

For diagnostics, there‘s a tool shipping with polarion, extracting and preparing logfiles for support. It’s located under polarion root folder, which is – on default installation: C:\Polarion\polarion\diagtool This will create a whole lot of logfiles and remove sensitive information like passwords.

Usage

This can only be done on the server, so you need a user allowed to connect remotely by RDP or similar!

1. Goto folder “diagtool” (on default setup, this is C:\Polarion\polarion\diagtool )
2. Run “run.bat” with administrative privileges. On default setup, parameters are not required.
3. In subfolder “Results”, this will create a folder like “20240122-102214022” and a zip file named “diagtool_results_Test-Polarion-2_20240122-102214022.zip”

Result in folder will look like this:

For detailed information see C:\Polarion\polarion\diagtool\diagtool.pdf.

What do I have to configure before using LemonTree.Connect?

Configuration in EA

The data that is exchanged between EA and Polarion, is defined in a so called "Mapping Configuration", which is stored in the the folder mapping located at %programdata%\LieberLieber\LemonTree.Connect.Polarion\mapping.
How to configure a mapping is described here: Mapping Configuration

Configuration in Polarion

If you want to export data from EA to Polarion, you have to define a Mapping Configuration and also configure the destination project in Polarion accordingly. You can either use a project template that inlcudes all neccessary work item types, link roles and custom fields, or you can manually configure a project for export.
Both configuration variants are described here: Configure a Polarion Project for Export of EA Elements.

Is it possible to import / export connectors from / to Polarion?

Yes, it is possible to define mappings for so called "Trace Links". Connectors from EA are mapped to "work item link roles" in Polarion. 

For further information please see the following pages:

• Import of Traceability Links between Polarion Work Items
• Export of Traceability Links between Polarion Requirements and EA Architecture Elements

How can I filter out unwanted tracker item types for a Polarion import?

It is possible only import specific tracker item types. For more information, check out the guide Mapping Configuration.

A filter mechanism based on property values is planned for a future release, see the Roadmap for details.

Why is the feature "Open in Polarion" disabled?

This feature requires the Polarion field uri mapped to an EA tagged value, called uri.

Can I exchange data in both directions and establish a bi-directional synchronization?

No, roundtrips are not possible. The focus of LemonTree.Connect is the establishing of traceability between Polarion items and Enterprise Architect elements. For more information about the implemented workflow, see Supported Workflow.

Why can I not access my cluster environment?

The way we acess Polarion - via web service - does not properly support access to clustered environments. An easy workaround is to use a dedicated single node for access with LemonTree.Connect.

Failing Imports/Exports

Why does the import fail with java.OutOfMemoryException?

When reading multiple thousand elements the Polarion server can get overwhelmed if not enough memory is allocated. Also, the amount of elements returned by a query can be limited, which restricts LemonTree.Connect reading the entire project.

Please refer to Configure the Polarion Server for Projects with a large number of elements for more details.

Can I export with a custom field called "type" which conflicts with the work item type?

type is an invalid Polarion type ID for mapping with our connector. Doing so will result in an error as it conflicts with our terminology.

Why does my import/export fail with a ConcurrentModificationException?

Running too many calls at the same time can cause a Polarion server exception. The amount of parallel tasks run by LTC can be adjusted at "MaxConcurrentTasks" in %appdata%\LieberLieber\LemonTree.Connect.Polarion\config.json