mopdf.com

Blackboard Urkund Integration APIBuilding BlockUser Guide 2012 Blackboard Inc. Proprietary and Confidential

Publication Date: November, 2016Revision 1.0Worldwide HeadquartersInternational HeadquartersBlackboard Inc.Blackboard International B.V.650 Massachusetts Avenue NWSixth FloorWashington, DC 20001-3796Paleisstraat 1-51012 RB AmsterdamThe Netherlands 1 800 424 9299 toll free US & Canada 1 202 463 4860 telephone 31 20 788 2450 (NL) telephone 1 202 463 4863 facsimile 31 20 788 2451 (NL) ight 1997-2014. Blackboard, the Blackboard logo, BbWorld, Blackboard Learn, BlackboardTransact, Blackboard Connect, the Blackboard Outcomes System, Behind the Blackboard, and ConnectED are trademarks or registered trademarks of Blackboard Inc. or its subsidiaries in the United States andother countries. U.S. Patent Numbers: 6,988,138; 7,493,396; 6,816,878.Sun , Java , JDK , JVM , JDBC , Solaris , Microsoft , Windows , Windows Server , WindowsVista , SQL Server , Internet Explorer , Oracle , Red Hat , Enterprise Linux , Apple , Mac OS ,Tiger , Leopard , Snow Leopard , Safari , Apache Tomcat , Tomcat , Mozilla , Firefox , JAWS forWindows , VMware , Xen , Wimba Pronto , Acxiom Identify-X , NBC , Follett , Wiley, WileyPLUSare trademarks or registered trademarks of their respective owners.Other product and company names mentioned herein may be the trademarks of their respective owners.No part of the contents of this manual may be reproduced or transmitted in any form or by any meanswithout the written permission of the publisher, Blackboard Inc.Blackboard Urkund Integration API Building Block Building Block - User Guide 2017 Blackboard Inc. Proprietary and ConfidentialPage 2

Table of ContentsGlossary of Terms . 4About Blackboard Urkund Integration API Building Block built by Blackboard . 5Urkund Enabled Assignment Creation . 6To create Urkund enabled Assignments as an Instructor in a course:. 6View Similarity Report . 9To view the report as an instructor . 9To view the report as a student . 11Supported document types . 12Blackboard Urkund Integration API Building Block Building Block - User Guide 2017 Blackboard Inc. Proprietary and ConfidentialPage 3

Glossary of TermsBelow is a list of abbreviations used in the document.Building BlockB2, b2BlackboardBB, Bb, bbBlackboard Urkund Integration APIurkund b2AdministratoradminBlackboard LearnBb LearnBlackboard Urkund Integration API Building Block Building Block - User Guide 2017 Blackboard Inc. Proprietary and ConfidentialPage 4

About Blackboard Urkund Integration API Building Block built by BlackboardThe Blackboard Urkund Integration API building block (also referred as RPS b2) is a course tool forStaff/Administrators in the institution.1. Instructors/Teaching Assistant can create Urkund enabled Assignments and the tool will support individual,group and anonymous assignments as normal BB assignment work flow.[Urkund enabled Assignments are similar to Online Assignments in Bb Learn.]2. To record written/document submissions through Urkund enabled Assignments via an interface in the b2 andprovide the Staff/Instructor report from Urkund on plagiarism for the document submitted.3. The students submit documents or written submission through the Urkund assignments which is sent across toUrkund for plagiarism check. Once a document has reached a final state, i.e. analyzed or in error in Urkund, thestatus of the document is recorded and shown in the course. Visibility of response data is dependent on the b2configuration and Urkund mashup tool configuration.4. A plagiarism score and report link with plagiarism details is provided by Urkund for documents submittedthrough the b2 using webservices.5. The b2 leverages REST functionality and consumes Urkund API services for checking plagiarism of documents orcontent.Blackboard Urkund Integration API Building Block Building Block - User Guide 2017 Blackboard Inc. Proprietary and ConfidentialPage 5

Urkund Enabled Assignment CreationTo create Urkund enabled Assignments as an Instructor in a course:1.Login to the Learn 9.1 system as an Instructor / TA role and access the course.2.Go to the Content Area of the course and click any course toc content folder.3.In the Course Toc Content folder, go to the ‘Assessments ‘area dropdown and click on Assignments.4.Fill the general settings as required in a normal assignment.5.Go to the VTBE editor, click on the drop down of Mashups, and locate Urkund Plagiarism Checker.Blackboard Urkund Integration API Building Block Building Block - User Guide 2017 Blackboard Inc. Proprietary and ConfidentialPage 6

