Micro Focus ALM Synchronizer Defect Management Tool Hands-On Tutorial

Here is an overview of HP ALM Synchronizer and now Micro Focus ALM Synchronizer:

Micro Focus ALM Synchronizer seems to be a very new term for most of us and several questions occur to us when we first see or hear this term.

Usually, when we come across a new term, we typically do a Google search to find out the details about it. However, when we do a search for this term, unfortunately not many results can be found except some installation guides, images, few descriptive details etc.

To have a proper understanding of this, a tutorial/article in easier language is required, especially for those who are covering Micro Focus ALM Synchronizer topic for the first time.

That is the main reason for which I am sharing this topic with all of you. I am lucky enough to get a chance to work on this tool and to understand it closely.

HP ALM Synchronizer

This article will give a complete overview of the role, needs and work on the Micro Focus ALM tool along with its download link and procedure in a precise way for your easy understanding. This article will really be an effective guide for those who are new to this tool.

Overview

Micro Focus ALM Synchronizer is a very useful and convenient tool for those companies where the Developers are using some Defect Management tools like TFS (Team Foundation Server) and Testers/QA are using some other Defect Management Tools like QC/ALM (Quality Centre/Application Lifecycle Management).

Let’s take a proper look at it now..!!!!

Micro Focus ALM Synchronizer is a ‘Defect Management Tool’.

Many companies use this tool for smooth flow of defect management among the developers and testers. Handling defects is one of the important tasks of testing. Hence it is important to have such a tool that can assure the smooth flow of defect management across the company among the developers and testers.

Now comes the question of what does Micro Focus ALM Synchronizer do exactly and how?

Please follow the tutorial below to seek an answer to this question.

What is the Role of This Tool

This tool enables one to synchronize the data between Micro Focus ALM and its following endpoints. There will always be 1 ALM Instance tool at one end and some other tool on the other end, among which syncing is done. I am considering Micro Focus ALM and TFS as 2 endpoints for the rest of the tutorial.

The below diagram depicts syncing between 2 endpoints:

‘Micro Focus ALM/QC’ is a tool which is used by the testers/QA for handling all the information related to defects. The other one is the TFS, which is used among the developers for handling all the information about defects.

If testers make any changes to some defects at the QC end then how can the developers keep an update of that or in simple terms, we can say how can the developers keep an eye on the tester’s actions for the same defect from the TFS end.

This problem arises just because of lack of communication between the developers and QC/ALM in many organizations and they solely use TFS/JIRA or like manner tools for defect management.

Under such cases, a tool like Micro Focus ALM Synchronizer comes into the picture.

Download Info

Micro Focus ALM Synchronizer Client and the Server can be downloaded from the Micro Focus Site.

It is very important to know the versions of the 2 endpoints before downloading the Synchronizer.

Example: If the versions of Micro Focus ALM and TFS are 12.2 then 12.2 Synchronizer Client should be downloaded on the local machine from where the synchronizer needs to run.

Before downloading the client, it’s essential to register for a Micro Focus Passport and then sign in to the downloaded software and documentation for the installation guide.

Here is the link to get registered: Download Link

Click on the Register for Micro Focus Official site to create an account and then login & download as per the needs.

For any assistance regarding the installation guide and documentation, you can go to the help menu of the tool.

Why Is There a Need for This Tool

After having an overview of this tool, we will now move on to the next section to understand why the need for Micro Focus ALM Synchronizer arose and what it all exactly does.

Take a look at the replies:

#1) Serves the purpose of Integration: between both the TFS and QC/ALM, which thereby enables the testing team to coordinate on project management with the development team which uses TFS strictly.

#2) Synchronizes QC Defects with TFS Bugs: What Does This Mean? It means that when any defect is logged by any tester at the QC end, then all its related information is mapped directly into TFS, once the synchronizer starts running the developers also come to know about any new defect is that logged with all the details pertaining to it.

#3) Supports Error Handling: No one can be 100% perfect and it is quite common for humans to commit errors and this is where Synchronizers come into picture by providing Error Handling Mechanism. Using the “Advanced” tab section, Synchronizer makes it possible by letting a specific group e-mail address section who can respond quickly and intimate the concerned person to rectify the errors.

