Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt

Use this file to discover all available pages before exploring further.

The PDMP Configuration screen (/cl/pdmp/configuration) is the admin page for setting the Prescription Drug Monitoring Program gateway provider and query behavior options for the organization.

​
Overview

The page renders PdmpConfigurationForm inside a PageContainer. The form is gated by PermissionGate on cl.pdmp.configuration.manage and shows a loading skeleton while configuration data is fetched via usePdmpConfiguration. The form has four fields validated with Zod: a gateway_provider select (options: PMP Gateway (NABP), Bamboo Health / Appriss, Arizona HIE (Contexture)) and three boolean toggles — auto_query_enabled (Auto-Query on Prescribing), interstate_query_enabled (Interstate Queries), and delegate_access_enabled (Delegate Access). On submit, updateConfiguration.mutate is called with the form values. The card header text reads “Configure Arizona CSPMP/PDMP gateway settings for your organization.”

​
Who it’s for

Requires permission: cl.pdmp.configuration.manage

​
Before you start

You must hold the cl.pdmp.configuration.manage permission. Only one PDMP configuration record exists per organization; this screen edits that record. Gateway credential secrets are managed separately and are not exposed in this UI.

​
Steps

1

Navigate to /cl/pdmp/configuration

Open the Clinical module and navigate to PDMP Configuration. The form loads the current gateway settings for your organization.
2

Select a gateway provider

Choose the PDMP gateway vendor from the dropdown: PMP Gateway (NABP), Bamboo Health / Appriss, or Arizona HIE (Contexture).
3

Configure query behavior toggles

Enable or disable each toggle as appropriate:
  • Auto-Query on Prescribing — automatically query PDMP when prescribing controlled substances.
  • Interstate Queries — query neighboring state PDMP databases in addition to Arizona.
  • Delegate Access — allow designated delegates to query PDMP on behalf of prescribers.
4

Save configuration

Click “Save Configuration.” The button shows “Saving…” while the mutation is in flight and returns to its default label on completion.

​
Key concepts

Three providers are available in the shipped schema: pmp_gateway (PMP Gateway / NABP), bamboo_health (Bamboo Health / Appriss), arizona_hie (Arizona HIE / Contexture). Selection is enforced by a Zod enum — no other values are accepted.
The component comment explicitly notes: “credentials_vault_ref is NOT exposed in the UI.” Gateway credentials are stored separately outside this form.
While configuration data loads, the form renders three skeleton rows inside the card. No data is shown until usePdmpConfiguration resolves.
PermissionGate wraps the entire form with fallback={null}. Users without cl.pdmp.configuration.manage see nothing rendered by the form component.

Clinical

Overview of the Clinical core.

Governance & parity

Documentation coverage and governance.
This page documents shipped product behavior. It is not medical, legal, or billing advice. Verify against your organization’s policies and applicable regulations before using it for clinical, compliance, or billing decisions. Protected health information (PHI) shown in the product is governed by your tenant’s access controls and is never exposed in this documentation.
  • src/routes/cl.tsx
  • src/cores/cl/pages/PdmpConfigurationPage.tsx
  • src/cores/cl/components/PdmpConfigurationForm.tsx
  • src/cores/cl/hooks/usePdmpConfiguration.ts