Expertiza_Wiki - User contributions [en]

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-30T03:49:53Z

Rsah: /* Relevant Links */

__TOC__

== Background ==
Answer tagging (see [https://github.com/expertiza/expertiza/blob/25713567e5e5e1c0b363409715e6d8797b45b01a/app/models/answer_tag.rb answer_tab.rb] and [[Answer_tags|wiki]]) helps determine a few metrics on a student’s responses to a questionnaire. Students can tag these metrics for other students for things such as “Positive Tone” or “Suggest Solutions”.

These specs below all need to be further developed to cover missing methods/lines. Some structures currently exist at the top of spec files (such as assignments, participants, etc) to help make writing tests easier. Please feel free to add to these and write extra tests to cover any edge cases you may think of.

As an instructor on an assignment, going to Etc/View Reports/Answer Tagging Report will show student answer tagging. You will be able to see the percentage of answers tagged, # of answers tagged, # not tagged, and # of taggable answers for each student on a questionnaire.

[[File:Tagging_report.png|thumb|center|Fig. 1]]

== Project Purpose==
The objective of the project is unit testing of functionality in these two ruby files and increasing the coverage.

[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec]

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec]

== Initial Coverage ==
[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec] : 0% Covered

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec] : 18% Covered

=== Missed Methods ===
* <code>app/controllers/answer_tags_controller.rb</code>
** <code>action_allowed?</code>
** <code>index</code>
** <code>create_edit</code>
** <code>destroy</code>

* <code>app/models/tag_prompt_deployment.rb</code>
** <code>get_number_of_taggable_answers</code>
** <code>assignment_tagging_progress</code>

== Project Design ==
In this project, we have two controllers to be tested using Rspec Unit testing.

