Merge pull request #124 from msupply-foundation/oms-indicators-docs

Oms indicators docs

content/docs/distribution/requisitions.md

@@ -110,7 +110,7 @@ You will then see the detail view of the requisition:
 The customer reference is automatically generated when the customer creates an
 Internal Order, but you can also enter a customer reference manually.
 
-#### View or edit the Requisition Information Panel
+#### View or Edit the Requisition Information Panel
 
 The information Panel allows you to see or edit information about the
 Requisition. It is divided into three sections:
@@ -121,7 +121,7 @@ Requisition. It is divided into three sections:
 
 We are planning to add more sections in the future as Open mSupply grows.
 
-##### How to open and close the information Panel?
+##### How to Open and Close the Information Panel?
 
 To open the Information Panel, you can tap on the `More` button, located in the
 top right corner of the Requisition page.
@@ -286,7 +286,7 @@ Usually, Requisitions will be sent to you by your Customers. However, if they ar
 You cannot change the customer name after the requisition has been created. If you have made a mistake in selecting the customer, you will need to delete the requisition and create a new one.
 </div>
 
-#### Adding lines to a Requisition
+#### Adding Lines to a Requisition
 
 Tap on the `Add Item` button (top right corner).
 

content/docs/programs/immunizations.md

@@ -4,7 +4,7 @@ description = "Immunization Programs"
 date = 2022-05-17T16:20:00+00:00
 updated = 2022-05-17T16:20:00+00:00
 draft = false
-weight = 62
+weight = 61
 sort_by = "weight"
 template = "docs/page.html"
 

content/docs/programs/module-hiv.es.md

@@ -4,7 +4,7 @@ description = "Introducción al módulo de manejo de pacientes con VIH"
 date = 2023-01-27T00:00:00+00:00
 updated = 2023-01-27T00:00:00+00:00
 draft = false
-weight = 61
+weight = 63
 sort_by = "weight"
 template = "docs/page.html"
 
@@ -16,60 +16,59 @@ top = false
 
 Trabajo en progreso...
 
-Crear un nuevo paciente 
+Crear un nuevo paciente
 
 mSupply puede crear un archivo de paciente que contendrá toda la información necesaria para dispensar medicamentos. Para crear un nuevo archivo de paciente, haz clic en 'dispensario' y luego en el icono de 'pacientes' desde el Panel de control:
 
 ![Stock: nav](/docs/programs/images/Access_Patient.png)
 
-
 Esto mostrará la página de 'Paciente'. Para ingresar la información de un nuevo paciente en mSupply, haz clic en el botón 'Nuevo Paciente'.
 
 ![Stock: nav](/docs/programs/images/New_Patient.png)
 
-Aquí encontrarás la opción de buscar a un paciente existente para poder dispensarle el medicamento necesario al paciente correcto, y la información se documentará e informará a mSupply. 
+Aquí encontrarás la opción de buscar a un paciente existente para poder dispensarle el medicamento necesario al paciente correcto, y la información se documentará e informará a mSupply.
 
 ![Stock: nav](/docs/programs/images/Patient_Details.png)
 
 Haz clic en 'Aceptar y Siguiente' para mostrar todos los criterios coincidentes, como en el ejemplo a continuación:
 
 ![Stock: nav](/docs/programs/images/Matching_Patients.png)
 
-Para crear un nuevo paciente, simplemente coloca toda la información relevante del paciente en la pestaña 'Nuevo Paciente'. Esto mostrará la opción para incluir el nombre, fecha de nacimiento y número de identificación de salud nacional, entre otros detalles. 
+Para crear un nuevo paciente, simplemente coloca toda la información relevante del paciente en la pestaña 'Nuevo Paciente'. Esto mostrará la opción para incluir el nombre, fecha de nacimiento y número de identificación de salud nacional, entre otros detalles.
 
 ![Stock: nav](/docs/programs/images/Patient_Details.png)
 
 La información ahora se puede utilizar para encontrar el archivo del paciente en una fecha posterior. Después de hacer clic en 'Aceptar y Siguiente', puedes acceder a la opción 'Crear', que transferirá toda la información previamente ingresada a una nueva pestaña que permite/requiere más detalles:
 
 ![Stock: nav](/docs/programs/images/Create_Patient.png)
 
