Knowledge Transactions
The Classic API provides knowledge transactions to create, update, delete and retrieve knowledge articles. There is also a transaction to take feedback on articles.
Limited Support/End of Life Capabilities
The Classic API has been replaced by the Alemba RestFul API. While we will continue to support the Classic API for clients that are still using it, no further development will be done.
If you need to request a hotfix or support for these features, please contact Alemba Support
Messaging transactions are also provided to send knowledge articles to Users, analysts and groups. See MessageSendMessage Transaction for more information.
KnowledgeCreate Transaction
The KnowledgeCreate transaction can be used to create a knowledge entry. The type of entry to be created can be passed as an input parameter.
Input Parameters: KnowledgeCreateRequest
Argument
Type
Mandatory
Default
Description
sID
String
No. See Transaction Login.
“”
Analyst’s current Session ID
sLoginUserID
String
No. See Transaction Login.
“”
Analyst’s Login ID
sLoginPassword
String
No. See Transaction Login.
“”
Analyst’s Password
sDatabase
String
No. See Transaction Login.
“”
Name of the ASM System for logging in.
lEntityRef
Lookup Field
Ignored
-
Ignored on Create
lEntityType
Lookup Field
No
500 (Abstract)
Knowledge Entry Type
sAbstract
String
No
“”
Knowledge Entry Abstract field.
sTitle
String
Yes
“”
Knowledge Entry title
sAdditionalInfo
String
No
“”
Knowledge Entry Additional Information field
sFreeText
String
No
“”
HTML Knowledge Body
sSolution
String
No
“”
Knowledge Entry Solution field
nCreditedItemVersion
Integer
No
0
Last major credited version of the knowledge bank entry
lStatus
Lookup Field
No
0
Knowledge Entry status
sExternalRef
String
No
“”
Knowledge Entry External Ref field
lCall
Lookup Field
No
0
Call Number linked to this Knowledge Entry
lProfileRef
Lookup Field
No
0
Knowledge Profile
bIndexSubDirs
Boolean
No
False
Flag whether to index subdirectories. Values:
True = index article and subdirectories
False = only index article
nFrequency
Integer
No
0
Frequency
nTraversalDepth
Integer
No
0
Traversal Depth
lFormat
Lookup Field
No
Plain Text
Knowledge Format. Values:
1 = Plain Text
2 = HTML
3 = Related HTML
lService
Lookup Field
No
0
Service linked to this Knowledge Entry
yLite
Yes/No
No
N
Flag whether this Knowledge Entry will be available on the Self Service Portal. Values:
Y = Knowledge entry will be available on the Self Service Portal
N = Knowledge entry will not be available on the Self Service Portal
yReviewRequired
Yes/No
No
N
Flag whether this Knowledge Entry needs to be reviewed. Values:
Y = Knowledge Entry flagged as requiring review
N = no review required
nCompositeTypeRef
Integer
No
0
Knowledge Type. The reference number provided can correspond to lower Knowledge Type tiers.
dExpires
Date/Time
No
(null)
Knowledge entry expiry date
dNextReview
Date/Time
No
(null)
Knowledge entry next review date
sComments
String
No
“”
Comments
lPartition
Lookup Field
No
Analyst’s default partition
Partition in which to create the Knowledge Entry
lSecurityProfile
Lookup Field
No
0
Security profile to apply to the Knowledge Entry
aCustomParameters
Array
No
“”
See Defining Custom Parameters.
Return Values:KnowledgeResponse
Argument
Type
Description
nEntityRef
Integer
New Knowledge Ref
sMessage
String
Error/Warning Message
Ret
APIReturn
Error/Warning Number
KnowledgeUpdate Transaction
The KnowledgeUpdate transaction can be used to modify an existing knowledge entry.
Input Parameters: KnowledgeUpdateRequest
Argument
Type
Mandatory
Default
Description
sID
String
No. See Transaction Login.
“”
Analyst’s current Session ID
sLoginUserID
String
No. See Transaction Login.
“”
Analyst’s Login ID
sLoginPassword
String
No. See Transaction Login.
“”
Analyst’s Password
sDatabase
String
No. See Transaction Login.
“”
Name of the ASM System for logging in.
lEntityRef
Lookup Field
Yes
-
Reference number of the Knowledge entry to update
lEntityType
Lookup Field
No
(As is)
Knowledge Entry Type and Major Type
sAbstract
String
No
(As is)
Knowledge Entry Abstract field.
sTitle
String
No
(As is)
Knowledge Entry title
sAdditionalInfo
String
No
(As is)
Knowledge Entry Additional Information field
sFreeText
String
No
(As is)
HTML Knowledge Body
sSolution
String
No
(As is)
Knowledge Entry Solution field
nCreditedItemVersion
Integer
No
(As is)
Last major credited version of the knowledge bank entry
lStatus
Lookup Field
No
(As is)
Knowledge Entry status
sExternalRef
String
No
(As is)
Knowledge Entry External Ref field
lCall
Lookup Field
No
(As is)
Call Number linked to this Knowledge Entry
lProfileRef
Lookup Field
No
(As is)
Knowledge Profile
bIndexSubDirs
Boolean
No
(As is)
Flag whether to index subdirectories. Values:
True = index article and subdirectories
False = only index article
nFrequency
Integer
No
(As is)
Frequency
nTraversalDepth
Integer
No
(As is)
Traversal Depth
lFormat
Lookup Field
No
(As is)
Knowledge Format. Values:
1 = Plain Text
2 = HTML
3 = Related HTML
lService
Lookup Field
No
(As is)
Service linked to this Knowledge Entry
yLite
Yes/No
No
(As is)
Flag whether this Knowledge Entry will be available on the Self Service Portal. Values:
Y = Knowledge entry will be available on the Self Service Portal
N = Knowledge entry will not be available on the Self Service Portal
yReviewRequired
Yes/No
No
(As is)
Flag whether this Knowledge Entry needs to be reviewed. Values:
Y = Knowledge Entry flagged as requiring review
N = no review required
nCompositeTypeRef
Integer
No
(As is)
Knowledge Type. The reference number provided can correspond to lower Knowledge Type tiers.
dExpires
Date/Time
No
(As is)
Knowledge entry expiry date
dNextReview
Date/Time
No
(As is)
Knowledge entry next review date
sComments
String
No
(As is)
Comments
lPartition
Lookup Field
No
(As is)
Partition in which to create the Knowledge Entry
lSecurityProfile
Lookup Field
No
0
Security profile to apply to the Knowledge Entry
aCustomParameters
Array
No
“”
See Defining Custom Parameters.
Return Values: KnowledgeResponse
See KnowledgeResponse for more information.
KnowledgeRetrieve Transaction
The KnowledgeRetrieve transaction can be used to locate and retrieve an existing knowledge entry.
Input Parameters: KnowledgeRetrieveRequest
Argument
Type
Mandatory
Default
Description
sID
String
No. See Transaction Login.
“”
Analyst’s current Session ID
sLoginUserID
String
No. See Transaction Login.
“”
Analyst’s Login ID
sLoginPassword
String
No. See Transaction Login.
“”
Analyst’s Password
sDatabase
String
No. See Transaction Login.
“”
Name of the ASM System for logging in.
lEntityRef
Lookup Field
Yes
-
Reference number of the Knowledge Entry to retrieve
aCustomParameters
Array
No
“”
See Defining Custom Parameters.
Return Values: KnowledgeEntityResponse
Argument
Type
Description
Ret
APIReturn
Error/Warning Number
sMessage
String
Error/Warning Message
ResultSet
DataSet
ResultSet containing attribute details
KnowledgeDelete Transaction
The KnowledgeDelete transaction can be used to delete an existing knowledge entry. This transaction cannot be used to update knowledge entries.
Input Parameters: KnowledgeDeleteRequest
Argument
Type
Mandatory
Default
Description
sID
String
No. See Transaction Login.
“”
Analyst’s current Session ID
sLoginUserID
String
No. See Transaction Login.
“”
Analyst’s Login ID
sLoginPassword
String
No. See Transaction Login.
“”
Analyst’s Password
sDatabase
String
No. See Transaction Login.
“”
Name of the ASM System for logging in.
lEntityRef
Lookup Field
Yes
-
Reference number of the Knowledge Entry to delete
aCustomParameters
Array
No
“”
See Defining Custom Parameters.
Return Values: KnowledgeResponse
See KnowledgeResponse for more information.
KnowledgeFeedback Transaction
The KnowledgeFeedback transaction can be used to provide feedback on a knowledge entry.
Input Parameters: KnowledgeFeedbackRequest
Argument
Type
Mandatory
Default
Description
sID
String
No. See Transaction Login.
“”
Analyst’s current Session ID
sLoginUserID
String
No. See Transaction Login.
“”
Analyst’s Login ID
sLoginPassword
String
No. See Transaction Login.
“”
Analyst’s Password
sDatabase
String
No. See Transaction Login.
“”
Name of the ASM System for logging in.
lEntityRef
Lookup Field
Yes
-
Reference number of the Knowledge Entry in which to provide feedback
sComments
String
No
“”
Feedback comments
lKnowledgeRating
Lookup Field
Yes
-
Feedback comments
aCustomParameters
Array
No
“”
See Defining Custom Parameters.
Return Values: KnowledgeResponse
See KnowledgeResponse for more information.