FAQs

This topic lists commonly asked questions about Micro Focus Connect synchronizations and connections.

Why can't I delete a connection or data source?

Micro Focus Connect uses the connection and data source details (servers, projects, etc.) to define the links between the corresponding items in the synchronized products. If these details are removed, the link will be broken.

You can delete a data source and connection as long as they are not being used for a synchronization.

Back to top

How can I use a connection whose type name has changed?

You can use a connection that uses types whose names were changed by the endpoint admin. For example, let's assume that you have a Jira custom type Error that was renamed to Bug-RSI.

If you take no action, all connections that include the original type, will fail. To continue using the connection, you need to rename the type within the connections.

To fix the connection:

  1. Create a copy of each connection that included the original type name. You can do this via the user interface, as described in Define a connection.

  2. Alternatively, use the import /export mechanism:

    1. Export the connect.xml file of the original connection and open it for editing.

    2. Change the connection name.

    3. Replace all occurrences of the original type name with the new type name.

    4. Import the modified connect.xml file. For details, see Clone a connection.

  3. Import the cross references from the old connection to the new one:

    1. Manually as described in Manage cross references.

    2. Using the CopyXRefs batch script . For details, see CopyXrefs.

  4. Delete the old connection:

    1. Manually as described in Manage cross references.

    2. Using the DeleteConnection batch script . For details, see Connection scripts.

  5. Start the new connection. For details, see Start and stop connections.

Back to top

What is the significance of master and target in a connection?

Micro Focus Connect uses several levels of information to detect changes and to determine which side made a change most recently. In the rare case where this information is insufficient for determining which side's changes should be applied, Micro Focus Connect resorts to the master. Most products provide sufficient details, making this designation almost redundant.

Back to top

Can I rename an ALM Octane or an ALM/QC project, without breaking my synchronization?

Yes. Stop all connections in Micro Focus Connect, and stop the Micro Focus Connect service on the machine. Rename the ALM/QC project and restart the Micro Focus Connect service.

  • If the renamed project was used as a data source (sample) project, update the data source's project name.
  • If the project is being used by a connection in Common Projects, double-click on the old project name, expand the project list drop down, and select the new project name. Save the changes and run the connection.
  • If the project is being used in a type-specific project map, click the Change Project Pair for this Type Rule button . Expand the project list dropdown and select the new project name. Save the changes and run the connection.

  • If you are synching with Jira, after you change the project name, you must also replace the issue keys. When you rename a project, Jira generates a new project key and updates the issue keys to use the new project key. To replace the issue keys:

    1. Export the cross references for the connection. For details, see Manage cross references.
    2. Perform a search and replace for old issue keys (using the old project key) to new issue keys (using the new project key).
    3. Re-import the modified cross references. For details, see Manage cross references.
    4. Test and verify the connection and make sure that the newly created keys match the keys in the Jira server.

Back to top

How can I remove orphan cross references?

I have deleted artifacts at one of the endpoints. How can I remove the orphan cross-references from the Micro Focus Connect database?

The following solution applies to the following endpoints – ALM/QC, ALM Octane, Jira, Azure DevOps, Rally, and Version One:

  1. Run the StopAllConnections script to stop all connections. For details, see Batch utility scripts.
  2. Run the Purge script to purge the data.
  3. Stop the Micro Focus Connect service.
  4. Archive the data folder into a Zip file, and back it up.
  5. Run the ClearWaterMarks script with the following options to remove the watermarks (remove the ‘rem’ from line 21, save, and run). This will delete all cross references which no longer exist as artifacts in Jira or ALM/QC.

    rem "%JRE_PATH%\java.exe" -jar "%UTILITIES_PATH%\mfcClearWaterMarks.jar" "%CONNECT_PATH%" removenulls removemismatches

  6. Restart the Micro Focus Connect service and log in to Micro Focus Connect.
  7. Select the connection. Click the connection's cogwheel-shaped button , Modify Connection, to open the action menu. Choose Export Cross References.
  8. Open the resulting XML file. Perform a spot check and verify that the stale and deleted cross references are no longer present.

  9. Run the StartAllConnections script to restart all of the connections.

Back to top

Can I move stories/defects across projects?

Yes, depending on the product. For example, Rally understands and describes when a Story has moved from one project to another.

Back to top

When an item fails to synchronize, does Micro Focus Connect retry?

Yes. Any failure to synchronize an item is tracked and recorded. Micro Focus Connect will retry twice. If it continues to fail, it will stop trying. After this point, if Micro Focus Connect detects a change to the item (for example, if you fixed a bad status value) it will try synchronizing again. Finally, if you clear the watermarks for a connection, this also clears the failure state on items, and Micro Focus Connect will resume its attempts to synchronize.

Back to top

How does Micro Focus Connect synchronize embedded images?

In some systems, such as ALM Octane and Jira, images embedded in memo fields are saved as attachments. In other systems, such as Azure DevOps, embedded images are not saved as attachments.

When an Azure DevOps item with an embedded image is synchronized with ALM Octane, for example, the image is saved in ALM Octane as an attachment. The attachment from ALM Octane is then synchronized back to Azure DevOps and appended to the original item as an attachment. Both of these operations are completed within the same connection iteration.

Back to top

Jira-specific questions

This section lists several common question asked by Jira users.

Why is the JIRA cloud column "Reporter" missing?

For any field to be displayed in Micro Focus Connect, it must appear in the Create screen of:

  • The sample project and board, selected in the data source.
  • Every Jira project being synced to or from Micro Focus Connect.

Admins must follow all of the instructions described in Prepare Jira for synchronization.

Can I change my target data source from Jira Server (on-premises) to Jira Cloud?

Yes. To ensure that cross references are maintained and to avoid data duplication, perform the following steps:

  1. Create a new cloud data source.
  2. Stop the on-premises connection and disable it.
  3. Export the on-premises connection to an XML file, for example, connect.xml. For details, see Export data.
  4. Open the XML file for editing and change the connection name and the Jira data source name. Save the file.
  5. Import the modified XML file. For details, see Import data.
  6. Copy the original cross references to the cloud connection in one of the following ways:

    • Run the CopyXrefs script located in the utilities folder. For details, see CopyXrefs.
    • Manually copy the cross references:

      1. Export the cross references from the on-premise connection. For details, see Import/export use-cases.
      2. Copy and paste the cross references from the on-prem xref.xml to the cloud xref-template.xml. The XML files are add blocks.
      3. Verify that the cloud XML schema is valid by opening it in a browser such as Chrome or Edge. The browser will indicate any errors in the XML code.
      4. Import the cross reference template file (now with all the cross references added). For details, see Import/export use-cases.
  7. Export the cross references from the cloud connection. Perform a spot check to verify that the cross references are correct.
  8. Start running the cloud connection.

Back to top

See also: