Blackboard Basic for Academic Suite/Learn

  • Supported by Open Options for Integrations.
  • Plug-in (known in Blackboard as a "building block") developed by iParadigms using the publicly available Blackboard APIs and as a member Blackboard's Building Blocks developer partner program.
  • Allows access to all Turnitin services (OriginalityCheck, GradeMark and PeerMark) without having to leave the Blackboard environment or log into Turnitin directly.
  • Turnitin services are displayed in their own browser frame, using the standard Turnitin user interface.

Versions & Release Notes

Bb 6.1, 6.2, 6.3, 7.0, 7.1 (pre-7.2)
Tii Bb Building Block 2.2.9

For integration with Blackboard versions pre-7.2

Changes in version 2.2.9:
  1. added administrator setting to preserve assignment dates on copied assignments
Changes in version 2.2.8:
  1. fixed issue with students getting a blank page if an instructor user is disabled
Changes in version 2.2.7:
  1. fixed issue where administrators accessing Turnitin Assignments got a java error instead of error page
Changes in version 2.2.6
  1. added a setting for instructors to choose whether to display grades to students before the assignment post date
Changes in version 2.2.5
  1. in view assignments by groups, use current user instead of earliest enrolled instructor
  2. fixed recallUrl links for confirmation pages
  3. added a check when looking up currently attached files if attempt directories don't yet exist
  4. fixed referrer URL for gradebook_view.jsp
  5. updated syntax for jsp:forward call for students to view grades
  6. save all files for instructor comments and notes in the directory including the user-created course ID; if the assignment was created using an older plugin (pre-2.x.0), there was a way it could have used the directory including the Blackboard-created primary course ID
  7. when looking up files, search in directories using both the user-created course ID and the Blackboard-created primary course ID
  8. use earliest enrolled TA as the instructor if nobody is enrolled with the instructor role
Changes in version 2.2.4:
  1. changed the way teacher email is created to support multiple instructor schema

Skipped version number 2.2.3

Changes in version 2.2.2:
  1. changed the frameset row size for create and modify pages so those windows will fully open in IE
Changes in version 2.2.1:
  1. added web services URL to configuration page as a setting
  2. removed copy button when creating Turnitin Assignments
  3. in course copy, set orig ID to first gradebook column ID if there is only one column
  4. added support for Grader and Course Builder roles to see Turnitin Assignments as instructors
Changes in version 2.2.0:
  1. changed version number according to new numbering scheme to match other versions and their numbering schemes
Known Issues:
  1. The '!' in the Blackboard Gradebook doesn't show for a student who has submitted to a Turnitin Assignment

    Basically, what is happening is that the student is submitting a paper, and it is being received by Turnitin, but when Turnitin tries to make a web service call back into Blackboard to indicate in Blackboard that the student has submitted, the web service call fails, and the student receives the error message: "The paper was submitted successfolly to Turnitin, but the Blackboard Gradebook was not modified. The Blackboard Gradebook does not currently reflect his assignment's submission status." That means there is no exclamation mark in the Blackboard Gradebook for the Turnitin Assignment for each student that has submitted a paper and received this error message.

    The likely cause is that during the submission process, after the papers were received by Turnitin, there was an error that occurred in the web service call. What happens when a student submits to a Turnitin Assignment is that it is accepted by our system, and then a web service call is made from our Turnitin servers to the Blackboard servers to indicate in Blackboard that the student has submitted for this Turnitin Assignment, and particolarly to have that exclamation mark appear in the Blackboard Gradebook. However, there are times when that web service call can fail for one reason or another, thus making it so that Turnitin has received the paper successfolly by the indication in the Blackboard Gradebook could not be completed. This is a known issue for which happens intermittently for different institutions, and we have not been able to determine the cause or reproduce it on our own systems. We are looking for a way to reproduce this error consistently so that we can come up with a solution for it but have not been able to so far. Because the papers are still successfolly received by Turnitin, instead of giving the user a large error screen when this occurs, we just give a notice that the paper was successfolly received, but that the web service call failed.

    There isn't a solution to this problem really, or a way to get that exclamation mark to appear in the Blackboard Gradebook. We are looking into a tool that will try to resend the web service call, but we're not sure if this will work either. What you can try is having the instructor delete the submission and having the student try to submit again. If the error happens again for that student, please contact our Helpdesk.

  2. Error when trying to modify an existing Turnitin assignment or grade a submission in an existing Turnitin Assignment

    One thing to check here is if there is a corresponding Gradebook column for this Turnitin Assignment, and that Gradebook column needs to have the same title as the Turnitin Assignment. If the Gradebook column is missing or the title is different (e.g., abbreviated, etc.) this will cause the errors to occur.

  3. Copying Turnitin Assignments in Blackboard

    First off, copying Turnitin Assignments that were not created with a Turnitin building block version 2.0.5 and above will not work no matter what. It just wasn't supported back then and won't work if the original Turnitin Assignment that is being copied wasn't created with a building block that supported Course Copy.

    Secondly, using the "Copy" button that shows up next to the content item along with the "Modify", "Manage" and "Remove" buttons in the "Assignments" area in the "Control Panel" also will not work in trying to copy a Turnitin Assignment. We have added code to remove that button, but if for some reason it still shows up in that area, do not use it to copy a Turnitin Assignment.

    The only way where copying should work is from the "Control Panel", selecting the "Course Copy" feature in the "Course Options" area. If you click on that link, it will give you 3 options.

    Any one of these 3 options should work. However, if you choose "Copy Course Materials into a New Course" or "Copy Course Materials into an Existing Course", you have to be sure that you select the content area that contains the Turnitin Assignments that you want copied (e.g. Assignments) as well as the corresponding "Gradebook Items and Settings" to make sure the copy will succeed.

    Otherwise, an instructor will need to delete any copied assignments and recreate them manually.

  4. Incoming/outgoing connections with regards to the Turnitin Building Block and the Blackboard server

    For the Turnitin Building Block to work correctly, the Blackboard server needs to be able to make outgoing HTTP/HTTPS connections as well as receive incoming HTTP/HTTPS connections. One the outgoing connections, the Blackboard server is going to be trying to make connections to api.turnitin.com over the standard HTTP or HTTPS ports.

    Also, your Blackboard server needs to be able to receive incoming connections from our Turnitin servers. If you have a firewall in place that is not allowing outside connections to your Blackboard server, please check this. For your Blackboard servers, the ports 80 and 443 need to be accessible from our range of IP addresses (note, this is different from the IP address you might get when your servers try to connect to our servers).

    IPv4 Addresses (*)
       •  199.47.80-87.x
       •  174.47.2.x
       •  38.111.147.x
       •  67.203.85.x
       •  67.203.111.x

    IPv6 Addresses
       •  2620:108:E000::/44

