Programs (Lära)

TABLE OF CONTENTS

Learning programs: program/get
Learning programs: program/getlist
Learning programs: program/geturl
Learning programs: program/getadminbranches
Learning programs: program/addadminbranches
Learning programs: program/removeadminbranches
Learning program error code descriptions

LEARNING PROGRAMS

A "learning program" brings together several courses into a structured pathway in which users register by cohort. It is represented by a tile in the catalogue and can issue a certificate when it is completed. A learning program in the API is named "program".

Learning programs: program/get

https://www.domaine.com/lmsapi/program/get

Returns an object representing a learning program in your environment.
API call address : https://.../lmsapi/program/get

Request

Example of request call content for information on a learning program:

{
  "id": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d"
}

Field descriptions

Name
Required
Comments/description
id
X
Unique identifier of the learning program.
(String type)

Response

Example of response call content for information on a learning program:

{
  "id": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d",
  "creationDate": "2018-11-20T09:30:19.417",
  "name": "Programme de Test",
  "minParticipants": 4,
  "maxParticipants": 0,
  "description": "",
  "coverId": "",
  "subscriptionType": 0,
  "enrolmentType": 0,
  "authorizationType": 0,
  "needAdminApproval": true,
  "visibilityType": 0,
  "startDate": "0001-01-01T00:00:00",
  "endDate": "0001-01-01T00:00:00",
  "showAvailableSubscriptions": true,
  "providerId": "eYlMGw7Dsq7EEUb%2f7tbtNg%3d%3d",
  "certificateId": "",
  "categoryId": "eWAFhEFBmzdeDcziVz93Ag%3d%3d",
  "credits": 0.00,
  "keywords": "",
  "createdByUserID": "4zwet3FOX5xXfHX7YFuR8w%3d%3d",
  "shortDescription": "",
  "status": 0,
  "language": 1,
  "externalLink": "",
  "taxEnabled": true,
  "isSinglePayment": true,
  "expirationType": 0,
  "daysToComplete": 0, 
  "dateToComplete": "0001-01-01T00:00:00",
  "catalogLink": "UrlToPublicCatalog",
  "lastModificationDate": "0001-01-01T00:00:00",
  "taxCountryId": 123,  
  "taxStateId": 321,
   "customFields": {
    "Champ1": "Snow",
    "Test": ""
  }
}

Field descriptions

Name 

Comments/description

id

This is the unique database identifier. (String type)

creationDate

Creation date of the learning program. (get only) String type (YYYY-MM-DDTHH:MM:SSZ)

name

Name of the learning program as displayed in the portal. (String type, between 5 and 250 characters)

 

minParticipants

Minimum number of registered users required for the learning program to take place.

(Number type)

A value of 0 means no minimum

maxParticipants

Maximum number of users who can register (if the waiting list is not enabled) 

(Number type)

A value of 0 means no maximum

description

Description of the learning program; this will be displayed in the catalogue and in the learning program.

(String type)

coverId

The identifier of the cover image of your learning program. Your item can be associated with only one cover image. (String type)

subscriptionType

Determines whether the learning program accepts registrations: 

  • 0 = Open for registration (default value) 
  • 1 = Closed 
  • 2 = Open for registration for a specific period

enrolmentType

Accepted registration types: 

  • 0 = Self-registration
  • 1 = Manual  (administrative)
  • 2 = External 

authorizationType

Accepted authorization types: 

  • 0 = Approval by an administrator
  • 1 = Automatic
 needAdminApproval
Boolean - By default this value is "false".  This value determines whether the course requires an approver to be set at the time of registration

visibilityType 

Visibility type in the catalogues

  • 0 = PublicVisibility = public, unauthenticated visitors
  • 1 = AuthenticatedVisibility = authenticated users
  • 2 = SubscribedVisibility = registered users only
  • 3 = MaskedVisibility = hidden 

(Number type)

startDate

 

This value is required if the specific SubscriptionType (2) is selected. It determines the start of the range during which registrations are accepted.

(Date type YYYY-MM-DDTHH:MM:SSZ)

endDate

This value is required if the specific SubscriptionType (2) is selected. It determines the end of the range during which registrations are accepted. 

(Date type YYYY-MM-DDTHH:MM:SSZ)

showAvailableSubscriptions

By default this value is "false". Displays the number of available and total seats in the catalogue when users register. (Boolean type)

providerId

The identifier of the service provider with which your learning program is associated. Your item can be associated with only one service provider. (String type) 

