Using the Medical-Quality Connection, organizations with both MedInquiry and a Quality QMS Vault can exchange data. The Medical-Quality Connection transfers Product Quality Complaint data from MedInquiry to Quality, which includes the relevant product, event, and reporter information required for the Complaint Intake process.
Medical-Quality Connection Components
The components below support the standard Medical-Quality Connection.
Connections
The following Connection records are available in Admin > Connections:
- Medical-Quality Connection (
medical_quality__v) is available in your Medical Vault - Medical-Quality Connection (
medical_quality__v) is available in your Quality Vault
You must establish a Vault to Vault Connection before using the Connection records.
Integration & Integration Points
The Integration and Integration Point objects enable Vault to manage the message queues and define what documents and data the connection maps from one Vault to another. These records are read-only and are used by Vault to manage the connection and track any connection errors.
In your Medical Vault, the Medical-Quality Connection record includes the default Product Quality Complaint Integration record with following standard Integration Point records:
- Product Quality Complaint Outbound Integration Point
- Product Quality Complaint Inbound Integration Point
In your Quality Vault, the Medical-Quality Connection record includes the default Medical-Quality: PQC Integration record with following standard Integration Point records:
- Medical-Quality: PQC Outbound Integration Point
- Medical-Quality: PQC Inbound Integration Point
Integration Rules
To support the Medical-Quality Connection, it may be necessary to transform data from the source Vault’s data model to fit within the target Vault’s data model. You can use Integration Rules to incorporate configurable rules for mapping object and document fields between two Vaults.
Third Party Agreements
The connection supports different third party agreements with regards to managing Reporter data in Quality. While configuring the connection, please contact Veeva Support to configure the connection for your relevant third party agreement.
Queues
This feature includes four (4) standard message processing queues. You can access and manage these queues from Admin > Connections > Spark Queues.
In your Medical Vault, you have:
- Medical to Quality Product Quality Complaint Outbound Queue (
medical_to_quality_pqc_outbound_queue__v) - Quality to Medical Product Quality Complaint Inbound Queue (
quality_to_medical_pqc_inbound_queue__v)
In your Quality Vault, you have:
- Quality to Medical Product Quality Complaint Outbound Queue (
quality_to_medical_pqc_outbound_queue__v) - Medical to Quality Product Quality Complaint Inbound Queue (
medical_to_quality_pqc_inbound_queue__v)
Query Object Rules
The connection supports query object rules. Query object rules provide an additional layer of specificity to your field rules. Learn more about creating query object rules.
User Exception Objects
Vault includes the User Exception Message object and its child object, User Exception Item, to help you track and resolve any errors that occur with your Medical-Quality Connection. If either end of your integration can’t process an incoming message, Vault creates a User Exception Message record to capture the failure.
Vault also creates individual User Exception Item records for each item that failed on the related Integration Point record in one of your Vaults. Vault typically creates User Exception Messages in the source Vault when there are issues with the configuration or connection itself. User Exception Messages in the target Vault often contain User Exception Items, as the target Vault can encounter document-specific errors as well as configuration errors.
You can view and manage these messages from Admin > Connections > User Exception Messages. If you want specific users or groups to receive notifications when Vault creates User Exception Message records, you may configure a flash report for new User Exception Messages, or create a custom lifecycle for the User Exception Message object and configure a notification entry action.
A User Exception Message may mean you need to update your data or configuration. After you update the configuration, Vault attempts to resolve any errors the next time the connection runs. You can also select the Retry Transfer action on the User Exception Message record to run the connection and resolve errors.
Last Successful Run Time Field
On each Integration record, the Last Successful Run Time field captures the date and time that the integration last ran with no errors. Vault uses this date to query changes since the integration’s last successful run.
When an integration becomes active, Vault automatically sets its Last Successful Run Time to the current datetime. If you inactivate and reactivate an Integration record, Vault also sets the Last Successful Run Time to the current datetime.
You can also manually set the Last Successful Run Time field to a prior datetime. Setting the field to a prior datetime automatically triggers the integration.
Configuring Your Vaults for the Connection
Enabling the Integration in MedInquiry
The Product Quality Complaint Integration is inactive by default. To activate this integration:
- In your MedInquiry Vault, navigate to Admin > Connections > Medical-Quality Connection.
- Expand the Integrations section.
- Click Product Quality Complaint Integration.
- Select Active in the Status field.
- Click Save.
Enabling the Integration in Quality
The Medical-Quality:PQC Integration is inactive by default. To activate this integration:
- In your Quality Vault, navigate to Admin > Connections > Medical-Quality Connection.
- Expand the Integrations section.
- Click Medical-Quality: PQC Integration.
- Select Active in the Status field.
- Click Save.
Configuring Reference Lookups
Reference lookups are a configuration component referenced by integration rules that allow you to map the value of a field on a target object or document indirectly from a value in the source Vault. When you configure the Medical-Quality Connection, you need to add reference lookups for controlled fields within the integration scope. We recommend creating CSV mapping files and loading these to your Vault to create reference lookups.
Reviewing Field Rules
We recommend reviewing the field rules for each integration rule for the Medical-Quality Connection. To do so, navigate to Admin > Connections > Integration Rules, select an integration rule, and click Field Rules.
Related Permissions
You need a System Admin security profile as well as the following permissions to set up the standard Medical-Quality connection:
| Type | Permission Label | Controls |
|---|---|---|
| Security Profile | Admin: Application: Manage Connections | Ability to set up the standard Medical-Quality Connection |
| Security Profile | Object: User Exception Item, User Exception Message: Read | Ability to see User Exception Item and User Exception Message records if a connection failure occurs |