For other Blackboard known issues please see the frequently asked questions (FAQs) at the bottom of this page.

DISCLAIMER:

Any of the information and suggestions made in this file are "try at your own risk" and iParadigms/Turnitin cannot be held responsible for any actions you take.

Bb 7.2+ (up to but not including 8.0)
Tii Bb Building Block 2.3.9

Changes in version 2.3.9:
  1. added administrator setting to preserve assignment dates on copied assignments
Changes in version 2.3.8:
  1. fixed issue with students getting a blank page if an instructor user is disabled
Changes in version 2.3.7:
  1. fixed issue where administrators accessing Turnitin Assignments got a java error instead of error page
Change in version 2.3.6:
  1. added a setting for instructors to choose whether to display grades to students before the assignment post date
Change in version 2.3.5:
  1. in view assignments by groups, use current user instead of earliest enrolled instructor
  2. fixed recallUrl links for confirmation pages
  3. added a check when looking up currently attached files if attempt directories don't yet exist
  4. fixed referrer URL for gradebook_view.jsp
  5. updated syntax for jsp:forward call for students to view grades
  6. use earliest enrolled TA as the instructor if nobody is enrolled with the instructor role
Change in version 2.3.4:
  1. changed the way teacher email is created to support multiple instructor schema
Change in version 2.3.3:
  1. fixed page import in modify_body.jsp
Change in version 2.3.2:
  1. changed the frameset row size for create and modify pages so those windows will fully open in IE
Changes in version 2.3.1:
  1. added web services URL to configuration page as a setting
  2. removed copy button when creating Turnitin Assignments
  3. in course copy, set orig ID to first gradebook column ID if there is only one column
  4. added support for Grader and Course Builder roles to see Turnitin Assignments as instructors
Changes in version 2.3.0:
  1. changed version number according to new numbering scheme to match other versions and their numbering schemes
  2. changed the directory in which files that instructors save for comments and notes are stored to include the user-created course ID rather than the Blackboard-created primary course ID. This is how files are stored for normal Blackboard assignments