certificateId

 

Identifier of the certificate associated with the learning program. It is awarded automatically based on the completion criteria of the learning program. (String type)

categoryId

The identifier of the category with which your learning program is associated. Your item can be associated with only one category. (String type)

credits

Number of credits associated with the successful completion of this learning program. 

(Number type)

keywords

Search keywords for the learning program. Maximum 250 characters.

createdByUserID

The identifier of the user who created the learning program. (String type).

shortDescription

Short description of the learning program; this will be displayed in the catalogue.

(String type)

status

Status of the learning program.

  • 0 = Active 
  • 1 = Cancelled
  • 2 = Deleted

(Number type)

language

Language of the learning program.

  • 1 = French (Canada) 
  • 2 = English
  • 3 = French (France)
  • 4 = Spanish

 (Number type)

externalLink

Redirect URL applied to the "register" link to redirect the user to an external site for registration. Maximum 250 characters.

taxEnabled

Indicates whether taxes are enabled on the learning program.

(Boolean type)

taxCountryId

Number indicating the country of the learning program

 

 Number type (See Appendix 3: Countries and States/Provinces)

taxStateId

Number indicating the state of the learning program 

 

Number type (See Appendix 3: Countries and States/Provinces)

isSinglePayment

Indicates whether payment is made at the learning program level.

(Boolean type)

expirationType

Expiration type for the registrations of the cohorts of the learning program. 

  • 0 = No expiration
  • 1 = Number of days after registration
  • 2 = Deadline

(Number type)

daysToComplete

Number of days after registration before it expires.

(Number type)

dateToComplete

Deadline for the expiration of all the registrations of the learning program.

(Number type)

catalogLink

URL to the public catalogue page for this learning program. The URL provided points to the default portal. 

 

(Get only)

lastModificationDate

Date of the last modification of the learning program

Cannot be modified. Available in get and getlist.

customFieldsCustom fields linked to the program.

Learning programs: program/getlist

https://www.domaine.com/lmsapi/program/getlist

Returns the list of all the learning programs in your environment.
API call address : https://.../lmsapi/program/getlist

Request

Example of request call content for the list of learning programs:

{
   "filterDate": "YYYY-MM-DDTHH:MM:SSZ",
   "filterEditDate": "YYYY-MM-DDTHH:MM:SSZ"
}

Field descriptions

Name
Required
Comments/description
filterDate Optional parameter corresponding to the creation date of the element. The method returns the list of objects that were created after the date passed as a filter.
Type: String (YYYY-MM-DDTHH:MM:SSZ)
filterEditDate Optional parameter corresponding to the last modification date of the element. The method returns the list of objects that were modified after the date passed as a filter. A modification made to a learning program may correspond to:
  • Modification of the administrative settings of the learning program;
  • Addition or removal of catalogues;
Type: String (YYYY-MM-DDTHH:MM:SSZ)

Response

Example of response call content for the list of learning programs:

[
	  {
	    "id": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d",
	    "creationDate": "2018-11-20T09:30:19.417",
	    "name": "Programme de Test",
	    "minParticipants": 4,
	    "maxParticipants": 0,
	    "description": "",
	    "coverId": "",
	    "subscriptionType": 0,
	    "enrolmentType": 0,
	    "authorizationType": 0,
	    "needAdminApproval": true,
	    "visibilityType": 0,
	    "startDate": "0001-01-01T00:00:00",
	    "endDate": "0001-01-01T00:00:00",
	    "showAvailableSubscriptions": true,
	    "providerId": "eYlMGw7Dsq7EEUb%2f7tbtNg%3d%3d",
	    "certificateId": "",
	    "categoryId": "eWAFhEFBmzdeDcziVz93Ag%3d%3d",
	    "credits": 0.00,
	    "keywords": "",
	    "createdByUserID": "4zwet3FOX5xXfHX7YFuR8w%3d%3d",
	    "shortDescription": "",
	    "status": 0,
	    "language": 1,
	    "externalLink": "",
	    "isSinglePayment": true,
	    "expirationType": 0,
	    "daysToComplete": 0,
	    "dateToComplete": "0001-01-01T00:00:00",
	    "catalogLink": "UrlToPublicCatalog",
	    "lastModificationDate": "0001-01-01T00:00:00",
	    "taxEnabled": true,
	    "taxCountryId": 123,
	    "taxStateId": 321,
	    "customFields": {
	      "Champ1": "Snow",
	      "Test": ""
	    }
	  }
	]

