Examples
One of the challenges with adopting a new integration is coming up to speed on the basics of interacting with the partner system. To lower the slope of the learning curve, Academic Benchmarks has documented examples and developed apps. We are sharing the source to give developer's working examples of how to integrate with AB Connect.
Below are brief descriptions of efficient means for implementing solutions and useful examples apps with links to the Instructure Github repository where they can be downloaded. All samples and apps are offered as-is with no warranty. Although they are often usable as is, the main purpose is to illustrate how to interact with the AB Connect API. If any particular app doesn't do what you need, feel free to download a copy and modify it to meet your needs. This repository is not meant to host solutions for non-technical users nor is it a location to submit requests for changes or additions to the API or the samples listed here. Be sure to read the ReadMe for each app for details.
Standards Relationships Browser
Simple Standards Browser
Browse Standards by Topic
Show Alignments On Your Content Page
Content Browser
Standards Relationships Report
This example is similar to the browser app but is a node.js based and generates a report with a mapping of a set of Standards from one document to another. The input and output are done through Excel files. There is a template supplied as part of the repository. You'll need to use another means for gathering the input which is a set of Standard GUIDs. One quick way to build the list is to use something like Postman to gather the Standards of interest. You can find the source in the relationships-report folder of our public repository.
Standards Browser Widget Source
The source for the Standards Browser Widget documented in Using AB Connect's Embeddable Widgets is accessable as well. This is a more complex example that spends more effort on the quality of the look and user experience. Where the other examples are good for accelerating API ramp up, the widget source code is best suited to situations where the widget itself is close to meeting your organization's needs but you need to add or modify some features. In that case, start with the existing widget and extend it to meet your needs. You can download the latest source here.
Here are basic instructions for building the supplied source for distribution. All commands must be executed in the directory where you've unzipped the source.
Download the source from here.
Unzip the file into a folder on your system.
Run the following commands in the folder where you placed the unzipped source.
npm install
npm run build
Use dist/widgets.js and dist/widgets.js.map
To obtain a production widgets bundle, follow these steps:
For a bash shell:
NODE_ENV=production npm run build
For Windows cmd.exe:
set NODE_ENV=production
npm run build
Use dist/widgets.js
Postman Collections
The illustrative-postman-collections folder in our public repository hosts a set of Postman collections that can help get you started with API calls for various scenarios. The ReadMe file gives the details of the available collections.
Last updated