Known Issues:
  1. 430 error when checking the status of the Building Block after properly configuring it:

    Try restarting your Blackboard server and try again
    If the problem persists or happens intermittently, search your Blackboard server(s) for the saaj.jar file. If you find any instances of the saaj.jar file in any of the other building block directories, you can take the following action:
    1. You can request from the vendor of that building block a version that has the saaj.jar file removed
    2. You can manually remove the saaj.jar file from your server (we do not guarantee that the building block will continue to function normally, but it normally does); restart your server.
    3. If problems continue to persist, contact our Helpdesk.
  2. The '!' in the Blackboard Gradebook doesn't show for a student who has submitted to a Turnitin Assignment

    Basically, what is happening is that the student is submitting a paper, and it is being received by Turnitin, but when Turnitin tries to make a web service call back into Blackboard to indicate in Blackboard that the student has submitted, the web service call fails, and the student receives the error message: "The paper was submitted successfolly to Turnitin, but the Blackboard Gradebook was not modified. The Blackboard Gradebook does not currently reflect his assignment's submission status." That means there is no exclamation mark in the Blackboard Gradebook for the Turnitin Assignment for each student that has submitted a paper and received this error message.

    The likely cause is that during the submission process, after the papers were received by Turnitin, there was an error that occurred in the web service call. What happens when a student submits to a Turnitin Assignment is that it is accepted by our system, and then a web service call is made from our Turnitin servers to the Blackboard servers to indicate in Blackboard that the student has submitted for this Turnitin Assignment, and particolarly to have that exclamation mark appear in the Blackboard Gradebook. However, there are times when that web service call can fail for one reason or another, thus making it so that Turnitin has received the paper successfolly by the indication in the Blackboard Gradebook could not be completed. This is a known issue for which happens intermittently for different institutions, and we have not been able to determine the cause or reproduce it on our own systems. We are looking for a way to reproduce this error consistently so that we can come up with a solution for it but have not been able to so far. Because the papers are still successfolly received by Turnitin, instead of giving the user a large error screen when this occurs, we just give a notice that the paper was successfolly received, but that the web service call failed.

    There isn't a solution to this problem really, or a way to get that exclamation mark to appear in the Blackboard Gradebook. We are looking into a tool that will try to resend the web service call, but we're not sure if this will work either. What you can try is having the instructor delete the submission and having the student try to submit again. If the error happens again for that student, please contact our Helpdesk.

  3. Error when trying to modify an existing Turnitin assignment or grade a submission in an existing Turnitin Assignment

    One thing to check here is if there is a corresponding Gradebook column for this Turnitin Assignment, and that Gradebook column needs to have the same title as the Turnitin Assignment. If the Gradebook column is missing or the title is different (e.g., abbreviated, etc.) this will cause the errors to occur.

  4. Copying Turnitin Assignments in Blackboard

    First off, copying Turnitin Assignments that were not created with a Turnitin building block version 2.0.5 and above will not work no matter what. It just wasn't supported back then and won't work if the original Turnitin Assignment that is being copied wasn't created with a building block that supported Course Copy.

    Secondly, using the "Copy" button that shows up next to the content item along with the "Modify", "Manage" and "Remove" buttons in the "Assignments" area in the "Control Panel" also will not work in trying to copy a Turnitin Assignment. We have added code to remove that button, but if for some reason it still shows up in that area, do not use it to copy a Turnitin Assignment.

    The only way where copying should work is from the "Control Panel", selecting the "Course Copy" feature in the "Course Options" area. If you click on that link, it will give you 3 options.

    Any one of these 3 options should work. However, if you choose "Copy Course Materials into a New Course" or "Copy Course Materials into an Existing Course", you have to be sure that you select the content area that contains the Turnitin Assignments that you want copied (e.g. Assignments) as well as the corresponding "Gradebook Items and Settings" to make sure the copy will succeed.

    Otherwise, an instructor will need to delete any copied assignments and recreate them manually.

  5. Incoming/outgoing connections with regards to the Turnitin Building Block and the Blackboard server

    For the Turnitin Building Block to work correctly, the Blackboard server needs to be able to make outgoing HTTP/HTTPS connections as well as receive incoming HTTP/HTTPS connections. One the outgoing connections, the Blackboard server is going to be trying to make connections to api.turnitin.com over the standard HTTP or HTTPS ports.

    Also, your Blackboard server needs to be able to receive incoming connections from our Turnitin servers. If you have a firewall in place that is not allowing outside connections to your Blackboard server, please check this. For your Blackboard servers, the ports 80 and 443 need to be accessible from our range of IP addresses (note, this is different from the IP address you might get when your servers try to connect to our servers).

    IPv4 Addresses (*)
       •  199.47.80-87.x
       •  174.47.2.x
       •  38.111.147.x
       •  67.203.85.x
       •  67.203.111.x

    IPv6 Addresses
       •  2620:108:E000::/44

For other Blackboard known issues please see the frequently asked questions (FAQs) at the bottom of this page.

DISCLAIMER:

Any of the information and suggestions made in this file are "try at your own risk" and iParadigms/Turnitin cannot be held responsible for any actions you take.

Bb 8.0+ (up to but not including 9.0)
Tii Bb Building Block 2.4.11

Changes in version 2.4.11
  1. Instructors now have the capability to manually sync grades from Turnitin to Blackboard which doesn't rely on the webservices calls. Instructors can click on the "Sync Grades" link next to each assignment in the "Turnitin Assignments" tool area and it will grab the grades and update the Blackboard gradebook.
  2. Just to note. This is an addition to the existing web services calls. We are still using these calls like before including updating the gradebook when students submit and when grades are entered. This feature allows the user an alternative to the current web services workflow and also allows the users to fix any gradebook issues.
  3. Instructors/Admins should use this when:
    • They want the grades from Turnitin to show up in Blackboard.
    • If the exclamation doesn't show up in Blackboard and the student has submitted
Changes in version 2.4.10
  1. added administrator setting to preserve assignment dates on copied assignments
Changes in version 2.4.9
  1. fixed issue where user couldn't remove attached files with single quotes
Changes in version 2.4.8
  1. fixed issue with students getting a blank page if an instructor user is disabled
Changes in version 2.4.7:
  1. fixed issue where administrators accessing Turnitin Assignments got a java error instead of error page
Change in version 2.4.6:
  1. added a setting for instructors to choose whether to display grades to students before the assignment post date
Changes in version 2.4.5:
  1. in view assignments by groups, use current user instead of earliest enrolled instructor
  2. fixed recallUrl links for confirmation pages
  3. added a check when looking up currently attached files if attempt directories don't yet exist
  4. fixed referrer URL for gradebook_view.jsp
  5. updated syntax for jsp:forward call for students to view grades
  6. use earliest enrolled TA as the instructor if nobody is enrolled with the instructor role
Changes in version 2.4.4:
  1. changed the way teacher email is created to support multiple instructor schema

Skipped version number 2.4.3

Skipped version number 2.4.2

Changes in version 2.4.1
  1. added web services URL to configuration page as a setting
  2. removed copy button when creating Turnitin Assignments
  3. in course copy, set orig ID to first gradebook column ID if there is only one column
  4. added support for Grader and Course Builder roles to see Turnitin Assignments as instructors
  5. check that paper ID for 'Clear Attempt' is valid value
  6. fixed attempt ID to allow students to view instructor feedback files
Changes in version 2.4.0:
  1. changed version number according to new numbering scheme to match other versions and their numbering schemes
  2. changed the directory in which files that instructors save for comments and notes are stored to include the user-created course ID rather than the Blackboard-created primary course ID. This is how files are stored for normal Blackboard assignments.