Field descriptions

Name 

Comments/description

id

This is the unique database identifier. (String type)

creationDate

Creation date of the learning program. (get only) String type (YYYY-MM-DDTHH:MM:SSZ)

name

Name of the learning program as displayed in the portal. (String type, between 5 and 250 characters)

 

minParticipants

Minimum number of registered users required for the learning program to take place.

(Number type)

A value of 0 means no minimum

maxParticipants

Maximum number of users who can register (if the waiting list is not enabled) 

(Number type)

A value of 0 means no maximum

description

Description of the learning program; this will be displayed in the catalogue and in the learning program.

(String type)

coverId

The identifier of the cover image of your learning program. Your item can be associated with only one cover image. (String type)

subscriptionType

Determines whether the learning program accepts registrations: 

  • 0 = Open for registration (default value) 
  • 1 = Closed 
  • 2 = Open for registration for a specific period

enrolmentType

Accepted registration types: 

  • 0 = Self-registration
  • 1 = Manual  (administrative)
  • 2 = External 

authorizationType

Accepted authorization types: 

  • 0 = Approval by an administrator
  • 1 = Automatic
 needAdminApproval
Boolean - By default this value is "false".  This value determines whether the course requires an approver to be set at the time of registration

visibilityType 

Visibility type in the catalogues

  • 0 = PublicVisibility = public, unauthenticated visitors
  • 1 = AuthenticatedVisibility = authenticated users
  • 2 = SubscribedVisibility = registered users only
  • 3 = MaskedVisibility = hidden 

(Number type)

startDate

 

This value is required if the specific SubscriptionType (2) is selected. It determines the start of the range during which registrations are accepted.

(Date type YYYY-MM-DDTHH:MM:SSZ)

endDate

This value is required if the specific SubscriptionType (2) is selected. It determines the end of the range during which registrations are accepted. 

(Date type YYYY-MM-DDTHH:MM:SSZ)

showAvailableSubscriptions

By default this value is "false". Displays the number of available and total seats in the catalogue when users register. (Boolean type)

providerId

The identifier of the service provider with which your learning program is associated. Your item can be associated with only one service provider. (String type) 

certificateId

 

Identifier of the certificate associated with the learning program. It is awarded automatically based on the completion criteria of the learning program. (String type)

categoryId

The identifier of the category with which your learning program is associated. Your item can be associated with only one category. (String type)

credits

Number of credits associated with the successful completion of this learning program. 

(Number type)

keywords

Search keywords for the learning program. Maximum 250 characters.

createdByUserID

The identifier of the user who created the learning program. (String type).

shortDescription

Short description of the learning program; this will be displayed in the catalogue.

(String type)

status

Status of the learning program.

  • 0 = Active 
  • 1 = Cancelled
  • 2 = Deleted

(Number type)

language

Language of the learning program.

  • 1 = French (Canada) 
  • 2 = English
  • 3 = French (France)
  • 4 = Spanish

 (Number type)

externalLink

Redirect URL applied to the "register" link to redirect the user to an external site for registration. Maximum 250 characters.

taxEnabled

Indicates whether taxes are enabled on the learning program.

(Boolean type)

taxCountryId

Number indicating the country of the learning program

 

 Number type (See Appendix 3: Countries and States/Provinces)

taxStateId

Number indicating the state of the learning program 

 

Number type (See Appendix 3: Countries and States/Provinces)

isSinglePayment

Indicates whether payment is made at the learning program level.

(Boolean type)

expirationType

Expiration type for the registrations of the cohorts of the learning program. 

  • 0 = No expiration
  • 1 = Number of days after registration
  • 2 = Deadline

(Number type)

daysToComplete

Number of days after registration before it expires.

(Number type)

dateToComplete

Deadline for the expiration of all the registrations of the learning program.

(Number type)

catalogLink

URL to the public catalogue page for this learning program. The URL provided points to the default portal. 

 

(Get only)

lastModificationDate

Date of the last modification of the learning program

Cannot be modified. Available in get and getlist.

customFieldsCustom fields linked to the program.

Learning programs: program/geturl

https://www.domaine.com/lmsapi/program/geturl

Returns the list of public catalogue URLs for this learning program.
API call address : https://.../lmsapi/program/geturl

Request

Example of request call content for the list of public catalogue URLs for a learning program:

{
  "id": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d",
  "filterId" : "aoflemrnQ2A8DFaNy22zA%3d%3d"
}

