From 759ea8bd1090c4e287ebac02a249eee616d4c590 Mon Sep 17 00:00:00 2001 From: Truls Torgersen Date: Fri, 31 Jan 2025 09:50:19 +0100 Subject: [PATCH] removed readme content in backend and added corresponding documenation to docs folder --- Bouvet.Developer.Survey.Backend/README.md | 63 +---------------------- docs/QUALTRICS.md | 29 +++++++++++ 2 files changed, 30 insertions(+), 62 deletions(-) create mode 100644 docs/QUALTRICS.md diff --git a/Bouvet.Developer.Survey.Backend/README.md b/Bouvet.Developer.Survey.Backend/README.md index 5bdd336..7d822e2 100644 --- a/Bouvet.Developer.Survey.Backend/README.md +++ b/Bouvet.Developer.Survey.Backend/README.md @@ -1,64 +1,3 @@ # Bouvet Developer Survey Backend -- Read /docs/GETTING_STARTED.md before reading this. - -### Setting up db (Windows only) -The testing and production enviroment uses a Azure Database, but for local development you can use a local database. -For creating a local db and connecting to it, follow these steps: - -1. Open cmd and run the following command on this path: `C:\Windows\System32> - * `sqllocaldb create "Local"` - -2. Open Microsoft SQL Server Management Studio and connect to the local db: - * Server name: (localdb)\Local - * Authentication: Windows Authentication - -3. Create a new database called whatever you want, but for this example we will call it BouvetDeveloperSurvey. - -In the secrets.json, add the following connection string: -```json -{ - "ConnectionString": "Server=(localdb)\\Local;Initial Catalog=BouvetDeveloperSurvey;Integrated Security=True" -} -``` - -Then you can run the api, the database will be connected and migrations to create the tables will be run automatically. - -## Connect to Azure OpenAI - -The key vault has not been connected to the project yet, but the secrets to connect to the Azure OpenAI API should be stored in the secrets.json file. The OpenAiUrl and OpenAiKey should be stored in the secrets.json file. - -```json -{ - "OpenAiUrl": "url", - "OpenAiSecretKey": "key" -} -``` - ---- - -## Exporting the survey from Qualtrics - -First of all, we will have to go to https://www.qualtrics.com/ where the survey is located. -We will have to export the survey structure and responses to a file. -* The structure file will be in the format of a .json file. -* The responses file will be in the format of a .csv file. - -In order to export the survey structure, go to the survey you want to export and on the Survey tab, click the dropdown menu Tools and then Import/Export. And then click on Export Survey. - -![img_6.png](../docs/images-gettings-started/img_6.png) - -When the export is done, we will have a .qsf file that are a json file with the survey structure. - -In order to export the survey responses, go to the survey you want to export and on the Data & Analysis tab. - -![img_7.png](../docs/images-gettings-started/img_7.png) - -There is a dropdown menu called Export Data. Click on it and then click on Export Data. - -![img_8.png](../docs/images-gettings-started/img_8.png) - -Then, use this export functionality to export the responses to a .csv file in the correct format. -It is important to use numeric values, as the .csv file does not provide data on multiple-choice questions if there are choice texts marked as export values! - -![img_9.png](../docs/images-gettings-started/img_9.png) +- Read /docs/GETTING_STARTED.md on how to set up the project. \ No newline at end of file diff --git a/docs/QUALTRICS.md b/docs/QUALTRICS.md new file mode 100644 index 0000000..28c890e --- /dev/null +++ b/docs/QUALTRICS.md @@ -0,0 +1,29 @@ +# Qualtrics + +The project is currently using qualtrics to host the survey. This guide outlines how to export data from there. To get test data see GETTING_STARTET.md. + +## Exporting the survey from Qualtrics + +First of all, we will have to go to https://www.qualtrics.com/ where the survey is located. +We will have to export the survey structure and responses to a file. +* The structure file will be in the format of a .json file. +* The responses file will be in the format of a .csv file. + +In order to export the survey structure, go to the survey you want to export and on the Survey tab, click the dropdown menu Tools and then Import/Export. And then click on Export Survey. + +![img_6.png](../docs/images-gettings-started/img_6.png) + +When the export is done, we will have a .qsf file that are a json file with the survey structure. + +In order to export the survey responses, go to the survey you want to export and on the Data & Analysis tab. + +![img_7.png](../docs/images-gettings-started/img_7.png) + +There is a dropdown menu called Export Data. Click on it and then click on Export Data. + +![img_8.png](../docs/images-gettings-started/img_8.png) + +Then, use this export functionality to export the responses to a .csv file in the correct format. +It is important to use numeric values, as the .csv file does not provide data on multiple-choice questions if there are choice texts marked as export values! + +![img_9.png](../docs/images-gettings-started/img_9.png) \ No newline at end of file