Known Issues:
  1. 430 error when checking the status of the Building Block after properly configuring it:

    Try restarting your Blackboard server and try again
    If the problem persists or happens intermittently, search your Blackboard server(s) for the saaj.jar file. If you find any instances of the saaj.jar file in any of the other building block directories, you can take the following action:
    1. You can request from the vendor of that building block a version that has the saaj.jar file removed
    2. You can manually remove the saaj.jar file from your server (we do not guarantee that the building block will continue to function normally, but it normally does); restart your server.
    3. If problems continue to persist, contact our Helpdesk.
  2. The '!' in the Blackboard Gradebook doesn't show for a student who has submitted to a Turnitin Assignment

    Basically, what is happening is that the student is submitting a paper, and it is being received by Turnitin, but when Turnitin tries to make a web service call back into Blackboard to indicate in Blackboard that the student has submitted, the web service call fails, and the student receives the error message: "The paper was submitted successfolly to Turnitin, but the Blackboard Gradebook was not modified. The Blackboard Gradebook does not currently reflect his assignment's submission status." That means there is no exclamation mark in the Blackboard Gradebook for the Turnitin Assignment for each student that has submitted a paper and received this error message.

    The likely cause is that during the submission process, after the papers were received by Turnitin, there was an error that occurred in the web service call. What happens when a student submits to a Turnitin Assignment is that it is accepted by our system, and then a web service call is made from our Turnitin servers to the Blackboard servers to indicate in Blackboard that the student has submitted for this Turnitin Assignment, and particolarly to have that exclamation mark appear in the Blackboard Gradebook. However, there are times when that web service call can fail for one reason or another, thus making it so that Turnitin has received the paper successfolly by the indication in the Blackboard Gradebook could not be completed. This is a known issue for which happens intermittently for different institutions, and we have not been able to determine the cause or reproduce it on our own systems. We are looking for a way to reproduce this error consistently so that we can come up with a solution for it but have not been able to so far. Because the papers are still successfolly received by Turnitin, instead of giving the user a large error screen when this occurs, we just give a notice that the paper was successfolly received, but that the web service call failed.

    There isn't a solution to this problem really, or a way to get that exclamation mark to appear in the Blackboard Gradebook. We are looking into a tool that will try to resend the web service call, but we're not sure if this will work either. What you can try is having the instructor delete the submission and having the student try to submit again. If the error happens again for that student, please contact our Helpdesk.

  3. Error when trying to modify an existing Turnitin assignment or grade a submission in an existing Turnitin Assignment

    One thing to check here is if there is a corresponding Gradebook column for this Turnitin Assignment, and that Gradebook column needs to have the same title as the Turnitin Assignment. If the Gradebook column is missing or the title is different (e.g., abbreviated, etc.) this will cause the errors to occur.

  4. Copying Turnitin Assignments in Blackboard

    First off, copying Turnitin Assignments that were not created with a Turnitin building block version 2.0.5 and above will not work no matter what. It just wasn't supported back then and won't work if the original Turnitin Assignment that is being copied wasn't created with a building block that supported Course Copy.

    Secondly, using the "Copy" button that shows up next to the content item along with the "Modify", "Manage" and "Remove" buttons in the "Assignments" area in the "Control Panel" also will not work in trying to copy a Turnitin Assignment. We have added code to remove that button, but if for some reason it still shows up in that area, do not use it to copy a Turnitin Assignment.

    The only way where copying should work is from the "Control Panel", selecting the "Course Copy" feature in the "Course Options" area. If you click on that link, it will give you 3 options.

    Any one of these 3 options should work. However, if you choose "Copy Course Materials into a New Course" or "Copy Course Materials into an Existing Course", you have to be sure that you select the content area that contains the Turnitin Assignments that you want copied (e.g. Assignments) as well as the corresponding "Gradebook Items and Settings" to make sure the copy will succeed.

    Any one of these 3 options should work. However, if you choose "Copy Course Materials into a New Course" or "Copy Course Materials into an Existing Course", you have to be sure that you select the content area that contains the Turnitin Assignments that you want copied (e.g. Assignments) as well as the corresponding "Gradebook Items and Settings" to make sure the copy will succeed.

    Otherwise, an instructor will need to delete any copied assignments and recreate them manually.

  5. I'm having trouble with Blackboard 8 Grade Center and Turnitin Assignments

    A known issue is that students are unable to access feedback that has been uploaded by instructors prior to the upgrade. When students view Turnitin Assignments in My Grades, the grade they have been given is not clickable, so they cannot view the additional files that have been uploaded.

    This is the known issue with Blackboard 8 and our Turnitin Building Block. Blackboard has said that it will be addressed in Service Pack 4 for Blackboard 8, but we have not been informed as to when that will be released. The way Blackboard has implemented changes to their gradebook, "comments" that have been made by the instructor should be viewable there, but "attached files" are not accessible.

  6. Incoming/outgoing connections with regards to the Turnitin Building Block and the Blackboard server

    For the Turnitin Building Block to work correctly, the Blackboard server needs to be able to make outgoing HTTP/HTTPS connections as well as receive incoming HTTP/HTTPS connections. One the outgoing connections, the Blackboard server is going to be trying to make connections to api.turnitin.com over the standard HTTP or HTTPS ports.

    Also, your Blackboard server needs to be able to receive incoming connections from our Turnitin servers. If you have a firewall in place that is not allowing outside connections to your Blackboard server, please check this. For your Blackboard servers, the ports 80 and 443 need to be accessible from our range of IP addresses (note, this is different from the IP address you might get when your servers try to connect to our servers).

    IPv4 Addresses (*)
       •  199.47.80-87.x
       •  174.47.2.x
       •  38.111.147.x
       •  67.203.85.x
       •  67.203.111.x

    IPv6 Addresses
       •  2620:108:E000::/44

For other Blackboard known issues please see the frequently asked questions (FAQs) at the bottom of this page.