Field descriptions

Name
Required
Comments/description
id
X
Unique identifier of the learning program.
(String type)
filterId Portal identifier used to receive only the URL of this learning program for that specific portal.
(String type)

Response

Example of response call content for the list of public catalogue URLs for a learning program:

[
  {
    "portalId": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d",
    "url": "UrlPourLePortail"
  },
  {
    "portalId": "h89s6rd8hVQ2A8DFaNy22zA%3d%3d",
    "url": "UrlPourLePortail"
  }
]

Field descriptions

NameComments/description
portalIdUnique identifier of the portal for which the URL is returned.
(String type)
urlURL to the public catalogue page of this learning program for the corresponding portal.
(String type)

Learning programs: program/getadminbranches

https://www.domaine.com/lmsapi/program/getadminbranches

Returns the list of administrative branches associated with a learning program.
API call address : https://.../lmsapi/program/getadminbranches

Request

Example of request call content for the list of administrative branches associated with a learning program:

{
  "id": "68a9Y6p%2bhVsJJBRcIMOo0w%3d%3d"
}

Field descriptions

Name
Required
Comments/description
id
X
Unique identifier of the learning program.
(String type)

Response

Example of response call content for the list of administrative branches associated with a learning program:

[
  "vrj0IrWe0HF%2bK9OKGpDF5A%3d%3d",
    "6d7yavtJwLemtOAO2HF5BQ%3d%3d"
]

Field descriptions

NameComments/description
branchesList of the unique identifiers of the administrative branches associated with the learning program.
(List of strings type)

Learning programs: program/addadminbranches

https://www.domaine.com/lmsapi/program/addadminbranches

Adds administrative branches to a learning program.
API call address : https://.../lmsapi/program/addadminbranches

Request

Example of request call content to add administrative branches to a learning program:

{
  "id": "68a9Y6p%2bhVsJJBRcIMOo0w%3d%3d",
  "branches": [
    "vrj0IrWe0HF%2bK9OKGpDF5A%3d%3d",
    "6d7yavtJwLemtOAO2HF5BQ%3d%3d"
  ]
}

Field descriptions

Name
Required
Comments/description
id
X
Unique identifier of the learning program.
(String type)
branches
X
List of the unique identifiers of the administrative branches.
(List of strings type)

Response

Example of response call content when adding administrative branches to a learning program:

{
  "id": "68a9Y6p%2bhVsJJBRcIMOo0w%3d%3d"
}

Field descriptions

NameComments/description
idUnique identifier of the learning program to which the branches were added.
(String type)

Learning programs: program/removeadminbranches

https://www.domaine.com/lmsapi/program/removeadminbranches

Removes administrative branches from a learning program.
API call address : https://.../lmsapi/program/removeadminbranches

Request

Example of request call content to remove administrative branches from a learning program:

{
  "id": "68a9Y6p%2bhVsJJBRcIMOo0w%3d%3d",
  "branches": [
    "vrj0IrWe0HF%2bK9OKGpDF5A%3d%3d",
    "6d7yavtJwLemtOAO2HF5BQ%3d%3d"
  ]
}

Field descriptions

Name
Required
Comments/description
id
X
Unique identifier of the learning program.
(String type)
branches
X
List of the unique identifiers of the administrative branches.
(List of strings type)

Response

Example of response call content when removing administrative branches from a learning program:

{
  "id": "68a9Y6p%2bhVsJJBRcIMOo0w%3d%3d"
}

Field descriptions

NameComments/description
idUnique identifier of the learning program from which the branches were removed.
(String type)


Learning program error code descriptions

Number

Message

Comments/description

1400

Required id

You must provide an identifier for the learning program.

1401

Invalid id

The identifier provided for the learning program is invalid.

1402

Invalid filterId

The identifier provided to perform the filter is invalid.

1405Invalid name lengthThe name provided for the learning program must contain between 3 and 250 characters inclusively.

1432

Missing required branches

The "branches" parameter is required.

1433

Invalid branchId

A branch identifier is invalid.

1434

Cannot remove all branches

All administrative branches of a program cannot be removed.

1435Cannot add branchesThe administrative branches cannot be added to a program because some branches have already been added. 
1436Cannot remove branchesThe administrative branches of a program cannot be removed because some branches are not associated.

1437Invalid language

The value provided for the language is invalid.


1438Invalid authorizationType
The value provided for the authorization type does not match the information provided

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.