-Búsqueda de un paciente 
+Búsqueda de un paciente
 
-Cuando estés en el menú 'Dispensario', aparecerá una lista completa de pacientes existentes. 
+Cuando estés en el menú 'Dispensario', aparecerá una lista completa de pacientes existentes.
 
 ![Stock: nav](/docs/programs/images/Search_Patient.png)
 
 Al hacer clic en el nombre de un paciente, se mostrarán los detalles del paciente.
 
-En el mismo menú de 'Paciente', hay barras de búsqueda encima de la lista de pacientes que se pueden utilizar para reducir y especificar la búsqueda. Puedes buscar por el primer nombre y el apellido, así como por ID. Esto puede ser útil para encontrar rápidamente pacientes con nombres comunes o si hay un gran número de pacientes existentes. 
+En el mismo menú de 'Paciente', hay barras de búsqueda encima de la lista de pacientes que se pueden utilizar para reducir y especificar la búsqueda. Puedes buscar por el primer nombre y el apellido, así como por ID. Esto puede ser útil para encontrar rápidamente pacientes con nombres comunes o si hay un gran número de pacientes existentes.
 
 ![Stock: nav](/docs/programs/images/Narrow_Search_Patient.png)
 
-Encontrar detalles del paciente 
+Encontrar detalles del paciente
 
-Al hacer clic en un archivo de paciente (en la pestaña 'Paciente'), se vinculará automáticamente con los detalles personales del paciente. El historial de 'Programa' y 'Encuentro' se pueden encontrar en la misma sección. 
+Al hacer clic en un archivo de paciente (en la pestaña 'Paciente'), se vinculará automáticamente con los detalles personales del paciente. El historial de 'Programa' y 'Encuentro' se pueden encontrar en la misma sección.
 
 ![Stock: nav](/docs/programs/images/Patient_Program_Details.png)
 
 Exportar lista de pacientes
 
 mSupply permite la opción de exportar datos de pacientes para enviarlos a un usuario que no usa mSupply. Esto iniciará la descarga de un archivo de Excel con los detalles básicos de los pacientes:
 
-1) Nombre
-2) Apellido
-3) ID
+1. Nombre
+2. Apellido
+3. ID
 
-Esto se puede hacer haciendo clic en la opción 'Exportar' en la esquina del menú principal de 'Paciente'.. 
+Esto se puede hacer haciendo clic en la opción 'Exportar' en la esquina del menú principal de 'Paciente'..
 
 ![Stock: nav](/docs/programs/images/Export_Patients.png)
 
@@ -79,32 +78,28 @@ mSupply permite inscribir a los pacientes en un programa relevante para la inter
 
 ![Stock: nav](/docs/programs/images/Add_Program.png)
 
-Los programas son personalizables y específicos para cada contexto y país: los siguientes ejemplos son de la intervención del VIH en Papúa Nueva Guinea. Esto significa que cada programa y los detalles requeridos serán diferentes para cada usuario de mSupply. 
+Los programas son personalizables y específicos para cada contexto y país: los siguientes ejemplos son de la intervención del VIH en Papúa Nueva Guinea. Esto significa que cada programa y los detalles requeridos serán diferentes para cada usuario de mSupply.
 
 Si hay más de un programa disponible, todas las opciones aparecerán con los programas específicos en los que el paciente está inscrito marcados y en gris.
 
-Si deseas inscribir al paciente resaltado en otro programa, puedes hacerlo desde este menú.  
+Si deseas inscribir al paciente resaltado en otro programa, puedes hacerlo desde este menú.
 
 ![Stock: nav](/docs/programs/images/Program_Details.png)
 
 Encuentros
 
-Un 'Encuentro' es la visita registrada de un paciente y su tratamiento bajo un programa específico.  
+Un 'Encuentro' es la visita registrada de un paciente y su tratamiento bajo un programa específico.
 
 NOTA: No puedes registrar un encuentro sin un paciente inscrito en un programa - sin embargo, esto puede cambiar en futuras implementaciones de mSupply
 
