Docs: Adding informatin on Surveys. user/lfloyd/Docs_Surveys
authorlfloyd <lfloyd@library.in.gov>
Fri, 27 Dec 2019 20:18:03 +0000 (15:18 -0500)
committerlfloyd <lfloyd@library.in.gov>
Fri, 27 Dec 2019 20:18:03 +0000 (15:18 -0500)
Adding updated information on Surveys, their creation, use, and reporting.

Lynn Floyd  lfloyd1@library.in.gov

13 files changed:
docs/admin/surveys.adoc [new file with mode: 0644]
docs/media/survey-1.png
docs/media/survey-10.png
docs/media/survey-2.png
docs/media/survey-3.png
docs/media/survey-3a.png [new file with mode: 0644]
docs/media/survey-4.png
docs/media/survey-5.png
docs/media/survey-6.png
docs/media/survey-8.png
docs/media/survey-9.png
docs/root.adoc
docs/root_staff_client_admin.adoc

diff --git a/docs/admin/surveys.adoc b/docs/admin/surveys.adoc
new file mode 100644 (file)
index 0000000..bc91ef0
--- /dev/null
@@ -0,0 +1,113 @@
+Surveys
+-------
+indexterm:[Surveys]
+
+Surveys can be created that appear on the patron registration/edit page for a branch or system. Surveys questions can be optional or required. Some examples of survey questions might include: Would you use the library if it were open on a Sunday? Would you like to be contacted by the library to learn about new services? Do you attend library programs? Are you registered to vote?
+
+Surveys come up when a patron is first registered. If you would like staff to ask the survey questions when the patron’s library card is renewed, you’ll need to make that part of local procedure.
+
+It is possible to run reports on Surveys, this will allow you to obtain statisical information from the surveys or listing of responses. For example, you could find out how many people say they would use the library if it were open on a Sunday, or you could get a list of patrons who say they would like to receive marketing material from the library. You can also visit individvual patron records to see their survey answers.
+
+To create a new survey
+~~~~~~~~~~~~~~~~~~~~~~
+
+. Go to *Administration* -> *Local Administration* -> *Surveys*.
++
+image::media/survey-2.png[Surveys]
++
+. Click the Add New Survey button.
+. A popup will appear:
++
+image::media/survey-3.png[New Survey]
++
+. Fill in the form.
+  * _Name_ is the Name of the survey, this shows up in the patron record.
+  * _Description_ is a description of the survey, include anything you want about the survery.
+  * _Owning Library_ sets who gets the survey question. Set at consortitial level for all patrons, set at system level for just a system, set at branch level for just a branch. 
+  * _Start Date_ must be at least one day after the current date and must be in the format m/d/y. Example: 12/27/19
+  * _End Date_ is the date the survey is to end. This must be set in the same format m/d/y. If you do not want the survey to expire, then set the date way off in the future example 12/31/35.
+  * _OPAC Survey?_ This is to be future development, do not set.
+  * _Poll Style?_ This is to be future development, do not set.
+  * _Is Required?_ This sets the Survey as required for patron registration. 
+  * _Display in User Summery?_ This allows the survey questions and answers to show up in the User Summery on the right hand side.
+. Click *Save Changes*.
+. The screen will refresh so that you may add a question: 
++
+image::media/survey-3a.png[Add Questions]
++
+. Enter the survey question and click the *Save Question & Add Answer* button.
++
+image::media/survey-4.png[Add Answers]
++
+. Enter each option answer and click the *Add Answer* button after each one. Then click the *Save Changes* button. If you do not save your changes, then the answer will not be saved.
++
+image::media/survey-5.png[Saving Answers]
++
+. Repeat the steps above to add as many questions and answers as you wish. 
+. Click the Save button when complete. Make sure you use your browsers Back Button to go to the list of surveys.
+
+To Edit a Survey
+~~~~~~~~~~~~~~~~
+
+To edit a survey the survey must be in the future, you cannot edit active surveys. 
+
+. Open the survey to edit by clicking on it's _Name_.
++
+image::media/survey-7.png[Edit Survey]
++
+. If the survey is an active survey, change the _Survey Start Date/Time_ to a future date.
+. Click *Save*.
+. Use the browser Back Button to go back to your list of surveys, and select your survey again.
+. Now edit the Survey questions, 
+  * Edit the text of any question or answer, making sure your click *Save Changes* after each edit.
+  * Delete a question completely by clicking on *Delete Question & Answers*.
+  * Delete just an answer by clicking on *Delete Answer* for that answer only.
+. Add any additional questions and/or answers at this time.  Remembering to always *Save Changes*.
+. Click *Save* once all your changes are made.
++
+image::media/survey-1.png[Edit Survey]
++
+. Use the browser Back Button to go back to the list of surveys.
+
+TIP: If the survey needs to be active immediately, you can set the _Survey Start Date/Time_ in the past. This is really usefully when editing an existing survey.
+
+To End a Survey
+~~~~~~~~~~~~~~~
+
+If you need to end a survey before the Survey End Date, you can edit the survey and then click on *End Survey Now*. This will set the Survey End Date to today's date.
+
+Normal Staff view of Surveys
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This is what the survey looks like in the Patron Registration, the answers appear as a drop down list.
+
+image::media/survey-6.png[Patron Registration]
+
+To access a patrons answers to a survy, you can view those through the staff client. Once in the patron record go to *Other -> Surveys*.
+
+image::media/survey-9.png[Access Survey Answers]
+
+This will show the answers to the surveys for that patron.
+
+image::media/survey-8.png[Patron Survey Answers]
+
+Reporting on Surveys
+~~~~~~~~~~~~~~~~~~~~
+
+There are three Non-core Sources for reporting.
+
+* *Survey*
+** This reports informaton about surveys starting with the Survey.
+** This source is great to see the surveys with questions and answers(Responses). 
+** Also, use this source to find out the Survey Answers and Questions ID's.
+* *Survey Answer*
+** This source starts with the answers then goes to the questions.
+* *Survey Response*
+** This sources ties into the Responding Users.  
+** Use this source to report user information and counts.
+** This is the source you will use for most of the reporting on the Surveys.
+
+In the Core Sources you can use _ILS User_. In the ILS User, there is the source for _Survey Responses_.
+
+NOTE: In the _Survey Response_ Source there is a _Response Group ID_. This links all the answers to a specific set of Survey questions, answers, and patron information.
+
index 536f926..61468d1 100644 (file)
Binary files a/docs/media/survey-1.png and b/docs/media/survey-1.png differ
index 80d5b85..b391dea 100644 (file)
Binary files a/docs/media/survey-10.png and b/docs/media/survey-10.png differ
index ba6a10f..99a58e0 100644 (file)
Binary files a/docs/media/survey-2.png and b/docs/media/survey-2.png differ
index 6f0afd0..2fcbb99 100644 (file)
Binary files a/docs/media/survey-3.png and b/docs/media/survey-3.png differ
diff --git a/docs/media/survey-3a.png b/docs/media/survey-3a.png
new file mode 100644 (file)
index 0000000..7103224
Binary files /dev/null and b/docs/media/survey-3a.png differ
index 0ffc781..33c9daa 100644 (file)
Binary files a/docs/media/survey-4.png and b/docs/media/survey-4.png differ
index afafdcb..d4f1e0e 100644 (file)
Binary files a/docs/media/survey-5.png and b/docs/media/survey-5.png differ
index 688d1f6..eeacfdf 100644 (file)
Binary files a/docs/media/survey-6.png and b/docs/media/survey-6.png differ
index 3a37afd..d0ef4a2 100644 (file)
Binary files a/docs/media/survey-8.png and b/docs/media/survey-8.png differ
index 896e527..aa87b13 100644 (file)
Binary files a/docs/media/survey-9.png and b/docs/media/survey-9.png differ
index 8925b21..26f4554 100644 (file)
@@ -326,6 +326,8 @@ include::admin/lsa-statcat.adoc[]
 
 include::admin/popularity_badges_web_client.adoc[]
 
+include::admin/surveys.adoc[]
+
 include::admin/lsa-work_log.adoc[]
 
 Acquisitions
index e4d40f1..d3f1a2f 100644 (file)
@@ -291,6 +291,8 @@ Introduction
 
 This section describes other staff client administrator tasks.
 
+include::admin/surveys.adoc[]
+
 include::admin/actiontriggers.adoc[]
 
 :leveloffset: 0