The ER diagram of the parent tables is given below for reference ([https://expertiza.csc.ncsu.edu/index.php/Answer_tags Source: Answer_tags]).

[[File:answer_tags_imported.png]]

The flow diagrams below show how controllers in this project are connected with interrelated classes, methods, and views.

[[File:E2169 answer tags controller.png|900px]]

[[File:E2169 tag prompt deployment.png|900px]]

== Testing Plan ==
=== Controller: answer_tags_controller.rb ===

Existing coverage = 0%

Description:
The purpose of this controller is to track down the total number of tags done by the students. The database structure for the answer_tags can be found here [https://expertiza.csc.ncsu.edu/index.php/Answer_tags]

'''Methods'''

1. action_allowed? ( params: action )

Description: To allow the functionality only if the accessing user is having student privileges (current_user_has_student_privileges?)

<code>Use cases:</code>
* <code>When the session is null, Access should be denied</code>
* <code>When the session is of student type, access should be allowed and operation should be executed.</code>

2. index ( params : assignment_id, questionnaire_id, user_id )

Description: Populates the tags by fetching the records from AnswerTag corresponding to each TagPromptDeployment based on the filers provided as params.

<code>Use cases:</code>
* <code> When all valid params are passed, the function should populate the answer tags.</code>
* <code> When user_id is provided, answer tags specific to that user should only be populated.</code>
* <code> When questionnaire_id is provided, answer tags specific to that questionnaire should only be populated.</code>
* <code> When assignment_id is provided, answer tags specific to that assignment should only be populated.</code>
* <code> When only one parameter is passed, the corresponding answer tags should be populated.</code>

<code>Edge test cases:</code>
* <code> When user_id is nil, 0 tags prompts should be returned.</code>
* <code> When questionnaire_id is nil, 0 tags prompts should be returned.</code>
* <code> When assignment_id is nil, 0 tags prompts should be returned.</code>

3. create_edit ( params : answer_id, tag_prompt_deployment_id, value )

Description: Fetches the answer tag with the params provided and then updates the respective tag values by the updated values provided as params.

<code>Use cases:</code>
* <code> When the existing tag is found based on the params passed, the existing tag should be updated with new values.</code>

=== Controller: tag_prompt_deployment.rb ===

Existing coverage = 18%

Description:
This Controller is when a user (with instructor privilege) wants to see tagging summary of every user that participated in a tagging assignment.

'''Methods'''

1. tag_prompt
Description: tag_prompt has existing test cases scoring 18 percentage coverage. Additional testing is not required.

2. get_number_of_taggable_answers ( params: user_id)

Description: To calculate total taggable answers reviewed by a user that participated in the given tagging assignment. user_id is the parameter passed to this method. An individual and his team will have the same score. Fig 1: The last column values are processed by this method.

<code>Use cases:</code>
* <code>when user_id is nil expect an error</code>
* <code>when a team has given any response then count of taggable answer > 0</code>
* <code>When a question or a response does not exists then count of taggable answer = 0 (extreme case) </code>
* <code>When answer_length_threshold not set, count taggable answer</code>
* <code>When answer_length_threshold is set, count taggable answer</code>

<code>Edge cases:</code>
* user_id (parameter) is nil
* response is empty
* question is empty

3. assignment_tagging_progress

Description: To compute the number of tagged answers, number of untagged answers, and percentage of answers tagged by the users that participated in the tagging Assignment to a particular question.
Fig 1: First three columns after the 2nd column onwards are updated with results obtained from this method.

<code>Use cases:</code>
* <code>When not team participated in the assignment, assert count(user_answer_tagging) =0</code>
* <code>When the question does not exist, assert count(user_answer_tagging) =0 </code>
* <code>When multiple rounds of review, render ReviewResponseMap and assert response object</code>
* <code>When single round of review, render ResponseMap and assert response object</code>
* <code>When answer_length_threshold is SET, number of answers and when answer_length_threshold is NOT SET, number of answers</code>
* <code>When route is success answer_tagging object structure matching</code>

<code>Edge cases:</code>
* There are no teams associated with the assignment.
* There are no questions in the questionnaire that have the question type specified in the TagPromptDeployment object.
* The assignment is set to vary by round.
* The assignment is set not to vary by round.
* There are multiple tags.
* There are no tags.

== Bug Fixing of Additional Issues ==

===Model: tag_prompt_deployment.rb (method: get_number_of_taggable_answers)===

An additional issue in the method get_number_of_taggable_answers. The error message is as shown below which indicates string concatenation fails between integer and string data types.

''TypeError:''
no implicit conversion of Fixnum into String at line 23 https://github.com/expertiza/expertiza/blob/beta/app/models/tag_prompt_deployment.rb.

[[File:Get_number_of_taggable_answers_bug.JPG]]

This issue is fixed by correcting the syntax of the two-strings concatenation. After fixing the code is

<code> answers = answers.where(conditions: "length(comments) < #{self.answer_length_threshold}" ) unless self.answer_length_threshold.nil? </code>

===Model: tag_prompt_deployment.rb (method: assignment_tagging_progress)===

<pre>
Failure/Error: answers = answers.where("length(comments) > ?", self.answer_length_threshold.to_s) unless self.answer_length_threshold.nil?

NoMethodError:
undefined method `where' for #<Array:0x00000003424b60>
</pre>

This issue was resolved by using <code>Arrays.select</code> to achieve the same functionality.

There was another small error in which the TeamsUser <code>user</code> was not found, and the resolution was to find the User model for each <code>TeamsUser.user_id</code>.

== Results ==
Test cases are added to cover all functionality. With the cases added the coverage has reached to 100%.

Test cases demo can be found at [https://youtu.be/WYSUmL6jcHc OSS Final Project Testing Video]

tag_prompt_deployment.rb: Coverage = 100%

[[File:Tag_prompt_deployment_coverage.jpeg]]

answer_tags_controller.rb: Coverage = 100%

[[File:Answer_tag_controller_coverage.jpeg]]

== Collaborators ==
Nicholas Himes (Mentor)

1. Aditya Khadse

2. Alec Landow

3. Rageeni Sah

4. Sayali Parab

== Relevant Links ==
Main Expertiza repository can be found at [https://github.com/expertiza/expertiza/tree/beta GitHubExp]

Our forked repository can be found at [https://github.com/akk5597/expertiza Github]

== Video Link ==

Test case run and coverage recording [https://www.youtube.com/watch?v=WYSUmL6jcHc]

File:Answer tag controller coverage.jpeg

2021-11-30T02:51:55Z

Rsah: Rsah uploaded a new version of File:Answer tag controller coverage.jpeg

Answer_tag_controller_coverage

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-30T02:48:21Z

Rsah: /* Results */

__TOC__

== Background ==
Answer tagging (see [https://github.com/expertiza/expertiza/blob/25713567e5e5e1c0b363409715e6d8797b45b01a/app/models/answer_tag.rb answer_tab.rb] and [[Answer_tags|wiki]]) helps determine a few metrics on a student’s responses to a questionnaire. Students can tag these metrics for other students for things such as “Positive Tone” or “Suggest Solutions”.

These specs below all need to be further developed to cover missing methods/lines. Some structures currently exist at the top of spec files (such as assignments, participants, etc) to help make writing tests easier. Please feel free to add to these and write extra tests to cover any edge cases you may think of.

As an instructor on an assignment, going to Etc/View Reports/Answer Tagging Report will show student answer tagging. You will be able to see the percentage of answers tagged, # of answers tagged, # not tagged, and # of taggable answers for each student on a questionnaire.

[[File:Tagging_report.png|thumb|center|Fig. 1]]

== Project Purpose==
The objective of the project is unit testing of functionality in these two ruby files and increasing the coverage.

[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec]

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec]

== Initial Coverage ==
[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec] : 0% Covered

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec] : 18% Covered

=== Missed Methods ===
* <code>app/controllers/answer_tags_controller.rb</code>
** <code>action_allowed?</code>
** <code>index</code>
** <code>create_edit</code>
** <code>destroy</code>

* <code>app/models/tag_prompt_deployment.rb</code>
** <code>get_number_of_taggable_answers</code>
** <code>assignment_tagging_progress</code>

== Project Design ==
In this project, we have two controllers to be tested using Rspec Unit testing.

The ER diagram of the parent tables is given below for reference ([https://expertiza.csc.ncsu.edu/index.php/Answer_tags Source: Answer_tags]).

[[File:answer_tags_imported.png]]

The flow diagrams below show how controllers in this project are connected with interrelated classes, methods, and views.

[[File:E2169 answer tags controller.png|900px]]

[[File:E2169 tag prompt deployment.png|900px]]

== Testing Plan ==
=== Controller: answer_tags_controller.rb ===

Existing coverage = 0%

Description:
The purpose of this controller is to track down the total number of tags done by the students. The database structure for the answer_tags can be found here [https://expertiza.csc.ncsu.edu/index.php/Answer_tags]

'''Methods'''

1. action_allowed? ( params: action )

Description: To allow the functionality only if the accessing user is having student privileges (current_user_has_student_privileges?)

<code>Use cases:</code>
* <code>When the session is null, Access should be denied</code>
* <code>When the session is of student type, access should be allowed and operation should be executed.</code>

2. index ( params : assignment_id, questionnaire_id, user_id )

Description: Populates the tags by fetching the records from AnswerTag corresponding to each TagPromptDeployment based on the filers provided as params.

<code>Use cases:</code>
* <code> When all valid params are passed, the function should populate the answer tags.</code>
* <code> When user_id is provided, answer tags specific to that user should only be populated.</code>
* <code> When questionnaire_id is provided, answer tags specific to that questionnaire should only be populated.</code>
* <code> When assignment_id is provided, answer tags specific to that assignment should only be populated.</code>
* <code> When only one parameter is passed, the corresponding answer tags should be populated.</code>

<code>Edge test cases:</code>
* <code> When user_id is nil, 0 tags prompts should be returned.</code>
* <code> When questionnaire_id is nil, 0 tags prompts should be returned.</code>
* <code> When assignment_id is nil, 0 tags prompts should be returned.</code>

3. create_edit ( params : answer_id, tag_prompt_deployment_id, value )

Description: Fetches the answer tag with the params provided and then updates the respective tag values by the updated values provided as params.

<code>Use cases:</code>
* <code> When the existing tag is found based on the params passed, the existing tag should be updated with new values.</code>

=== Controller: tag_prompt_deployment.rb ===

Existing coverage = 18%

Description:
This Controller is when a user (with instructor privilege) wants to see tagging summary of every user that participated in a tagging assignment.

'''Methods'''

1. tag_prompt
Description: tag_prompt has existing test cases scoring 18 percentage coverage. Additional testing is not required.

2. get_number_of_taggable_answers ( params: user_id)

Description: To calculate total taggable answers reviewed by a user that participated in the given tagging assignment. user_id is the parameter passed to this method. An individual and his team will have the same score. Fig 1: The last column values are processed by this method.

<code>Use cases:</code>
* <code>when user_id is nil expect an error</code>
* <code>when a team has given any response then count of taggable answer > 0</code>
* <code>When a question or a response does not exists then count of taggable answer = 0 (extreme case) </code>
* <code>When answer_length_threshold not set, count taggable answer</code>
* <code>When answer_length_threshold is set, count taggable answer</code>

<code>Edge cases:</code>
* user_id (parameter) is nil
* response is empty
* question is empty

3. assignment_tagging_progress

Description: To compute the number of tagged answers, number of untagged answers, and percentage of answers tagged by the users that participated in the tagging Assignment to a particular question.
Fig 1: First three columns after the 2nd column onwards are updated with results obtained from this method.

<code>Use cases:</code>
* <code>When not team participated in the assignment, assert count(user_answer_tagging) =0</code>
* <code>When the question does not exist, assert count(user_answer_tagging) =0 </code>
* <code>When multiple rounds of review, render ReviewResponseMap and assert response object</code>
* <code>When single round of review, render ResponseMap and assert response object</code>
* <code>When answer_length_threshold is SET, number of answers and when answer_length_threshold is NOT SET, number of answers</code>
* <code>When route is success answer_tagging object structure matching</code>

<code>Edge cases:</code>
* There are no teams associated with the assignment.
* There are no questions in the questionnaire that have the question type specified in the TagPromptDeployment object.
* The assignment is set to vary by round.
* The assignment is set not to vary by round.
* There are multiple tags.
* There are no tags.

== Bug Fixing of Additional Issues ==

===Model: tag_prompt_deployment.rb (method: get_number_of_taggable_answers)===

An additional issue in the method get_number_of_taggable_answers. The error message is as shown below which indicates string concatenation fails between integer and string data types.

''TypeError:''
no implicit conversion of Fixnum into String at line 23 https://github.com/expertiza/expertiza/blob/beta/app/models/tag_prompt_deployment.rb.

[[File:Get_number_of_taggable_answers_bug.JPG]]

This issue is fixed by correcting the syntax of the two-strings concatenation. After fixing the code is

<code> answers = answers.where(conditions: "length(comments) < #{self.answer_length_threshold}" ) unless self.answer_length_threshold.nil? </code>

===Model: tag_prompt_deployment.rb (method: assignment_tagging_progress)===

<pre>
Failure/Error: answers = answers.where("length(comments) > ?", self.answer_length_threshold.to_s) unless self.answer_length_threshold.nil?

NoMethodError:
undefined method `where' for #<Array:0x00000003424b60>
</pre>

This issue was resolved by using <code>Arrays.select</code> to achieve the same functionality.

There was another small error in which the TeamsUser <code>user</code> was not found, and the resolution was to find the User model for each <code>TeamsUser.user_id</code>.

== Results ==
Test cases are added to cover all functionality. With the cases added the coverage has reached to 100%.

tag_prompt_deployment.rb: Coverage = 100%

[[File:Tag_prompt_deployment_coverage.jpeg]]

answer_tags_controller.rb: Coverage = 100%

[[File:Answer_tag_controller_coverage.jpeg]]

== Collaborators ==
Nicholas Himes (Mentor)

1. Aditya Khadse

2. Alec Landow

3. Rageeni Sah

4. Sayali Pranab

== Relevant Links ==
Main Expertiza repository can be found at [https://github.com/expertiza/expertiza/tree/beta GitHubExp]

Our forked repository can be found at [https://github.com/akk5597/expertiza Github]

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-30T02:46:51Z

Rsah: /* Results */

__TOC__

== Background ==
Answer tagging (see [https://github.com/expertiza/expertiza/blob/25713567e5e5e1c0b363409715e6d8797b45b01a/app/models/answer_tag.rb answer_tab.rb] and [[Answer_tags|wiki]]) helps determine a few metrics on a student’s responses to a questionnaire. Students can tag these metrics for other students for things such as “Positive Tone” or “Suggest Solutions”.

These specs below all need to be further developed to cover missing methods/lines. Some structures currently exist at the top of spec files (such as assignments, participants, etc) to help make writing tests easier. Please feel free to add to these and write extra tests to cover any edge cases you may think of.

As an instructor on an assignment, going to Etc/View Reports/Answer Tagging Report will show student answer tagging. You will be able to see the percentage of answers tagged, # of answers tagged, # not tagged, and # of taggable answers for each student on a questionnaire.

[[File:Tagging_report.png|thumb|center|Fig. 1]]

== Project Purpose==
The objective of the project is unit testing of functionality in these two ruby files and increasing the coverage.

[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec]

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec]

== Initial Coverage ==
[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec] : 0% Covered

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec] : 18% Covered

=== Missed Methods ===
* <code>app/controllers/answer_tags_controller.rb</code>
** <code>action_allowed?</code>
** <code>index</code>
** <code>create_edit</code>
** <code>destroy</code>

* <code>app/models/tag_prompt_deployment.rb</code>
** <code>get_number_of_taggable_answers</code>
** <code>assignment_tagging_progress</code>

== Project Design ==
In this project, we have two controllers to be tested using Rspec Unit testing.

The ER diagram of the parent tables is given below for reference ([https://expertiza.csc.ncsu.edu/index.php/Answer_tags Source: Answer_tags]).

[[File:answer_tags_imported.png]]

The flow diagrams below show how controllers in this project are connected with interrelated classes, methods, and views.

[[File:E2169 answer tags controller.png|900px]]

[[File:E2169 tag prompt deployment.png|900px]]

== Testing Plan ==
=== Controller: answer_tags_controller.rb ===

Existing coverage = 0%

Description:
The purpose of this controller is to track down the total number of tags done by the students. The database structure for the answer_tags can be found here [https://expertiza.csc.ncsu.edu/index.php/Answer_tags]

'''Methods'''

1. action_allowed? ( params: action )

Description: To allow the functionality only if the accessing user is having student privileges (current_user_has_student_privileges?)

<code>Use cases:</code>
* <code>When the session is null, Access should be denied</code>
* <code>When the session is of student type, access should be allowed and operation should be executed.</code>

2. index ( params : assignment_id, questionnaire_id, user_id )

Description: Populates the tags by fetching the records from AnswerTag corresponding to each TagPromptDeployment based on the filers provided as params.

<code>Use cases:</code>
* <code> When all valid params are passed, the function should populate the answer tags.</code>
* <code> When user_id is provided, answer tags specific to that user should only be populated.</code>
* <code> When questionnaire_id is provided, answer tags specific to that questionnaire should only be populated.</code>
* <code> When assignment_id is provided, answer tags specific to that assignment should only be populated.</code>
* <code> When only one parameter is passed, the corresponding answer tags should be populated.</code>

<code>Edge test cases:</code>
* <code> When user_id is nil, 0 tags prompts should be returned.</code>
* <code> When questionnaire_id is nil, 0 tags prompts should be returned.</code>
* <code> When assignment_id is nil, 0 tags prompts should be returned.</code>

3. create_edit ( params : answer_id, tag_prompt_deployment_id, value )

Description: Fetches the answer tag with the params provided and then updates the respective tag values by the updated values provided as params.

<code>Use cases:</code>
* <code> When the existing tag is found based on the params passed, the existing tag should be updated with new values.</code>

=== Controller: tag_prompt_deployment.rb ===

Existing coverage = 18%

Description:
This Controller is when a user (with instructor privilege) wants to see tagging summary of every user that participated in a tagging assignment.

'''Methods'''

1. tag_prompt
Description: tag_prompt has existing test cases scoring 18 percentage coverage. Additional testing is not required.

2. get_number_of_taggable_answers ( params: user_id)

Description: To calculate total taggable answers reviewed by a user that participated in the given tagging assignment. user_id is the parameter passed to this method. An individual and his team will have the same score. Fig 1: The last column values are processed by this method.

<code>Use cases:</code>
* <code>when user_id is nil expect an error</code>
* <code>when a team has given any response then count of taggable answer > 0</code>
* <code>When a question or a response does not exists then count of taggable answer = 0 (extreme case) </code>
* <code>When answer_length_threshold not set, count taggable answer</code>
* <code>When answer_length_threshold is set, count taggable answer</code>

<code>Edge cases:</code>
* user_id (parameter) is nil
* response is empty
* question is empty

3. assignment_tagging_progress

Description: To compute the number of tagged answers, number of untagged answers, and percentage of answers tagged by the users that participated in the tagging Assignment to a particular question.
Fig 1: First three columns after the 2nd column onwards are updated with results obtained from this method.

<code>Use cases:</code>
* <code>When not team participated in the assignment, assert count(user_answer_tagging) =0</code>
* <code>When the question does not exist, assert count(user_answer_tagging) =0 </code>
* <code>When multiple rounds of review, render ReviewResponseMap and assert response object</code>
* <code>When single round of review, render ResponseMap and assert response object</code>
* <code>When answer_length_threshold is SET, number of answers and when answer_length_threshold is NOT SET, number of answers</code>
* <code>When route is success answer_tagging object structure matching</code>

<code>Edge cases:</code>
* There are no teams associated with the assignment.
* There are no questions in the questionnaire that have the question type specified in the TagPromptDeployment object.
* The assignment is set to vary by round.
* The assignment is set not to vary by round.
* There are multiple tags.
* There are no tags.

== Bug Fixing of Additional Issues ==

===Model: tag_prompt_deployment.rb (method: get_number_of_taggable_answers)===

An additional issue in the method get_number_of_taggable_answers. The error message is as shown below which indicates string concatenation fails between integer and string data types.

''TypeError:''
no implicit conversion of Fixnum into String at line 23 https://github.com/expertiza/expertiza/blob/beta/app/models/tag_prompt_deployment.rb.

[[File:Get_number_of_taggable_answers_bug.JPG]]

This issue is fixed by correcting the syntax of the two-strings concatenation. After fixing the code is

<code> answers = answers.where(conditions: "length(comments) < #{self.answer_length_threshold}" ) unless self.answer_length_threshold.nil? </code>

===Model: tag_prompt_deployment.rb (method: assignment_tagging_progress)===

<pre>
Failure/Error: answers = answers.where("length(comments) > ?", self.answer_length_threshold.to_s) unless self.answer_length_threshold.nil?

NoMethodError:
undefined method `where' for #<Array:0x00000003424b60>
</pre>

This issue was resolved by using <code>Arrays.select</code> to achieve the same functionality.

There was another small error in which the TeamsUser <code>user</code> was not found, and the resolution was to find the User model for each <code>TeamsUser.user_id</code>.

== Results ==
Test cases are added to cover all functionality.

tag_prompt_deployment.rb: Coverage = 100%

[[File:Tag_prompt_deployment_coverage.jpeg]]

answer_tags_controller.rb: Coverage = 100%

[[File:Answer_tag_controller_coverage.jpeg]]

== Collaborators ==
Nicholas Himes (Mentor)

1. Aditya Khadse

2. Alec Landow

3. Rageeni Sah

4. Sayali Pranab

== Relevant Links ==
Main Expertiza repository can be found at [https://github.com/expertiza/expertiza/tree/beta GitHubExp]

Our forked repository can be found at [https://github.com/akk5597/expertiza Github]

File:Answer tag controller coverage.jpeg

2021-11-30T02:44:14Z

Rsah: Answer_tag_controller_coverage

Answer_tag_controller_coverage

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-30T02:42:43Z

Rsah: /* Results */

__TOC__

== Background ==
Answer tagging (see [https://github.com/expertiza/expertiza/blob/25713567e5e5e1c0b363409715e6d8797b45b01a/app/models/answer_tag.rb answer_tab.rb] and [[Answer_tags|wiki]]) helps determine a few metrics on a student’s responses to a questionnaire. Students can tag these metrics for other students for things such as “Positive Tone” or “Suggest Solutions”.

These specs below all need to be further developed to cover missing methods/lines. Some structures currently exist at the top of spec files (such as assignments, participants, etc) to help make writing tests easier. Please feel free to add to these and write extra tests to cover any edge cases you may think of.

As an instructor on an assignment, going to Etc/View Reports/Answer Tagging Report will show student answer tagging. You will be able to see the percentage of answers tagged, # of answers tagged, # not tagged, and # of taggable answers for each student on a questionnaire.

[[File:Tagging_report.png|thumb|center|Fig. 1]]

== Project Purpose==
The objective of the project is unit testing of functionality in these two ruby files and increasing the coverage.

[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec]

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec]

== Initial Coverage ==
[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec] : 0% Covered

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec] : 18% Covered

=== Missed Methods ===
* <code>app/controllers/answer_tags_controller.rb</code>
** <code>action_allowed?</code>
** <code>index</code>
** <code>create_edit</code>
** <code>destroy</code>

* <code>app/models/tag_prompt_deployment.rb</code>
** <code>get_number_of_taggable_answers</code>
** <code>assignment_tagging_progress</code>

== Project Design ==
In this project, we have two controllers to be tested using Rspec Unit testing.

The ER diagram of the parent tables is given below for reference ([https://expertiza.csc.ncsu.edu/index.php/Answer_tags Source: Answer_tags]).

[[File:answer_tags_imported.png]]

The flow diagrams below show how controllers in this project are connected with interrelated classes, methods, and views.

[[File:E2169 answer tags controller.png|900px]]

[[File:E2169 tag prompt deployment.png|900px]]

== Testing Plan ==
=== Controller: answer_tags_controller.rb ===

Existing coverage = 0%

Description:
The purpose of this controller is to track down the total number of tags done by the students. The database structure for the answer_tags can be found here [https://expertiza.csc.ncsu.edu/index.php/Answer_tags]

'''Methods'''

1. action_allowed? ( params: action )

Description: To allow the functionality only if the accessing user is having student privileges (current_user_has_student_privileges?)

<code>Use cases:</code>
* <code>When the session is null, Access should be denied</code>
* <code>When the session is of student type, access should be allowed and operation should be executed.</code>

2. index ( params : assignment_id, questionnaire_id, user_id )

Description: Populates the tags by fetching the records from AnswerTag corresponding to each TagPromptDeployment based on the filers provided as params.

<code>Use cases:</code>
* <code> When all valid params are passed, the function should populate the answer tags.</code>
* <code> When user_id is provided, answer tags specific to that user should only be populated.</code>
* <code> When questionnaire_id is provided, answer tags specific to that questionnaire should only be populated.</code>
* <code> When assignment_id is provided, answer tags specific to that assignment should only be populated.</code>
* <code> When only one parameter is passed, the corresponding answer tags should be populated.</code>

<code>Edge test cases:</code>
* <code> When user_id is nil, 0 tags prompts should be returned.</code>
* <code> When questionnaire_id is nil, 0 tags prompts should be returned.</code>
* <code> When assignment_id is nil, 0 tags prompts should be returned.</code>

3. create_edit ( params : answer_id, tag_prompt_deployment_id, value )

Description: Fetches the answer tag with the params provided and then updates the respective tag values by the updated values provided as params.

<code>Use cases:</code>
* <code> When the existing tag is found based on the params passed, the existing tag should be updated with new values.</code>

=== Controller: tag_prompt_deployment.rb ===

Existing coverage = 18%

Description:
This Controller is when a user (with instructor privilege) wants to see tagging summary of every user that participated in a tagging assignment.

'''Methods'''

1. tag_prompt
Description: tag_prompt has existing test cases scoring 18 percentage coverage. Additional testing is not required.

2. get_number_of_taggable_answers ( params: user_id)

Description: To calculate total taggable answers reviewed by a user that participated in the given tagging assignment. user_id is the parameter passed to this method. An individual and his team will have the same score. Fig 1: The last column values are processed by this method.

<code>Use cases:</code>
* <code>when user_id is nil expect an error</code>
* <code>when a team has given any response then count of taggable answer > 0</code>
* <code>When a question or a response does not exists then count of taggable answer = 0 (extreme case) </code>
* <code>When answer_length_threshold not set, count taggable answer</code>
* <code>When answer_length_threshold is set, count taggable answer</code>

<code>Edge cases:</code>
* user_id (parameter) is nil
* response is empty
* question is empty

3. assignment_tagging_progress

Description: To compute the number of tagged answers, number of untagged answers, and percentage of answers tagged by the users that participated in the tagging Assignment to a particular question.
Fig 1: First three columns after the 2nd column onwards are updated with results obtained from this method.

<code>Use cases:</code>
* <code>When not team participated in the assignment, assert count(user_answer_tagging) =0</code>
* <code>When the question does not exist, assert count(user_answer_tagging) =0 </code>
* <code>When multiple rounds of review, render ReviewResponseMap and assert response object</code>
* <code>When single round of review, render ResponseMap and assert response object</code>
* <code>When answer_length_threshold is SET, number of answers and when answer_length_threshold is NOT SET, number of answers</code>
* <code>When route is success answer_tagging object structure matching</code>

<code>Edge cases:</code>
* There are no teams associated with the assignment.
* There are no questions in the questionnaire that have the question type specified in the TagPromptDeployment object.
* The assignment is set to vary by round.
* The assignment is set not to vary by round.
* There are multiple tags.
* There are no tags.

== Bug Fixing of Additional Issues ==

===Model: tag_prompt_deployment.rb (method: get_number_of_taggable_answers)===

An additional issue in the method get_number_of_taggable_answers. The error message is as shown below which indicates string concatenation fails between integer and string data types.

''TypeError:''
no implicit conversion of Fixnum into String at line 23 https://github.com/expertiza/expertiza/blob/beta/app/models/tag_prompt_deployment.rb.

[[File:Get_number_of_taggable_answers_bug.JPG]]

This issue is fixed by correcting the syntax of the two-strings concatenation. After fixing the code is

<code> answers = answers.where(conditions: "length(comments) < #{self.answer_length_threshold}" ) unless self.answer_length_threshold.nil? </code>

===Model: tag_prompt_deployment.rb (method: assignment_tagging_progress)===

<pre>
Failure/Error: answers = answers.where("length(comments) > ?", self.answer_length_threshold.to_s) unless self.answer_length_threshold.nil?

NoMethodError:
undefined method `where' for #<Array:0x00000003424b60>
</pre>

This issue was resolved by using <code>Arrays.select</code> to achieve the same functionality.

There was another small error in which the TeamsUser <code>user</code> was not found, and the resolution was to find the User model for each <code>TeamsUser.user_id</code>.

== Results ==
Test cases are added to cover all functionality.

tag_prompt_deployment.rb: Coverage = 100%

[[File:Tag_prompt_deployment_coverage.jpeg]]

answer_tags_controller.rb: Coverage = 100%

== Collaborators ==
Nicholas Himes (Mentor)

1. Aditya Khadse

2. Alec Landow

3. Rageeni Sah

4. Sayali Pranab

== Relevant Links ==
Main Expertiza repository can be found at [https://github.com/expertiza/expertiza/tree/beta GitHubExp]

Our forked repository can be found at [https://github.com/akk5597/expertiza Github]

File:Tag prompt deployment coverage.jpeg

2021-11-30T02:41:36Z

Rsah:

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-30T02:36:17Z

Rsah: /* Results */

__TOC__

== Background ==
Answer tagging (see [https://github.com/expertiza/expertiza/blob/25713567e5e5e1c0b363409715e6d8797b45b01a/app/models/answer_tag.rb answer_tab.rb] and [[Answer_tags|wiki]]) helps determine a few metrics on a student’s responses to a questionnaire. Students can tag these metrics for other students for things such as “Positive Tone” or “Suggest Solutions”.

These specs below all need to be further developed to cover missing methods/lines. Some structures currently exist at the top of spec files (such as assignments, participants, etc) to help make writing tests easier. Please feel free to add to these and write extra tests to cover any edge cases you may think of.

As an instructor on an assignment, going to Etc/View Reports/Answer Tagging Report will show student answer tagging. You will be able to see the percentage of answers tagged, # of answers tagged, # not tagged, and # of taggable answers for each student on a questionnaire.

[[File:Tagging_report.png|thumb|center|Fig. 1]]

== Project Purpose==
The objective of the project is unit testing of functionality in these two ruby files and increasing the coverage.

[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec]

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec]

== Initial Coverage ==
[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec] : 0% Covered

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec] : 18% Covered

=== Missed Methods ===
* <code>app/controllers/answer_tags_controller.rb</code>
** <code>action_allowed?</code>
** <code>index</code>
** <code>create_edit</code>
** <code>destroy</code>

* <code>app/models/tag_prompt_deployment.rb</code>
** <code>get_number_of_taggable_answers</code>
** <code>assignment_tagging_progress</code>

== Project Design ==
In this project, we have two controllers to be tested using Rspec Unit testing.

The ER diagram of the parent tables is given below for reference ([https://expertiza.csc.ncsu.edu/index.php/Answer_tags Source: Answer_tags]).

[[File:answer_tags_imported.png]]

The flow diagrams below show how controllers in this project are connected with interrelated classes, methods, and views.

[[File:E2169 answer tags controller.png|900px]]

[[File:E2169 tag prompt deployment.png|900px]]

== Testing Plan ==
=== Controller: answer_tags_controller.rb ===

Existing coverage = 0%

Description:
The purpose of this controller is to track down the total number of tags done by the students. The database structure for the answer_tags can be found here [https://expertiza.csc.ncsu.edu/index.php/Answer_tags]

'''Methods'''

1. action_allowed? ( params: action )

Description: To allow the functionality only if the accessing user is having student privileges (current_user_has_student_privileges?)

<code>Use cases:</code>
* <code>When the session is null, Access should be denied</code>
* <code>When the session is of student type, access should be allowed and operation should be executed.</code>

2. index ( params : assignment_id, questionnaire_id, user_id )

Description: Populates the tags by fetching the records from AnswerTag corresponding to each TagPromptDeployment based on the filers provided as params.

<code>Use cases:</code>
* <code> When all valid params are passed, the function should populate the answer tags.</code>
* <code> When user_id is provided, answer tags specific to that user should only be populated.</code>
* <code> When questionnaire_id is provided, answer tags specific to that questionnaire should only be populated.</code>
* <code> When assignment_id is provided, answer tags specific to that assignment should only be populated.</code>
* <code> When only one parameter is passed, the corresponding answer tags should be populated.</code>

<code>Edge test cases:</code>
* <code> When user_id is nil, 0 tags prompts should be returned.</code>
* <code> When questionnaire_id is nil, 0 tags prompts should be returned.</code>
* <code> When assignment_id is nil, 0 tags prompts should be returned.</code>

3. create_edit ( params : answer_id, tag_prompt_deployment_id, value )

Description: Fetches the answer tag with the params provided and then updates the respective tag values by the updated values provided as params.

<code>Use cases:</code>
* <code> When the existing tag is found based on the params passed, the existing tag should be updated with new values.</code>

=== Controller: tag_prompt_deployment.rb ===

Existing coverage = 18%

Description:
This Controller is when a user (with instructor privilege) wants to see tagging summary of every user that participated in a tagging assignment.

'''Methods'''

1. tag_prompt
Description: tag_prompt has existing test cases scoring 18 percentage coverage. Additional testing is not required.

2. get_number_of_taggable_answers ( params: user_id)

Description: To calculate total taggable answers reviewed by a user that participated in the given tagging assignment. user_id is the parameter passed to this method. An individual and his team will have the same score. Fig 1: The last column values are processed by this method.

<code>Use cases:</code>
* <code>when user_id is nil expect an error</code>
* <code>when a team has given any response then count of taggable answer > 0</code>
* <code>When a question or a response does not exists then count of taggable answer = 0 (extreme case) </code>
* <code>When answer_length_threshold not set, count taggable answer</code>
* <code>When answer_length_threshold is set, count taggable answer</code>

<code>Edge cases:</code>
* user_id (parameter) is nil
* response is empty
* question is empty

3. assignment_tagging_progress

Description: To compute the number of tagged answers, number of untagged answers, and percentage of answers tagged by the users that participated in the tagging Assignment to a particular question.
Fig 1: First three columns after the 2nd column onwards are updated with results obtained from this method.

<code>Use cases:</code>
* <code>When not team participated in the assignment, assert count(user_answer_tagging) =0</code>
* <code>When the question does not exist, assert count(user_answer_tagging) =0 </code>
* <code>When multiple rounds of review, render ReviewResponseMap and assert response object</code>
* <code>When single round of review, render ResponseMap and assert response object</code>
* <code>When answer_length_threshold is SET, number of answers and when answer_length_threshold is NOT SET, number of answers</code>
* <code>When route is success answer_tagging object structure matching</code>

<code>Edge cases:</code>
* There are no teams associated with the assignment.
* There are no questions in the questionnaire that have the question type specified in the TagPromptDeployment object.
* The assignment is set to vary by round.
* The assignment is set not to vary by round.
* There are multiple tags.

== Bug Fixing of Additional Issues ==

===Model: tag_prompt_deployment.rb (method: get_number_of_taggable_answers)===

An additional issue in the method get_number_of_taggable_answers. The error message is as shown below which indicates string concatenation fails between integer and string data types.

''TypeError:''
no implicit conversion of Fixnum into String at line 23 https://github.com/expertiza/expertiza/blob/beta/app/models/tag_prompt_deployment.rb.

[[File:Get_number_of_taggable_answers_bug.JPG]]

This issue is fixed by correcting the syntax of the two-strings concatenation. After fixing the code is

<code> answers = answers.where(conditions: "length(comments) < #{self.answer_length_threshold}" ) unless self.answer_length_threshold.nil? </code>

===Model: tag_prompt_deployment.rb (method: assignment_tagging_progress)===

<pre>
Failure/Error: answers = answers.where("length(comments) > ?", self.answer_length_threshold.to_s) unless self.answer_length_threshold.nil?

NoMethodError:
undefined method `where' for #<Array:0x00000003424b60>
</pre>

This issue was resolved by using <code>Arrays.select</code> to achieve the same functionality.

There was another small error in which the TeamsUser <code>user</code> was not found, and the resolution was to find the User model for each <code>TeamsUser.user_id</code>.

== Results ==
Test cases are added to cover all functionality.

tag_prompt_deployment.rb: Coverage = 100%

answer_tags_controller.rb: Coverage = 100%

== Collaborators ==
Nicholas Himes (Mentor)

1. Aditya Khadse

2. Alec Landow

3. Rageeni Sah

4. Sayali Pranab

== Relevant Links ==
Main Expertiza repository can be found at [https://github.com/expertiza/expertiza/tree/beta GitHubExp]

Our forked repository can be found at [https://github.com/akk5597/expertiza Github]

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-30T02:28:08Z

Rsah: /* Controller: tag_prompt_deployment.rb */

__TOC__

== Background ==
Answer tagging (see [https://github.com/expertiza/expertiza/blob/25713567e5e5e1c0b363409715e6d8797b45b01a/app/models/answer_tag.rb answer_tab.rb] and [[Answer_tags|wiki]]) helps determine a few metrics on a student’s responses to a questionnaire. Students can tag these metrics for other students for things such as “Positive Tone” or “Suggest Solutions”.

These specs below all need to be further developed to cover missing methods/lines. Some structures currently exist at the top of spec files (such as assignments, participants, etc) to help make writing tests easier. Please feel free to add to these and write extra tests to cover any edge cases you may think of.

As an instructor on an assignment, going to Etc/View Reports/Answer Tagging Report will show student answer tagging. You will be able to see the percentage of answers tagged, # of answers tagged, # not tagged, and # of taggable answers for each student on a questionnaire.

[[File:Tagging_report.png|thumb|center|Fig. 1]]

== Project Purpose==
The objective of the project is unit testing of functionality in these two ruby files and increasing the coverage.

[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec]

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec]

== Initial Coverage ==
[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec] : 0% Covered

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec] : 18% Covered

=== Missed Methods ===
* <code>app/controllers/answer_tags_controller.rb</code>
** <code>action_allowed?</code>
** <code>index</code>
** <code>create_edit</code>
** <code>destroy</code>

* <code>app/models/tag_prompt_deployment.rb</code>
** <code>get_number_of_taggable_answers</code>
** <code>assignment_tagging_progress</code>

== Project Design ==
In this project, we have two controllers to be tested using Rspec Unit testing.

The ER diagram of the parent tables is given below for reference ([https://expertiza.csc.ncsu.edu/index.php/Answer_tags Source: Answer_tags]).

[[File:answer_tags_imported.png]]

The flow diagrams below show how controllers in this project are connected with interrelated classes, methods, and views.

[[File:E2169 answer tags controller.png|900px]]

[[File:E2169 tag prompt deployment.png|900px]]

== Testing Plan ==
=== Controller: answer_tags_controller.rb ===

Existing coverage = 0%

Description:
The purpose of this controller is to track down the total number of tags done by the students. The database structure for the answer_tags can be found here [https://expertiza.csc.ncsu.edu/index.php/Answer_tags]

'''Methods'''

1. action_allowed? ( params: action )

Description: To allow the functionality only if the accessing user is having student privileges (current_user_has_student_privileges?)

<code>Use cases:</code>
* <code>When the session is null, Access should be denied</code>
* <code>When the session is of student type, access should be allowed and operation should be executed.</code>

2. index ( params : assignment_id, questionnaire_id, user_id )

Description: Populates the tags by fetching the records from AnswerTag corresponding to each TagPromptDeployment based on the filers provided as params.

<code>Use cases:</code>
* <code> When all valid params are passed, the function should populate the answer tags.</code>
* <code> When user_id is provided, answer tags specific to that user should only be populated.</code>
* <code> When questionnaire_id is provided, answer tags specific to that questionnaire should only be populated.</code>
* <code> When assignment_id is provided, answer tags specific to that assignment should only be populated.</code>
* <code> When only one parameter is passed, the corresponding answer tags should be populated.</code>

<code>Edge test cases:</code>
* <code> When user_id is nil, 0 tags prompts should be returned.</code>
* <code> When questionnaire_id is nil, 0 tags prompts should be returned.</code>
* <code> When assignment_id is nil, 0 tags prompts should be returned.</code>

3. create_edit ( params : answer_id, tag_prompt_deployment_id, value )

Description: Fetches the answer tag with the params provided and then updates the respective tag values by the updated values provided as params.

<code>Use cases:</code>
* <code> When the existing tag is found based on the params passed, the existing tag should be updated with new values.</code>

=== Controller: tag_prompt_deployment.rb ===

Existing coverage = 18%

Description:
This Controller is when a user (with instructor privilege) wants to see tagging summary of every user that participated in a tagging assignment.

'''Methods'''

1. tag_prompt
Description: tag_prompt has existing test cases scoring 18 percentage coverage. Additional testing is not required.

2. get_number_of_taggable_answers ( params: user_id)

Description: To calculate total taggable answers reviewed by a user that participated in the given tagging assignment. user_id is the parameter passed to this method. An individual and his team will have the same score. Fig 1: The last column values are processed by this method.

<code>Use cases:</code>
* <code>when user_id is nil expect an error</code>
* <code>when a team has given any response then count of taggable answer > 0</code>
* <code>When a question or a response does not exists then count of taggable answer = 0 (extreme case) </code>
* <code>When answer_length_threshold not set, count taggable answer</code>
* <code>When answer_length_threshold is set, count taggable answer</code>

<code>Edge cases:</code>
* user_id (parameter) is nil
* response is empty
* question is empty

3. assignment_tagging_progress

Description: To compute the number of tagged answers, number of untagged answers, and percentage of answers tagged by the users that participated in the tagging Assignment to a particular question.
Fig 1: First three columns after the 2nd column onwards are updated with results obtained from this method.

<code>Use cases:</code>
* <code>When not team participated in the assignment, assert count(user_answer_tagging) =0</code>
* <code>When the question does not exist, assert count(user_answer_tagging) =0 </code>
* <code>When multiple rounds of review, render ReviewResponseMap and assert response object</code>
* <code>When single round of review, render ResponseMap and assert response object</code>
* <code>When answer_length_threshold is SET, number of answers and when answer_length_threshold is NOT SET, number of answers</code>
* <code>When route is success answer_tagging object structure matching</code>

<code>Edge cases:</code>
* There are no teams associated with the assignment.
* There are no questions in the questionnaire that have the question type specified in the TagPromptDeployment object.
* The assignment is set to vary by round.
* The assignment is set not to vary by round.
* There are multiple tags.

== Bug Fixing of Additional Issues ==

===Model: tag_prompt_deployment.rb (method: get_number_of_taggable_answers)===

An additional issue in the method get_number_of_taggable_answers. The error message is as shown below which indicates string concatenation fails between integer and string data types.

''TypeError:''
no implicit conversion of Fixnum into String at line 23 https://github.com/expertiza/expertiza/blob/beta/app/models/tag_prompt_deployment.rb.

[[File:Get_number_of_taggable_answers_bug.JPG]]

This issue is fixed by correcting the syntax of the two-strings concatenation. After fixing the code is

<code> answers = answers.where(conditions: "length(comments) < #{self.answer_length_threshold}" ) unless self.answer_length_threshold.nil? </code>

===Model: tag_prompt_deployment.rb (method: assignment_tagging_progress)===

<pre>
Failure/Error: answers = answers.where("length(comments) > ?", self.answer_length_threshold.to_s) unless self.answer_length_threshold.nil?

NoMethodError:
undefined method `where' for #<Array:0x00000003424b60>
</pre>

This issue was resolved by using <code>Arrays.select</code> to achieve the same functionality.

There was another small error in which the TeamsUser <code>user</code> was not found, and the resolution was to find the User model for each <code>TeamsUser.user_id</code>.

== Results ==
Test cases are added to cover all functionality. With test cases the new coverage is as follows:

tag_prompt_deployment.rb: Coverage = 100%

answer_tags_controller.rb: Coverage = 100%

== Collaborators ==
Nicholas Himes (Mentor)

1. Aditya Khadse

2. Alec Landow

3. Rageeni Sah

4. Sayali Pranab

== Relevant Links ==
Main Expertiza repository can be found at [https://github.com/expertiza/expertiza/tree/beta GitHubExp]

Our forked repository can be found at [https://github.com/akk5597/expertiza Github]

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-30T02:24:29Z

Rsah: /* Controller: tag_prompt_deployment.rb */

__TOC__

== Background ==
Answer tagging (see [https://github.com/expertiza/expertiza/blob/25713567e5e5e1c0b363409715e6d8797b45b01a/app/models/answer_tag.rb answer_tab.rb] and [[Answer_tags|wiki]]) helps determine a few metrics on a student’s responses to a questionnaire. Students can tag these metrics for other students for things such as “Positive Tone” or “Suggest Solutions”.

These specs below all need to be further developed to cover missing methods/lines. Some structures currently exist at the top of spec files (such as assignments, participants, etc) to help make writing tests easier. Please feel free to add to these and write extra tests to cover any edge cases you may think of.

As an instructor on an assignment, going to Etc/View Reports/Answer Tagging Report will show student answer tagging. You will be able to see the percentage of answers tagged, # of answers tagged, # not tagged, and # of taggable answers for each student on a questionnaire.

[[File:Tagging_report.png|thumb|center|Fig. 1]]

== Project Purpose==
The objective of the project is unit testing of functionality in these two ruby files and increasing the coverage.

[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec]

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec]

== Initial Coverage ==
[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec] : 0% Covered

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec] : 18% Covered

=== Missed Methods ===
* <code>app/controllers/answer_tags_controller.rb</code>
** <code>action_allowed?</code>
** <code>index</code>
** <code>create_edit</code>
** <code>destroy</code>

* <code>app/models/tag_prompt_deployment.rb</code>
** <code>get_number_of_taggable_answers</code>
** <code>assignment_tagging_progress</code>

== Project Design ==
In this project, we have two controllers to be tested using Rspec Unit testing.

The ER diagram of the parent tables is given below for reference ([https://expertiza.csc.ncsu.edu/index.php/Answer_tags Source: Answer_tags]).

[[File:answer_tags_imported.png]]

The flow diagrams below show how controllers in this project are connected with interrelated classes, methods, and views.

[[File:E2169 answer tags controller.png|900px]]

[[File:E2169 tag prompt deployment.png|900px]]

== Testing Plan ==
=== Controller: answer_tags_controller.rb ===

Existing coverage = 0%

Description:
The purpose of this controller is to track down the total number of tags done by the students. The database structure for the answer_tags can be found here [https://expertiza.csc.ncsu.edu/index.php/Answer_tags]

'''Methods'''

1. action_allowed? ( params: action )

Description: To allow the functionality only if the accessing user is having student privileges (current_user_has_student_privileges?)

<code>Use cases:</code>
* <code>When the session is null, Access should be denied</code>
* <code>When the session is of student type, access should be allowed and operation should be executed.</code>

2. index ( params : assignment_id, questionnaire_id, user_id )

Description: Populates the tags by fetching the records from AnswerTag corresponding to each TagPromptDeployment based on the filers provided as params.

<code>Use cases:</code>
* <code> When all valid params are passed, the function should populate the answer tags.</code>
* <code> When user_id is provided, answer tags specific to that user should only be populated.</code>
* <code> When questionnaire_id is provided, answer tags specific to that questionnaire should only be populated.</code>
* <code> When assignment_id is provided, answer tags specific to that assignment should only be populated.</code>
* <code> When only one parameter is passed, the corresponding answer tags should be populated.</code>

<code>Edge test cases:</code>
* <code> When user_id is nil, 0 tags prompts should be returned.</code>
* <code> When questionnaire_id is nil, 0 tags prompts should be returned.</code>
* <code> When assignment_id is nil, 0 tags prompts should be returned.</code>

3. create_edit ( params : answer_id, tag_prompt_deployment_id, value )

Description: Fetches the answer tag with the params provided and then updates the respective tag values by the updated values provided as params.

<code>Use cases:</code>
* <code> When the existing tag is found based on the params passed, the existing tag should be updated with new values.</code>

=== Controller: tag_prompt_deployment.rb ===

Existing coverage = 18%

Description:
This Controller is when a user (with instructor privilege) wants to see tagging summary of every user that participated in a tagging assignment.

'''Methods'''

1. tag_prompt
Description: tag_prompt has existing test cases scoring 18 percentage coverage. Additional testing is not required.

2. get_number_of_taggable_answers ( params: user_id)

Description: To calculate total taggable answers reviewed by a user that participated in the given tagging assignment. user_id is the parameter passed to this method. An individual and his team will have the same score. Fig 1: The last column values are processed by this method.

<code>Use cases:</code>
* <code>when user_id is nil expect an error</code>
* <code>when a team has given any response then count of taggable answer > 0</code>
* <code>When a question or a response does not exists then count of taggable answer = 0 (extreme case) </code>
* <code>When answer_length_threshold not set, count taggable answer</code>
* <code>When answer_length_threshold is set, count taggable answer</code>

<code>Edge cases:</code>
* user_id (parameter) is nil

3. assignment_tagging_progress

Description: To compute the number of tagged answers, number of untagged answers, and percentage of answers tagged by the users that participated in the tagging Assignment to a particular question.
Fig 1: First three columns after the 2nd column onwards are updated with results obtained from this method.

<code>Use cases:</code>
* <code>When not team participated in the assignment, assert count(user_answer_tagging) =0</code>
* <code>When the question does not exist, assert count(user_answer_tagging) =0 </code>
* <code>When multiple rounds of review, render ReviewResponseMap and assert response object</code>
* <code>When single round of review, render ResponseMap and assert response object</code>
* <code>When answer_length_threshold is SET, number of answers and when answer_length_threshold is NOT SET, number of answers</code>
* <code>When route is success answer_tagging object structure matching</code>

<code>Edge cases:</code>
* There are no teams associated with the assignment.
* There are no questions in the questionnaire that have the question type specified in the TagPromptDeployment object.
* The assignment is set to vary by round.
* The assignment is set not to vary by round.
* There are multiple tags.

== Bug Fixing of Additional Issues ==

===Model: tag_prompt_deployment.rb (method: get_number_of_taggable_answers)===

An additional issue in the method get_number_of_taggable_answers. The error message is as shown below which indicates string concatenation fails between integer and string data types.

''TypeError:''
no implicit conversion of Fixnum into String at line 23 https://github.com/expertiza/expertiza/blob/beta/app/models/tag_prompt_deployment.rb.

[[File:Get_number_of_taggable_answers_bug.JPG]]

This issue is fixed by correcting the syntax of the two-strings concatenation. After fixing the code is

<code> answers = answers.where(conditions: "length(comments) < #{self.answer_length_threshold}" ) unless self.answer_length_threshold.nil? </code>

===Model: tag_prompt_deployment.rb (method: assignment_tagging_progress)===

<pre>
Failure/Error: answers = answers.where("length(comments) > ?", self.answer_length_threshold.to_s) unless self.answer_length_threshold.nil?

NoMethodError:
undefined method `where' for #<Array:0x00000003424b60>
</pre>

This issue was resolved by using <code>Arrays.select</code> to achieve the same functionality.

There was another small error in which the TeamsUser <code>user</code> was not found, and the resolution was to find the User model for each <code>TeamsUser.user_id</code>.

== Results ==
Test cases are added to cover all functionality. With test cases the new coverage is as follows:

tag_prompt_deployment.rb: Coverage = 100%

answer_tags_controller.rb: Coverage = 100%

== Collaborators ==
Nicholas Himes (Mentor)

1. Aditya Khadse

2. Alec Landow

3. Rageeni Sah

4. Sayali Pranab

== Relevant Links ==
Main Expertiza repository can be found at [https://github.com/expertiza/expertiza/tree/beta GitHubExp]

Our forked repository can be found at [https://github.com/akk5597/expertiza Github]

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-30T02:22:03Z

Rsah: /* Controller: tag_prompt_deployment.rb */

__TOC__

== Background ==
Answer tagging (see [https://github.com/expertiza/expertiza/blob/25713567e5e5e1c0b363409715e6d8797b45b01a/app/models/answer_tag.rb answer_tab.rb] and [[Answer_tags|wiki]]) helps determine a few metrics on a student’s responses to a questionnaire. Students can tag these metrics for other students for things such as “Positive Tone” or “Suggest Solutions”.

These specs below all need to be further developed to cover missing methods/lines. Some structures currently exist at the top of spec files (such as assignments, participants, etc) to help make writing tests easier. Please feel free to add to these and write extra tests to cover any edge cases you may think of.

As an instructor on an assignment, going to Etc/View Reports/Answer Tagging Report will show student answer tagging. You will be able to see the percentage of answers tagged, # of answers tagged, # not tagged, and # of taggable answers for each student on a questionnaire.

[[File:Tagging_report.png|thumb|center|Fig. 1]]

== Project Purpose==
The objective of the project is unit testing of functionality in these two ruby files and increasing the coverage.

[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec]

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec]

== Initial Coverage ==
[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec] : 0% Covered

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec] : 18% Covered

=== Missed Methods ===
* <code>app/controllers/answer_tags_controller.rb</code>
** <code>action_allowed?</code>
** <code>index</code>
** <code>create_edit</code>
** <code>destroy</code>

* <code>app/models/tag_prompt_deployment.rb</code>
** <code>get_number_of_taggable_answers</code>
** <code>assignment_tagging_progress</code>

== Project Design ==
In this project, we have two controllers to be tested using Rspec Unit testing.

The ER diagram of the parent tables is given below for reference ([https://expertiza.csc.ncsu.edu/index.php/Answer_tags Source: Answer_tags]).

[[File:answer_tags_imported.png]]

The flow diagrams below show how controllers in this project are connected with interrelated classes, methods, and views.

[[File:E2169 answer tags controller.png|900px]]

[[File:E2169 tag prompt deployment.png|900px]]

== Testing Plan ==
=== Controller: answer_tags_controller.rb ===

Existing coverage = 0%

Description:
The purpose of this controller is to track down the total number of tags done by the students. The database structure for the answer_tags can be found here [https://expertiza.csc.ncsu.edu/index.php/Answer_tags]

'''Methods'''

1. action_allowed? ( params: action )

Description: To allow the functionality only if the accessing user is having student privileges (current_user_has_student_privileges?)

<code>Use cases:</code>
* <code>When the session is null, Access should be denied</code>
* <code>When the session is of student type, access should be allowed and operation should be executed.</code>

2. index ( params : assignment_id, questionnaire_id, user_id )

Description: Populates the tags by fetching the records from AnswerTag corresponding to each TagPromptDeployment based on the filers provided as params.

<code>Use cases:</code>
* <code> When all valid params are passed, the function should populate the answer tags.</code>
* <code> When user_id is provided, answer tags specific to that user should only be populated.</code>
* <code> When questionnaire_id is provided, answer tags specific to that questionnaire should only be populated.</code>
* <code> When assignment_id is provided, answer tags specific to that assignment should only be populated.</code>
* <code> When only one parameter is passed, the corresponding answer tags should be populated.</code>

<code>Edge test cases:</code>
* <code> When user_id is nil, 0 tags prompts should be returned.</code>
* <code> When questionnaire_id is nil, 0 tags prompts should be returned.</code>
* <code> When assignment_id is nil, 0 tags prompts should be returned.</code>

3. create_edit ( params : answer_id, tag_prompt_deployment_id, value )

Description: Fetches the answer tag with the params provided and then updates the respective tag values by the updated values provided as params.

<code>Use cases:</code>
* <code> When the existing tag is found based on the params passed, the existing tag should be updated with new values.</code>

=== Controller: tag_prompt_deployment.rb ===

Existing coverage = 18%

Description:
This Controller is when a user (with instructor privilege) wants to see tagging summary of every user that participated in a tagging assignment.

'''Methods'''

1. tag_prompt
Description: tag_prompt has existing test cases scoring 18 percentage coverage. Additional testing is not required.

2. get_number_of_taggable_answers ( params: user_id)

Description: To calculate total taggable answers reviewed by a user that participated in the given tagging assignment. user_id is the parameter passed to this method. An individual and his team will have the same score. Fig 1: The last column values are processed by this method.

<code>Use cases:</code>
* <code>when user_id is nil expect an error</code>
* <code>when a team has given any response then count of taggable answer > 0</code>
* <code>When a question or a response does not exists then count of taggable answer = 0 (extreme case) </code>
* <code>When answer_length_threshold not set, count taggable answer</code>
* <code>When answer_length_threshold is set, count taggable answer</code>

3. assignment_tagging_progress

Description: To compute the number of tagged answers, number of untagged answers, and percentage of answers tagged by the users that participated in the tagging Assignment to a particular question.
Fig 1: First three columns after the 2nd column onwards are updated with results obtained from this method.

<code>Use cases:</code>
* <code>When not team participated in the assignment, assert count(user_answer_tagging) =0</code>
* <code>When the question does not exist, assert count(user_answer_tagging) =0 </code>
* <code>When multiple rounds of review, render ReviewResponseMap and assert response object</code>
* <code>When single round of review, render ResponseMap and assert response object</code>
* <code>When answer_length_threshold is SET, number of answers and when answer_length_threshold is NOT SET, number of answers</code>
* <code>When route is success answer_tagging object structure matching</code>

<code>Edge cases:</code>
* There are no teams associated with the assignment.
* There are no questions in the questionnaire that have the question type specified in the TagPromptDeployment object.
* The assignment is set to vary by round.
* The assignment is set not to vary by round.
* There are multiple tags.

== Bug Fixing of Additional Issues ==

===Model: tag_prompt_deployment.rb (method: get_number_of_taggable_answers)===

An additional issue in the method get_number_of_taggable_answers. The error message is as shown below which indicates string concatenation fails between integer and string data types.

''TypeError:''
no implicit conversion of Fixnum into String at line 23 https://github.com/expertiza/expertiza/blob/beta/app/models/tag_prompt_deployment.rb.

[[File:Get_number_of_taggable_answers_bug.JPG]]

This issue is fixed by correcting the syntax of the two-strings concatenation. After fixing the code is

<code> answers = answers.where(conditions: "length(comments) < #{self.answer_length_threshold}" ) unless self.answer_length_threshold.nil? </code>

===Model: tag_prompt_deployment.rb (method: assignment_tagging_progress)===

<pre>
Failure/Error: answers = answers.where("length(comments) > ?", self.answer_length_threshold.to_s) unless self.answer_length_threshold.nil?

NoMethodError:
undefined method `where' for #<Array:0x00000003424b60>
</pre>

This issue was resolved by using <code>Arrays.select</code> to achieve the same functionality.

There was another small error in which the TeamsUser <code>user</code> was not found, and the resolution was to find the User model for each <code>TeamsUser.user_id</code>.

== Results ==
Test cases are added to cover all functionality. With test cases the new coverage is as follows:

tag_prompt_deployment.rb: Coverage = 99%

answer_tags_controller.rb: Coverage = 100%

== Collaborators ==
Nicholas Himes (Mentor)

1. Aditya Khadse

2. Alec Landow

3. Rageeni Sah

4. Sayali Pranab

== Relevant Links ==
Main Expertiza repository can be found at [https://github.com/expertiza/expertiza/tree/beta GitHubExp]

Our forked repository can be found at [https://github.com/akk5597/expertiza Github]

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-30T02:21:41Z

Rsah: /* Controller: tag_prompt_deployment.rb */

__TOC__

== Background ==
Answer tagging (see [https://github.com/expertiza/expertiza/blob/25713567e5e5e1c0b363409715e6d8797b45b01a/app/models/answer_tag.rb answer_tab.rb] and [[Answer_tags|wiki]]) helps determine a few metrics on a student’s responses to a questionnaire. Students can tag these metrics for other students for things such as “Positive Tone” or “Suggest Solutions”.

These specs below all need to be further developed to cover missing methods/lines. Some structures currently exist at the top of spec files (such as assignments, participants, etc) to help make writing tests easier. Please feel free to add to these and write extra tests to cover any edge cases you may think of.

As an instructor on an assignment, going to Etc/View Reports/Answer Tagging Report will show student answer tagging. You will be able to see the percentage of answers tagged, # of answers tagged, # not tagged, and # of taggable answers for each student on a questionnaire.

[[File:Tagging_report.png|thumb|center|Fig. 1]]

== Project Purpose==
The objective of the project is unit testing of functionality in these two ruby files and increasing the coverage.

[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec]

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec]

== Initial Coverage ==
[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec] : 0% Covered

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec] : 18% Covered

=== Missed Methods ===
* <code>app/controllers/answer_tags_controller.rb</code>
** <code>action_allowed?</code>
** <code>index</code>
** <code>create_edit</code>
** <code>destroy</code>

* <code>app/models/tag_prompt_deployment.rb</code>
** <code>get_number_of_taggable_answers</code>
** <code>assignment_tagging_progress</code>

== Project Design ==
In this project, we have two controllers to be tested using Rspec Unit testing.

The ER diagram of the parent tables is given below for reference ([https://expertiza.csc.ncsu.edu/index.php/Answer_tags Source: Answer_tags]).

[[File:answer_tags_imported.png]]

The flow diagrams below show how controllers in this project are connected with interrelated classes, methods, and views.

[[File:E2169 answer tags controller.png|900px]]

[[File:E2169 tag prompt deployment.png|900px]]

== Testing Plan ==
=== Controller: answer_tags_controller.rb ===

Existing coverage = 0%

Description:
The purpose of this controller is to track down the total number of tags done by the students. The database structure for the answer_tags can be found here [https://expertiza.csc.ncsu.edu/index.php/Answer_tags]

'''Methods'''

1. action_allowed? ( params: action )

Description: To allow the functionality only if the accessing user is having student privileges (current_user_has_student_privileges?)

<code>Use cases:</code>
* <code>When the session is null, Access should be denied</code>
* <code>When the session is of student type, access should be allowed and operation should be executed.</code>

2. index ( params : assignment_id, questionnaire_id, user_id )

Description: Populates the tags by fetching the records from AnswerTag corresponding to each TagPromptDeployment based on the filers provided as params.

<code>Use cases:</code>
* <code> When all valid params are passed, the function should populate the answer tags.</code>
* <code> When user_id is provided, answer tags specific to that user should only be populated.</code>
* <code> When questionnaire_id is provided, answer tags specific to that questionnaire should only be populated.</code>
* <code> When assignment_id is provided, answer tags specific to that assignment should only be populated.</code>
* <code> When only one parameter is passed, the corresponding answer tags should be populated.</code>

<code>Edge test cases:</code>
* <code> When user_id is nil, 0 tags prompts should be returned.</code>
* <code> When questionnaire_id is nil, 0 tags prompts should be returned.</code>
* <code> When assignment_id is nil, 0 tags prompts should be returned.</code>

3. create_edit ( params : answer_id, tag_prompt_deployment_id, value )

Description: Fetches the answer tag with the params provided and then updates the respective tag values by the updated values provided as params.

<code>Use cases:</code>
* <code> When the existing tag is found based on the params passed, the existing tag should be updated with new values.</code>

=== Controller: tag_prompt_deployment.rb ===

Existing coverage = 18%

Description:
This Controller is when a user (with instructor privilege) wants to see tagging summary of every user that participated in a tagging assignment.

'''Methods'''

1. tag_prompt
Description: tag_prompt has existing test cases scoring 18 percentage coverage. Additional testing is not required.

2. get_number_of_taggable_answers ( params: user_id)

Description: To calculate total taggable answers reviewed by a user that participated in the given tagging assignment. user_id is the parameter passed to this method. An individual and his team will have the same score. Fig 1: The last column values are processed by this method.

<code>Use cases:</code>
* <code>when user_id is nil expect an error> 0</code>
* <code>when a team has given any response then count of taggable answer > 0</code>
* <code>When a question or a response does not exists then count of taggable answer = 0 (extreme case) </code>
* <code>When answer_length_threshold not set, count taggable answer</code>
* <code>When answer_length_threshold is set, count taggable answer</code>

3. assignment_tagging_progress

Description: To compute the number of tagged answers, number of untagged answers, and percentage of answers tagged by the users that participated in the tagging Assignment to a particular question.
Fig 1: First three columns after the 2nd column onwards are updated with results obtained from this method.

<code>Use cases:</code>
* <code>When not team participated in the assignment, assert count(user_answer_tagging) =0</code>
* <code>When the question does not exist, assert count(user_answer_tagging) =0 </code>
* <code>When multiple rounds of review, render ReviewResponseMap and assert response object</code>
* <code>When single round of review, render ResponseMap and assert response object</code>
* <code>When answer_length_threshold is SET, number of answers and when answer_length_threshold is NOT SET, number of answers</code>
* <code>When route is success answer_tagging object structure matching</code>

<code>Edge cases:</code>
* There are no teams associated with the assignment.
* There are no questions in the questionnaire that have the question type specified in the TagPromptDeployment object.
* The assignment is set to vary by round.
* The assignment is set not to vary by round.
* There are multiple tags.

== Bug Fixing of Additional Issues ==

===Model: tag_prompt_deployment.rb (method: get_number_of_taggable_answers)===

An additional issue in the method get_number_of_taggable_answers. The error message is as shown below which indicates string concatenation fails between integer and string data types.

''TypeError:''
no implicit conversion of Fixnum into String at line 23 https://github.com/expertiza/expertiza/blob/beta/app/models/tag_prompt_deployment.rb.

[[File:Get_number_of_taggable_answers_bug.JPG]]

This issue is fixed by correcting the syntax of the two-strings concatenation. After fixing the code is

<code> answers = answers.where(conditions: "length(comments) < #{self.answer_length_threshold}" ) unless self.answer_length_threshold.nil? </code>

===Model: tag_prompt_deployment.rb (method: assignment_tagging_progress)===

<pre>
Failure/Error: answers = answers.where("length(comments) > ?", self.answer_length_threshold.to_s) unless self.answer_length_threshold.nil?

NoMethodError:
undefined method `where' for #<Array:0x00000003424b60>
</pre>

This issue was resolved by using <code>Arrays.select</code> to achieve the same functionality.

There was another small error in which the TeamsUser <code>user</code> was not found, and the resolution was to find the User model for each <code>TeamsUser.user_id</code>.

== Results ==
Test cases are added to cover all functionality. With test cases the new coverage is as follows:

tag_prompt_deployment.rb: Coverage = 99%

answer_tags_controller.rb: Coverage = 100%

== Collaborators ==
Nicholas Himes (Mentor)

1. Aditya Khadse

2. Alec Landow

3. Rageeni Sah

4. Sayali Pranab

== Relevant Links ==
Main Expertiza repository can be found at [https://github.com/expertiza/expertiza/tree/beta GitHubExp]

Our forked repository can be found at [https://github.com/akk5597/expertiza Github]

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-29T13:21:18Z

Rsah: /* Collaborators */

__TOC__

== Background ==
Answer tagging (see [https://github.com/expertiza/expertiza/blob/25713567e5e5e1c0b363409715e6d8797b45b01a/app/models/answer_tag.rb answer_tab.rb] and [[Answer_tags|wiki]]) helps determine a few metrics on a student’s responses to a questionnaire. Students can tag these metrics for other students for things such as “Positive Tone” or “Suggest Solutions”.

These specs below all need to be further developed to cover missing methods/lines. Some structures currently exist at the top of spec files (such as assignments, participants, etc) to help make writing tests easier. Please feel free to add to these and write extra tests to cover any edge cases you may think of.

As an instructor on an assignment, going to Etc/View Reports/Answer Tagging Report will show student answer tagging. You will be able to see the percentage of answers tagged, # of answers tagged, # not tagged, and # of taggable answers for each student on a questionnaire.

[[File:Tagging_report.png|thumb|center|Fig. 1]]

== Project Purpose==
The objective of the project is unit testing of functionality in these two ruby files and increasing the coverage.

[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec]

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec]

== Initial Coverage ==
[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec] : 0% Covered

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec] : 18% Covered

=== Missed Methods ===
* <code>app/controllers/answer_tags_controller.rb</code>
** <code>action_allowed?</code>
** <code>index</code>
** <code>create_edit</code>
** <code>destroy</code>

* <code>app/models/tag_prompt_deployment.rb</code>
** <code>get_number_of_taggable_answers</code>
** <code>assignment_tagging_progress</code>

== Project Design ==
In this project, we have two controllers to be tested using Rspec Unit testing.

The ER diagram of the parent tables is given below for reference ([https://expertiza.csc.ncsu.edu/index.php/Answer_tags Source: Answer_tags]).

[[File:answer_tags_imported.png]]

The flow diagrams below show how controllers in this project are connected with interrelated classes, methods, and views.

[[File:E2169 answer tags controller.png|900px]]

[[File:E2169 tag prompt deployment.png|900px]]

== Testing Plan ==
=== Controller: answer_tags_controller.rb ===

Existing coverage = 0%

Description:
The purpose of this controller is to track down the total number of tags done by the students. The database structure for the answer_tags can be found here [https://expertiza.csc.ncsu.edu/index.php/Answer_tags]

'''Methods'''

1. action_allowed? ( params: action )

Description: To allow the functionality only if the accessing user is having student privileges (current_user_has_student_privileges?)

<code>Use cases:</code>
* <code>When the session is null, Access should be denied</code>
* <code>When the session is of student type, access should be allowed and operation should be executed.</code>

2. index ( params : assignment_id, questionnaire_id, user_id )

Description: Populates the tags by fetching the records from AnswerTag corresponding to each TagPromptDeployment based on the filers provided as params.

<code>Use cases:</code>
* <code> When the params for fetching TagPromptDeployment are null, 0 tags prompts should be returned.</code>
* <code> When all valid params are passed, the function should populate the tag prompts.</code>
* <code> When user_id is provided, tag prompts specific to that user should only be populated.</code>

3. create_edit ( params : answer_id, tag_prompt_deployment_id, value )

Description: Fetches the answer tag with the params provided and then updates the respective tag values by the updated values provided as params.

<code>Use cases:</code>
* <code> When the existing tag is found based on the params passed, the existing tag should be updated with new values.</code>

=== Controller: tag_prompt_deployment.rb ===

Existing coverage = 18%

Description:
This Controller is when a user (with instructor privilege) wants to see tagging summary of every user that participated in a tagging assignment.

'''Methods'''

1. tag_prompt
Description: tag_prompt has existing test cases scoring 18 percentage coverage. Additional testing is not required.

2. get_number_of_taggable_answers ( params: user_id)

Description: To calculate total taggable answers reviewed by a user that participated in the given tagging assignment. user_id is the parameter passed to this method. An individual and his team will have the same score. Fig 1: The last column values are processed by this method.

<code>Use cases:</code>
* <code>when a team has given any response then count of taggable answer > 0</code>
* <code>When a question or a response does not exists then count of taggable answer = 0 (extreme case) </code>
* <code>When answer_length_threshold not set, count taggable answer</code>
* <code>When answer_length_threshold is set, count taggable answer</code>

3. assignment_tagging_progress

Description: To compute the number of tagged answers, number of untagged answers, and percentage of answers tagged by the users that participated in the tagging Assignment to a particular question.
Fig 1: First three columns after the 2nd column onwards are updated with results obtained from this method.

<code>Use cases:</code>
* <code>When not team participated in the assignment, assert count(user_answer_tagging) =0</code>
* <code>When the question does not exist, assert count(user_answer_tagging) =0 </code>
* <code>When multiple rounds of review, render ReviewResponseMap and assert response object</code>
* <code>When single round of review, render ResponseMap and assert response object</code>
* <code>When answer_length_threshold is SET, number of answers and when answer_length_threshold is NOT SET, number of answers</code>
* <code>When route is success answer_tagging object structure matching</code>

== Bug Fixing of Additional Issues ==

===Model: tag_prompt_deployment.rb (method: get_number_of_taggable_answers)===

An additional issue in the method get_number_of_taggable_answers. The error message is as shown below which indicates string concatenation fails between integer and string data types.

''TypeError:''
no implicit conversion of Fixnum into String at line 23 https://github.com/expertiza/expertiza/blob/beta/app/models/tag_prompt_deployment.rb.

[[File:Get_number_of_taggable_answers_bug.JPG]]

This issue is fixed by correcting the syntax of the two-strings concatenation. After fixing the code is

<code> answers = answers.where(conditions: "length(comments) < #{self.answer_length_threshold}" ) unless self.answer_length_threshold.nil? </code>

===Model: tag_prompt_deployment.rb (method: assignment_tagging_progress)===

<pre>
Failure/Error: answers = answers.where("length(comments) > ?", self.answer_length_threshold.to_s) unless self.answer_length_threshold.nil?

NoMethodError:
undefined method `where' for #<Array:0x00000003424b60>
</pre>

This issue was resolved by using <code>Arrays.select</code> to achieve the same functionality.

There was another small error in which the TeamsUser <code>user</code> was not found, and the resolution was to find the User model for each <code>TeamsUser.user_id</code>.
A similar issue was found with TeamsUser

== Results ==
Test cases are added to cover all functionality. With test cases the new coverage is as follows:

tag_prompt_deployment.rb: Coverage = 99%

answer_tags_controller.rb: Coverage = 100%

Edge cases that are considered in the project are:

-
-
-

== Collaborators ==
Nicholas Himes (Mentor)

1. Aditya Khadse

2. Alec Landow

3. Rageeni Sah

4. Sayali Pranab

== Relevant Links ==
Main Expertiza repository can be found at [https://github.com/expertiza/expertiza/tree/beta GitHubExp]

Our forked repository can be found at [https://github.com/akk5597/expertiza Github]

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-29T13:16:02Z

Rsah: /* Controller: tag_prompt_deployment.rb */

__TOC__

== Background ==
Answer tagging (see [https://github.com/expertiza/expertiza/blob/25713567e5e5e1c0b363409715e6d8797b45b01a/app/models/answer_tag.rb answer_tab.rb] and [[Answer_tags|wiki]]) helps determine a few metrics on a student’s responses to a questionnaire. Students can tag these metrics for other students for things such as “Positive Tone” or “Suggest Solutions”.

These specs below all need to be further developed to cover missing methods/lines. Some structures currently exist at the top of spec files (such as assignments, participants, etc) to help make writing tests easier. Please feel free to add to these and write extra tests to cover any edge cases you may think of.

As an instructor on an assignment, going to Etc/View Reports/Answer Tagging Report will show student answer tagging. You will be able to see the percentage of answers tagged, # of answers tagged, # not tagged, and # of taggable answers for each student on a questionnaire.

[[File:Tagging_report.png|thumb|center|Fig. 1]]

== Project Purpose==
The objective of the project is unit testing of functionality in these two ruby files and increasing the coverage.

[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec]

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec]

== Initial Coverage ==
[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec] : 0% Covered

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec] : 18% Covered

=== Missed Methods ===
* <code>app/controllers/answer_tags_controller.rb</code>
** <code>action_allowed?</code>
** <code>index</code>
** <code>create_edit</code>
** <code>destroy</code>

* <code>app/models/tag_prompt_deployment.rb</code>
** <code>get_number_of_taggable_answers</code>
** <code>assignment_tagging_progress</code>

== Project Design ==
In this project, we have two controllers to be tested using Rspec Unit testing.

The ER diagram of the parent tables is given below for reference ([https://expertiza.csc.ncsu.edu/index.php/Answer_tags Source: Answer_tags]).

[[File:answer_tags_imported.png]]

The flow diagrams below show how controllers in this project are connected with interrelated classes, methods, and views.

[[File:E2169 answer tags controller.png|900px]]

[[File:E2169 tag prompt deployment.png|900px]]

== Testing Plan ==
=== Controller: answer_tags_controller.rb ===

Existing coverage = 0%

Description:
The purpose of this controller is to track down the total number of tags done by the students. The database structure for the answer_tags can be found here [https://expertiza.csc.ncsu.edu/index.php/Answer_tags]

'''Methods'''

1. action_allowed? ( params: action )

Description: To allow the functionality only if the accessing user is having student privileges (current_user_has_student_privileges?)

<code>Use cases:</code>
* <code>When the session is null, Access should be denied</code>
* <code>When the session is of student type, access should be allowed and operation should be executed.</code>

2. index ( params : assignment_id, questionnaire_id, user_id )

Description: Populates the tags by fetching the records from AnswerTag corresponding to each TagPromptDeployment based on the filers provided as params.

<code>Use cases:</code>
* <code> When the params for fetching TagPromptDeployment are null, 0 tags prompts should be returned.</code>
* <code> When all valid params are passed, the function should populate the tag prompts.</code>
* <code> When user_id is provided, tag prompts specific to that user should only be populated.</code>

3. create_edit ( params : answer_id, tag_prompt_deployment_id, value )

Description: Fetches the answer tag with the params provided and then updates the respective tag values by the updated values provided as params.

<code>Use cases:</code>
* <code> When the existing tag is found based on the params passed, the existing tag should be updated with new values.</code>

=== Controller: tag_prompt_deployment.rb ===

Existing coverage = 18%

Description:
This Controller is when a user (with instructor privilege) wants to see tagging summary of every user that participated in a tagging assignment.

'''Methods'''

1. tag_prompt
Description: tag_prompt has existing test cases scoring 18 percentage coverage. Additional testing is not required.

2. get_number_of_taggable_answers ( params: user_id)

Description: To calculate total taggable answers reviewed by a user that participated in the given tagging assignment. user_id is the parameter passed to this method. An individual and his team will have the same score. Fig 1: The last column values are processed by this method.

<code>Use cases:</code>
* <code>when a team has given any response then count of taggable answer > 0</code>
* <code>When a question or a response does not exists then count of taggable answer = 0 (extreme case) </code>
* <code>When answer_length_threshold not set, count taggable answer</code>
* <code>When answer_length_threshold is set, count taggable answer</code>

3. assignment_tagging_progress

Description: To compute the number of tagged answers, number of untagged answers, and percentage of answers tagged by the users that participated in the tagging Assignment to a particular question.
Fig 1: First three columns after the 2nd column onwards are updated with results obtained from this method.

<code>Use cases:</code>
* <code>When not team participated in the assignment, assert count(user_answer_tagging) =0</code>
* <code>When the question does not exist, assert count(user_answer_tagging) =0 </code>
* <code>When multiple rounds of review, render ReviewResponseMap and assert response object</code>
* <code>When single round of review, render ResponseMap and assert response object</code>
* <code>When answer_length_threshold is SET, number of answers and when answer_length_threshold is NOT SET, number of answers</code>
* <code>When route is success answer_tagging object structure matching</code>

== Bug Fixing of Additional Issues ==

===Model: tag_prompt_deployment.rb (method: get_number_of_taggable_answers)===

An additional issue in the method get_number_of_taggable_answers. The error message is as shown below which indicates string concatenation fails between integer and string data types.

''TypeError:''
no implicit conversion of Fixnum into String at line 23 https://github.com/expertiza/expertiza/blob/beta/app/models/tag_prompt_deployment.rb.

[[File:Get_number_of_taggable_answers_bug.JPG]]

This issue is fixed by correcting the syntax of the two-strings concatenation. After fixing the code is

<code> answers = answers.where(conditions: "length(comments) < #{self.answer_length_threshold}" ) unless self.answer_length_threshold.nil? </code>

===Model: tag_prompt_deployment.rb (method: assignment_tagging_progress)===

<pre>
Failure/Error: answers = answers.where("length(comments) > ?", self.answer_length_threshold.to_s) unless self.answer_length_threshold.nil?

NoMethodError:
undefined method `where' for #<Array:0x00000003424b60>
</pre>

This issue was resolved by using <code>Arrays.select</code> to achieve the same functionality.

There was another small error in which the TeamsUser <code>user</code> was not found, and the resolution was to find the User model for each <code>TeamsUser.user_id</code>.
A similar issue was found with TeamsUser

== Collaborators ==
Nicholas Himes (Mentor)

1. Aditya Khadse

2. Alec Landow

3. Rageeni Sah

4. Sayali Pranab

== Relevant Links ==
Main Expertiza repository can be found at [https://github.com/expertiza/expertiza/tree/beta GitHubExp]

Our forked repository can be found at [https://github.com/akk5597/expertiza Github]

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-29T13:15:10Z

Rsah: /* Controller: tag_prompt_deployment.rb */

__TOC__

== Background ==
Answer tagging (see [https://github.com/expertiza/expertiza/blob/25713567e5e5e1c0b363409715e6d8797b45b01a/app/models/answer_tag.rb answer_tab.rb] and [[Answer_tags|wiki]]) helps determine a few metrics on a student’s responses to a questionnaire. Students can tag these metrics for other students for things such as “Positive Tone” or “Suggest Solutions”.

These specs below all need to be further developed to cover missing methods/lines. Some structures currently exist at the top of spec files (such as assignments, participants, etc) to help make writing tests easier. Please feel free to add to these and write extra tests to cover any edge cases you may think of.

As an instructor on an assignment, going to Etc/View Reports/Answer Tagging Report will show student answer tagging. You will be able to see the percentage of answers tagged, # of answers tagged, # not tagged, and # of taggable answers for each student on a questionnaire.

[[File:Tagging_report.png|thumb|center|Fig. 1]]

== Project Purpose==
The objective of the project is unit testing of functionality in these two ruby files and increasing the coverage.

[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec]

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec]

== Initial Coverage ==
[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec] : 0% Covered

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec] : 18% Covered

=== Missed Methods ===
* <code>app/controllers/answer_tags_controller.rb</code>
** <code>action_allowed?</code>
** <code>index</code>
** <code>create_edit</code>
** <code>destroy</code>

* <code>app/models/tag_prompt_deployment.rb</code>
** <code>get_number_of_taggable_answers</code>
** <code>assignment_tagging_progress</code>

== Project Design ==
In this project, we have two controllers to be tested using Rspec Unit testing.

The ER diagram of the parent tables is given below for reference ([https://expertiza.csc.ncsu.edu/index.php/Answer_tags Source: Answer_tags]).

[[File:answer_tags_imported.png]]

The flow diagrams below show how controllers in this project are connected with interrelated classes, methods, and views.

[[File:E2169 answer tags controller.png|900px]]

[[File:E2169 tag prompt deployment.png|900px]]

== Testing Plan ==
=== Controller: answer_tags_controller.rb ===

Existing coverage = 0%

Description:
The purpose of this controller is to track down the total number of tags done by the students. The database structure for the answer_tags can be found here [https://expertiza.csc.ncsu.edu/index.php/Answer_tags]

'''Methods'''

1. action_allowed? ( params: action )

Description: To allow the functionality only if the accessing user is having student privileges (current_user_has_student_privileges?)

<code>Use cases:</code>
* <code>When the session is null, Access should be denied</code>
* <code>When the session is of student type, access should be allowed and operation should be executed.</code>

2. index ( params : assignment_id, questionnaire_id, user_id )

Description: Populates the tags by fetching the records from AnswerTag corresponding to each TagPromptDeployment based on the filers provided as params.

<code>Use cases:</code>
* <code> When the params for fetching TagPromptDeployment are null, 0 tags prompts should be returned.</code>
* <code> When all valid params are passed, the function should populate the tag prompts.</code>
* <code> When user_id is provided, tag prompts specific to that user should only be populated.</code>

3. create_edit ( params : answer_id, tag_prompt_deployment_id, value )

Description: Fetches the answer tag with the params provided and then updates the respective tag values by the updated values provided as params.

<code>Use cases:</code>
* <code> When the existing tag is found based on the params passed, the existing tag should be updated with new values.</code>

=== Controller: tag_prompt_deployment.rb ===

Before change coverage = 18%

After change coverage = 99%

Description:
This Controller is when a user (with instructor privilege) wants to see tagging summary of every user that participated in a tagging assignment.

'''Methods'''

1. tag_prompt
Description: tag_prompt has existing test cases scoring 18 percentage coverage. Additional testing is not required.

2. get_number_of_taggable_answers ( params: user_id)

Description: To calculate total taggable answers reviewed by a user that participated in the given tagging assignment. user_id is the parameter passed to this method. An individual and his team will have the same score. Fig 1: The last column values are processed by this method.

<code>Use cases:</code>
* <code>when a team has given any response then count of taggable answer > 0</code>
* <code>When a question or a response does not exists then count of taggable answer = 0 (extreme case) </code>
* <code>When answer_length_threshold not set, count taggable answer</code>
* <code>When answer_length_threshold is set, count taggable answer</code>

3. assignment_tagging_progress

Description: To compute the number of tagged answers, number of untagged answers, and percentage of answers tagged by the users that participated in the tagging Assignment to a particular question.
Fig 1: First three columns after the 2nd column onwards are updated with results obtained from this method.

<code>Use cases:</code>
* <code>When not team participated in the assignment, assert count(user_answer_tagging) =0</code>
* <code>When the question does not exist, assert count(user_answer_tagging) =0 </code>
* <code>When multiple rounds of review, render ReviewResponseMap and assert response object</code>
* <code>When single round of review, render ResponseMap and assert response object</code>
* <code>When answer_length_threshold is SET, number of answers and when answer_length_threshold is NOT SET, number of answers</code>
* <code>When route is success answer_tagging object structure matching</code>

== Bug Fixing of Additional Issues ==

===Model: tag_prompt_deployment.rb (method: get_number_of_taggable_answers)===

An additional issue in the method get_number_of_taggable_answers. The error message is as shown below which indicates string concatenation fails between integer and string data types.

''TypeError:''
no implicit conversion of Fixnum into String at line 23 https://github.com/expertiza/expertiza/blob/beta/app/models/tag_prompt_deployment.rb.

[[File:Get_number_of_taggable_answers_bug.JPG]]

This issue is fixed by correcting the syntax of the two-strings concatenation. After fixing the code is

<code> answers = answers.where(conditions: "length(comments) < #{self.answer_length_threshold}" ) unless self.answer_length_threshold.nil? </code>

===Model: tag_prompt_deployment.rb (method: assignment_tagging_progress)===

<pre>
Failure/Error: answers = answers.where("length(comments) > ?", self.answer_length_threshold.to_s) unless self.answer_length_threshold.nil?

NoMethodError:
undefined method `where' for #<Array:0x00000003424b60>
</pre>

This issue was resolved by using <code>Arrays.select</code> to achieve the same functionality.

There was another small error in which the TeamsUser <code>user</code> was not found, and the resolution was to find the User model for each <code>TeamsUser.user_id</code>.
A similar issue was found with TeamsUser

== Collaborators ==
Nicholas Himes (Mentor)

1. Aditya Khadse

2. Alec Landow

3. Rageeni Sah

4. Sayali Pranab

== Relevant Links ==
Main Expertiza repository can be found at [https://github.com/expertiza/expertiza/tree/beta GitHubExp]

Our forked repository can be found at [https://github.com/akk5597/expertiza Github]

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-28T05:23:08Z

Rsah: /* Controller: tag_prompt_deployment.rb */

__TOC__

== Background ==
Answer tagging (see [https://github.com/expertiza/expertiza/blob/25713567e5e5e1c0b363409715e6d8797b45b01a/app/models/answer_tag.rb answer_tab.rb] and [[Answer_tags|wiki]]) helps determine a few metrics on a student’s responses to a questionnaire. Students can tag these metrics for other students for things such as “Positive Tone” or “Suggest Solutions”.

These specs below all need to be further developed to cover missing methods/lines. Some structures currently exist at the top of spec files (such as assignments, participants, etc) to help make writing tests easier. Please feel free to add to these and write extra tests to cover any edge cases you may think of.

As an instructor on an assignment, going to Etc/View Reports/Answer Tagging Report will show student answer tagging. You will be able to see the percentage of answers tagged, # of answers tagged, # not tagged, and # of taggable answers for each student on a questionnaire.

[[File:Tagging_report.png|thumb|center|Fig. 1]]

== Project Purpose==
The objective of the project is unit testing of functionality in these two ruby files and increasing the coverage.

[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec]

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec]

== Initial Coverage ==
[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec] : 0% Covered

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec] : 18% Covered

=== Missed Methods ===
* <code>app/controllers/answer_tags_controller.rb</code>
** <code>action_allowed?</code>
** <code>index</code>
** <code>create_edit</code>
** <code>destroy</code>

* <code>app/models/tag_prompt_deployment.rb</code>
** <code>get_number_of_taggable_answers</code>
** <code>assignment_tagging_progress</code>

== Project Design ==
In this project, we have two controllers to be tested using Rspec Unit testing.

The ER diagram of the parent tables is given below for reference ([https://expertiza.csc.ncsu.edu/index.php/Answer_tags Source: Answer_tags]).

[[File:answer_tags_imported.png]]

The flow diagrams below show how controllers in this project are connected with interrelated classes, methods, and views.

[[File:E2169 answer tags controller.png|900px]]

[[File:E2169 tag prompt deployment.png|900px]]

== Testing Plan ==
=== Controller: answer_tags_controller.rb ===

Existing coverage = 0%

Description:
The purpose of this controller is to track down the total number of tags done by the students. The database structure for the answer_tags can be found here [https://expertiza.csc.ncsu.edu/index.php/Answer_tags]

'''Methods'''

1. action_allowed? ( params: action )

Description: To allow the functionality only if the accessing user is having student privileges (current_user_has_student_privileges?)

<code>Use cases:</code>
* <code>When the session is null, Access should be denied</code>
* <code>When the session is of student type, access should be allowed and operation should be executed.</code>

2. index ( params : assignment_id, questionnaire_id, user_id )

Description: Populates the tags by fetching the records from AnswerTag corresponding to each TagPromptDeployment based on the filers provided as params.

<code>Use cases:</code>
* <code> When the params for fetching TagPromptDeployment are null, 0 tags prompts should be returned.</code>
* <code> When all valid params are passed, the function should populate the tag prompts.</code>
* <code> When user_id is provided, tag prompts specific to that user should only be populated.</code>

3. create_edit ( params : answer_id, tag_prompt_deployment_id, value )

Description: Fetches the answer tag with the params provided and then updates the respective tag values by the updated values provided as params.

<code>Use cases:</code>
* <code> When the existing tag is found based on the params passed, the existing tag should be updated with new values.</code>

=== Controller: tag_prompt_deployment.rb ===

Before change coverage = 18%

After change coverage = 38%

Description:
This Controller is when a user (with instructor privilege) wants to see tagging summary of every user that participated in a tagging assignment.

'''Methods'''

1. tag_prompt
Description: tag_prompt has existing test cases scoring 18 percentage coverage. Additional testing is not required.

2. get_number_of_taggable_answers ( params: user_id)

Description: To calculate total taggable answers reviewed by a user that participated in the given tagging assignment. user_id is the parameter passed to this method. An individual and his team will have the same score. Fig 1: The last column values are processed by this method.

<code>Use cases:</code>
* <code>when a team has given any response then count of taggable answer > 0</code>
* <code>When a question or a response does not exists then count of taggable answer = 0 (extreme case) </code>
* <code>When answer_length_threshold not set, count taggable answer</code>
* <code>When answer_length_threshold is set, count taggable answer</code>

3. assignment_tagging_progress

Description: To compute the number of tagged answers, number of untagged answers, and percentage of answers tagged by the users that participated in the tagging Assignment to a particular question.
Fig 1: First three columns after the 2nd column onwards are updated with results obtained from this method.

<code>Use cases:</code>
* <code>When not team participated in the assignment, assert count(user_answer_tagging) =0</code>
* <code>When the question does not exist, assert count(user_answer_tagging) =0 </code>
* <code>When multiple rounds of review, render ReviewResponseMap and assert response object</code>
* <code>When single round of review, render ResponseMap and assert response object</code>
* <code>When answer_length_threshold is SET, number of answers and when answer_length_threshold is NOT SET, number of answers</code>
* <code>When route is success answer_tagging object structure matching</code>

== Bug Fixing of Additional Issues ==

'''Model: tag_prompt_deployment.rb (method: get_number_of_taggable_answers)'''

An additional issue in the method get_number_of_taggable_answers. The error message is as shown below which indicates string concatenation fails between integer and string data types.

''TypeError:''
no implicit conversion of Fixnum into String at line 23 https://github.com/expertiza/expertiza/blob/beta/app/models/tag_prompt_deployment.rb.

[[File:Get_number_of_taggable_answers_bug.JPG]]

This issue is fixed by correcting the syntax of the two-strings concatenation. After fixing the code is

<code> answers = answers.where(conditions: "length(comments) < #{self.answer_length_threshold}" ) unless self.answer_length_threshold.nil? </code>

== Collaborators ==
Nicholas Himes (Mentor)

1. Aditya Khadse

2. Alec Landow

3. Rageeni Sah

4. Sayali Pranab

== Relevant Links ==
Main Expertiza repository can be found at [https://github.com/expertiza/expertiza/tree/beta GitHubExp]

Our forked repository can be found at [https://github.com/akk5597/expertiza Github]

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-28T05:21:59Z

Rsah: /* Controller: tag_prompt_deployment.rb */

__TOC__

== Background ==
Answer tagging (see [https://github.com/expertiza/expertiza/blob/25713567e5e5e1c0b363409715e6d8797b45b01a/app/models/answer_tag.rb answer_tab.rb] and [[Answer_tags|wiki]]) helps determine a few metrics on a student’s responses to a questionnaire. Students can tag these metrics for other students for things such as “Positive Tone” or “Suggest Solutions”.

These specs below all need to be further developed to cover missing methods/lines. Some structures currently exist at the top of spec files (such as assignments, participants, etc) to help make writing tests easier. Please feel free to add to these and write extra tests to cover any edge cases you may think of.

As an instructor on an assignment, going to Etc/View Reports/Answer Tagging Report will show student answer tagging. You will be able to see the percentage of answers tagged, # of answers tagged, # not tagged, and # of taggable answers for each student on a questionnaire.

[[File:Tagging_report.png|thumb|center|Fig. 1]]

== Project Purpose==
The objective of the project is unit testing of functionality in these two ruby files and increasing the coverage.

[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec]

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec]

== Initial Coverage ==
[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec] : 0% Covered

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec] : 18% Covered

=== Missed Methods ===
* <code>app/controllers/answer_tags_controller.rb</code>
** <code>action_allowed?</code>
** <code>index</code>
** <code>create_edit</code>
** <code>destroy</code>

* <code>app/models/tag_prompt_deployment.rb</code>
** <code>get_number_of_taggable_answers</code>
** <code>assignment_tagging_progress</code>

== Project Design ==
In this project, we have two controllers to be tested using Rspec Unit testing.

The ER diagram of the parent tables is given below for reference ([https://expertiza.csc.ncsu.edu/index.php/Answer_tags Source: Answer_tags]).

[[File:answer_tags_imported.png]]

The flow diagrams below show how controllers in this project are connected with interrelated classes, methods, and views.

[[File:E2169 answer tags controller.png|900px]]

[[File:E2169 tag prompt deployment.png|900px]]

== Testing Plan ==
=== Controller: answer_tags_controller.rb ===

Existing coverage = 0%

Description:
The purpose of this controller is to track down the total number of tags done by the students. The database structure for the answer_tags can be found here [https://expertiza.csc.ncsu.edu/index.php/Answer_tags]

'''Methods'''

1. action_allowed? ( params: action )

Description: To allow the functionality only if the accessing user is having student privileges (current_user_has_student_privileges?)

<code>Use cases:</code>
* <code>When the session is null, Access should be denied</code>
* <code>When the session is of student type, access should be allowed and operation should be executed.</code>

2. index ( params : assignment_id, questionnaire_id, user_id )

Description: Populates the tags by fetching the records from AnswerTag corresponding to each TagPromptDeployment based on the filers provided as params.

<code>Use cases:</code>
* <code> When the params for fetching TagPromptDeployment are null, 0 tags prompts should be returned.</code>
* <code> When all valid params are passed, the function should populate the tag prompts.</code>
* <code> When user_id is provided, tag prompts specific to that user should only be populated.</code>

3. create_edit ( params : answer_id, tag_prompt_deployment_id, value )

Description: Fetches the answer tag with the params provided and then updates the respective tag values by the updated values provided as params.

<code>Use cases:</code>
* <code> When the existing tag is found based on the params passed, the existing tag should be updated with new values.</code>

=== Controller: tag_prompt_deployment.rb ===

Before change coverage = 18%

After change coverage = 38%

Description:
This Controller is when a user (with instructor privilege) wants to see tagging summary of every user that participated in a tagging assignment.

'''Methods'''

1. tag_prompt
Description: tag_prompt has existing test cases scoring 18 percentage coverage. Additional testing is not required.

2. get_number_of_taggable_answers ( params: user_id)

Description: To calculate total taggable answers reviewed by a user that participated in the given tagging assignment. user_id is the parameter passed to this method. An individual and his team will have the same score. Fig 1: The last column values are processed by this method.

<code>Use cases:</code>
* <code>when a team has given any response then count of taggable answer > 0</code>
* <code>When a question or a response does not exists then count of taggable answer = 0</code>
* <code>When answer_length_threshold not set, count taggable answer</code>
* <code>When answer_length_threshold is set, count taggable answer</code>

3. assignment_tagging_progress

Description: To compute the number of tagged answers, number of untagged answers, and percentage of answers tagged by the users that participated in the tagging Assignment to a particular question.
Fig 1: First three columns after the 2nd column onwards are updated with results obtained from this method.

<code>Use cases:</code>
* <code>When not team participated in the assignment, assert count(user_answer_tagging) =0</code>
* <code>When the question does not exist, assert count(user_answer_tagging) =0 </code>
* <code>When multiple rounds of review, render ReviewResponseMap and assert response object</code>
* <code>When single round of review, render ResponseMap and assert response object</code>
* <code>When answer_length_threshold is SET, number of answers and when answer_length_threshold is NOT SET, number of answers</code>
* <code>When route is success answer_tagging object structure matching</code>

== Bug Fixing of Additional Issues ==

'''Model: tag_prompt_deployment.rb (method: get_number_of_taggable_answers)'''

An additional issue in the method get_number_of_taggable_answers. The error message is as shown below which indicates string concatenation fails between integer and string data types.

''TypeError:''
no implicit conversion of Fixnum into String at line 23 https://github.com/expertiza/expertiza/blob/beta/app/models/tag_prompt_deployment.rb.

[[File:Get_number_of_taggable_answers_bug.JPG]]

This issue is fixed by correcting the syntax of the two-strings concatenation. After fixing the code is

<code> answers = answers.where(conditions: "length(comments) < #{self.answer_length_threshold}" ) unless self.answer_length_threshold.nil? </code>

== Collaborators ==
Nicholas Himes (Mentor)

1. Aditya Khadse

2. Alec Landow

3. Rageeni Sah

4. Sayali Pranab

== Relevant Links ==
Main Expertiza repository can be found at [https://github.com/expertiza/expertiza/tree/beta GitHubExp]

Our forked repository can be found at [https://github.com/akk5597/expertiza Github]

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-28T05:18:53Z

Rsah: /* Controller: tag_prompt_deployment.rb */

__TOC__

== Background ==
Answer tagging (see [https://github.com/expertiza/expertiza/blob/25713567e5e5e1c0b363409715e6d8797b45b01a/app/models/answer_tag.rb answer_tab.rb] and [[Answer_tags|wiki]]) helps determine a few metrics on a student’s responses to a questionnaire. Students can tag these metrics for other students for things such as “Positive Tone” or “Suggest Solutions”.

These specs below all need to be further developed to cover missing methods/lines. Some structures currently exist at the top of spec files (such as assignments, participants, etc) to help make writing tests easier. Please feel free to add to these and write extra tests to cover any edge cases you may think of.

As an instructor on an assignment, going to Etc/View Reports/Answer Tagging Report will show student answer tagging. You will be able to see the percentage of answers tagged, # of answers tagged, # not tagged, and # of taggable answers for each student on a questionnaire.

[[File:Tagging_report.png|thumb|center|Fig. 1]]

== Project Purpose==
The objective of the project is unit testing of functionality in these two ruby files and increasing the coverage.

[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec]

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec]

== Initial Coverage ==
[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec] : 0% Covered

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec] : 18% Covered

=== Missed Methods ===
* <code>app/controllers/answer_tags_controller.rb</code>
** <code>action_allowed?</code>
** <code>index</code>
** <code>create_edit</code>
** <code>destroy</code>

* <code>app/models/tag_prompt_deployment.rb</code>
** <code>get_number_of_taggable_answers</code>
** <code>assignment_tagging_progress</code>

== Project Design ==
In this project, we have two controllers to be tested using Rspec Unit testing.

The ER diagram of the parent tables is given below for reference ([https://expertiza.csc.ncsu.edu/index.php/Answer_tags Source: Answer_tags]).

[[File:answer_tags_imported.png]]

The flow diagrams below show how controllers in this project are connected with interrelated classes, methods, and views.

[[File:E2169 answer tags controller.png|900px]]

[[File:E2169 tag prompt deployment.png|900px]]

== Testing Plan ==
=== Controller: answer_tags_controller.rb ===

Existing coverage = 0%

Description:
The purpose of this controller is to track down the total number of tags done by the students. The database structure for the answer_tags can be found here [https://expertiza.csc.ncsu.edu/index.php/Answer_tags]

'''Methods'''

1. action_allowed? ( params: action )

Description: To allow the functionality only if the accessing user is having student privileges (current_user_has_student_privileges?)

<code>Use cases:</code>
* <code>When the session is null, Access should be denied</code>
* <code>When the session is of student type, access should be allowed and operation should be executed.</code>

2. index ( params : assignment_id, questionnaire_id, user_id )

Description: Populates the tags by fetching the records from AnswerTag corresponding to each TagPromptDeployment based on the filers provided as params.

<code>Use cases:</code>
* <code> When the params for fetching TagPromptDeployment are null, 0 tags prompts should be returned.</code>
* <code> When all valid params are passed, the function should populate the tag prompts.</code>
* <code> When user_id is provided, tag prompts specific to that user should only be populated.</code>

3. create_edit ( params : answer_id, tag_prompt_deployment_id, value )

Description: Fetches the answer tag with the params provided and then updates the respective tag values by the updated values provided as params.

<code>Use cases:</code>
* <code> When the existing tag is found based on the params passed, the existing tag should be updated with new values.</code>

=== Controller: tag_prompt_deployment.rb ===

Before change coverage = 18%

After change coverage = 38%

Description:
This Controller is when a user (with instructor privilege) wants to see tagging summary of every user that participated in a tagging assignment.

'''Methods'''

1. tag_prompt
Description: tag_prompt has existing test cases scoring 18 percentage coverage. Additional testing is not required.

2. get_number_of_taggable_answers ( params: user_id)

Description: To calculate total taggable answers reviewed by a user that participated in the given tagging assignment. user_id is the parameter passed to this method. An individual and his team will have the same score. Fig 1: The last column values are processed by this method.

<code>Use cases:</code>
* <code>when a team has not given any response then assert count of taggable answer = 0</code>
* <code>When question does not exists then count of taggable answer = 0</code>
* <code>When a valid response exists, count of taggable answer (answer.count should be greater than zero)</code>
* <code>When answer_length_threshold not set, count taggable answer</code>
* <code>When answer_length_threshold is set, count taggable answer</code>

3. assignment_tagging_progress

Description: To compute the number of tagged answers, number of untagged answers, and percentage of answers tagged by the users that participated in the tagging Assignment to a particular question.
Fig 1: First three columns after the 2nd column onwards are updated with results obtained from this method.

<code>Use cases:</code>
* <code>When not team participated in the assignment, assert count(user_answer_tagging) =0</code>
* <code>When the question does not exist, assert count(user_answer_tagging) =0 </code>
* <code>When multiple rounds of review, render ReviewResponseMap and assert response object</code>
* <code>When single round of review, render ResponseMap and assert response object</code>
* <code>When answer_length_threshold is SET, number of answers and when answer_length_threshold is NOT SET, number of answers</code>
* <code>When route is success answer_tagging object structure matching</code>

== Bug Fixing of Additional Issues ==

'''Model: tag_prompt_deployment.rb (method: get_number_of_taggable_answers)'''

An additional issue in the method get_number_of_taggable_answers. The error message is as shown below which indicates string concatenation fails between integer and string data types.

''TypeError:''
no implicit conversion of Fixnum into String at line 23 https://github.com/expertiza/expertiza/blob/beta/app/models/tag_prompt_deployment.rb.

[[File:Get_number_of_taggable_answers_bug.JPG]]

This issue is fixed by correcting the syntax of the two-strings concatenation. After fixing the code is

<code> answers = answers.where(conditions: "length(comments) < #{self.answer_length_threshold}" ) unless self.answer_length_threshold.nil? </code>

== Collaborators ==
Nicholas Himes (Mentor)

1. Aditya Khadse

2. Alec Landow

3. Rageeni Sah

4. Sayali Pranab

== Relevant Links ==
Main Expertiza repository can be found at [https://github.com/expertiza/expertiza/tree/beta GitHubExp]

Our forked repository can be found at [https://github.com/akk5597/expertiza Github]

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-28T05:18:41Z

Rsah: /* Controller: tag_prompt_deployment.rb */

__TOC__

== Background ==
Answer tagging (see [https://github.com/expertiza/expertiza/blob/25713567e5e5e1c0b363409715e6d8797b45b01a/app/models/answer_tag.rb answer_tab.rb] and [[Answer_tags|wiki]]) helps determine a few metrics on a student’s responses to a questionnaire. Students can tag these metrics for other students for things such as “Positive Tone” or “Suggest Solutions”.

These specs below all need to be further developed to cover missing methods/lines. Some structures currently exist at the top of spec files (such as assignments, participants, etc) to help make writing tests easier. Please feel free to add to these and write extra tests to cover any edge cases you may think of.

As an instructor on an assignment, going to Etc/View Reports/Answer Tagging Report will show student answer tagging. You will be able to see the percentage of answers tagged, # of answers tagged, # not tagged, and # of taggable answers for each student on a questionnaire.

[[File:Tagging_report.png|thumb|center|Fig. 1]]

== Project Purpose==
The objective of the project is unit testing of functionality in these two ruby files and increasing the coverage.

[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec]

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec]

== Initial Coverage ==
[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec] : 0% Covered

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec] : 18% Covered

=== Missed Methods ===
* <code>app/controllers/answer_tags_controller.rb</code>
** <code>action_allowed?</code>
** <code>index</code>
** <code>create_edit</code>
** <code>destroy</code>

* <code>app/models/tag_prompt_deployment.rb</code>
** <code>get_number_of_taggable_answers</code>
** <code>assignment_tagging_progress</code>

== Project Design ==
In this project, we have two controllers to be tested using Rspec Unit testing.

The ER diagram of the parent tables is given below for reference ([https://expertiza.csc.ncsu.edu/index.php/Answer_tags Source: Answer_tags]).

[[File:answer_tags_imported.png]]

The flow diagrams below show how controllers in this project are connected with interrelated classes, methods, and views.

[[File:E2169 answer tags controller.png|900px]]

[[File:E2169 tag prompt deployment.png|900px]]

== Testing Plan ==
=== Controller: answer_tags_controller.rb ===

Existing coverage = 0%

Description:
The purpose of this controller is to track down the total number of tags done by the students. The database structure for the answer_tags can be found here [https://expertiza.csc.ncsu.edu/index.php/Answer_tags]

'''Methods'''

1. action_allowed? ( params: action )

Description: To allow the functionality only if the accessing user is having student privileges (current_user_has_student_privileges?)

<code>Use cases:</code>
* <code>When the session is null, Access should be denied</code>
* <code>When the session is of student type, access should be allowed and operation should be executed.</code>

2. index ( params : assignment_id, questionnaire_id, user_id )

Description: Populates the tags by fetching the records from AnswerTag corresponding to each TagPromptDeployment based on the filers provided as params.

<code>Use cases:</code>
* <code> When the params for fetching TagPromptDeployment are null, 0 tags prompts should be returned.</code>
* <code> When all valid params are passed, the function should populate the tag prompts.</code>
* <code> When user_id is provided, tag prompts specific to that user should only be populated.</code>

3. create_edit ( params : answer_id, tag_prompt_deployment_id, value )

Description: Fetches the answer tag with the params provided and then updates the respective tag values by the updated values provided as params.

<code>Use cases:</code>
* <code> When the existing tag is found based on the params passed, the existing tag should be updated with new values.</code>

=== Controller: tag_prompt_deployment.rb ===

Before change coverage = 18%
After change coverage = 38%

Description:
This Controller is when a user (with instructor privilege) wants to see tagging summary of every user that participated in a tagging assignment.

'''Methods'''

1. tag_prompt
Description: tag_prompt has existing test cases scoring 18 percentage coverage. Additional testing is not required.

2. get_number_of_taggable_answers ( params: user_id)

Description: To calculate total taggable answers reviewed by a user that participated in the given tagging assignment. user_id is the parameter passed to this method. An individual and his team will have the same score. Fig 1: The last column values are processed by this method.

<code>Use cases:</code>
* <code>when a team has not given any response then assert count of taggable answer = 0</code>
* <code>When question does not exists then count of taggable answer = 0</code>
* <code>When a valid response exists, count of taggable answer (answer.count should be greater than zero)</code>
* <code>When answer_length_threshold not set, count taggable answer</code>
* <code>When answer_length_threshold is set, count taggable answer</code>

3. assignment_tagging_progress

Description: To compute the number of tagged answers, number of untagged answers, and percentage of answers tagged by the users that participated in the tagging Assignment to a particular question.
Fig 1: First three columns after the 2nd column onwards are updated with results obtained from this method.

<code>Use cases:</code>
* <code>When not team participated in the assignment, assert count(user_answer_tagging) =0</code>
* <code>When the question does not exist, assert count(user_answer_tagging) =0 </code>
* <code>When multiple rounds of review, render ReviewResponseMap and assert response object</code>
* <code>When single round of review, render ResponseMap and assert response object</code>
* <code>When answer_length_threshold is SET, number of answers and when answer_length_threshold is NOT SET, number of answers</code>
* <code>When route is success answer_tagging object structure matching</code>

== Bug Fixing of Additional Issues ==

'''Model: tag_prompt_deployment.rb (method: get_number_of_taggable_answers)'''

An additional issue in the method get_number_of_taggable_answers. The error message is as shown below which indicates string concatenation fails between integer and string data types.

''TypeError:''
no implicit conversion of Fixnum into String at line 23 https://github.com/expertiza/expertiza/blob/beta/app/models/tag_prompt_deployment.rb.

[[File:Get_number_of_taggable_answers_bug.JPG]]

This issue is fixed by correcting the syntax of the two-strings concatenation. After fixing the code is

<code> answers = answers.where(conditions: "length(comments) < #{self.answer_length_threshold}" ) unless self.answer_length_threshold.nil? </code>

== Collaborators ==
Nicholas Himes (Mentor)

1. Aditya Khadse

2. Alec Landow

3. Rageeni Sah

4. Sayali Pranab

== Relevant Links ==
Main Expertiza repository can be found at [https://github.com/expertiza/expertiza/tree/beta GitHubExp]

Our forked repository can be found at [https://github.com/akk5597/expertiza Github]

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-27T20:37:53Z

Rsah: /* Additional Issues Bug Fix */

__TOC__

== Background ==
Answer tagging (see [https://github.com/expertiza/expertiza/blob/25713567e5e5e1c0b363409715e6d8797b45b01a/app/models/answer_tag.rb answer_tab.rb] and [[Answer_tags|wiki]]) helps determine a few metrics on a student’s responses to a questionnaire. Students can tag these metrics for other students for things such as “Positive Tone” or “Suggest Solutions”.

These specs below all need to be further developed to cover missing methods/lines. Some structures currently exist at the top of spec files (such as assignments, participants, etc) to help make writing tests easier. Please feel free to add to these and write extra tests to cover any edge cases you may think of.

As an instructor on an assignment, going to Etc/View Reports/Answer Tagging Report will show student answer tagging. You will be able to see the percentage of answers tagged, # of answers tagged, # not tagged, and # of taggable answers for each student on a questionnaire.

[[File:Tagging_report.png|thumb|center|Fig. 1]]

== Project Purpose==
The objective of the project is unit testing of functionality in these two ruby files and increasing the coverage.

[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec]

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec]

== Initial Coverage ==
[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec] : 0% Covered

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec] : 18% Covered

=== Missed Methods ===
* <code>app/controllers/answer_tags_controller.rb</code>
** <code>action_allowed?</code>
** <code>index</code>
** <code>create_edit</code>
** <code>destroy</code>

* <code>app/models/tag_prompt_deployment.rb</code>
** <code>get_number_of_taggable_answers</code>
** <code>assignment_tagging_progress</code>

== Project Design ==
In this project, we have two controllers to be tested using Rspec Unit testing.

The ER diagram of the parent tables is given below for reference ([https://expertiza.csc.ncsu.edu/index.php/Answer_tags Source: Answer_tags]).

[[File:answer_tags_imported.png]]

The flow diagrams below show how controllers in this project are connected with interrelated classes, methods, and views.

[[File:E2169 answer tags controller.png|900px]]

[[File:E2169 tag prompt deployment.png|900px]]

== Testing Plan ==
=== Controller: answer_tags_controller.rb ===

Existing coverage = 0%

Description:
The purpose of this controller is to track down the total number of tags done by the students. The database structure for the answer_tags can be found here [https://expertiza.csc.ncsu.edu/index.php/Answer_tags]

'''Methods'''

1. action_allowed? ( params: action )

Description: To allow the functionality only if the accessing user is having student privileges (current_user_has_student_privileges?)

<code>Use cases:</code>
* <code>When the session is null, Access should be denied</code>
* <code>When the session is of student type, access should be allowed and operation should be executed.</code>

2. index ( params : assignment_id, questionnaire_id, user_id )

Description: Populates the tags by fetching the records from AnswerTag corresponding to each TagPromptDeployment based on the filers provided as params.

<code>Use cases:</code>
* <code> When the params for fetching TagPromptDeployment are null, 0 tags prompts should be returned.</code>
* <code> When all valid params are passed, the function should populate the tag prompts.</code>
* <code> When user_id is provided, tag prompts specific to that user should only be populated.</code>

3. create_edit ( params : answer_id, tag_prompt_deployment_id, value )

Description: Fetches the answer tag with the params provided and then updates the respective tag values by the updated values provided as params.

<code>Use cases:</code>
* <code> When the existing tag is found based on the params passed, the existing tag should be updated with new values.</code>

=== Controller: tag_prompt_deployment.rb ===

Existing coverage = 18%

Description:
This Controller is when a user (with instructor privilege) wants to see tagging summary of every user that participated in a tagging assignment.

'''Methods'''

1. tag_prompt
Description: tag_prompt has existing test cases scoring 18 percentage coverage. Additional testing is not required.

2. get_number_of_taggable_answers ( params: user_id)

Description: To calculate total taggable answers reviewed by a user that participated in the given tagging assignment. user_id is the parameter passed to this method. An individual and his team will have the same score. Fig 1: The last column values are processed by this method.

<code>Use cases:</code>
* <code>when a team has not given any response then assert count of taggable answer = 0</code>
* <code>When question does not exists then count of taggable answer = 0</code>
* <code>When a valid response exists, count of taggable answer (answer.count should be greater than zero)</code>
* <code>When answer_length_threshold not set, count taggable answer</code>
* <code>When answer_length_threshold is set, count taggable answer</code>

3. assignment_tagging_progress

Description: To compute the number of tagged answers, number of untagged answers, and percentage of answers tagged by the users that participated in the tagging Assignment to a particular question.
Fig 1: First three columns after the 2nd column onwards are updated with results obtained from this method.

<code>Use cases:</code>
* <code>When not team participated in the assignment, assert count(user_answer_tagging) =0</code>
* <code>When the question does not exist, assert count(user_answer_tagging) =0 </code>
* <code>When multiple rounds of review, render ReviewResponseMap and assert response object</code>
* <code>When single round of review, render ResponseMap and assert response object</code>
* <code>When answer_length_threshold is SET, number of answers and when answer_length_threshold is NOT SET, number of answers</code>
* <code>When route is success answer_tagging object structure matching</code>

== Bug Fixing of Additional Issues ==

'''Model: tag_prompt_deployment.rb (method: get_number_of_taggable_answers)'''

An additional issue in the method get_number_of_taggable_answers. The error message is as shown below which indicates string concatenation fails between integer and string data types.

''TypeError:''
no implicit conversion of Fixnum into String at line 23 https://github.com/expertiza/expertiza/blob/beta/app/models/tag_prompt_deployment.rb.

[[File:Get_number_of_taggable_answers_bug.JPG]]

This issue is fixed by correcting the syntax of the two-strings concatenation. After fixing the code is

<code> answers = answers.where(conditions: "length(comments) < #{self.answer_length_threshold}" ) unless self.answer_length_threshold.nil? </code>

== Collaborators ==
Nicholas Himes (Mentor)

1. Aditya Khadse

2. Alec Landow

3. Rageeni Sah

4. Sayali Pranab

== Relevant Links ==
Main Expertiza repository can be found at [https://github.com/expertiza/expertiza/tree/beta GitHubExp]

Our forked repository can be found at [https://github.com/akk5597/expertiza Github]

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-27T20:37:00Z

Rsah: /* Collaborators */

__TOC__

== Background ==
Answer tagging (see [https://github.com/expertiza/expertiza/blob/25713567e5e5e1c0b363409715e6d8797b45b01a/app/models/answer_tag.rb answer_tab.rb] and [[Answer_tags|wiki]]) helps determine a few metrics on a student’s responses to a questionnaire. Students can tag these metrics for other students for things such as “Positive Tone” or “Suggest Solutions”.

These specs below all need to be further developed to cover missing methods/lines. Some structures currently exist at the top of spec files (such as assignments, participants, etc) to help make writing tests easier. Please feel free to add to these and write extra tests to cover any edge cases you may think of.

As an instructor on an assignment, going to Etc/View Reports/Answer Tagging Report will show student answer tagging. You will be able to see the percentage of answers tagged, # of answers tagged, # not tagged, and # of taggable answers for each student on a questionnaire.

[[File:Tagging_report.png|thumb|center|Fig. 1]]

== Project Purpose==
The objective of the project is unit testing of functionality in these two ruby files and increasing the coverage.

[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec]

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec]

== Initial Coverage ==
[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec] : 0% Covered

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec] : 18% Covered

=== Missed Methods ===
* <code>app/controllers/answer_tags_controller.rb</code>
** <code>action_allowed?</code>
** <code>index</code>
** <code>create_edit</code>
** <code>destroy</code>

* <code>app/models/tag_prompt_deployment.rb</code>
** <code>get_number_of_taggable_answers</code>
** <code>assignment_tagging_progress</code>

== Project Design ==
In this project, we have two controllers to be tested using Rspec Unit testing.

The ER diagram of the parent tables is given below for reference ([https://expertiza.csc.ncsu.edu/index.php/Answer_tags Source: Answer_tags]).

[[File:answer_tags_imported.png]]

The flow diagrams below show how controllers in this project are connected with interrelated classes, methods, and views.

[[File:E2169 answer tags controller.png|900px]]

[[File:E2169 tag prompt deployment.png|900px]]

== Testing Plan ==
=== Controller: answer_tags_controller.rb ===

Existing coverage = 0%

Description:
The purpose of this controller is to track down the total number of tags done by the students. The database structure for the answer_tags can be found here [https://expertiza.csc.ncsu.edu/index.php/Answer_tags]

'''Methods'''

1. action_allowed? ( params: action )

Description: To allow the functionality only if the accessing user is having student privileges (current_user_has_student_privileges?)

<code>Use cases:</code>
* <code>When the session is null, Access should be denied</code>
* <code>When the session is of student type, access should be allowed and operation should be executed.</code>

2. index ( params : assignment_id, questionnaire_id, user_id )

Description: Populates the tags by fetching the records from AnswerTag corresponding to each TagPromptDeployment based on the filers provided as params.

<code>Use cases:</code>
* <code> When the params for fetching TagPromptDeployment are null, 0 tags prompts should be returned.</code>
* <code> When all valid params are passed, the function should populate the tag prompts.</code>
* <code> When user_id is provided, tag prompts specific to that user should only be populated.</code>

3. create_edit ( params : answer_id, tag_prompt_deployment_id, value )

Description: Fetches the answer tag with the params provided and then updates the respective tag values by the updated values provided as params.

<code>Use cases:</code>
* <code> When the existing tag is found based on the params passed, the existing tag should be updated with new values.</code>

=== Controller: tag_prompt_deployment.rb ===

Existing coverage = 18%

Description:
This Controller is when a user (with instructor privilege) wants to see tagging summary of every user that participated in a tagging assignment.

'''Methods'''

1. tag_prompt
Description: tag_prompt has existing test cases scoring 18 percentage coverage. Additional testing is not required.

2. get_number_of_taggable_answers ( params: user_id)

Description: To calculate total taggable answers reviewed by a user that participated in the given tagging assignment. user_id is the parameter passed to this method. An individual and his team will have the same score. Fig 1: The last column values are processed by this method.

<code>Use cases:</code>
* <code>when a team has not given any response then assert count of taggable answer = 0</code>
* <code>When question does not exists then count of taggable answer = 0</code>
* <code>When a valid response exists, count of taggable answer (answer.count should be greater than zero)</code>
* <code>When answer_length_threshold not set, count taggable answer</code>
* <code>When answer_length_threshold is set, count taggable answer</code>

3. assignment_tagging_progress

Description: To compute the number of tagged answers, number of untagged answers, and percentage of answers tagged by the users that participated in the tagging Assignment to a particular question.
Fig 1: First three columns after the 2nd column onwards are updated with results obtained from this method.

<code>Use cases:</code>
* <code>When not team participated in the assignment, assert count(user_answer_tagging) =0</code>
* <code>When the question does not exist, assert count(user_answer_tagging) =0 </code>
* <code>When multiple rounds of review, render ReviewResponseMap and assert response object</code>
* <code>When single round of review, render ResponseMap and assert response object</code>
* <code>When answer_length_threshold is SET, number of answers and when answer_length_threshold is NOT SET, number of answers</code>
* <code>When route is success answer_tagging object structure matching</code>

== Additional Issues Bug Fix==

'''Model: tag_prompt_deployment.rb (method: get_number_of_taggable_answers)'''

An additional issue in the method get_number_of_taggable_answers. The error message is as shown below which indicates string concatenation fails between integer and string data types.

''TypeError:''
no implicit conversion of Fixnum into String at line 23 https://github.com/expertiza/expertiza/blob/beta/app/models/tag_prompt_deployment.rb.

[[File:Get_number_of_taggable_answers_bug.JPG]]

This issue is fixed by correcting the syntax of the two-strings concatenation. After fixing the code is

<code> answers = answers.where(conditions: "length(comments) < #{self.answer_length_threshold}" ) unless self.answer_length_threshold.nil? </code>

== Collaborators ==
Nicholas Himes (Mentor)

1. Aditya Khadse

2. Alec Landow

3. Rageeni Sah

4. Sayali Pranab

== Relevant Links ==
Main Expertiza repository can be found at [https://github.com/expertiza/expertiza/tree/beta GitHubExp]

Our forked repository can be found at [https://github.com/akk5597/expertiza Github]

File:Get number of taggable answers bug.JPG

2021-11-27T20:28:09Z

Rsah: TypeError: no implicit conversion of Fixnum into String at line 23 https://github.com/expertiza/expertiza/blob/beta/app/models/tag_prompt_deployment.rb.

TypeError:
no implicit conversion of Fixnum into String at line 23 https://github.com/expertiza/expertiza/blob/beta/app/models/tag_prompt_deployment.rb.

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-17T02:28:11Z

Rsah: /* Controller: tag_prompt_deployment.rb */

__TOC__

== Background ==
Answer tagging (see [https://github.com/expertiza/expertiza/blob/25713567e5e5e1c0b363409715e6d8797b45b01a/app/models/answer_tag.rb answer_tab.rb] and [[Answer_tags|wiki]]) helps determine a few metrics on a student’s responses to a questionnaire. Students can tag these metrics for other students for things such as “Positive Tone” or “Suggest Solutions”.

These specs below all need to be further developed to cover missing methods/lines. Some structures currently exist at the top of spec files (such as assignments, participants, etc) to help make writing tests easier. Please feel free to add to these and write extra tests to cover any edge cases you may think of.

As an instructor on an assignment, going to Etc/View Reports/Answer Tagging Report will show student answer tagging. You will be able to see the percentage of answers tagged, # of answers tagged, # not tagged, and # of taggable answers for each student on a questionnaire.

[[File:Tagging_report.png|thumb|center|Fig. 1]]

== Project Purpose==
The objective of the project is unit testing of functionality in these two ruby files and increasing the coverage.

[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec]

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec]

== Initial Coverage ==
[https://coveralls.io/builds/43656335/source?filename=app%2Fcontrollers%2Fanswer_tags_controller.rb Answer_tags_controller_spec] : 0% Covered

[https://coveralls.io/builds/43656335/source?filename=app%2Fmodels%2Ftag_prompt_deployment.rb Tag_prompt_deployment_spec] : 18% Covered

=== Missed Methods ===
* <code>app/controllers/answer_tags_controller.rb</code>
** <code>action_allowed?</code>
** <code>index</code>
** <code>create_edit</code>
** <code>destroy</code>

* <code>app/models/tag_prompt_deployment.rb</code>
** <code>get_number_of_taggable_answers</code>
** <code>assignment_tagging_progress</code>

== Project Design ==
In this project, we have two controllers to be tested using Rspec Unit testing.

The ER diagram of the parent tables is given below for reference ([https://expertiza.csc.ncsu.edu/index.php/Answer_tags Source: Answer_tags]).

[[File:answer_tags_imported.png]]

The flow diagrams below show how controllers in this project are connected with interrelated classes, methods, and views.

[[File:E2169 answer tags controller.png|900px]]

[[File:E2169 tag prompt deployment.png|900px]]

== Testing Plan ==
=== Controller: answer_tags_controller.rb ===

Existing coverage = 0%

Description:
The purpose of this controller is to track down the total number of tags done by the students. The database structure for the answer_tags can be found here [https://expertiza.csc.ncsu.edu/index.php/Answer_tags]

'''Methods'''

1. action_allowed? ( params: action )

Description: To allow the functionality only if the accessing user is having student privileges (current_user_has_student_privileges?)

<code>Use cases:</code>
* <code>When the session is null, Access should be denied</code>
* <code>When the session is of student type, access should be allowed and operation should be executed.</code>

2. index ( params : assignment_id, questionnaire_id, user_id )

Description: Populates the tags by fetching the records from AnswerTag corresponding to each TagPromptDeployment based on the filers provided as params.

<code>Use cases:</code>
* <code> When the params for fetching TagPromptDeployment are null, 0 tags prompts should be returned.</code>
* <code> When all valid params are passed, the function should populate the tag prompts.</code>
* <code> When user_id is provided, tag prompts specific to that user should only be populated.</code>

3. create_edit ( params : answer_id, tag_prompt_deployment_id, value )

Description: Fetches the answer tag with the params provided and then updates the respective tag values by the updated values provided as params.

<code>Use cases:</code>
* <code> When the existing tag is found based on the params passed, the existing tag should be updated with new values.</code>

=== Controller: tag_prompt_deployment.rb ===

Existing coverage = 18%

Description:
This Controller is when a user (with instructor privilege) wants to see tagging summary of every user that participated in a tagging assignment.

'''Methods'''

1. tag_prompt
Description: tag_prompt has existing test cases scoring 18 percentage coverage. Additional testing is not required.

2. get_number_of_taggable_answers ( params: user_id)

Description: To calculate total taggable answers reviewed by a user that participated in the given tagging assignment. user_id is the parameter passed to this method. An individual and his team will have the same score. Fig 1: The last column values are processed by this method.

<code>Use cases:</code>
* <code>when a team has not given any response then assert count of taggable answer = 0</code>
* <code>When question does not exists then count of taggable answer = 0</code>
* <code>When a valid response exists, count of taggable answer (answer.count should be greater than zero)</code>
* <code>When answer_length_threshold not set, count taggable answer</code>
* <code>When answer_length_threshold is set, count taggable answer</code>

3. assignment_tagging_progress

Description: To compute the number of tagged answers, number of untagged answers, and percentage of answers tagged by the users that participated in the tagging Assignment to a particular question.
Fig 1: First three columns after the 2nd column onwards are updated with results obtained from this method.

<code>Use cases:</code>
* <code>When not team participated in the assignment, assert count(user_answer_tagging) =0</code>
* <code>When the question does not exist, assert count(user_answer_tagging) =0 </code>
* <code>When multiple rounds of review, render ReviewResponseMap and assert response object</code>
* <code>When single round of review, render ResponseMap and assert response object</code>
* <code>When answer_length_threshold is SET, number of answers and when answer_length_threshold is NOT SET, number of answers</code>
* <code>When route is success answer_tagging object structure matching</code>

== Collaborators ==
Nicholas Himes (Mentor)

1. Aditya Khadse

2. Alec Landow

3. Rageeni Sah

4. Sayali Pranab

== Relevant Links ==
Main Expertiza repository can be found at [https://github.com/expertiza/expertiza/tree/beta GitHubExp]

Our forked repository can be found at [https://github.com/akk5597/expertiza Github]

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-05T03:57:14Z

Rsah: /* Project Design */

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-05T03:54:30Z

Rsah: /* Project Design */

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-04T17:36:57Z

Rsah: /* Type of testing */

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-04T17:32:54Z

Rsah: /* Test Plan */

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-04T17:31:07Z

Rsah: /* Project Purpose */

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-04T17:29:47Z

Rsah: /* Background */

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-04T17:02:56Z

Rsah: /* Initial Coverage */

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-04T16:43:43Z

Rsah: /* Test Plan */

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-04T16:43:12Z

Rsah: /* Controller: answer_tags_controller.rb */

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-04T16:42:57Z

Rsah: /* Controller: tag_prompt_deployment.rb */

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-04T16:38:50Z

Rsah: /* Team members */

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-03T02:35:59Z

Rsah: /* Team members */

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-03T02:35:19Z

Rsah: /* Test Plan */

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-02T23:16:06Z

Rsah: /* Test Plan */

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-02T21:54:50Z

Rsah: /* Background */

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-02T21:53:18Z

Rsah: /* Background */

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-02T21:51:53Z

Rsah: /* Initial Coverage */

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-02T21:51:31Z

Rsah: /* Background */

File:Tagging report.png

2021-11-02T21:46:22Z

Rsah:

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-02T21:43:35Z

Rsah: /* Test Plan */

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-02T21:40:29Z

Rsah: /* Test Plan */

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-02T21:36:16Z

Rsah: /* Methods */

CSC/ECE 517 Fall 2021 - E2169. Testing - Answer Tagging

2021-11-02T21:34:41Z

Rsah: /* Test Plan */