DISCLAIMER:

Any of the information and suggestions made in this file are "try at your own risk" and iParadigms/Turnitin cannot be held responsible for any actions you take.

Bb 9.0+
Tii Bb Building Block 2.5.28

Changes in version 2.5.28
  1. Bug fix: No longer will sync anonymous marking submissions
  2. Bug fix: no longer update gradebook column settings if setting to display grades to students before the assignment post date doesn't change
Changes in version 2.5.27
  1. Instructors now have the capability to manually sync grades from Turnitin to Blackboard which doesn't rely on the webservices calls. Instructors can click on the "Sync Grades" link next to each assignment in the "Turnitin Assignments" tool area and it will grab the grades and update the Blackboard gradebook.
  2. Just to note. This is an addition to the existing web services calls. We are still using these calls like before including updating the gradebook when students submit and when grades are entered. This feature allows the user an alternative to the current web services workflow and also allows the users to fix any gradebook issues.
  3. Instructors/Admins should use this when:
    • They want the grades from Turnitin to show up in Blackboard.
    • If the exclamation doesn't show up in Blackboard and the student has submitted
Changes in version 2.5.26
  1. bug fixes: utf-8 issues on assignment creation, ie display issues
Changes in version 2.5.25
  1. added administrator setting to preserve assignment dates on copied assignments
Changes in version 2.5.24
  1. Allow for decimal values for grades
  2. Allow for file attachment to submissions without supplying a grade
  3. Roles with the word "Instructor" are considered Turnitin Instructors
  4. Turnitin Assignments show up now if it is the only assignment in the content area
  5. Administrators no longer get 500 error page when accessing Turnitin pages
  6. Fixed other issues with 500 error pages
Changes in version 2.5.23
  1. Fixed issue with double breadcrumb in specific versions of Blackboard 9.0 and older plugins
  2. Fixed issue where users couldn't delete papers from the GradeCenter
  3. Fixed Roster Sync issue to support UTF-8 characters
  4. Fixed issue where student users couldn't access grade info for Turnitin Assignments created with older versions of the plugin
Changes in version 2.5.22
  1. Fixed issue with double breadcrumb in specific versions of Blackboard 9.0 and older plugins
Changes in version 2.5.21
  1. Fixed issue where instructors couldn't attach files if grade wasn't assigned
  2. Fixed issue where instructors couldn't remove attachments with apostrophes in the name
Changes in version 2.5.20
  1. Fixed issue where assignments created with an older version of the plugin couldn't delete comment and feedback files
Changes in version 2.5.19
  1. Change download of instructor comment/note files to be more secure
Changes in version 2.5.18
  1. Fixed issue where students couldn't view Turnitin papers and reports
  2. Fixed issue with viewing Turnitin Assignments by Groups
Changes in version 2.5.17
  1. As of version 2.5.17 of our Building Block with Blackboard version 9.0+ we now support custom roles created within Blackboard. What this means is that the base Blackboard course roles (Student, Instructor, TA, Grader, and Course Builder) still work the same as they did before in previous versions of the Building Block. The Student role still will map to the student role in Turnitin and will only be able to view/complete a Turnitin Assignment and view their grades in the grade book. The Instructor, TA, Grader, and Course Builder role will be mapped to an instructor role in Turntiin. They will have access to all the content for the Turnitin Building Block as long as the role has access to the areas where the links and content reside within Blackboard.
    • course.content.CREATE/MODIFY/DELETE/VIEW
    • course.control_panel.view
    • course.gradebook-item.MODIFY
    Those with the privilege "course.content.CREATE/MODIFY/DELETE" will have the same respective ability with regards to Turnitin Assignments. For example, a role with only the privilege "course.content.CREATE" can only create Turnitin Assignments but cannot edit or remove the Turnitin Assignments. Roles with only course.content.VIEW will be treated as students through Turnitin. Roles with the privilege "course.control_panel.VIEW" will have access to the Turnitin tools that are located in the "Course Tools" section like viewing Turnitin Assignments and Turnitin Assignments by groups. Finally the privilege "course.gradebook-item.MODIFY" is not a privilege that can be granted directly through the Blackboard interface, it is something that is inherited from the base role that the new custom role is copied from. For example, the INSTRUCTOR role has this privilege and so any new custom role copied from it will have the privilege also. But if the new custom role is copied from the COURSE BUILDER role then since this role doesn't have the course.gradebook-item.MODIFY privilege, the new custom role will also not have this privilege. This privilege gives the user the ability to access the Blackboard grade book entries for Turnitin Assignments and give feedback and edit the grade.
Changes in version 2.5.16
  1. fix issue with Blackboard 9.1 when students view the gradebook for an assignment and the page title doesn't show correctly
  2. updated icons
Changes in version 2.5.15
  1. fix for Blackboard 9.1: creating Turnitin Assignments is in the "Create Assessment" area
Changes in version 2.5.14
  1. fixed issue with Java error when grading a submission
  2. fixed issue with IE7 and vertical scrollbar not showing up
Changes in version 2.5.13
  1. fixed issue with students getting a blank page if an instructor user is disabled
  2. fixed an issue with IE where the frame height was too small
Changes in version 2.5.12
  1. fixed an issue with small fonts with Blackboard 9.1
  2. fixed an issue where administrators accessing Turnitin Assignments got a java error instead of the error page
Changes in version 2.5.11
  1. fixed a double breadcrumb bar on the submission page for Blackboard 9.0
Changes in version 2.5.10
  1. fixed cancelUrl links in Blackboard Gradebook pages
  2. added a setting for instructors to choose whether to display grades to students before the assignment post date
