Read.WarningLetter
Reads an array warning letters that have the status "Created" (it means that they have been published in itslearning), when they are read, the status is set to "Received".
Input parameters
Name | Description | Type | M/O |
SiteId | Site where action will be executed. | Integer | Optional |
VendorId | VendorId. Currently not used. | Text | Optional |
PageIndex | Starts on 0 (0 is default if nothing is specified). Refers to the page number. | Integer | O |
PageSize | Size of the array that will be returned (max 100, default 100) | Integer | O |
Message request example:
<
soapenv
:Envelope
xmlns:soapenv
=
"http://schemas.xmlsoap.org/soap/envelope/"
xmlns:tem
=
"http://tempuri.org/"
xmlns:its
=
"http://schemas.datacontract.org/2004/07/Itslearning.Integration.ContentImport.Model.ServiceEntities"
>
<
soapenv
:Header/>
<
soapenv
:Body>
<
tem
:ReadWarningLetter>
<
tem
:request>
<
its
:PageIndex>0</
its
:PageIndex>
<
its
:PageSize>25</
its
:PageSize>
</
tem
:request>
</
tem
:ReadWarningLetter>
</
soapenv
:Body>
</
soapenv
:Envelope>
Output
The method returns an array of warning letters.
If the warning letter is not connected to a course, the CourseId
property will be 0
and CourseSyncKey
and CourseTitle
properties will be empty.
Message response example:
<
s
:Envelope
xmlns:s
=
"http://schemas.xmlsoap.org/soap/envelope/"
xmlns:u
=
"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
>
<
s
:Header>
<
o
:Security
s:mustUnderstand
=
"1"
xmlns:o
=
"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
>
<
u
:Timestamp
u:Id
=
"_0"
>
<
u
:Created>2012-11-05T15:15:19.514Z</
u
:Created>
<
u
:Expires>2012-11-05T15:20:19.514Z</
u
:Expires>
</
u
:Timestamp>
</
o
:Security>
</
s
:Header>
<
s
:Body>
<
ReadWarningLetterResponse
xmlns
=
"http://tempuri.org/"
>
<
ReadWarningLetterResult
xmlns:a
=
"http://schemas.datacontract.org/2004/07/Itslearning.Integration.ContentImport.Model.ServiceEntities.WarningLetter"
xmlns:i
=
"http://www.w3.org/2001/XMLSchema-instance"
>
<
CurrentPageIndex
xmlns
=
"http://schemas.datacontract.org/2004/07/Itslearning.Integration.ContentImport.Model.ServiceEntities"
>0</
CurrentPageIndex
>
<
PageSize
xmlns
=
"http://schemas.datacontract.org/2004/07/Itslearning.Integration.ContentImport.Model.ServiceEntities"
>25</
PageSize
>
<
Total
xmlns
=
"http://schemas.datacontract.org/2004/07/Itslearning.Integration.ContentImport.Model.ServiceEntities"
>2</
Total
>
<
a
:WarningLetters>
<
a
:WarningLetter>
<
a
:AuthorId>1</
a
:AuthorId>
<
a
:AuthorSyncKey>Mikael Karlsson</
a
:AuthorSyncKey>
<
a
:CourseId>1</
a
:CourseId>
<
a
:CourseSyncKey>synccourseid</
a
:CourseSyncKey>
<
a
:Id>3</
a
:Id>
<
a
:RecipientId>100</
a
:RecipientId>
<
a
:RecipientSyncKey/>
<
a
:Text><![CDATA[<
table
>.. Some text ..</
table
>]]</
a
:Text>
<
a
:Title>Final warning</
a
:Title>
<
a
:CourseTitle>Maths</
a
:CourseTitle>
<
a
:OrganisationSyncKey
i:nil
=
"true"
/>
<
a
:PublishDate>2013-05-01T11:59:48</
a
:PublishDate>
</
a
:WarningLetter>
<
a
:WarningLetter>
<
a
:AuthorId>1</
a
:AuthorId>
<
a
:AuthorSyncKey>Mikael Karlsson</
a
:AuthorSyncKey>
<
a
:CourseId>3</
a
:CourseId>
<
a
:CourseSyncKey/>
<
a
:Id>4</
a
:Id>
<
a
:RecipientId>100</
a
:RecipientId>
<
a
:RecipientSyncKey/>
<
a
:Text><![CDATA[<
table
>.. Some other text ..</
table
>]]</
a
:Text>
<
a
:Title>Title of the letter</
a
:Title>
<
a
:CourseTitle>Training</
a
:CourseTitle>
<
a
:OrganisationSyncKey>site_abc</
a
:OrganisationSyncKey>
<
a
:PublishDate>2013-05-01T11:40:18</
a
:PublishDate>
</
a
:WarningLetter>
<
a
:WarningLetter>
<
a
:AuthorId>1</
a
:AuthorId>
<
a
:AuthorSyncKey>Mikael Karlsson</
a
:AuthorSyncKey>
<
a
:CourseId>0</
a
:CourseId>
<
a
:CourseSyncKey/>
<
a
:Id>5</
a
:Id>
<
a
:RecipientId>105</
a
:RecipientId>
<
a
:RecipientSyncKey/>
<
a
:Text><![CDATA[<
table
>.. Some other text ..</
table
>]]</
a
:Text>
<
a
:Title>Title of the letter</
a
:Title>
<
a
:CourseTitle/>
<
a
:OrganisationSyncKey>site_abc</
a
:OrganisationSyncKey>
<
a
:PublishDate>2013-05-01T11:41:25</
a
:PublishDate>
</
a
:WarningLetter>
</
a
:WarningLetters>
</
ReadWarningLetterResult
>
</
ReadWarningLetterResponse
>
</
s
:Body>
</
s
:Envelope>