The IDMP Viewer consolidates and displays medicinal product submission data in a unified view, allowing your organization to more easily review IDMP data prior to and following submission.
Note: This feature is only available on RIM Registrations Vaults and must be configured by an Admin.
About IDMP Data Sets & Data View Selection
The IDMP Viewer displays unified views of up to 20 total IDMP data sets.
A single data set can be:
- A Medicinal Product for which IDMP data has been generated.
- A single Medicinal Product record corresponds to a single Product Data Submission record in scope of a given Regulatory Objective.
- Up to 20 Product Data Submission records can be collected within an IDMP Grouping to manage them in bulk.
- PMS data for a single Medicinal Product.
- FHIR messages generated either in RIM as part of the IDMP process, or from the EMA’s Product Lifecycle Management (PLM) Portal as an eAF output report.
This means that users generating a data view may be prevented from selecting certain Data View Selection dialog options, based on previous selections. For example, a user initiates an IDMP Viewer session (runs the Generate IDMP Data View action) from an IDMP Grouping with 15 related Product Data Submission records, accounting for 15 Medicinal Products. (As noted above, one Product Data Submission record corresponds to one Medicinal Product record.) For the remaining five data sets, the user can select up to five FHIR messages in the Compare Data dropdown, for a total of 20 data sets.
This limitation is especially impactful in RIM Vaults configured for PMS submission, where users may want to create a data view with PMS data for Medicinal Products, likely within an IDMP Grouping. Using the example above, a user in a PMS-configured Vault would not be able to select the Include PMS Data checkbox, because the view already includes 15 Medicinal Products, and PMS data for a single Medicinal Product is counted as one data set.
Working with IDMP Groupings
The IDMP Viewer supports reviewing data for a single Product Data Submission record, or you can create an IDMP Grouping object record for up to 20 Product Data Submission records in scope of the related Regulatory Objective.
Using a grouping also allows you to refresh IDMP elements from source data for the included Product Data Submissions.
To create an IDMP grouping:
- From a Regulatory Objective record, navigate to the IDMP Groupings section.
- Click Create, populate any required fields, and click Save. Vault loads the Regulatory Objective record page.
- Navigate to the IDMP Groupings section and open the record you created.
- Within the IDMP Product Data Submissions section, click Create.
- In the Create IDMP Product Data Submission dialog, populate a Medicinal Product and any other required fields. Click Save.
Repeat these steps as applicable for up to 20 Product Data Submission records. Selecting more than 20 records causes the related Vault job to error when generating the view.
About the Data View Owner
By default, Vault sets the Data View Owner on the selected Product Data Submission records with the name of the user who initiates the viewer session. When populated, all other users are prevented from initiating a session which includes any of these records.
In the event the Data View Owner is unable to commit their changes and end the session, remove their name from this field. This discards all uncommitted changes, unlocks the Product Data Submission record(s), and allows another user to initiate a new session.
When the related Vault setting is enabled, the initiating user is instead prompted to select a Data View Owner in the viewer’s Data View Selection dialog. They can select themselves, or designate a different owner. In the latter scenario, the designated owner receives a notification with their user-specific link to the viewer session. The initiating user does not receive a notification and cannot access the session.
FHIR Message Version Support
Generally, the IDMP Viewer supports generating and comparing FHIR messages using v5.0.0 only.
While the viewer can display messages for other FHIR versions, comparison data may be incomplete. See additional details about how Vault supports different FHIR versions.
Initiating an IDMP Viewer Session
You can initiate an IDMP Viewer session via the Generate IDMP Data View action from an IDMP Grouping record you’ve created, or from a single Product Data Submission record. Generally, a single IDMP Viewer session can include up to 20 total data sets.
Depending on your Vault’s configuration, the action may only be available for records in a specific lifecycle state, for example In Progress for IDMP Groupings and Planned for Product Data Submissions.
- From a Regulatory Objective record, navigate to the IDMP Groupings or Product Data Submissions section to locate the record you wish to load in the viewer.
- In the record’s Actions menu, select Generate IDMP Data View. Depending on your Vault’s IDMP Viewer settings, the Data View Selection dialog includes various prompts. Click Continue once you’ve made your selection(s).
- Use the Select IDMP Data View Owner dropdown to select yourself, or designate another user.
- Select FHIR messages within the Compare Data dropdown for comparison in the viewer. Options are limited to messages stored in the Library under the IDMP > EU IDMP Submission or IDMP > eAF FHIR Output document subtypes.
- Select or deselect the Include PMS Data checkbox option.
Vault begins processing the request. Once complete, you or the selected owner receive a Vault notification and email with a link to the IDMP Viewer session, as well as a CSV file confirming results.
Note: IDMP Viewer links are unique to the user who received the notification and cannot be shared.
Returning to a Session
While your IDMP Viewer session is active, you can use the link provided in the original Vault notification or email to return to it as needed. You cannot return to session by re-running the Generate IDMP Data View action, even if you are the current Data View Owner.
Working in the IDMP Viewer
Once Vault initiates an IDMP Viewer session, the Data View Owner can begin reviewing the selected records across one or multiple sessions. When the view includes Unmatched data, click Review> to do so directly. Otherwise, apply any Filters to locate the element you’d like to review, then click Commit.
Once Vault launches the comparison view, you can:
- Select the FHIR Data, PMS Data, or Unmatched filter chip to quickly display that type.
- Apply additional standard filters, as well as the Only Text Fields and Differing Values quick filters.
- Select or deselect records in the left-hand navigation tree to temporarily hide or show them in the comparison view.
- Click Edit to update text override fields.
As you work in the viewer, Vault saves any changes to a temporary file it creates for the session.
About Unmatched Data
When the IDMP Viewer flags PMS or FHIR message data as Unmatched, this means that the data exists in PMS but does not exist in RIM, or PMS data does not match existing RIM data based on defining characteristics. The viewer’s various filters can help you determine which is correct.
When updates are required, we recommend doing so within RIM by updating the source data then re-generating IDMP data and the data view. The ability to update source data directly within the IDMP Viewer will be supported in a future Vault release.
The Unmatched filter chip displays such records in the viewer grid within highlighted blocks. Each block is an XML representation of PMS data elements for the indicated medicinal product.
Records are grouped by the parent Medicinal Product with other records of the same type. For example, the viewer displays unmatched PDS Packaged Medicinal Product Element records with matched PDS Packaged Medicinal Product Element records from PMS and IDMP output records of the same type.
About Text Fields & Differing Values
You can apply the comparison view’s Only Text Fields and Differing Values quick filters together or separately.
- The Only text fields filter displays only text override fields, for example GMO Text, which overrides the GMO field in the PDS Classification System object.
- The Differing values filter displays only editable text override fields with different field values.
- Vault highlights fields in blue to indicate a data difference in that field, in comparison to the record listed first in the grid, on the far left.
- Vault does not highlight differences in other types of fields, such as object reference fields. For example, Vault would not highlight a Legal Basis field because it is a PDS Classification System field referencing a Legal Basis Controlled Vocabulary object record.
Note: Vault highlights differing fields only to indicate further review may be required. Highlighting does not necessarily indicate a problem with the data, and some differences among like records may be appropriate. For example, the PDS Classification System object includes the GMO Text field, which is configured for only the GMO object type. When comparing a GMO record against other classification object types (Legal Basis, Paediatric Use), the viewer highlights the GMO Text field as different, because GMO Text is not configured for the other types.
Comparing Submission Data & FHIR Messages
When you generate an IDMP data view, you can additionally Compare selected data sets. For example, the viewer can highlight differences between a PDS Packaged Medicinal Product Element record and its related packaging configurations captured in Packaged Medicinal Product records.
Vault highlights any differing data points among like records, which the Data View Owner can update where necessary directly in the viewer.
Refreshing IDMP Data
The Refresh IDMP Data action is available to recreate IDMP elements from source data for the Product Data Submissions related to an IDMP Grouping.
Depending on your Vault’s configuration, this action may be available on IDMP Grouping records in the In Progress state.
Committing & Closing a Session
When your review and edits are complete, click the Commit button to confirm and close the IDMP viewer session, even if you did not make any changes.
Upon committing, Vault permanently ends the IDMP viewer session and:
- Updates the IDMP output records with any changes captured within the temporary file it created for the session.
- Unlocks the Product Data Submission and selected IDMP output records, allowing other users to edit and view them within a new viewer session.
- Inactivates the session link from the original IDMP Viewer session notification. If you attempt to reinitiate the session from an inactive link, Vault displays a “Page Not Found” error message, and you must return to the IDMP Grouping or Product Data Submission record to initiate a new session.
- Purges the temporary file.
Vault performs these actions asynchronously within the Commit IDMP Data View system job.
About eAF FHIR Messages
The IDMP Viewer supports viewing FHIR message XML in human-readable format. For more information, see Generating eAF Output Reports.