Changes in version 2.5.9
  1. in view assignments by groups, use current user instead of earliest enrolled instructor
  2. fixed recallUrl links for confirmation pages
  3. use earliest enrolled TA as the instructor if nobody is enrolled with the instructor role
Changes in version 2.5.8:
  1. save all files for instructor comments and notes in the directory including the user-created course ID; if the assignment was created using an older plugin (pre-2.x.0), there was a way it could have used the directory including the Blackboard-created primary course ID
  2. when looking up files, search in directories using both the user-created course ID and the Blackboard-created primary course ID
Changes in version 2.5.7:
  1. fixed the jsp:forward call for students to view grades when using Blackboard 9.1
  2. fixed a bug when looking up currently attached files if attempt directories don't yet exist
Changes in version 2.5.6:
  1. fixed a breadcrumb link for students on the submit page to go back to the Content page
Changes in version 2.5.5:
  1. fixed a link on the page to save grades in the Blackboard Gradebook for submissions to assignments created using an old building block
Changes in version 2.5.4:
  1. changed the way teacher email is created to support multiple instructor schema

Skipped version number 2.5.3

Changes in version 2.5.2:

Made changes to accommodate for Blackboard 9
  1. added web services URL to configuration page as a setting
  2. removed copy button when creating Turnitin Assignments
  3. in course copy, set orig ID to first gradebook column ID if there is only one column
  4. added support for Grader and Course Builder roles to see Turnitin Assignments as instructors
  5. checked that paper ID for 'Clear Attempt' is valid value
  6. fixed attempt ID to allow students to view instructor feedback files
  7. fix Statistics page to support IE users
Changes in version 2.5.1:
  1. fixed pages to support IE users
  2. put Create, Modify, Submit, and View pages all within framesets
  3. set size and names for these framesets so that they open completely
  4. fixed breadcrumbs within these pages to have correct target
Changes in version 2.5.0:
  1. changed version number according to new numbering scheme to match other versions and their numbering schemes
  2. changed the directory in which files that instructors save for comments and notes are stored to include the user-created course ID rather than the Blackboard-created primary course ID. This is how files are stored for normal Blackboard assignments.
  3. made changes to accommodate for Blackboard 9
  4. fixed breadcrumb bar issues so links don't open new windows or add another breadcrumb bar to the frame
  5. fixed links in breadcrumb bar
  6. fixed paths to certain images ('OK', 'View') that resided in different places in previous versions of Blackboard
  7. fixed paths to certain images ('OK', 'View') that resided in different places in previous versions of Blackboard
  8. created new method to store files for instructor notes and comments because GradebookFileManager functions were deprecated
Known Issues:
  1. 430 error when checking the status of the Building Block after properly configuring it:

    Try restarting your Blackboard server and try again
    If the problem persists or happens intermittently, search your Blackboard server(s) for the saaj.jar file. If you find any instances of the saaj.jar file in any of the other building block directories, you can take the following action:
    1. You can request from the vendor of that building block a version that has the saaj.jar file removed
    2. You can manually remove the saaj.jar file from your server (we do not guarantee that the building block will continue to function normally, but it normally does); restart your server.
    3. If problems continue to persist, contact our Helpdesk.
  2. The '!' in the Blackboard Gradebook doesn't show for a student who has submitted to a Turnitin Assignment.

    Basically, what is happening is that the student is submitting a paper, and it is being received by Turnitin, but when Turnitin tries to make a web service call back into Blackboard to indicate in Blackboard that the student has submitted, the web service call fails, and the student receives the error message: "The paper was submitted successfully to Turnitin, but the Blackboard Gradebook was not modified. The Blackboard Gradebook does not currently reflect his assignment's submission status." That means there is no exclamation mark in the Blackboard Gradebook for the Turnitin Assignment for each student that has submitted a paper and received this error message.

    The likely cause is that during the submission process, after the papers were received by Turnitin, there was an error that occurred in the web service call. What happens when a student submits to a Turnitin Assignment is that it is accepted by our system, and then a web service call is made from our Turnitin servers to the Blackboard servers to indicate in Blackboard that the student has submitted for this Turnitin Assignment, and particularly to have that exclamation mark appear in the Blackboard Gradebook. However, there are times when that web service call can fail for one reason or another, thus making it so that Turnitin has received the paper successfully by the indication in the Blackboard Gradebook could not be completed. This is a known issue for which happens intermittently for different institutions, and we have not been able to determine the cause or reproduce it on our own systems. We are looking for a way to reproduce this error consistently so that we can come up with a solution for it but have not been able to so far. Because the papers are still successfully received by Turnitin, instead of giving the user a large error screen when this occurs, we just give a notice that the paper was successfully received, but that the web service call failed.

    There isn't a solution to this problem really, or a way to get that exclamation mark to appear in the Blackboard Gradebook. We are looking into a tool that will try to resend the web service call, but we're not sure if this will work either. What you can try is having the instructor delete the submission and having the student try to submit again. If the error happens again for that student, please contact our Helpdesk.

  3. Error when trying to modify an existing Turnitin assignment or grade a submission in an existing Turnitin Assignment.

    One thing to check here is if there is a corresponding Gradebook column for this Turnitin Assignment, and that Gradebook column needs to have the same title as the Turnitin Assignment. If the Gradebook column is missing or the title is different (e.g., abbreviated, etc.) this will cause the errors to occur.

  4. Copying Turnitin Assignments in Blackboard

    First off, copying Turnitin Assignments that were not created with a Turnitin building block version 2.0.5 and above will not work no matter what. It just wasn't supported back then and won't work if the original Turnitin Assignment that is being copied wasn't created with a building block that supported Course Copy.

    Secondly, using the "Copy" button that shows up next to the content item along with the "Modify", "Manage" and "Remove" buttons in the "Assignments" area in the "Control Panel" also will not work in trying to copy a Turnitin Assignment. We have added code to remove that button, but if for some reason it still shows up in that area, do not use it to copy a Turnitin Assignment.

    The only way where copying should work is from the "Control Panel", selecting the "Course Copy" feature in the "Course Options" area. If you click on that link, it will give you 3 options.

    Any one of these 3 options should work. However, if you choose "Copy Course Materials into a New Course" or "Copy Course Materials into an Existing Course", you have to be sure that you select the content area that contains the Turnitin Assignments that you want copied (e.g. Assignments) as well as the corresponding "Gradebook Items and Settings" to make sure the copy will succeed.

    Otherwise, an instructor will need to delete any copied assignments and recreate them manually.

  5. I'm having trouble with Blackboard 8 Grade Center and Turnitin Assignments

    A known issue is that students are unable to access feedback that has been uploaded by instructors prior to the upgrade. When students view Turnitin Assignments in My Grades, the grade they have been given is not clickable, so they cannot view the additional files that have been uploaded.

    This is the known issue with Blackboard 8 and our Turnitin Building Block. Blackboard has said that it will be addressed in Service Pack 4 for Blackboard 8, but we have not been informed as to when that will be released. The way Blackboard has implemented changes to their gradebook, "comments" that have been made by the instructor should be viewable there, but "attached files" are not accessible.

  6. Incoming/outgoing connections with regards to the Turnitin Building Block and the Blackboard server

    For the Turnitin Building Block to work correctly, the Blackboard server needs to be able to make outgoing HTTP/HTTPS connections as well as receive incoming HTTP/HTTPS connections. One the outgoing connections, the Blackboard server is going to be trying to make connections to api.turnitin.com over the standard HTTP or HTTPS ports.

    Also, your Blackboard server needs to be able to receive incoming connections from our Turnitin servers. If you have a firewall in place that is not allowing outside connections to your Blackboard server, please check this. For your Blackboard servers, the ports 80 and 443 need to be accessible from our range of IP addresses (note, this is different from the IP address you might get when your servers try to connect to our servers).

    IPv4 Addresses (*)
       •  199.47.80-87.x
       •  174.47.2.x
       •  38.111.147.x
       •  67.203.85.x
       •  67.203.111.x

    IPv6 Addresses
       •  2620:108:E000::/44