6.Clicking on the Urkund Plagiarism tool shows a custom configuration page for the assignment.a) Check Submissions for potential plagiarism using URKUND: Make the assignment Urkund checked.Educator Account: This field is to be populated with the blackboard email address by default. Theinstructor can change the email address with a valid format and submit. An analysis address is createdusing the Instructor/Staff’s email address through the b2 automatically on using the mashup tool. Theeducator account will be read only if lock educator account in the settings page is enabled.b) Allow a student to view originality report means that the report sent back by Urkund on documentanalysis completion, is made available for the students and educator at the same time. The report and thesimilarity score will be available for the instructors in Feedback to Learner when grading the assignment forthe students. The similarity score for the students will be visible only after the instructor grade a studentfor the regular assignment. Similarity column will never be visible for the students in My grades.c) Include Similarity Score in Grade Center: The similarity score as returned by Urkund for plagiarism ofcontent for a document submission. This column would be added to the grade center if selected. Foranonymous assignments, the similarity column will not be visible in Grade center for the instructors.Blackboard Urkund Integration API Building Block Building Block - User Guide 2017 Blackboard Inc. Proprietary and ConfidentialPage 7

d) Submit previously received answers for plagiarism control: The option will be greyed out/disabled if nowritten/document submissions were made by a student. The option will be enabled only for theassignment that was already created and there is at least one written/document submission made by astudent and not plagiarism detected for that particular assignment. Enabling the option and thensubmitting the mash up tool page will trigger a background process which will submit thewritten/document submission to URKUND. Once the documents were submitted to URKUND, Blackboardwill treat the document status as per the normal workflow. The documents that were already submitted toURKUND will not be resent to URKUND, but this individual document resubmission will be handled fromthe Resubmit Link available from the Grading Notes.7.On submit of the configuration, an Urkund icon followed by text is displayed in the VTBE editor. If theinstructor wishes to remove/delete the icon then the instructor has to select edit option from theassignment. If the instructor removes URKUND icon during assignment creation then the assignment willnot be considered as URKUND assignment.8.The Urkund enabled Assignment has the same configuration options as that of a regular Assignment.Blackboard Urkund Integration API Building Block Building Block - User Guide 2017 Blackboard Inc. Proprietary and ConfidentialPage 8

View Similarity ReportTo view the report as an instructor1.View grade history or individual attempt of each submission to view Urkund response for assignmentsubmissions.Example: Instructor View for Urkund returned response for documents submitted by students in a course.Grade Center Regular Assignment Column User cell(click chevron) View Grade Details AttemptsThe Grading notes for instructors would contain information on response returned from Urkund for the documentssubmitted for the student. Information available would be as follows:a) Warning if any, b) Filename, c) resubmit link for the document, d) score, e) report linkWarning/Error: These are warning messages as returned by Urkund or blank and will be included only in gradingnotes for the instructor view.Filename: This is the name of the file submitted to Urkund by the student.Resubmit Link: Link to do a resubmit for the assignment’s document using the same attempt as that of thestudent. This link will be available in the grading notes for the instructors to resubmit the documents on behalf ofthe students.Score: This is the plagiarism score returned by Urkund when the document has reached Analyzed state.Report Link: This link is to access the report generated by Urkund for the document submitted by the student.Blackboard Urkund Integration API Building Block Building Block - User Guide 2017 Blackboard Inc. Proprietary and ConfidentialPage 9

2.The grading Notes can also be viewed from Grade Center Select user attempt (from the chevronavailable in the cell) of a regular assignment column Grade Assignment Click the arrow to expand andview the Grading Notes and Feedback to User. Instructor can copy the url and access it directly in thebrowser to view the report.Resubmit should be available always (irrespective of the status error or analyzed) in the Grading Notes forthe Instructor.3.Grade column: Grade column created having the name “Similarity- assignment title ”. If multipledocuments submitted for the same attempt or single document for multiple attempts the SimilarityBlackboard Urkund Integration API Building Block Building Block - User Guide 2017 Blackboard Inc. Proprietary and ConfidentialPage 10

column shall display the result as “MULTI”. In case of student submits a single document submission, thesimilarity score is displayed.To view the report as a student1. Students in their My Grades view would be able to see the below feedback from Urkund when the documentshave reached a final state in Urkund.The below image is viewed by clicking on the bubble icon for the normal assignment column.Blackboard Urkund Integration API Building Block Building Block - User Guide 2017 Blackboard Inc. Proprietary and ConfidentialPage 11

2. Students can resubmit assignments based on how the assignments have been created, i.e. multiple submissionsor single submission. This is not handled by the b2 but by the core product. Therefore, no resubmit link appears forstudents in cases of failure. Only Instructors/staff would be able to do a resubmit on their behalf in cases of failure.Supported document typesThe following document types can be submitted to the integration service.The following documenttypes can be submitted tothe integration service. Fileextension.doc.docx.sxw.ppt.pptx.pdfMime entationml.presentationapplication/pdfBlackboard Urkund Integration API Building Block Building Block - User Guide 2017 Blackboard Inc. Proprietary and ConfidentialPage 12