.. _data-entry-user-docs: Data Entry ========== The Way Back (TWB) Support Service Minimum Data Set is an extension of the Primary Mental Health Care Minimum Data Set (PMHC MDS); current PMHC MDS online User Guide for Data Entry is available to be viewed at https://docs.pmhc-mds.com/user-documentation/data-entry.html. PMHC Client Data ^^^^^^^^^^^^^^^^ For more detail on how to search, find, view, add, edit or delete Client PMHC data in the PMHC MDS, please visit the PMHC User Guide at https://docs.pmhc-mds.com/projects/user-documentation/en/latest/data-entry.html#client-data. PMHC Episodes ^^^^^^^^^^^^^ For more detail on how to find, view, add, edit or delete Client PMHC Episode data in the PMHC MDS, please visit the PMHC User Guide at https://docs.pmhc-mds.com/projects/user-documentation/en/latest/data-entry.html#episodes. .. _twb-episode-data: TWB-Episode ^^^^^^^^^^^ You can view a client’s episodes through Viewing a Client’s details available on the Data Entry tab, by following these steps: .. _view-episodes: Viewing a Client's PMHC Episode ------------------------------- You can view a client's TWB episodes through viewing a client's details available on the Data Entry tab, by following these steps: 1. Search for the client using one of the three search fields. .. figure:: screen-shots/client-search-fields.png :alt: Client Search View 2. Click on the Client Key in blue displayed within the table list. .. figure:: screen-shots/client-search-results.png :alt: Client Search View 3. From the Client's Summary tab, you can shortcut straight to an episode by clicking the Blue Episode Key displayed in the snapshot of the five most recent episodes. .. figure:: screen-shots/client-view-summary.png :alt: Client Data Summary View 4. Alternately, if you would like to view all episodes you can click on the Episode Tab. The heading for this tab displays in brackets the total number of episodes recorded in the PMHC MDS for this client at Provider Organisations for which you have access. A table will display all the Client's Episodes at Provider Organisations for which you have access. .. figure:: screen-shots/client-episodes-summary.png :alt: Client Data Summary View A Drop down list is available to view: * All Episodes * Currently Open Episodes * Closed Episodes .. figure:: screen-shots/client-episodes-summary-sort.png :alt: Client Episodes Sort View To view the Client's Episode details, click the Blue Episode Key. .. figure:: screen-shots/client-episodes-details.png :alt: Client Episodes Details View A page will display the Client's PMHC Episode details. .. _add-twb-episode: Adding a Client's TWB Episode data ---------------------------------- You can edit a Client's PMHC Episode details through :ref:`view-episodes` available on the Data Entry tab to add a Client's TWB Episode data, by following these steps: 1. Once :ref:`view-episodes`. 2. From the Client's Episode table, click the Episode Key. 3. Click Edit Details tab. 4. Add ``!wayback`` in the 'Tags' fields and press tab .. figure:: screen-shots/client-episodes-twb-tag.png :alt: Client Episodes TWB Tag 5. Scroll to the bottom of the PMHC Episode Add the Client's TWB Episode details. Mandatory fields are marked with an * . (Specification :ref:`TWB Episode Data Elements `) .. figure:: screen-shots/client-episodes-twb-add.png :alt: Client Episodes Edit Details You can also add the following information if available, or these can be added later: - See :ref:`TWB-Critical Incident data specifications ` for Critical Incident Data. - See :ref:`TWB-Recommendation Out data specifications ` for Recommendation Out Data. 6. Click the blue 'Save' button. (If you decide not to add TWB data, you can simply navigate away from this screen) You will receive confirmation that the Client's Episode details have been saved, and it will now be displaying. .. figure:: screen-shots/saved.png :alt: Client Episode Data Saved Successfully If you receive an error message, the data will need to be corrected before the record is saved and added to the PMHC MDS. See Validation Rules - :ref:`TWB Episode ` .. _edit-twb-episode: Editing a Client's TWB-Episode data ----------------------------------- You can edit a Client's PMHC Episode details through :ref:`view-episodes` available on the Data Entry tab, by following these steps: 1. Once :ref:`view-episodes`. 2. From the Client's Episode table, click the Episode Key. 3. Click Edit Details tab. 4. Scroll to the bottom of the PMHC Episode. Update the Client's TWB Episode details. Mandatory fields are marked with an * . (Specification :ref:`TWB Episode Data Elements `) .. figure:: screen-shots/client-episodes-twb-edit.png :alt: Client Episodes Edit Details 5. Click the blue 'Save' button. (If you decide not to save changes, you can simply navigate away from this screen) You will receive confirmation that the Client's TWB Episode details have been saved, and it will now be displaying these new details in the Episode View Details tab. .. figure:: screen-shots/saved.png :alt: Client Episode Data Saved Successfully If you receive an error message, the data will need to be corrected before the record is saved and added to the PMHC MDS. See Validation Rules - :ref:`TWB Episode ` .. _delete-twb-episode: Deleting an TWB Episode ----------------------- Removing the ``!wayback`` tag will delete an TWB Episode, through :ref:`view-episodes` available on the Data Entry tab, by following these steps: 1. Once :ref:`view-episodes`. 2. From the Client's Episode table, click the Episode Key. 3. Click Edit Details tab. 4. Click on the cross on the ``!wayback`` tag to remove it. .. figure:: screen-shots/client-episodes-twb-tag.png :alt: Client Episodes Edit Details 5. Click the blue 'Save' button. Deleting the The Way Back Episode data will also delete the: * Primary Nominated Professional Contact, * Critical Incidents, and * Recommendation Outs. However any associated measures will be retained. .. figure:: screen-shots/client-episodes-twb-delete.png :alt: Client Episodes TWB Delete Details **Please note: Once the collection occasion is deleted, you will not be able to recover this collection occasion data.** 6. Click the red 'Confirm' button to delete the data. (If you decide not to delete the data, you can click the blue 'Cancel' button) .. figure:: screen-shots/saved.png :alt: Client Episode Data Saved Successfully .. _collection-occasion-data: Collection Occasions ^^^^^^^^^^^^^^^^^^^^ .. _view-collection-occasion: Viewing a Client's Collection Occasions for an Episode ------------------------------------------------------ You can view a client's collection occasions through :ref:`view-episodes` available on the Data Entry tab, by following these steps: 1. Once :ref:`Viewing the Client's Episode `. 2. Click the Episode Collection Occasions Tab. This tab displays in brackets the total number of collection occasions recorded in the PMHC MDS for this episode. A table will display all the Collection Occasions linked to this Client's Episode. .. figure:: screen-shots/client-collection-occasions-view.png :alt: Client Episode Collection Occasions Table View 3. To view the Collection Occasions details, click the Blue Collection Occasions Key. .. figure:: screen-shots/client-collection-occasions-details.png :alt: Client Episode Collection Occasions Details View A page will display the Collection Occasions details as recorded via the :ref:`Collection Occasion Data Elements `. .. _add-collection-occasion: Adding an TWB Client's Collection Occasions data ------------------------------------------------ You can add a Client's Collection Occasions through :ref:`view-collection-occasion` available on the Data Entry tab, by following these steps: 1. Once :ref:`view-collection-occasion`. 2. Firstly double check the Collection Occasion is not already showing. 3. Click the Add New Collection Occasion tab. 4. Enter the Client's Collection Occasion details for the TWB episode. Mandatory fields are marked with an * . (Specification :ref:`Collection Occasion Data Elements `) .. figure:: screen-shots/client-collection-occasions-add.png :alt: Client Data Add Collection Occasions 5. Click the blue 'Save' button. (If you decide not to add this client's episode, you can simply navigate away from this screen) You will receive confirmation that the Client's Collection Occasion details have been added, and it will now be displaying these new details in the View Collection Occasions Details tab. .. figure:: screen-shots/saved.png :alt: Client Data Saved Successfully If you receive an error message, the data will need to be corrected before the record is saved and added to the PMHC MDS. .. _edit-collection-occasion: Editing a Client's Collection Occasions for an Episode ------------------------------------------------------ You can edit a Client's Collection Occasions through :ref:`view-collection-occasion` available on the Data Entry tab, by following these steps: 1. Once :ref:`view-collection-occasion`. 2. Click the Collection Occasion Key. 3. Click Edit Details tab. 4. Update the Client's Collection Occasion details. Mandatory fields are marked with an * . (Specification :ref:`Collection Occasion Data Elements `) *Please note: You can edit the Collection Occasion Key from this screen. See* :ref:`edit-collection-occasion-key`. .. figure:: screen-shots/client-collection-occasions-edit.png :alt: Client Collection Occasion Edit Details 5. Click the blue 'Save' button. (If you decide not to save changes, you can simply navigate away from this screen) You will receive confirmation that the Client's Collection Occasion details have been saved, and it will now be displaying these new details in the View Collection Occasion Details tab. .. figure:: screen-shots/saved.png :alt: Client Data Saved Successfully If you receive an error message, the data will need to be corrected before the record is saved and added to the PMHC MDS. .. _edit-collection-occasion-key: Editing a Collection Occasion Key ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ You can edit a collection occasion's identification key through :ref:`view-episodes` available on the Data Entry tab, by following these steps: 1. In step four when :ref:`edit-collection-occasion`. 2. From the Collection Occasion Edit Details tab, click the 'Edit Key' button. .. figure:: screen-shots/client-collection-occasions-edit-key.png :alt: Client Data Edit Collection Occasion Key 3. Type in the new collection occasion key and click 'Next'. 4. Double check the new key is correct and click save. (If it is incorrect, click back to re-enter the key or click the 'cross' in the top right to cancel this key change request) You will receive confirmation that the Collection Occasion's key has been saved, and the screen will now be displaying the updated collection occasion key details in the Collection Occasions View Details tab. .. figure:: screen-shots/client-collection-occasions-edit-key-saved.png :alt: Collection Occasion Key Saved Successfully .. _delete-collection-occasion: Deleting a Collection Occasion ------------------------------ You can delete a Client's Collection Occasions through ':ref:`view-collection-occasion`' available on the Data Entry tab, by following these steps: 1. Once :ref:`view-collection-occasion`. 2. Click the Collection Occasion Key. 3. Click the red 'Delete' button. 4. You will either be displayed a Confirm Delete screen or a Cannot Delete screen .. _delete-collection-occasion-confirm: Confirm Delete ~~~~~~~~~~~~~~ **Please note: Once the collection occasion is deleted, you will not be able to recover this collection occasion data.** 1. Click the blue 'Confirm' button to delete this collection occasion. (or click the orange 'Cancel' button if you decide not to delete this collection occasion data) .. figure:: screen-shots/client-collection-occasions-delete-confirm.png :alt: Client Collection Occasion Data Confirm Delete After you click Confirm, you will receive confirmation that the episode has been deleted, and you will be redirected to View Episodes where the episode will no longer be displayed. .. figure:: screen-shots/client-collection-occasions-delete-successful.png :alt: Client Collection Occasion Data Delete Successful .. _delete-collection-occasion-cannot: Cannot Delete ~~~~~~~~~~~~~ If the collection occasion you are trying to delete has any measures, you will not be able to proceed with deleting this collection occasion until all the related records have been deleted. You can click on the link provided to view the client’s measures for this collection occasion, or click the orange Dismiss button .. figure:: screen-shots/client-collection-occasions-delete-cannot.png :alt: Client Collection Occasion Data Delete Successful See :ref:`delete-collection-occasion-measure`. .. _collection-occasion-measure-data: Collection Occasion Measures ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. _view-collection-occasion-measure: Viewing a Client's Collection Occasion Measures for an Episode -------------------------------------------------------------- You can view a Client's Measures added to a Collection Occasion through :ref:`view-collection-occasion` available on the Data Entry tab, by following these steps: 1. Once :ref:`Viewing the Collection Occasion `. 2. Scroll down to the Measures A table will display all the Measures linked to this Client's Episode Collection Occasion. .. figure:: screen-shots/client-collection-occasions-details.png :alt: Client Episode Collection Occasions Table View 3. To view the Measure details, click the Blue Measure Key. .. figure:: screen-shots/client-collection-occasions-measures-view.png :alt: Client Episode Collection Occasions Details View A page will display the Collection Occasion details as recorded via the :ref:`Collection Occasion Data Elements `. .. figure:: screen-shots/client-collection-occasions-measures-details.png :alt: Client Episode Collection Occasions Details View .. _add-collection-occasion-measure: Adding an Client's Collection Occasion Measures data ---------------------------------------------------- You can add a Client's Measure for a Collection Occasion through :ref:`view-collection-occasion` available on the Data Entry tab, by following these steps: 1. Once :ref:`view-collection-occasion`. 2. Firstly double check the measure is not already showing. 3. Click the Add New Measure tab. .. figure:: screen-shots/client-collection-occasions-measures-add.png :alt: Client Data Add Collection Occasions 4. Select the Collection Occasion Measure type. .. figure:: screen-shots/client-collection-occasions-measures-select.png :alt: Client Data Add Collection Occasions Measure Select 5. Choose the Score Type, if it isn't already pre-filled. 6. Click the blue 'Next' button. 7. Enter the Client's Measure details for the Collection Occasion. Mandatory fields are marked with an * . * See :ref:`TWB-Plan data specifications ` for Plan Data. * See :ref:`TWB-NI data specifications ` for Needs Identification Data. * See :ref:`K10+ Measure data specifications `. * See :ref:`WHO-5 Measure data specifications `. * See :ref:`SIDAS Measure data specifications `. 6. Click the blue 'Save' button. (If you decide not to add this client's measure, you can simply navigate away from this screen) You will receive confirmation that the Client's Measure details have been added, and it will now be displaying these new details in the View Measure tab. .. figure:: screen-shots/client-collection-occasions-measures-saved-add.png :alt: Client Data Saved Successfully If you receive an error message, the data will need to be corrected before the record is saved and added to the PMHC MDS. .. _edit-collection-occasion-measure: Editing a Client's Measures for a Collection Occasion ----------------------------------------------------- You can edit a Client's Measure for a Collection Occasion through :ref:`view-collection-occasion` available on the Data Entry tab, by following these steps: 1. Once :ref:`view-collection-occasion`. 2. Scroll down to the Measures 3. Click the Blue Measure Key. 4. Click Edit Measure 5. Update the Client's Measure details. Mandatory fields are marked with an * . *Please note: You can edit the Measure Key from this screen. See* :ref:`edit-collection-occasion-measure-key`. .. figure:: screen-shots/client-collection-occasions-measures-edit.png :alt: Client Collection Occasions Edit Details 6. Click the blue 'Save' button. (If you decide not to save changes, you can simply navigate away from this screen) You will receive confirmation that the Client's Collection Occasions details have been saved, and it will now be displaying these new details in the View Collection Occasion Details tab. .. figure:: screen-shots/client-collection-occasions-measures-saved-edit.png :alt: Client Data Saved Successfully If you receive an error message, the data will need to be corrected before the record is saved and added to the PMHC MDS. .. _edit-collection-occasion-measure-key: Editing a Measure Key ~~~~~~~~~~~~~~~~~~~~~ You can edit an measure's identification key through :ref:`view-collection-occasion` available on the Data Entry tab, by following these steps: 1. In step four when :ref:`edit-collection-occasion-measure`. 2. From the Collection Occasion Edit Details tab, click the 'Edit Key' button. .. figure:: screen-shots/client-collection-occasions-measures-edit-key.png :alt: Client Data Edit Collection Occasion Key 3. Type in the new collection occasion key and click 'Next'. 4. Double check the new key is correct and click save. (If it is incorrect, click back to re-enter the key or click the 'cross' in the top right to cancel this key change request) You will receive confirmation that the Collection Occasion's key has been saved, and the screen will now be displaying the updated collection occasion key details in the Collection Occasion View Details tab. .. figure:: screen-shots/client-collection-occasions-measures-edit-key-saved.png :alt: Collection Occasion Key Saved Successfully .. _delete-collection-occasion-measure: Deleting a Measure from a Collection Occasion --------------------------------------------- You can delete a Client's Measure from a Collection Occasion through ':ref:`view-collection-occasion-measure`' available on the Data Entry tab, by following these steps: 1. Once :ref:`view-collection-occasion`. 2. Scroll down to the Measures 3. Click the Blue Measure Key. 4. Click Edit Measure 5. Click the red 'Delete' button. 6. You will be displayed a 'Confirm Deletion' screen. **Please note: Once the measure is deleted, you will not be able to recover this measure data.** 7. Click the blue 'Confirm' button to delete this measure. (or click the orange 'Cancel' button if you decide not to delete this measure data) .. figure:: screen-shots/client-collection-occasions-measures-delete-confirm.png :alt: Client Measure Data Confirm Delete After you click 'Confirm', you will receive confirmation that the measure has been deleted, and you will be redirected to the :ref:`View Measures ` where the measure will no longer be displayed. .. figure:: screen-shots/client-collection-occasions-measures-delete-successful.png :alt: Client Measure Data Delete Successful PMHC Service Contact Data ^^^^^^^^^^^^^^^^^^^^^^^^^ For more detail on how to search, find, view, add, edit or delete Service Contact PMHC data in the PMHC MDS, please visit the PMHC User Guide at https://docs.pmhc-mds.com/projects/user-documentation/en/latest/data-entry.html#service-contacts. **Please note: TWB adds an extra field Service Contact - Funding Source to the standard PMHC Service Contact.** Update the Client's Service Contact details. Mandatory fields are marked with an * . (Specification :ref:`Service Contact Data Elements `) For all Service Contacts provided under The Way Back please select “TWB”. .. figure:: screen-shots/client-collection-service-contact-funding.png :alt: Client Service Contact Funding Source