For other Blackboard known issues please see the frequently asked questions (FAQs) at the bottom of this page.

DISCLAIMER:

Any of the information and suggestions made in this file are "try at your own risk" and iParadigms/Turnitin cannot be held responsible for any actions you take.


Resources

User Manuals

Training Videos


FAQs

If the answer to your Blackboard Basic for Academic Suite/Learn question is not found here or if you have a more technical question, please view the manuals above or contact the helpdesk.

What are the differences between Blackboard Basic and Blackboard Direct?

The Blackboard Basic plugin supports the full Turnitin Suite: Originality Checking, GradeMark, and PeerMark. When this plugin has been installed users can access Turnitin from within Blackboard. This means that all instances where Turnitin is used, the actual Turnitin screen appears within Blackboard. With this plugin, papers submitted to the Turnitin assignment are only stored in Turnitin.

The Blackboard Basic plugin is recommended for customers who would like to use the full Turnitin Suite.

Although the Blackboard Basic integration incorporates all of the Turnitin functionality, some users may prefer to only work from within the Blackboard interface. Customers with such a desire can use the Blackboard Direct integration.

The Blackboard Direct plugin currently supports Turnitin Originality Checking and GradeMark. By using the Blackboard Direct plugin, all Turnitin actions have been incorporated seamlessly into the Blackboard workflow. This includes: Turnitin assignment creation, submitting papers to the assignment, and accessing Originality Reports and GradeMark. With this plugin, papers submitted to a Turnitin assignment are stored in both Blackboard and Turnitin. This plugin allows student users to access their submissions in Turnitin.

The Blackboard Direct plugin is recommended for customers who would like Turnitin to be incorporated seamlessly into the Blackboard workflow and only wish to use Turnitin Originality Checking and GradeMark. Although PeerMark is not currently available in the Blackboard Direct plugin, there are plans to include PeerMark in the future.

I get a 430 error when checking the status of the Building Block after properly configuring it, and I'm using (or updated to) Blackboard 7.2 or later.

  1. Make sure you are using the latest version of the Building Block for your version of Blackboard (at least version 2.1.4 or later).
  2. Restart your Blackboard server and check again
  3. If the problem persists or happens intermittently, search your Blackboard server(s) for the saaj.jar file. If you find any instances of the saaj.jar file in any of the other building block directories, you can take the following action:
    • You can request from the vendor of that building block a version that has the saaj.jar file removed
    • You can manually remove the saaj.jar file from your server (we do not guarantee that the building block will continue to function normally, but it normally does); restart your server.
    • If problems continue to persist, contact our Helpdesk.

Why don't I see the '!' in the Blackboard Gradebook for a student who has submitted to a Turnitin Assignment?

Basically, what is happening is that the student is submitting a paper, and it is being received by Turnitin, but when Turnitin tries to make a web service call back into Blackboard to indicate in Blackboard that the student has submitted, the web service call fails, and the student receives the error message: "The paper was submitted successfully to Turnitin, but the Blackboard Gradebook was not modified. The Blackboard Gradebook does not currently reflect his assignment's submission status." That means there is no exclamation mark in the Blackboard Gradebook for the Turnitin Assignment for each student that has submitted a paper and received this error message.

