1. ProKnow
  2. Patient Module
  3. General

Managing Patients in a Workspace

Avatar
Kyle Burnett
Follow

IN THIS ARTICLE

Once you have uploaded patients using either the Uploads module or the ProKnow DICOM Agent, you can view a list of patients for a given workspace in the Patients module. This article explains how to manage the patients in your workspaces.

Note: You must have the Read Workspace permission on a workspace to view that workspace. You must have the Read Patients permission on a patient to view that patient in the list of patients within a workspace.

Viewing the Patient List

To view the patients in your organization, select the Patients module from the main navigation on the left. Use the workspace dropdown at the top of the page to switch workspaces. If your organization has many workspaces, search for the one you're looking for by filtering the workspaces by name.

2018-08-14_16-20-46.gif

A similar filter mechanism is available to filter the list of patients. You can filter the patients by typing the patient's ID or name.

2018-08-14_16-23-44.gif

Viewing Patient Details

Double-click on a patient row in the table to view details about a patient including any associated image sets, structures, plans, doses, and scorecards.

Creating a Patient

  1. Press the Create Patient button located in the gray bar at the top.
  2. Enter the unique patient ID and the patient Name. This ID must be unique within each workspace. Optionally, enter the Birth Date, Birth Time, and Sex fields.

  3. Press the Create button to create the patient.

Note: You must have Create Patients permissions on a workspace to create patients in that workspace.

Selecting Patient

Patients may be selected in several ways:

  • Click on the row to select only that row.
  • Click on the checkbox in the first column to add the patient to the selection.
  • Ctrl + Click on the row to add the patient to the selection.
  • Shift + Click to add a range of patients to a selection.

Once you have one or more patients selected, the patient actions dropdown will become enabled with the options enumerated below.

Create New Collection

  1. With one or more patients selected, click on the Actions dropdown and press Create New Collection.
  2. Enter the Name and Description of the new collection.
  3. Press the Create button to create the collection with the selected patients.

Skipping Patients

Collections may only have 0 or 1 representative entity per patient. For each patient selected, the system will attempt to add the patient to the collection according to the following algorithm:

  1. If the patient has more than one dose object, skip the patient.
  2. Otherwise, if the patient has exactly one dose object, add the patient with the dose as the representative entity to the collection.
  3. Otherwise, if the patient has more than one plan object, skip the patient.
  4. Otherwise, if the patient has exactly one plan object, add the patient with the plan.
  5. Otherwise, if the patient has more than one structure set object, skip the patient.
  6. Otherwise, if the patient has exactly one structure set object, add the patient with the structure set.
  7. Otherwise, if the patient has more than one image set object, skip the patient.
  8. Otherwise, if the patient has exactly one image set object, add the patient with the image set.
  9. Otherwise, the patient should be added without a representative entity.

Note: You must have an Analytics license and the Create Collections permission on the workspace to create a new workspace collection for the selected patients.

Add to Existing Collection

  1. With one or more patients selected, click on the Actions dropdown and press Add to Existing Collection.
  2. Select the collection from the list of available collections. Use the collection filter to filter the list of collections available for the current workspace.
  3. Press the Submit button to add the selected patients to the collection.

Skipping Patients

Collections may only have 0 or 1 representative entity per patient. For each patient selected, the system will attempt to add the patient to the collection according to the following algorithm:

  1. If the patient has more than one dose object, skip the patient.
  2. Otherwise, if the patient has exactly one dose object, add the patient with the dose as the representative entity to the collection.
  3. Otherwise, if the patient has more than one plan object, skip the patient.
  4. Otherwise, if the patient has exactly one plan object, add the patient with the plan.
  5. Otherwise, if the patient has more than one structure set object, skip the patient.
  6. Otherwise, if the patient has exactly one structure set object, add the patient with the structure set.
  7. Otherwise, if the patient has more than one image set object, skip the patient.
  8. Otherwise, if the patient has exactly one image set object, add the patient with the image set.
  9. Otherwise, the patient should be added without a representative entity.

Note: You must have an Analytics license and the Add Collection Patients permission for a collection to add patients to an existing collection.

Export as CSV

  1. With one or more patients selected, click on the Actions dropdown and press Export as CSV.
  2. Open the downloaded CSV, which will contain the standard and custom fields that have been set for the selected patients.

Establish Entity Associations

  1. With one or more patients selected, click on the Actions dropdown and press Establish Entity Associations.
  2. Select the type of operation to perform. Currently, ProKnow only supports the Single Entity Assumption type. Press the Next button to continue.
  3. Press the Search button to search for entities that can be automatically associated.
  4. If no entities are found, press Close to exit the wizard. Otherwise, press Continue to view the results.
  5. Download the list of proposed entity associations, and follow the instructions given in the wizard. Modify and reupload the file as needed. Once you're ready to continue, read and acknowledge the disclaimer by checking the box at the bottom of the wizard, and choose Continue.
  6. Press the Start button to begin the association process.
  7. Press the Finish button to exit the wizard.

Move Patients

  1. With one or more patients selected, click on the Actions dropdown and press Move.
  2. Select the workspace where you wish to move the selected patients. Press the Next button to continue.
  3. Press the Move button to execute the move operation.
  4. Once the operation is complete, you may download the results CSV file to review the results of each copy, including any errors. Press the Finish button to exit the wizard.

Note: You must have the Move Patients permissions on a patient to move the patient and the Read Workspace permission for the destination workspace you choose.

Copy Patients

  1. With one or more patients selected, click on the Actions dropdown and press Copy.
  2. Select the workspace where you wish to copy the selected patients. Press the Copy button to begin the operation.

Note: You must have the Copy Patients permission for a patient to copy the patient and the Read Workspace permission for the destination workspace you choose.

Delete

CAUTION: Deleting patients is an irreversible action, so use caution. Deleting a patient will also delete all patient data associated with that patient.

  1. With one or more patients selected, click on the Actions dropdown, and press Delete.
  2. Press the Delete button to confirm that you wish to delete the selected patients and all their data.

Note: You must have the Delete Patients permission for a patient to delete the patient.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

0 comments

Article is closed for comments.