To explain this further in a practical manner, I wish to tell you that in my firm once I have the responsibility to take a closer look at the errors and get them rectified by making the concerned person.

One needs to have some training and basic knowledge to get it done as errors can be of various kinds. (Types of errors are discussed below in this article)

#4) Defect Management: This is easily achieved with the help of this tool by matching/syncing the fields in QC Defect IDs (like the priority, description of the defect, etc) with the corresponding TFS IDs.

Example: Defect has some attachments (documents) to it and for the same defect, there is a corresponding TFS ID.

But in case, if there is some discrepancy in the documents at both the ends, (the documents that are at QC end are not present at TFS end), then the synchronizer solves that issue by syncing and letting the same documents be made available at both the ends i.e. at TFS as well as at the QC.

Below is a screenshot depicting the look and feel of this tool with its fields and links:

As seen in the above diagram, there are several tabs and links section on the left-hand side. We will take a look at the links in the upcoming section.

Links to ALM Synchronizer

By now, we know that there will be 2 endpoints and sync will be done among those 2 endpoints, and now the question that comes next is how and where will it be present in the Synchronizer.

Links are used for storing information about these or we can say that it defines which entities are included in the synchronization and how synchronization is performed.

Key Points to be noted:

• 2 Links will be presented and named as per the organization’s convenience.
• To better understand it, we can name them Link1 and Link2.
• On the ALM/QC (endpoint1) front, defects will be referred to as “Bugs” and as “Task” at the TFS end (endpoint2). Note: I will be using these 2 terms throughout the article to state Defect in these 2 endpoints with these names.
• All the related information, as seen in the diagram (related to various tabs like general information, related to connection, field mapping, scheduling) has to be updated for both the links.
• Links should always be in an enabled state as the synchronizer can only run in the enabled state.
• On right-clicking any of the links, the synchronizer can run by selecting the run synchronizer option (any of the 3 types of synchronizer – which we will be discussing in a while)

Here is the basic information that you need to know about the Links to this tool.

Tabs for This Tool

I have tried to give a brief overview of each tab in the easiest manner for your better understanding so that if in case you get a chance to work on this tool in the future, you will at least be aware of what each of them represents.

#1) General Tab: This is the first tab which covers all the general information about both the endpoints. This shows the endpoint name, type, and information regarding all the types of synchronization runs and whether the run passed, failed or failed with errors along with the reports.

#2) Connectivity Tab: This tab contains all connection related details like username, a password for both endpoints and provides a button to check connectivity. You can check if the connection is successful or not.

#3) Scheduling Tab: This tab shows the scheduled information about running of a synchronizer and at what time the synchronizer runs by proving the details for both the endpoints or we can say for both the synchronizers (Link1 and Link2 namely).

#4) Filters Tab: This tab is used to provide filter options stating if any filter is required to sync the data or not. Queries from the backend can be provided for both the links and the name of the queries can be set as a filter. For link1, a query can be stored on the ALM side and for link2 at the TFS side respectively.

#5) Events Tab: This tab contains details or rules for creating, updating, deleting a record etc., and if a record is created at one end then what needs to be done at the other end. If a record is deleted or updated at one endpoint then what will be the corresponding event at the other endpoints?

These details can be put on this tab by selecting the required radio button or by choosing the ‘Do Nothing’ option in case nothing is required to be set.

#6) Field Mapping Tab: This is a very important tab to be understood as this holds the details about all the fields of both the endpoints.

Example: State, Severity, Priority of defects etc are stored for both the links and fields can be mapped bidirectionally or unidirectionally in some cases.

If the severity is updated of any defect on the ALM side then the same value should be moved to TFS side also and vice versa. Hence, it is mapped as bidirectional. Fields can be edited too by selecting the field and clicking on the edit button present on the synchronizer on the field mapping screen.

But this should be done only by trained ones as any mistake can hamper the working of the entire synchronizer.

#7) Advanced Tab: This tab is already discussed above in Error Handling points. This is basically to provide an advanced feature to intimate the concerned person to rectify errors.

Next comes the working of a Synchronizer!!

Working on Micro Focus ALM Synchronizer