-Bajo la categoría 'Dispensario' se encuentra la pestaña 'Encuentros'. 
+Bajo la categoría 'Dispensario' se encuentra la pestaña 'Encuentros'.
 
 ![Stock: nav](/docs/programs/images/Encounters_Tab.png)
 
 Al hacer clic en esto, se mostrará una lista de pacientes y todos los encuentros que se han documentado en mSupply. Esto incluye la fecha, estado y programa.
 
-NOTA: Un paciente debe estar inscrito en un programa para poder ingresar un encuentro. 
+NOTA: Un paciente debe estar inscrito en un programa para poder ingresar un encuentro.
 
 ![Stock: nav](/docs/programs/images/Encounters_List.png)
 
 Después de hacer clic en un paciente en la pestaña "Encuentro", se mostrará un panel de...
-
-
-
-

content/docs/programs/program_indicators.md

@@ -0,0 +1,40 @@
++++
+title = "Program Indicators"
+description = "Program Indicators"
+date = 2023-05-19T00:00:00+00:00
+updated = 2023-05-19T00:00:00+00:00
+draft = false
+weight = 62
+sort_by = "weight"
+template = "docs/page.html"
+
+[extra]
+lead = "Collecting data metrics across mSupply stores"
+toc = true
+top = false
++++
+
+Program Indicators are essentially sets of configurable survey questions that can be answered as part of a program requisition. They are recorded against the period that the program requisition is created for and used in reporting.
+
+## Enabling Program Indicators
+
+Program Indicators are configured on the mSupply Primary Server, following the documenation [here](https://docs.msupply.org.nz/items:programs#adding_indicators_to_a_program).
+
+## Manual Customer Requisitions
+
+Manual Customer Requisitions can be made to other stores as a fallback if device that store is meant to be active on is no longer operational.
+
+1. Create a manual requisition to another store as described [here](/docs/distribution/requisitions/#manual-requisition)
+2. Click on the Indicators tab
+
+![Indicators tab](/docs/programs/images/indicators.png)
+
+<div class='note'>
+HIV is only available on Programs where "HIV" has been enabled.
+</div>
+
+3. Click on one of the Program Indicator buttons
+
+![Indicators edit](/docs/programs/images/indicators_edit.png)
+
+From here you can enter in the data entry configured for each indicator configured for this program.

content/docs/programs/requisitions.md

@@ -75,7 +75,7 @@ The list view has gained some additional columns, showing the program related da
 
 #### Manual Program Requisitions
 
-Program Requisitions can also be created manually. This would typically be for customers who do not use mSupply, or in exceptional circumstances.
+Program Requisitions can also be created manually. This would typically be for customers who do not use mSupply, or in exceptional circumstances for other mSupply stores. It is **strongly** advised not to do this for customers that are mSupply Stores, unless their device is destroyed or mSupply is otherwise not operable. The risk is creating duplicate requisitions and indicator data for periods and schedules if users at the customer store are also entering the same data into mSupply.
 
 See the configuration steps above, and also the [Customer
 tag](https://docs.msupply.org.nz/names:adding_and_editing#tags_tab)
@@ -103,6 +103,11 @@ You will now be redirected to the Requisition detail page. The lines will be
 pre-populated with the items from the program; this means that you cannot add
 items manually to the Requisition.
 
+#### Extra Requisition Fields
+
+In manual requisitions it is possible to collect many additional columns of data for reporting and forcasting purposes. To enable these columns you need to configure store permissions to enable these extra columns as documenting in mSupply Desktop documentation [here](https://docs.msupply.org.nz/other_stuff:virtual_stores#preferences_tab). For quick reference this is the preference your logged in store requires:
+![Show extra fields on requisitions preference](/docs/programs/images/show_extra_fields_on_requisitions.png)
+
 ![Program Requisition Detail
 View](/docs/programs/images/program_requisition_detail_view.gif)