SAP Litmos Support

Getting Started
Knowledgebase
Community

Articles in this section

See more

Collections & Collection Listings

Avatar
Steve Cunha
  • Updated
Follow

The Collections feature provides an easy way to create, distribute and manage bundles of training. Each Collection is distributed through an entitlement record, called a Collection "Listing". A Collection can contain Assets, Courses and Learning Paths.

 

mceclip0.png

 

The Collection listing specifies who can access the Collection, how long those users can access the Collection, and the maximum number of users who can consume that Collection.

 

mceclip1.png

 

The API's documented here are for the Collections feature in Litmos.

 

 

Create a Collection 

Creates a new Collection. A collection will contain content and the content will be distributed via Collection Listings.

 

Request Uri

POST /collections?

Request Body

<Collection> 
 <Name></Name> 
 <Description></Description> 
 <DefaultListing>true/false</DefaultListing>
 <ImageURL></ImageUR> 
</Collection>

Response body

<Collection xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
 <Id></Id>
 <Name></Name> 
 <Description></Description> 
 <DefaultListing>true/false</DefaultListing>
 <ImageURL i:nil="true"/>
</Collection>

 

Delete a Collection 

Deletes a Collection. A collection contains content and the content will be distributed via a Collection Listing. The Collection cannot be deleted if it has a Collection Listing.

 

Request Uri

DELETE /collections/{collectionid}?

Response Header

200 ok

 

Add Courses to a Collection

Add course records to a collection. A collection will contain content and the content will be distributed via Collection Listings.

 

Request Uri

POST /collections/{collectionid}/courses?

Request Body

<Courses> 
  <Course> 
    <Id>string [max length 50]</Id> 
  </Course> 
  <Course> 
    <Id>string [max length 50]</Id> 
  </Course> 
  <Course> 
    <Id>string [max length 50]</Id> 
  </Course> 
  <Course> 
    <Id>string [max length 50]</Id> 
  </Course> 
  <Course> 
   <Id>string [max length 50]</Id> 
  </Course> 
</Courses>

Response Header

201 OK

 

Remove a Course from a Collection

Remove a course record from a collection. A collection will contain content and the content will be distributed via Collection Listings.

 

Request Uri

DELETE /collections/{collectionid}/courses?

Request Body

<Collection> 
  <Course> 
    <Id>string [max length 50]</Id> 
  </Course> 
</Collection>

Response Header

200 OK

 

Add Learning Paths to a Collection

Add learning path records to a collection. A collection will contain content and the content will be distributed via Collection Listings.

 

Request Uri

POST /collections/{collectionid}/learningpaths?

Request Body

<Collection> 
  <Learningpath> 
    <Id>string [max length 50]</Id> 
  </Learningpath> 
  <Learningpath>
    <Id>string [max length 50]</Id> 
  </Learningpath>  
  <Learningpath> 
    <Id>string [max length 50]</Id> 
  </Learningpath>  
  <Learningpath> 
    <Id>string [max length 50]</Id> 
  </Learningpath>  
  <Learningpath> 
   <Id>string [max length 50]</Id> 
  </Learningpath>  
</Collection>

Response Header

200 OK

 

Remove a Learning Path from a Collection

Remove a learning path record from a collection. A collection will contain content and the content will be distributed via Collection Listings.

 

Request Uri

DELETE /collections/{collectionid}/learningpath?

Request Body

<Collection> 
  <Learningpath> 
    <Id>string [max length 50]</Id> 
  </Learningpath> 
</Collection>

Response Header

200 OK

 

 

Create a Collection Listing

Creates a new Listing within a given Collection. A listing is an entitlement layer which controls which users and teams can access the Collection under that entitlement, how many total people can access it in the context of that entitlement, and how long it can be accessed for in the context of that entitlement.

 

Request Uri

POST /collectionlistings?

Request Body

<Listing> 
 <Id></Id> 
 <Name></Name> 
 <Active></Active> 
 <DurationType></DurationType> 
 <MaxUsers></MaxUsers> 
 <DurationDays></DurationDays> 
 <FixedDate></FixedDate> 
 <CollectionId>encryptedID</CollectionId> 
</Listing>

Response body