The likely cause is that during the submission process, after the papers were received by Turnitin, there was an error that occurred in the web service call. What happens when a student submits to a Turnitin Assignment is that it is accepted by our system, and then a web service call is made from our Turnitin servers to the Blackboard servers to indicate in Blackboard that the student has submitted for this Turnitin Assignment, and particularly to have that exclamation mark appear in the Blackboard Gradebook. However, there are times when that web service call can fail for one reason or another, thus making it so that Turnitin has received the paper successfully by the indication in the Blackboard Gradebook could not be completed. This is a known issue for which happens intermittently for different institutions, and we have not been able to determine the cause or reproduce it on our own systems. We are looking for a way to reproduce this error consistently so that we can come up with a solution for it but have not been able to so far. Because the papers are still successfully received by Turnitin, instead of giving the user a large error screen when this occurs, we just give a notice that the paper was successfully received, but that the web service call failed.

There isn't a solution to this problem really, or a way to get that exclamation mark to appear in the Blackboard Gradebook. We are looking into a tool that will try to resend the web service call, but we're not sure if this will work either. What you can try is having the instructor delete the submission and having the student try to submit again. If the error happens again for that student, please contact our Helpdesk.

Why am I getting an error when trying to modify an existing Turnitin Assignment or grade a submission in an existing Turnitin Assignment?

One thing to check here is if there is a corresponding Gradebook column for this Turnitin Assignment, and that Gradebook column needs to have the same title as the Turnitin Assignment. If the Gradebook column is missing or the title is different (e.g., abbreviated, etc.) this will cause the errors to occur.

How do I copy Turnitin Assignments in Blackboard?

Turnitin Assignments that were created in Blackboard using the Turnitin building block 2.0.5 or higher can be copied using any of the three options that appear when you select the "Course Copy" feature in the "Course Options" area in the "Control Panel". However, if either "Copy Course Materials into a New Course" or "Copy Course Materials into an Existing Course" is chosen, you must be certain to select the content area that contains the Turnitin Assignment you would like to copy as well as the corresponding "Gradebook Items and Settings" to ensure that the copy succeeds.

No other method of copying an assignment, including the use of the "Copy" button that appears next to the content item, is supported. Copying a Turnitin Assignment is unlikely to work with any method other than the three mentioned above.

Turnitin Assignments created in Blackboard using any Turnitin building block that was created before the 2.0.5 building block cannot be copied by any means.

NOTE: Copying of Revision, PeerMark, and Reflection assignment types is not currently supported.

I'm having trouble with Blackboard 8 Grade Center and Turnitin Assignments.

A known issue is that students are unable to access feedback that has been uploaded by instructors prior to the upgrade. When students view Turnitin Assignments in My Grades, the grade they have been given is not clickable, so they cannot view the additional files that have been uploaded. "Comments" that have been made by the instructor should be viewable there, but "attached files" are not accessible.

This is the known issue with earlier versions of service packs for Blackboard 8 and our Turnitin Building Block. It can be resolved by upgrading to Service Pack 6 or higher for Blackboard 8.

What are the restrictions for incoming/outgoing connections with regards to the Turnitin Building Block and our Blackboard server?

For the Turnitin Building Block to work correctly, the Blackboard server needs to be able to make outgoing HTTP/HTTPS connections as well as receive incoming HTTP/HTTPS connections. One the outgoing connections, the Blackboard server is going to be trying to make connections to api.turnitin.com over the standard HTTP or HTTPS ports.

Also, your Blackboard server needs to be able to receive incoming connections from our Turnitin servers. If you have a firewall in place that is not allowing outside connections to your Blackboard server, please check this. For your Blackboard servers, the ports 80 and 443 need to be accessible from our range of IP addresses (note, this is different from the IP address you might get when your servers try to connect to our servers).

IPv4 Addresses (*)
   •  199.47.80-87.x
   •  174.47.2.x
   •  38.111.147.x
   •  67.203.85.x
   •  67.203.111.x

IPv6 Addresses
   •  2620:108:E000::/44

How do I get the latest version of the Turnitin Building Block?

To download the update for the Turnitin Building Block, your Turnitin account administrator would need to follow these steps:

  1. Login in to Turnitin at www.turnitin.com (make sure that you are in as the administrator user type)
  2. Click on edit button ("gear" icon) for the account that has purchased the Turnitin Building Block
  3. Click on the "add/modify API integration information" link near the bottom of the page
  4. Click on the link to download the Turnitin Building Block

How do I deal with Error 431 due to using Windows/IIS/Active Directory Authentication?

The reason the problem is happening is because our Building Block uses web services for some of the advanced functionality, and the page that our Turnitin servers are trying to access when calling the web services is being blocked or receiving a request to log in because you are using Windows IIS/Active Directory authentication. The quickest and best way to solve the problem would be to open up the folder in IIS and remove the security on the folder. The folder should have a path like "blackboard/content/vi/bb_bb60/plugins/turn-plgnhndl/webapp" or something similar to that. It is the folder that is created when the Building Block is installed and where all the building block files live.

Does Turnitin grab user passwords from Blackboard?

No, we do not grab users' Blackboard passwords. We do store their usernames as a part of the verification process, but we do not get their passwords. The main pieces of information that we use are the user's Blackboard email address and the unique ID that gets assigned to each user within Blackboard. Because a user is logged in to Blackboard, we assume that they have already been authenticated.

Get Integration Help »

All product, organization and company names are the property of their respective owners.

Get Integration Help

Get help with configuring and troubleshooting your integration issues.