This FAQ answers some of the most common questions about an upcoming change related to the Blackboard Learn Inline Grading feature, and the transition from the Crocodoc API to the New Box View API.
No, transitioning to the use of the New Box View API for the Blackboard Learn Inline Grading feature will be "all at once." This will occur when a client upgrades to one of the supported versions of Learn for which the Inline Grading capability is updated to work with the New Box View API. Any changes in the way the Inline Grading capability works due to changes to the New Box View API will be fully documented by Blackboard and included in our release notes and on help.blackboard.com to assist with change management.
On January 15th, 2018, the Crocodoc service will no longer accept new documents nor allow users to access previously submitted documents. However, the client data associated with that instance will still exist in either the Crocodoc or New Box View database. Blackboard is working with Box on an appropriate strategy for retaining and accessing Crocodoc client data after the Crocodoc EOL date, and Blackboard will provide an update when more details are available.
On January 15th, 2018, the Crocodoc service will no longer accept new documents nor allow users to access previously submitted documents. The Crocodoc experience will likely present users with a "service no longer available" screen in place of the document being requested. Blackboard is actively working with Box on an appropriate experience for users requesting documents from Crocodoc after January 15th, 2018, and Blackboard will provide an update when more details are available.
Client data that exists in Crocodoc will be accessible in the New Box View service after upgrade. The exact implementation and user experience details are still being determined. Blackboard will provide an update when more details are available
No. If you have never enabled the Inline Grading capability on your Learn instance(s), this change will have no impact.
Blackboard is working with Box on an appropriate strategy for retaining Crocodoc client data after the Crocodoc EOL date, and Blackboard will provide an update when more details are available. It is important to note that all original student submissions are stored in Learn in addition to being sent to Crocodoc for conversion and display within the Inline Grading interface. Learn course archives contain original student submissions only, a known limitation.
The current plan for the integration with the New Box View API includes the ability to archive annotations and feedback provided within the document when a course is archived. This would be an improvement over the current functionality of Crocodoc, which does not include annotations on documents when courses are archived. The technical feasibility and implementation details of this specific use case are still being investigated, and Blackboard will provide an update when more information is available.
We are finalizing the design and implementation of the Inline Grading feature using the New Box View API. The feature will work in largely the same way it does today, and the design/workflow will be largely unchanged. However, because the New Box View APIs are not exactly the same as the Crocodoc APIs, there will be some changes to the Inline Grading feature, and we will document those fully once the implementation is complete. Some expected benefits of the New Box View service are annotation capabilities for students, localization for the UI, and a significantly expanded number of supported document types.
You will be able to see the Inline Grading feature using the New Box View API when we provide the update to one of our supported releases (see earlier answer for details), and you choose to install it on a test or staging environment.
The first implementation of the New Box View service for Learn will provide the same capabilities on mobile browsers as Crocodoc. Blackboard may consider improving the experience for mobile browsers in the future. We are still working to define the implementation strategy for our native mobile apps. Blackboard will provide an update when more information is available.
While this may be possible with the New Box View API, the first implementation of the New Box View API in place of Crocodoc will not support this scenario. Blackboard may consider adding this ability in the future.
The New Box View service infrastructure is built on and served from Box's internally-managed infrastructure, similar in concept to Blackboard's Managed Hosting infrastructure. Box does not have infrastructure regions outside of the United States at this time.
In order to provide certain functionality and capabilities within our products, Blackboard occasionally integrates third-party technologies to augment our internally developed tools. In the case of Box, Blackboard maintains the relationship with the vendor and responsibility of adhering to its policies. This means that customers will not be required to enter into a separate agreement with Box, and Blackboard will be the sole point of responsibility for the handling of user data. Blackboard customers’ usage of the Crocodoc service within Blackboard Learn is covered in this way today, and this relationship and expectation will remain in place when customers transition to using the New Box View service.
While the Crocodoc service will technically reach “end of life,” the databases containing submitted student data and documents will not be deleted or destroyed – this means that the data will still be available for migrations that occur after the EOL date, as well as for critical situations such as grade challenges. This does not mean that we will be honoring requests to retrieve individual papers on a regular basis, and the data persisting in Crocodoc does not imply the ability to continue using the service in any way beyond Jan 15, 2018.
Blackboard is still working with Box to define a long-term strategy for decommissioning Crocodoc servers permanently, but there is not a current timeline available and no expectation of near-term decommissioning.
After the EOL date and during the migration, the Crocodoc service will display a user-friendly splash page informing users of the unavailability of the service.
The New Box View service will completely replace the Crocodoc feature in exactly the same locations within Learn, with the same general user experience and interface elements. There will be some slight differences in the UI, primarily more streamlined buttons and options.
Customers should not expect significant change management for their users, and it is likely some users may not notice the change at all. Screenshots will be provided as a part of formal documentation with the Q4 2017 release and relevant CUs.
Blackboard is building proprietary, internal tools to assist clients in the data migration process with the goal of making the transition from Crocodoc to the New Box View service a “one click” activity to make the transition as easy as possible. These internal tools will be transparent to Learn clients and Administrators.
This means that Administrators will not need to take on additional work to enable the move between the two services. The switch for initiating the transition from Crocodoc to the New Box View Service will be available within the config settings for the Inline Grading Building Block after the relevant CU or Q4 2017 release.
When the switch mentioned above is triggered, the Crocodoc service will not be available during the migration; however, the Learn instance as a whole and all other functions of the system will be available. The transition between Crocodoc and the New Box View services will vary based on the number of documents submitted to the service by each client, but is not expected to take longer than 3-4 hours.
Our guidance to customers will be to perform the transition between the two services during an off-academic period where grading and feedback are not occurring (early morning hours are acceptable); this will help eliminate possible confusion for users when interacting with the Inline Grading workflows. The expected unavailability of the Crocodoc service should be considered immediately after the Learn instance is updated and as an addendum to the planned downtime for the Learn instance.
There are a number of complex and nuanced use cases relating to Grades being marked "complete", Anonymous Grading, and Delegated Grading functionality. These exact use cases and the expected behavior of these features based on when a document is submitted (before or after Crocodoc EOL) will be included in the formal documentation provided with the Q4 2017 release and relevant CUs.
As stated in the previous article, Frequently Asked Questions: Inline Grading and the Transition from Crocodoc to the New Box View API, CUs for previous versions of Learn will be available in the same timeframe as Q4 2017 which will be October. Given the time between today and October, we cannot provide exact dates for CUs or Q4 2017 yet – however, as soon as we finalize release dates for Q4 2017 and CUs for older Learn versions we will provide an additional update.
Box has announced the Crocodoc EOL date, not Blackboard. There is no flexibility on this date and is outside of Blackboard’s control.