- 03 Jun 2022
- 1 Minute to read
- Print
- DarkLight
MackinVIA Adapter Actions
- Updated on 03 Jun 2022
- 1 Minute to read
- Print
- DarkLight
MackinVIA Adapter Actions
defineMackinVIAConnection
Define a connection to a MackinVIA Server.
Property | Value | Description |
url* | text, expression, variable | the Base URL of the MackinVIA REST service |
apiUsername* | text, expression, variable | API userName for authentication to the MackinVIA REST service |
apiKey* | password, string, expression, variable | Secret key for authentication to the MackinVIA REST service |
options | expression, variable | A record or JavaScript object with a field for each additional option. Currently defined fields are connectTimeout and socketTime which require a numeric value from 1 to 2147483647 (0x7FFFFFFF) that represents the number of milliseconds for the timeout, and 0 representing no timeout. |
returnVariable | expression, variable | name of the variable to be assigned to the return value |
Global.MackinURL = "https://dss.mackinvia.com/"
Global.MackinApiUser = "MyMackinAdmin"
Global.MackinApiKey = <password>
conn = defineMackinVIAConnection(Global.MackinURL,
Global.MackinApiUser, Global.MackinApiKey)
deleteMackinVIAUser
Delete a given MackinVIA User.
Property | Value | Description |
connection* | expression, variable | the MackinVIA connection definition |
accountID* | text, expression, variable | The accountID of the User |
userName* | text, expression, variable | The userName of the User |
returnVariable | expression, variable | name of the variable to be assigned to the return value |
deleted = deleteMackinVIAUser(conn, Global.MackinAccountId, username)
getMackinVIAUser
Get a given MackinVIA User.
Property | Value | Description |
connection* | expression, variable | the MackinVIA connection definition |
accountID* | text, expression, variable | The accountID of the User |
userName* | text, expression, variable | The userName of the User |
returnVariable | expression, variable | name of the variable to be assigned to the return value |
userRecord = getMackinVIAUser(conn, Global.MackinAccountId, username)
getMackinVIAUsers
Get MackinVIA Users.
Property | Value | Description |
connection* | expression, variable | the MackinVIA connection definition |
accountID* | text, expression, variable | The accountID of the s |
lastNamePrefix | text, expression, variable | Lastname prefix of Users |
returnVariable | expression, variable | name of the variable to be assigned to the return value |
userRecords = getMackinVIAUsers(conn, Global.MackinAccountId, "Jones")
moveMackinVIAUser
Move a given MackinVIA User to a different Account.
Property | Value | Description |
connection* | expression, variable | the MackinVIA connection definition |
accountID* | text, expression, variable | The original accountID of the User |
userName* | text, expression, variable | The userName of the User |
newAccountID* | text, expression, variable | The new accountID of the User |
returnVariable | expression, variable | name of the variable to be assigned to the return value |
moved = moveMackinVIAUser(conn, Global.MackinAccountId, username,
Global.OtherMackinAccountId)
renameMackinVIAUser
Rename a given MackinVIA User.
Property | Value | Description |
connection* | expression, variable | the MackinVIA connection definition |
accountID* | text, expression, variable | The accountID of the User |
userName* | text, expression, variable | The original userName of the User |
newUserName* | text, expression, variable | The new userName of the User |
returnVariable | expression, variable | name of the variable to be assigned to the return value |
renamed = renameMackinVIAUser(conn, Global.MackinAccountId,
username, newUsername)
saveMackinVIAUser
Create or update a given MackinVIA User.
Property | Value | Description |
connection* | expression, variable | the MackinVIA connection definition |
record* | expression, variable | the User record |
returnVariable | expression, variable | name of the variable to be assigned to the return value |
userTemplate = createRecord(false)
setRecordFieldValue(userTemplate, "accountID", Global.MackinAccountId)
setRecordFieldValue(userTemplate, "userName", username)
setRecordFieldValue(userTemplate, "password",<Password>)
created = saveMackinVIAUser(conn, userTemplate)
Supported MackinVIA User Record Fields
Field | Read-Only | Description |
accountID | Y | the account id of the school or organization the user is associated with |
userName | N | the user name of the User (required for create) |
password | N | the User password (required for create / write-only) |
lastName | N | the last name of the User |
firstName | N | the first name of the User |
middleName | N | the middle name of the User |
active | N | “True” if the User is active, “False” otherwise |
emailAddress | N | the email address of the User |