D2L API for News SortOrder Attribute Issue?

Question

Hello,

Any D2L experts or internal folks here who can explain to me how the SortOrder attribute is supposed to work for the GET /d2l/api/le/(version)/(orgUnitId)/news/ that returns

https://docs.valence.desire2learn.com/res/news.html#News.NewsItem

?

In my initial testing, I see multiple News Items being returned with the exact same value here even after pinning. Multiple items with SortOrder = 0, etc.

I was hoping that this would solve the problem I had about not being able to determine which Pinned item to display first in a custom front-end (because I was told in my PIE item that this attribute should solve it).  I'm just really confused about what this number is doing, and honestly I don't see any value in it at all (which makes me feel like I must be missing something).

Nathan.G.332 · Answer

Thanks @Johnny.B.962!

Just wanted to say that I really appreciate your time and patience walking me through this API functionality! Even though it wasn't the "answer" I was hoping for, that's certainly not your fault. That's just how the API works for now. Hopefully my suggestion in PIE about incorporating Pinned timestamp logic into SortOrder will be considered for the future as well. :)

Johnny.B.962 · Answer

@Nathan.G.332, "Are you suggesting that I have to use the "Reorder" action within the Announcements tool before any of these values will change from the default?" - Yes that is exactly what I'm saying.

Regarding that PIE item, I'd suggest just making that same comment you made here, on the PIE item itself. Our development team does look at those, even on items that have been released. So if there's something that you think wasn't addressed, you could go ahead and make a new PIE item, but you can also just comment on the existing one if you think it needs to be clarified further.

-Johnny

D2L LAM

Nathan.G.332 · Answer

@Johnny.B.962

I guess I have a follow-up question in that case… I had previously created PIE Item D10662 which was marked as "Released" based on the functionality of the SortOrder attribute we've discussed. Here was my original request in that PIE item:

Regarding the new IsPinned attribute. ﻿If there are multiple Announcements which have been pinned - I'm not seeing a way to properly determine which of them is most recent. This is necessary to determine which should be at the very top of the Pinned Announcement set.

In the Brightspace front-end, I can see that the most recent Pin is respected even when I leave the course and return. So clearly a timestamp or some other sorting mechanism exists behind the front end, but I don't see that represented with the new API implementation.

﻿This can be implemented in a few different ways:

﻿1) ﻿Use a timestamp similiar to how Course Pinning already works with ﻿a ﻿PinDate attribute.

﻿2) Introduce a SortOrder attribute similar to how Content > Modules and Topics already works.

Given that the SortOrder doesn't actually do anything when an item is Pinned - my PIE item shouldn't really be considered "Released" then. Is there a way that the status can be changed back? Or is my only option to re-create the exact same request as a new item?