The points given below depict exactly how a Synchronizer works.

• A user can define the Input and Output criteria during the synchronization process. It means if a user wants to reflect the changes in the QC or TFS, accordingly, an input can be provided at any of the ends. To put it in better terms, if an input is TFS and output is QC then all the changes will be reflected in the QC defects and vice versa. Example: If I create a new Defect in the QC then the input is QC and output is TFS and the corresponding TFS ID for QC Defect ID is created accordingly.

• For every selected Defect for synchronization in QC, it creates a matching work item in TFS and for every selected Work Item in TFS, it creates a matching Defect in QC. The above diagram also clearly depicts this 2-way synchronization. Note: For new items created on the TFS end, I will be referring to it as a “Work Item”.
• For every Defect updated in QC, it updates a matching Work Item in TFS.
• It maps enumerated values like Severity, Priority etc., for every Defect.
• It synchronizes attachments between TFS and QC.

Next, let’s take a look at the Errors that occur while working with Micro Focus ALM Synchronizer and I wish to brief you more about all the possible error types along with their resolution.

Errors while working with this tool

You may come across some issues or errors while working with Synchronizer. When several people are involved in a working environment, the chances of error occurrence increases accordingly. But one should be ready to get it rectified as soon as possible.

Errors can be of the following types:

#1) Wrong Value Entered:

While working on a QC Defect, anyone may update/enter the description wrongly with some unrequired spaces or with some incorrect symbols.

In such a case, in order to rectify the issue, you can go and check the history of the Defect in QC as who has worked on the same and you can intimate the concerned person to get it updated correctly. It is recommended not to rectify it yourself even if you know the solution.

Let the concerned person handle it. Finally, once it is updated correctly, you can run the synchronizer and check the report if it passed or not and inform the person again in case of any issues. The same can be done if an issue occurs on the TFS side.

#2) Document Issue:

Sometimes the documents attached to the Defect may not be of the expected size or expected format. This can again give an error of FAILED/UPDATE/DELETE ATTACHMENTS and so one has to rectify it.

The process will be the same to let the concerned person upload the documents with the expected size or format.

#3) Blank Value in Mandatory Fields:

If any of the mandatory fields are left blank then it will throw an error automatically.

Again, let the concerned person update it correctly and run the synchronizer to see the results.

Finally, let’s discuss the different Types of Synchronizer!!

Types of Micro Focus ALM Synchronizer

Each type of Synchronizer runs on the basis of different requirements and can be scheduled to run at specific times in a day to know if the updated and newly created records are synced properly without any issues.

#1) Incremental Synchronizer

As the name itself suggests, it runs in case of increments or when some changes are made. This run is to determine which records in the endpoint were created or modified since the previous synchronization task.

Later, synchronization is done between the 2 endpoints based on the settings and mappings that are done for the link.

#2) Full Synchronizer

This synchronizer is for full syncing i.e. to perform a full comparison of the records for each endpoint. This helps to gather information about those records which are not synchronized in an incremental run. Hence, when this runs each and every record is synced.

With the help of the reports, one can easily know which all records in the endpoints are not synced properly.

#3) Integrity Check

This is completely different from the ones above. This does not run in normal scenarios. This runs mainly when creating a new link or modifying an existing link.

This should be handled very accurately, as on its failure the link remains invalidated and cannot be enabled for synchronization.

Conclusion

In a nutshell, a Synchronizer is a tool whose features can be utilized by just entering/creating the endpoints and their related fields just once and a specific timing can be assigned to it later, on which it runs on a daily basis and provides detailed reports to ensure if everything is in place.

Fewer defects are a sign of efficient testing and through this tool, that can be assured by keeping a check on the defects and by watching both the developers and testers to perform their tasks efficiently, without blaming one another.

Whenever any defect is logged, all its related information will be available to both developers and testers with full transparency with the help of Micro Focus ALM Synchronizer Tool.

Only those who are currently using this tool can truly understand its importance. I’m really excited to have the knowledge and hands-on experience with such a futuristic tool.

Have you tried this tool? Let us know your experiences in the comments section below. We would love to hear from you.

About the author: This post was written by STH team member Varsha G.