Difference between revisions of "Outcomes - Custom Processing Parameters"

From All n One's bxp software Wixi

Jump to: navigation, search
 
(16 intermediate revisions by the same user not shown)
Line 10: Line 10:
  
 
= MetaData Programs =  
 
= MetaData Programs =  
 +
[[File:Custom_parameter_output_001.png|thumb|400px|MetaData parameters]]
 +
 +
These are the ability to execute a MetaData program.
 +
 +
 +
Each program is split by [--Z--]
 +
 +
 +
Each parameter is split by [--Y--]
 +
 +
 +
The first parameter must be the Program Id.  All subsequent parameters within the [--Z--] represent (parameter field, value) pairs to pass to the program.
  
  
These are the ability to execute a MetaData program.
+
The structure of this parameter string is handled using the "Modify" button available to the right of the field.
  
  
  
 
= Custom Processing Parameters =
 
= Custom Processing Parameters =
 
+
[[File:Custom_parameter_output_002.png|thumb|400px|Custom Processing parameters]]
  
 
These are prescribed data functions.  Multiple functions can be put in here separated by [ [--a--]]
 
These are prescribed data functions.  Multiple functions can be put in here separated by [ [--a--]]
Line 26: Line 38:
  
 
The current implemented functions are:
 
The current implemented functions are:
 +
* eCourse
 +
* Gamification
 +
* Gamification2
 
* Lister
 
* Lister
* Gamification
 
* eCourse
 
  
  
Line 65: Line 78:
 
* Parameter(0) - Function, should always be Gamification
 
* Parameter(0) - Function, should always be Gamification
 
* Parameter(1) - Scheme Id
 
* Parameter(1) - Scheme Id
* Parameter(2) - Points
+
* Parameter(2) - Points
* Parameter(3) - Title
+
* Parameter(3) - Scheme Title
* Parameter(4) - Data
+
* Parameter(4) - Data
* Parameter(5) - Public/Private
+
* Parameter(5) - Public/Private
 +
 
 +
 
 +
The points can be a number or, using the -- notation CDA field in the record.
 +
 
 +
 
 +
 
 +
== Gamification2 ==
 +
 
 +
 
 +
Data : ''Gamification2[ [--b--]]SchemeId[ [--b--]]Points[ [--b--]]Title[ [--b--]]Data[ [--b--]]Private[ [--a--]]''
 +
 
 +
 
 +
* Parameter(0) - Function, should always be Gamification2
 +
* Parameter(1) - Scheme Id
 +
* Parameter(2) - Points
 +
* Parameter(3) - Scheme Title
 +
* Parameter(4) - Data
 +
* Parameter(5) - Public/Private
 +
* Parameter(6) - Field
 +
* Parameter(7) - Value
 +
* Parameter(8) - Condition
 +
 
 +
 
 +
The points can be a number or, using the -- notation CDA field in the record.
 +
 
 +
 
 +
For the conditions not all combinations are possible.  N/P, stands for a Not Possible combination.
 +
 
 +
 
 +
{| class=wikitable
 +
! scope="col" width="200" | Matching
 +
! scope="col" width="50" | Numeric
 +
! scope="col" width="50" | Date
 +
! scope="col" width="50" | Text
 +
|-
 +
| Exact match || Yes || Yes || Yes
 +
|-
 +
| Like || N/P || N/P || Yes
 +
|-
 +
| Starts with || Yes || Yes || Yes
 +
|-
 +
| Ends with || Yes || Yes || Yes
 +
|-
 +
| Greater Than || Yes || Yes || N/P
 +
|-
 +
| Less Than || Yes || Yes || N/P
 +
|-
 +
| Not (Exact match) || Yes || Yes || Yes
 +
|-
 +
| Not Like || N/P || N/P || Yes
 +
|-
 +
|}
  
  
Line 100: Line 165:
  
 
Permission is only give to the user logging the record.
 
Permission is only give to the user logging the record.
 +
 +
 +
As this is a security event it will automatically add to the AuditLog as "Form eCourse Unlock"
  
  

Latest revision as of 23:06, 14 December 2015

1 Overview

An outcome has a number of custom parameters for various parts of the bxp engine that can be included.


Main Menu > Form Management > Form - Outcome Manager > Outcome - Edit > Choose the form > Choose the outcome > Data Management >