<Listing xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
 <Id></Id>
 <Name></Name>
 <Active></Active>
 <DurationType></DurationType>
 <MaxUsers></MaxUsers>
 <DurationDays></DurationDays>
 <FixedDate></FixedDate>
 <CollectionId></CollectionId>
</Listing>

 

Delete a Collection Listing

Deletes a Collection Listing. A listing is an entitlement layer which controls which users and teams can access the Collection under that entitlement, how many total people can access it in the context of that entitlement, and how long it can be accessed for in the context of that entitlement.

 

Request Uri

DELETE /collectionlistings/{collectionid}/{listingid}?

Response Header

200 ok

 

 

Get a list of Collections

Returns a list of Collections that have been created in the org.

 

Request Uri

GET /collections?

Response Body

<Collections>
  <Collection>
    <Id></Id>
    <Name></Name>
  </Collection>
  <Collection>
    <Id></Id>
    <Name></Name>
  </Collection>
</Collections>

 

Get a list of Collection Listings

Returns a list of Collection Listings that have been created for a specific Collection in the org.

 

Request Uri

GET /collectionlistings/{collectionid}?

Response Body

<Listings>
  <Listing>
    <Id></Id>
    <Name></Name>
    <Active></Active>
    <DurationType></DurationType>
    <MaxUsers></<MaxUsers>
    <DurationDays></DurationDay>
    <FixedDate></FixedDate>
  </Listing>
  <Listing>
  <Listing>
    <Id></Id>
    <Name></Name>
    <Active></Active>
    <DurationType></DurationType>
    <MaxUsers></<MaxUsers>
    <DurationDays></DurationDay>
    <FixedDate></FixedDate>
  </Listing>
</Listings>

 

Get a list of users added to a Collection Listing

Returns a list of users that have been added to a specific Collection Listing.

 

Request Uri

GET /collectionlistings/{listingid}/users?

Response Body

<ListingUsers>
  <ListingUser>
    <Id></Id>
    <FirstName></FirstName>
    <LastName></LastName>
    <Username></Username>
    <AccessTill></AccessTill>
    <Active></Active>
  </ListingUser>
  <ListingUser>
    <Id></Id>
    <FirstName></FirstName>
    <LastName></LastName>
    <Username></Username>
    <AccessTill></AccessTill>
    <Active></Active>
  </ListingUser>
</ListingUsers>

 

Add users to a Collection Listing

Specify a list of users that need to be added to a specific Collection Listing.

 

Request Uri

POST /collectionlistings/{listingid}/users?

Request Body

[
 {
 "Id": "UserId",
 "UserName": "Username",
 "FirstName": null,
 "LastName": null,
 "Active": true,
 "Email": null,
 "AccessLevel": null,
 "Brand": null
 },
 {
 "Id": "UserId",
 "UserName": "Username",
 "FirstName": null,
 "LastName": null,
 "Active": true,
 "Email": null,
 "AccessLevel": null,
 "Brand": null
 }
]

Response Body

201 Created

 

Remove a user from a Collection Listing

Specify a list of users that need to be added to a specific Collection Listing.

 

Request Uri

DELETE /collectionlistings/{listingid}/users/{userid}?

Response Header

 200 OK

 

Get a list of teams added to a Collection Listing

Returns a list of users that have been added to a specific Collection Listing.

 

Request Uri

GET /collectionlistings/{listingid}/teams?

Response Body

<Teams>
  <Team>
    <Id></Id>
    <Name></Name>
    <TeamCodeForBulkImport></TeamCodeForBulkImport>
    <ParentTeamId i:nil="true"/>
  </Team>
  <Team>
    <Id></Id>
    <Name></Name>
    <TeamCodeForBulkImport></TeamCodeForBulkImport>
    <ParentTeamId i:nil="true"/>
  </Team>
</Teams>

 

Add a Team to a Collection Listing

Add a Team to a specific Collection Listing.

 

Request Uri

POST /collectionlistings/{listingid}/team/{teamid}?

Response Header

200 OK

 

Remove a Team from a Collection Listing

Remove a team from a specific Collection Listing.

 

Request Uri

DELETE /collectionlistings/{listingid}/team/{teamid}?

Response Header

200 OK

 

Related articles

Comments

0 comments

Article is closed for comments.