c_SSPInterface

Description

Part of ServicePortal API Library, documentation: https://confluence.kpn.org/display/SNBR/API+Library

Note: Create functions with a maximum of 1 parameters for now, to be able to use the REST interface

Methods


<static> getMenuItemList() → {Array.<MenuItem>}

Description

Retrieve the portal configuration object

Returns

Configuration object


<static> getIncidentTopic( params ) → {FormDefinition}

Description

Get Incident Topic details with all the data required to fill out an incident form

Parameters
Name Type Description
params Object

Selected topic from the DropDown (IncDef translation)

Name Type Description
keyValue sys_id

SysId of the incident topic

Returns

Incident form object if all parameters are provided and valid otherwise undefined


<static> getIncidentTopicList() → {ListItemPage}

Description

Retrieve a list of topics and categories with optional filters applied

Returns

<static> registerIncident( formDefinition ) → {FormResponse}

Description

Register an incident based on a topic form

Parameters
Name Type Description
formDefinition FormDefinition
Returns

<static> getKnowledgeArticle( params ) → {KnowledgeArticle}

Description

Retrieve a Knowledge article by sysId or number

Parameters
Name Type Description
params ListItem

<static> getKnowledgeList() → {ListItemPage}

Description

Get a list of articles and categories based on a filter

Returns

<static> addKnowledgeFeedback( feedback ) → {string}

Description

Add feedback to a knowledge article and returns

Parameters
Name Type Description
feedback Object
Properties
Name Type Description
feedback.articleSysId sys_id
feedback.comment string
feedback.useful boolean
Returns

<static> getMostViewedKnowledgeList() → {Array.<ListItem>}

Description

Gte a list of most viewed and recent articles

Returns

<static> registerCase( form ) → {FormResponse}

Description

Create a case from a submitted form

Parameters
Name Type Description
form FormDefinition

Submitted form

Returns

<static> lookupProduct( filter ) → {Array.<Choice>}

Description

Lookup CSM product

Parameters
Name Type Description
filter FilterOptions
Returns

<static> lookupInstallBase( filter ) → {Array.<Choice>}

Description

Lookup CSM Install base

Parameters
Name Type Description
filter FilterOptions
Returns

<static> getLastUsedRequestList() → {Array.<ListItem>}

Description

Get the last used requests (maximum 10)

Returns

<static> getRecentRequestList() → {Array.<ListItem>}

Description

Get the most recent rquested items

Returns

<static> _setFilterDefaults( filter ) → {FilterOptions}

Description

Set default filter values if not provided

Parameters
Name Type Description
filter FilterOptions
Returns

<static> getRequestItemList() → {ListItemPage}

Description

Get everything for the Request page

Returns

<static> getRequestItem( item ) → {Request}

Description

Retrieve an item object

Parameters
Name Type Description
item ListItem
Returns

<static> getPopularRequestList() → {Array.<ListItem>}

Description

Get a list of most used, latest used request items

Returns

<static> getPinnedArticleList() → {Array.<ListItem>}

Description

Get maximum 5 randomly pinned articles for this user

Returns

<static> getTicket( ticket ) → {Ticket}

Description

Retrieve details for a status ticket

Parameters
Name Type Description
ticket ListItem
Returns

<static> addTicketComment( form ) → {FormResponse}

Description

Add a comment to a ticket

Parameters
Name Type Description
form FormDefinition
Returns

<static> getRecentIncidentList() → {Array.<ListItem>}

Description

Get the most recent activities on your incidents

Returns

<static> getTicketList( input ) → {Array.<ListItem>}

Description

Get a list of all tickets for the current user, limits to 5000 tickets per type, maximum 3 months old in updates

Parameters
Name Type Description
input QueryInput
Returns

<static> getRecentTicketList() → {Array.<ListItem>}

Description

Get a list of recent tickets for interest of the user, eg based on changes, status etc.

Returns

<static> lookupUser( filter ) → {Array.<ListItem>}

Description

Lookup a user based on the provider filter (always in users own company)

Parameters
Name Type Description
filter FilterOptions
Returns

<static> lookupCI( filter ) → {Array.<ListItem>}

Description

Lookup a CI based on the provider filter (always in users own company)

Parameters
Name Type Description
filter FilterOptions
Returns

<static> lookupService( filter ) → {Array.<ListItem>}

Description

Lookup a CI based on the provider filter (always in users own company)

Parameters
Name Type Description
filter FilterOptions
Returns

<static> submitSurvey( survey ) → {FormResponse}

Description

Submit the results of a survey taken

Parameters
Name Type Description
survey Object
Properties
Name Type Description
survey.survey Survey
survey.values Object
Returns

<static> getSurvey( input ) → {Survey}

Description

Retrieve a survey that is relevant for the provided input, delivers a null object if nothing relavant was found. The Survey will always be relevant or targeted at the current user

Parameters
Name Type Description
input Object
Properties
Name Type Description
input.documentId sys_id | undefined

Provide a document Id if survey must be related to it

input.ticketType TicketType | undefined

Restrict searches to only a particular ticket type

input.started boolean | undefined

Restrict to started surveys only

Returns

<static> setLanguage( input )

Description

Change the session/user language

Parameters
Name Type Description
input Object
Properties
Name Type Description
language LanguagType

<static> addFeedback( form ) → {FormResponse}

Description

User feedback

Parameters
Name Type Description
form FormDefinition
Returns

<static> registerComplaint( form ) → {FormResponse}

Description

Register complaint

Parameters
Name Type Description
form FormDefinition
Returns

<static> updateApproval( input ) → {string}

Description

Update Approval data

Parameters
Name Type Description
input Object
Properties
Name Type Description
input.keyValue sys_id
input.action "comment" | "reject" | "approve"
input.comment string
Returns

<static> uploadAttachment( input ) → {Array.<Attachment>}

Description

Upload attachment for a document and returns the updated attachment list

Parameters
Name Type Description
input AttachmentInput
Returns

<static> clearAttachments( input ) → {Array.<Attachment>}

Description

Clear all attachments from a document and returns the updated (should be empty) attachment list

Parameters
Name Type Description
input AttachmentInput
Returns

<static> removeAttachment( input ) → {Array.<Attachment>}

Description

Remove attachment for a document and returns the updated attachment list

Parameters
Name Type Description
input AttachmentInput
Returns

<static> updateAttachment( input ) → {Object}

Description

Update attachment for a document and returns the updated attachment list

Parameters
Name Type Description
input AttachmentInput
Returns