2 MetaData Programs

MetaData parameters

These are the ability to execute a MetaData program.


Each program is split by [--Z--]


Each parameter is split by [--Y--]


The first parameter must be the Program Id. All subsequent parameters within the [--Z--] represent (parameter field, value) pairs to pass to the program.


The structure of this parameter string is handled using the "Modify" button available to the right of the field.


3 Custom Processing Parameters

Custom Processing parameters

These are prescribed data functions. Multiple functions can be put in here separated by [ [--a--]]


Within each function each parameter being separated by [ [--b--]]


The current implemented functions are:

  • eCourse
  • Gamification
  • Gamification2
  • Lister


3.1 Lister

Data : Lister[ [--b--]]intClient_Id[ [--b--]]Title[ [--b--]]Description[ [--b--]]Date[ [--b--]]Category[ [--b--]]Id1[ [--b--]]Id2[ [--b--]]Id3[ [--b--]]Id4[ [--b--]]eCourse[ [--a--]]


  • Parameter(0) - Function, should always be Lister
  • Parameter(1) - Id of user the listee is going to
  • Parameter(2) - Title of the listee
  • Parameter(3) - Description for the listee (Notes)
  • Parameter(4) - Deadline date
  • Parameter(5) - Category
  • Parameter(6) - Linker 1 Id
  • Parameter(7) - Linker 2 Id
  • Parameter(8) - Linker 3 Id
  • Parameter(9) - Linker 4 Id
  • Parameter(10) - eCourse Link


Replacements supported:

  • Supports --strCDA_X_field_y_Z-- notation replacement
  • intClient_Id is the Id of the current user, must have -- notation


3.2 Gamification

Data : Gamification[ [--b--]]SchemeId[ [--b--]]Points[ [--b--]]Title[ [--b--]]Data[ [--b--]]Private[ [--a--]]


  • Parameter(0) - Function, should always be Gamification
  • Parameter(1) - Scheme Id
  • Parameter(2) - Points
  • Parameter(3) - Scheme Title
  • Parameter(4) - Data
  • Parameter(5) - Public/Private


The points can be a number or, using the -- notation CDA field in the record.


3.3 Gamification2

Data : Gamification2[ [--b--]]SchemeId[ [--b--]]Points[ [--b--]]Title[ [--b--]]Data[ [--b--]]Private[ [--a--]]


  • Parameter(0) - Function, should always be Gamification2
  • Parameter(1) - Scheme Id
  • Parameter(2) - Points
  • Parameter(3) - Scheme Title
  • Parameter(4) - Data
  • Parameter(5) - Public/Private
  • Parameter(6) - Field
  • Parameter(7) - Value
  • Parameter(8) - Condition


The points can be a number or, using the -- notation CDA field in the record.


For the conditions not all combinations are possible. N/P, stands for a Not Possible combination.


Matching Numeric Date Text
Exact match Yes Yes Yes
Like N/P N/P Yes
Starts with Yes Yes Yes
Ends with Yes Yes Yes
Greater Than Yes Yes N/P
Less Than Yes Yes N/P
Not (Exact match) Yes Yes Yes
Not Like N/P N/P Yes


3.4 eCourse

Data : eCourse[ [--b--]]Engine[ [--b--]]Type[ [--b--]]BookId[ [--b--]]ChapterId[ [--b--]]PageId[ [--a--]]


  • Parameter(0) - Function, should always be eCourse
  • Parameter(1) - Engine, for control
  • Parameter(2) - Type, must be Read or Edit
  • Parameter(3) - Book Id to be accessed
  • Parameter(4) - Chapter Id to be accessed
  • Parameter(5) - Page Id to be accessed


Engine must have one of a number of keywords

  • All: Logging of this outcome unlocks the eCourse
  • Pass: If an Examination or Quality Assurance type form is "Passed", the eCourse unlocks


Type: Edit will also give Read permissions


  • If only a book Id is given Book level access will be granted
  • If a Book and Chapter Id are given, then Chapter level access will be granted.
  • If a Book, Chapter and Page Id are given, then Page level access will be granted.


Permission is only give to the user logging the record.


As this is a security event it will automatically add to the AuditLog as "Form eCourse Unlock"