How to get the grade from the dropbox in the API

Question

Hello,

I'm new using the brightspace api and I'm a bit lost in the data schema.

If I have a dropbox folder in a course that I can request with this request /d2l/api/le/(version)/(orgUnitId)/dropbox/folders/ (https://docs.valence.desire2learn.com/res/dropbox.html#get--d2l-api-le-(version)-(orgUnitId)-dropbox-folders-)

This dropbox is associated with a grade that I can get with this request

/d2l/api/le/(version)/(orgUnitId)/grades/ (https://docs.valence.desire2learn.com/res/grade.html#get--d2l-api-le-(version)-(orgUnitId)-grades-)

I can go from the dropbox folder to the grade using the gradeitemid but how can I go from the grade to the dropbox folder ?

Thanks for the help

Rusha.S.831 · Answer

Hello @Arald.d.320,

There's a Tools Data set that retrieves the data on all the tools that exist in the organization.

I hope this helps!

Thank you,

Rusha

Arald.d.320 · Answer

Is there a way to find which specific tool is associated with a given ToolItemId? When I retrieve a content topic the JSON data contains someting like:

"ToolId": 390000,

"ToolItemId": 50187

And 390000 is External Learning Tools (LTI) and 50187 is the tool linked to the content topic but how can I tell which? How can I map the ID to the toolname?

David.M.27 · Answer

Hi!

Grades should output a JSON block that includes the AssociatedTool identifier. AssociatedTool is part of a grade object and has its own ToolId and ToolItemId:

https://docs.valence.desire2learn.com/res/grade.html#Grade.AssociatedTool

The ToolItemId and ToolId tie back to the Content Object Topic, which gives you an ActivityId:

https://docs.valence.desire2learn.com/res/content.html

The ToolItemId is part of the ACTIVITYTPE_T table which tells you the type of activity correlated to the grade item:

https://docs.valence.desire2learn.com/res/content.html#term-ACTIVITYTYPE_T

You should be able to get the rest through the associated activity id.

I hope that this helps!

David