# Call Transactions

{% hint style="warning" %}
**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 [<mark style="color:blue;">**Alemba Support**</mark>](https://alemba.help/production/Portal.aspx)
{% endhint %}

Timesheet transactions are provided for updating existing calls.

Availability transactions are provided to find outages linked to existing calls.

When calls are created, there is an option to pass a list of CMDB Items against which an outage can be created. If possible, the API will create an outage against the specified items.  If the transaction is unable to create an outage against the specified item, it may return an error.

### CallCreate Transaction

The CallCreate transaction can be used to log a call. A call template can be specified to log a call.

#### Input Parameters: CallCreateRequest

<table data-header-hidden><thead><tr><th></th><th width="116"></th><th></th><th width="96"></th><th></th></tr></thead><tbody><tr><td>Argument</td><td>Type</td><td>Mandatory</td><td>Default</td><td>Description</td></tr><tr><td>sID</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s current Session ID</td></tr><tr><td>sLoginUserID</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s Login ID</td></tr><tr><td>sLoginPassword</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s Password</td></tr><tr><td>sDatabase</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Name of the ASM System for logging in.</td></tr><tr><td>lEntityRef</td><td>Lookup Field</td><td>Ignored</td><td>-</td><td>Ignored on Create</td></tr><tr><td>lTemplateRef</td><td>Lookup Field</td><td>No</td><td>0</td><td>Call Template used to log the call</td></tr><tr><td>sCallRef</td><td>String</td><td>No</td><td>“”</td><td>Call Ref on the call</td></tr><tr><td>lCustomer</td><td>Lookup Field</td><td>No</td><td>0</td><td>User on the call</td></tr><tr><td>lLocation</td><td>Lookup Field</td><td>No</td><td>0</td><td>Location on the call</td></tr><tr><td>lOrganization</td><td>Lookup Field</td><td>No</td><td>0</td><td>Organization on the call</td></tr><tr><td>lConfigItem</td><td>Lookup Field</td><td>No</td><td>0</td><td>Config Item on the call</td></tr><tr><td>lFwdOfficer</td><td>Lookup Field</td><td>No</td><td>0</td><td>Analyst to which this call will be assigned</td></tr><tr><td>lService</td><td>Lookup Field</td><td>No</td><td>0</td><td>Service on the call</td></tr><tr><td>lServiceAction</td><td>Lookup Field</td><td>No</td><td>0</td><td>Service Action on the call</td></tr><tr><td>lServiceBundle</td><td>Lookup Field</td><td>No</td><td>0</td><td>Service Bundle on the call</td></tr><tr><td>lImpact</td><td>Lookup Field</td><td>No</td><td>0</td><td>Call Impact</td></tr><tr><td>lPriority</td><td>Lookup Field</td><td>No</td><td>0</td><td>Call Priority</td></tr><tr><td>lUrgency</td><td>Lookup Field</td><td>No</td><td>0</td><td>Call Urgency</td></tr><tr><td>lFwdGroup</td><td>Lookup Field</td><td>No</td><td>0</td><td>Group to which this call will be assigned</td></tr><tr><td>lIPKStatus</td><td>Lookup Field</td><td>No</td><td>Analyst’s default IPK status</td><td>IPK status applied to the call</td></tr><tr><td>lIPKStream</td><td>Lookup Field</td><td>No</td><td>Analyst’s default IPK stream</td><td>IPK stream applied to the call</td></tr><tr><td>sActionDescription</td><td>String</td><td>No</td><td>“”</td><td>Action &#x26; Solution history entry</td></tr><tr><td>sProblemDescription</td><td>String</td><td>No</td><td>“”</td><td>Call Description</td></tr><tr><td>yPortal</td><td></td><td>No</td><td>N</td><td><p>Display this Action &#x26; Solution history entry on Self Service Portal? Values:</p><ul><li>Y = display this Action &#x26; Solution history entry on the Portal</li><li>N = do not display this Action &#x26; Solution history entry on the Portal</li></ul></td></tr><tr><td>lType</td><td>Lookup Field</td><td>No</td><td>0</td><td>Call Issue Type</td></tr><tr><td>dActionEnd</td><td>Date/Time</td><td>No</td><td>Now</td><td>Action End Date</td></tr><tr><td>dActionStart</td><td>Date/Time</td><td>No</td><td>Now</td><td>Action Start Date</td></tr><tr><td>lActionType</td><td>Lookup Field</td><td>No</td><td>0</td><td>Action Type corresponding to the Action &#x26; Solution history entry</td></tr><tr><td>nEstimatedHours</td><td>Integer</td><td>No</td><td>Uses the difference between the Action Start and Action End</td><td>Action &#x26; Solution recorded time spent</td></tr><tr><td>nEstimatedMins</td><td>Integer</td><td>No</td><td>Uses the difference between the Action Start and Action End</td><td>Action &#x26; Solution recorded time spent</td></tr><tr><td>nExpenses</td><td>Integer</td><td>No</td><td>0</td><td>Action &#x26; Solution recorded expenditure</td></tr><tr><td>bCreateOutage</td><td>Boolean</td><td>No</td><td>False</td><td>Create an outage against the specified CMDB item or Service and link it to this call. Values:</td></tr><tr><td>dOutageEnd</td><td>Date/Time</td><td>No</td><td>(NULL)</td><td><p>Outage end date; if entered, this date must be in the past.</p><p>Outage end date is entered in the logging analyst’s time zone.</p></td></tr><tr><td>dOutageStart</td><td>Date/Time</td><td>No</td><td>Now – if Create Outage was selected</td><td><p>Outage start date.</p><p>Outage start date is entered in the logging analyst’s time zone.</p></td></tr><tr><td>lOutageType</td><td>Lookup Field</td><td>No</td><td><p>Unspecified</p><p>Unplanned</p></td><td>Outage Type. This must be an unplanned Outage Type.</td></tr><tr><td>sOutageDesc</td><td>String</td><td>No</td><td>“”</td><td>Description of the created outage</td></tr><tr><td>sOutageItemList</td><td>String</td><td>No</td><td>“”</td><td><p>List of CMDB items or Services linked to the call (or dependent on these CI) against which to create the outage.</p><p>These outages will be linked to the call.</p></td></tr><tr><td>lCallStatus</td><td>Lookup Field</td><td>No</td><td>0</td><td>Call Status</td></tr><tr><td>lPartition</td><td>Lookup Field</td><td>No</td><td>Analyst’s default partition</td><td><p>Call Partition.</p><p>Ignored if a call template is specified, to which the partition on the template is used.</p></td></tr><tr><td>lSecurity</td><td>Lookup Field</td><td>No</td><td>0</td><td>Security Profile applied to the Action &#x26; Solution history entry.</td></tr><tr><td>bSendEmail</td><td>Boolean</td><td>No</td><td>False</td><td><p>Send an email to the assigned analyst/group regarding this call. Values:</p><ul><li>True = send an email to the assigned analyst/group</li><li>False = no email is sent</li></ul></td></tr><tr><td>bSendPager</td><td>Boolean</td><td>No</td><td>False</td><td><p>Send a pager message to the assigned analyst/group regarding this call. Values:</p><ul><li>True = send a pager message to the assigned analyst/group</li><li>False = no pager message is sent</li></ul></td></tr><tr><td>aCustomParameters</td><td>Array</td><td>No</td><td>“”</td><td>See Defining Custom Parameters.</td></tr></tbody></table>

#### Return Values:CallResponse <a href="#callresponse" id="callresponse"></a>

| Argument   | Type      | Description           |
| ---------- | --------- | --------------------- |
| nEntityRef | Integer   | New Call Number       |
| sMessage   | String    | Error/Warning Message |
| Ret        | APIReturn | Error/Warning Number  |

### CallUpdate Transaction

The CallUpdate transaction can be used to update and defer a call.

#### Input Parameters: CallUpdateRequest

**CallUpdateRequest**

| 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                        | -                                                           | Call to update                                                                                                                                                                                                                                    |
| lTemplateRef        | Lookup Field | No                         | (As is)                                                     | Call Template used to log the call                                                                                                                                                                                                                |
| sCallRef            | String       | No                         | (As is)                                                     | Call Ref on the call                                                                                                                                                                                                                              |
| lCustomer           | Lookup Field | No                         | (As is)                                                     | User on the call                                                                                                                                                                                                                                  |
| lLocation           | Lookup Field | No                         | (As is)                                                     | Location on the call                                                                                                                                                                                                                              |
| lOrganization       | Lookup Field | No                         | (As is)                                                     | Organization on the call                                                                                                                                                                                                                          |
| lConfigItem         | Lookup Field | No                         | (As is)                                                     | Config Item on the call                                                                                                                                                                                                                           |
| lFwdOfficer         | Lookup Field | No                         | (As is)                                                     | Analyst to which this call will be assigned                                                                                                                                                                                                       |
| lService            | Lookup Field | No                         | (As is)                                                     | Service on the call                                                                                                                                                                                                                               |
| lServiceAction      | Lookup Field | No                         | (As is)                                                     | Service Action on the call                                                                                                                                                                                                                        |
| lServiceBundle      | Lookup Field | No                         | (As is)                                                     | Service Bundle on the call                                                                                                                                                                                                                        |
| lImpact             | Lookup Field | No                         | (As is)                                                     | Call Impact                                                                                                                                                                                                                                       |
| lPriority           | Lookup Field | No                         | (As is)                                                     | Call Priority                                                                                                                                                                                                                                     |
| lUrgency            | Lookup Field | No                         | (As is)                                                     | Call Urgency                                                                                                                                                                                                                                      |
| lFwdGroup           | Lookup Field | No                         | (As is)                                                     | Group to which this call will be assigned                                                                                                                                                                                                         |
| lIPKStatus          | Lookup Field | No                         | (As is)                                                     | IPK status applied to the call                                                                                                                                                                                                                    |
| lIPKStream          | Lookup Field | No                         | (As is)                                                     | IPK stream applied to the call                                                                                                                                                                                                                    |
| sActionDescription  | String       | No                         | (As is)                                                     | Action & Solution history entry                                                                                                                                                                                                                   |
| sProblemDescription | String       | No                         | (As is)                                                     | Call Description                                                                                                                                                                                                                                  |
| yPortal             | Yes/No       | No                         | (As is)                                                     | <p>Display this Action & Solution history entry on Self Service Portal? Values:</p><ul><li>Y = display this Action & Solution history entry on the Portal</li><li>N = do not display this Action & Solution history entry on the Portal</li></ul> |
| lType               | Lookup Field | No                         |                                                             | Call Issue Type                                                                                                                                                                                                                                   |
| dActionEnd          | Date/Time    | No                         | Now                                                         | Action End Date                                                                                                                                                                                                                                   |
| dActionStart        | Date/Time    | No                         | Now                                                         | Action Start Date                                                                                                                                                                                                                                 |
| lActionType         | Lookup Field | No                         | 0                                                           | Action Type corresponding to the Action & Solution history entry                                                                                                                                                                                  |
| nEstimatedHours     | Integer      | No                         | Uses the difference between the Action Start and Action End | Action & Solution recorded time spent                                                                                                                                                                                                             |
| nEstimatedMins      | Integer      | No                         | Uses the difference between the Action Start and Action End | Action & Solution recorded time spent                                                                                                                                                                                                             |
| nExpenses           | Integer      | No                         | 0                                                           | Action & Solution recorded expenditure                                                                                                                                                                                                            |
| bCreateOutage       | Boolean      | No                         | False                                                       | Create an outage against the specified CMDB item or Service and link it to this call. Values:                                                                                                                                                     |
| dOutageEnd          | Date/Time    | No                         | (NULL)                                                      | <p>Outage end date; if entered, this date must be in the past.</p><p>Outage end date is entered in the logging analyst’s time zone.</p>                                                                                                           |
| dOutageStart        | Date/Time    | No                         | Now – if Create Outage was selected                         | <p>Outage start date.</p><p>Outage start date is entered in the logging analyst’s time zone.</p>                                                                                                                                                  |
| lOutageType         | Lookup Field | No                         | <p>Unspecified</p><p>Unplanned</p>                          | Outage Type. This must be an unplanned Outage Type.                                                                                                                                                                                               |
| sOutageDesc         | String       | No                         | “”                                                          | Description of the created outage                                                                                                                                                                                                                 |
| sOutageItemList     | String       | No                         | “”                                                          | <p>List of CMDB items or Services linked to the call (or dependent on these CI) against which to create the outage.</p><p>These outages will be linked to the call.</p>                                                                           |
| lCallStatus         | Lookup Field | No                         | (As is)                                                     | Call Status                                                                                                                                                                                                                                       |
| lPartition          | Lookup Field | No                         | (As is)                                                     | Call Partition.                                                                                                                                                                                                                                   |
| lSecurity           | Lookup Field | No                         | 0                                                           | Security Profile applied to the Action & Solution history entry.                                                                                                                                                                                  |
| bSendEmail          | Boolean      | No                         | False                                                       | <p>Send an email to the assigned analyst/group regarding this call. Values:</p><ul><li>True = send an email to the assigned analyst/group</li><li>False = no email is sent</li></ul>                                                              |
| bSendPager          | Boolean      | No                         | False                                                       | <p>Send a pager message to the assigned analyst/group regarding this call. Values:</p><ul><li>True = send a pager message to the assigned analyst/group</li><li>False = no pager message is sent</li></ul>                                        |
| aCustomParameters   | Array        | No                         | “”                                                          | See Defining Custom Parameters.                                                                                                                                                                                                                   |

#### Return Values: CallResponse

See CallResponse for more information.

### CallRetrieve Transaction

The CallRetrieve transaction can be used to retrieve an existing call’s details without taking action on it.

#### Input Parameters: CallRetrieveRequest

<table data-header-hidden><thead><tr><th></th><th width="131"></th><th></th><th width="115"></th><th></th></tr></thead><tbody><tr><td>Argument</td><td>Type</td><td>Mandatory</td><td>Default</td><td>Description</td></tr><tr><td>sID</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s current Session ID</td></tr><tr><td>sLoginUserID</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s Login ID</td></tr><tr><td>sLoginPassword</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s Password</td></tr><tr><td>sDatabase</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Name of the ASM System for logging in.</td></tr><tr><td>lEntityRef</td><td>Lookup Field</td><td>Yes</td><td>-</td><td>Call to retrieve</td></tr><tr><td>aCustomParameters</td><td>Array</td><td>No</td><td>“”</td><td>See Defining Custom Parameters.</td></tr></tbody></table>

#### Return Values:CallRetrieveResponse <a href="#callretrieveresponse" id="callretrieveresponse"></a>

| Argument  | Type      | Description                            |
| --------- | --------- | -------------------------------------- |
| Ret       | APIReturn | Error/Warning Number                   |
| sMessage  | String    | Error/Warning Message                  |
| ResultSet | DataSet   | ResultSet containing attribute details |

### CallForwardInternal Transaction

The CallForwardInternal transaction can be used to forward an existing call internally to an analyst or group.

#### Input Parameters: CallInternalRequest

<table data-header-hidden><thead><tr><th width="233"></th><th width="98"></th><th></th><th width="92"></th><th></th></tr></thead><tbody><tr><td>Argument</td><td>Type</td><td>Mandatory</td><td>Default</td><td>Description</td></tr><tr><td>sID</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s current Session ID</td></tr><tr><td>sLoginUserID</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s Login ID</td></tr><tr><td>sLoginPassword</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s Password</td></tr><tr><td>sDatabase</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Name of the ASM System for logging in.</td></tr><tr><td>lEntityRef</td><td>Lookup Field</td><td>Yes</td><td>-</td><td>Number of the call in which to forward</td></tr><tr><td>lFwdOfficer</td><td>Lookup Field</td><td>No</td><td>0</td><td>Analyst to which the call will be assigned</td></tr><tr><td>lFwdGroup</td><td>Lookup Field</td><td>No</td><td>0</td><td>Group to which the call will be assigned</td></tr><tr><td>bSendEmail</td><td>Boolean</td><td>No</td><td>False</td><td><p>Send an email to the assigned analyst/group regarding this call. Values:</p><ul><li>True = send an email to the assigned analyst/group</li><li>False = no email is sent</li></ul></td></tr><tr><td>bSendPager</td><td>Boolean</td><td>No</td><td>False</td><td><p>Send a pager message to the assigned analyst/group regarding this call. Values:</p><ul><li>True = send a pager message to the assigned analyst/group</li><li>False = no pager message is sent</li></ul></td></tr><tr><td>aCustomParameters</td><td>Array</td><td>No</td><td>“”</td><td>See Defining Custom Parameters.</td></tr></tbody></table>

#### Return Values: CallResponse

See CallResponse for more information.

### CallForwardExternal Transaction

The CallForwardExternal transaction can be used to forward an existing call externally.

#### Input Parameters: CallExternalRequest

<table data-header-hidden><thead><tr><th></th><th width="119"></th><th></th><th width="89"></th><th></th></tr></thead><tbody><tr><td>Argument</td><td>Type</td><td>Mandatory</td><td>Default</td><td>Description</td></tr><tr><td>sID</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s current Session ID</td></tr><tr><td>sLoginUserID</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s Login ID</td></tr><tr><td>sLoginPassword</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s Password</td></tr><tr><td>sDatabase</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Name of the ASM System for logging in.</td></tr><tr><td>lEntityRef</td><td>Lookup Field</td><td>Yes</td><td>-</td><td>Number of the call to forward externally</td></tr><tr><td>lFwdOfficer</td><td>Lookup Field</td><td>Yes</td><td>0</td><td>Analyst to which the call will be assigned. Will forward the call if provided.</td></tr><tr><td>lExternalSupplier</td><td>Lookup Field</td><td>No</td><td>0</td><td>External supplier to which the call will be assigned.</td></tr><tr><td>lContract</td><td>Lookup Field</td><td>No</td><td>0</td><td>Contract to apply when forwarded externally</td></tr><tr><td>sJobRef</td><td>String</td><td>No</td><td>“”</td><td>External Job Reference</td></tr><tr><td>yEmailSupplier</td><td>Yes/No</td><td>No</td><td>N</td><td><p>Send an email to the specified External Supplier. Values:</p><ul><li>Y = send email to assigned external supplier</li><li>N = do not send email to assigned external supplier</li></ul></td></tr><tr><td>bSendEmail</td><td>Boolean</td><td>No</td><td>False</td><td><p>Send an email to the assigned analyst. Values:</p><ul><li>Y = send email to assigned analyst</li><li>N = do not send email to assigned analyst</li></ul></td></tr><tr><td>bSendPager</td><td>Boolean</td><td>No</td><td>False</td><td><p>Send a pager message  to the assigned analyst. Values:</p><ul><li>Y = send pager message to assigned analyst</li><li>N = do not send pager message to assigned analyst</li></ul></td></tr><tr><td>aCustomParameters</td><td>Array</td><td>No</td><td>“”</td><td>See Defining Custom Parameters.</td></tr></tbody></table>

#### Return Values: CallResponse

See CallResponse for more information.

### CallClose Transaction

The CallClose transaction can be used to close an existing call.

#### Input Parameters: CallCloseRequest

<table data-header-hidden><thead><tr><th></th><th width="117"></th><th></th><th width="96"></th><th></th></tr></thead><tbody><tr><td>Argument</td><td>Type</td><td>Mandatory</td><td>Default</td><td>Description</td></tr><tr><td>sID</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s current Session ID</td></tr><tr><td>sLoginUserID</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s Login ID</td></tr><tr><td>sLoginPassword</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s Password</td></tr><tr><td>sDatabase</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Name of the ASM System for logging in.</td></tr><tr><td>lEntityRef</td><td>Lookup Field</td><td>Yes</td><td>-</td><td>Number of the call to close</td></tr><tr><td>lReason</td><td>Lookup Field</td><td>No</td><td>0</td><td>Reason for closing the call</td></tr><tr><td>lCallStatus</td><td>Lookup Field</td><td>No</td><td>0</td><td>Call Status</td></tr><tr><td>sOneLiner</td><td>String</td><td>No</td><td>“”</td><td>One Line explanation for closing the call</td></tr><tr><td>bCloneToKnowledgeBank</td><td>Boolean</td><td>Mp</td><td>False</td><td><p>Whether to create a KB entry based on this call. Values:</p><ul><li>True = create a KB entry based on this call</li><li>False = do not create a KB entry based on this call</li></ul></td></tr><tr><td>bEmailCustomer</td><td>Boolean</td><td>No</td><td>False</td><td><p>Whether to send an email to the User informing that this call is closed. Values:</p><ul><li>True = send email to User</li><li>False = do not send email to User</li></ul></td></tr><tr><td>aCustomParameters</td><td>Array</td><td>No</td><td>“”</td><td>See Defining Custom Parameters.</td></tr></tbody></table>

#### Return Values: CallResponse

See CallResponse for more information.

### CallFindLinkedOutage Transaction

The CallFindLinkedOutages transaction can be used to find outages linked to this call.

#### Input Parameters: CallFindLinkedOutageRequest

<table data-header-hidden><thead><tr><th></th><th width="150"></th><th></th><th width="91"></th><th></th></tr></thead><tbody><tr><td>Argument</td><td>Type</td><td>Mandatory</td><td>Default</td><td>Description</td></tr><tr><td>sID</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s current Session ID</td></tr><tr><td>sLoginUserID</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s Login ID</td></tr><tr><td>sLoginPassword</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s Password</td></tr><tr><td>sDatabase</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Name of the ASM System for logging in.</td></tr><tr><td>lEntityRef</td><td>Lookup Field</td><td>Yes</td><td>-</td><td>Call number for which to find linked outages.</td></tr><tr><td>aCustomParameters</td><td>Array</td><td>No</td><td>“”</td><td>See Defining Custom Parameters.</td></tr></tbody></table>

#### Return Values: CallRetrieveResponse

See CallRetrieveResponse for more information.

### CallMessageForum Transaction

The CallMessageForum transaction can be used to send an email to the forum attached to a call.

#### Input Parameters: CallMessageForumRequest

<table data-header-hidden><thead><tr><th></th><th width="104"></th><th></th><th width="104"></th><th></th></tr></thead><tbody><tr><td>Argument</td><td>Type</td><td>Mandatory</td><td>Default</td><td>Description</td></tr><tr><td>sID</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s current Session ID</td></tr><tr><td>sLoginUserID</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s Login ID</td></tr><tr><td>sLoginPassword</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s Password</td></tr><tr><td>sDatabase</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Name of the ASM System for logging in.</td></tr><tr><td>lEntityRef</td><td>Lookup Field</td><td>Yes</td><td>-</td><td>Number of the call to which an email will be sent to forum members</td></tr><tr><td>bForumNotLinked</td><td>Boolean</td><td>No</td><td>F</td><td><p>Whether to email a forum linked to the call (e.g. IPK workflow rules), or to email the forum members attached manually to the call (e.g. via call watch). Values:</p><ul><li>True = email all forum members</li><li>False = email only forum members who manually watched the call</li></ul></td></tr><tr><td>aCustomParameters</td><td>Array</td><td>No</td><td>“”</td><td>See Defining Custom Parameters.</td></tr></tbody></table>

#### Return Values: CallResponse

See CallResponse for more information.

### CallTimesheetCreate Transaction

The CallTimesheetCreate transaction can be used to add a timesheet entry for a call.

#### Input Parameters: CallTimesheetCreateRequest

<table data-header-hidden><thead><tr><th></th><th width="131"></th><th></th><th width="98"></th><th></th></tr></thead><tbody><tr><td>Argument</td><td>Type</td><td>Mandatory</td><td>Default</td><td>Description</td></tr><tr><td>sID</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s current Session ID</td></tr><tr><td>sLoginUserID</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s Login ID</td></tr><tr><td>sLoginPassword</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s Password</td></tr><tr><td>sDatabase</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Name of the ASM System for logging in.</td></tr><tr><td>lEntityRef</td><td>Lookup Field</td><td>Yes</td><td>-</td><td>Number of the call to create a timesheet entry</td></tr><tr><td>nHistoryOrder</td><td>Integer</td><td>Ignored</td><td>-</td><td><p>History order.</p><p>Automatically generated on create transaction.</p></td></tr><tr><td>lTimesheetAction</td><td>Lookup Field</td><td>No</td><td></td><td>Timesheet action</td></tr><tr><td>sHistoryDesc</td><td>String</td><td>No</td><td>“”</td><td>History description</td></tr><tr><td>dStartDate</td><td>Date/Time</td><td>No</td><td>Now</td><td>History Start Date</td></tr><tr><td>dEndDate</td><td>Date/Time</td><td>No</td><td>Now</td><td>History End Date</td></tr><tr><td>nExpenses</td><td>Integer</td><td>No</td><td>0</td><td>Expenses</td></tr><tr><td>yPortal</td><td>Yes/No</td><td>No</td><td>False</td><td><p>Make this history entry visible on the Self Service Portal? Values:</p><ul><li>True = history entry is visible on the Self Service Portal</li><li>False = history entry not displayed on the Self Service Portal</li></ul></td></tr><tr><td>lSecurityProfile</td><td>Lookup Field</td><td>No</td><td>0</td><td>Security Profile to apply to the timesheet entry</td></tr><tr><td>aCustomParameters</td><td>Array</td><td>No</td><td>“”</td><td>See Defining Custom Parameters.</td></tr></tbody></table>

#### Return Values: CallResponse

See CallResponse for more information.

### CallTimesheetUpdate Transaction

The CallTimeSheetUpdate transaction can be used to update a timesheet entry for a call.

#### Input Parameters: CallTimesheetUpdateRequest

<table data-header-hidden><thead><tr><th></th><th width="135"></th><th></th><th width="107"></th><th></th></tr></thead><tbody><tr><td>Argument</td><td>Type</td><td>Mandatory</td><td>Default</td><td>Description</td></tr><tr><td>sID</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s current Session ID</td></tr><tr><td>sLoginUserID</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s Login ID</td></tr><tr><td>sLoginPassword</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s Password</td></tr><tr><td>sDatabase</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Name of the ASM System for logging in.</td></tr><tr><td>lEntityRef</td><td>Lookup Field</td><td>Yes</td><td>-</td><td>Number of the call to create a timesheet entry</td></tr><tr><td>nHistoryOrder</td><td>Integer</td><td>Yes</td><td>-</td><td>History order to update</td></tr><tr><td>lTimesheetAction</td><td>Lookup Field</td><td>No</td><td>(As is)</td><td>Timesheet action</td></tr><tr><td>sHistoryDesc</td><td>String</td><td>No</td><td>(As is)</td><td>History description</td></tr><tr><td>dStartDate</td><td>Date/Time</td><td>No</td><td>(As is)</td><td>History Start Date</td></tr><tr><td>dEndDate</td><td>Date/Time</td><td>No</td><td>(As is)</td><td>History End Date</td></tr><tr><td>nExpenses</td><td>Integer</td><td>No</td><td>(As is)</td><td>Expenses</td></tr><tr><td>yPortal</td><td>Yes/No</td><td>No</td><td>(As is)</td><td><p>Make this history entry visible on the Self Service Portal? Values:</p><ul><li>True = history entry is visible on the Self Service Portal</li><li>False = history entry not displayed on the Self Service Portal</li></ul></td></tr><tr><td>lSecurityProfile</td><td>Lookup Field</td><td>No</td><td>(As is)</td><td>Security Profile to apply to the timesheet entry</td></tr><tr><td>aCustomParameters</td><td>Array</td><td>No</td><td>“”</td><td>See Defining Custom Parameters.</td></tr></tbody></table>

#### Return Values: CallResponse

See CallResponse for more information.

### CallTimesheetDelete Transaction

The CallTimeSheetDelete transaction can be used to delete a timesheet entry for a call.

#### Input Parameters: CallTimesheetDeleteRequest

<table data-header-hidden><thead><tr><th></th><th width="142"></th><th></th><th width="104"></th><th></th></tr></thead><tbody><tr><td>Argument</td><td>Type</td><td>Mandatory</td><td>Default</td><td>Description</td></tr><tr><td>sID</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s current Session ID</td></tr><tr><td>sLoginUserID</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s Login ID</td></tr><tr><td>sLoginPassword</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Analyst’s Password</td></tr><tr><td>sDatabase</td><td>String</td><td>No. See Transaction Login.</td><td>“”</td><td>Name of the ASM System for logging in.</td></tr><tr><td>lEntityRef</td><td>Lookup Field</td><td>Yes</td><td>-</td><td>Number of the call to create a timesheet entry</td></tr><tr><td>nHistoryOrder</td><td>Integer</td><td>Yes</td><td>-</td><td>History order to update</td></tr><tr><td>lTimesheetAction</td><td>Lookup Field</td><td>Ignored</td><td></td><td>Timesheet action</td></tr><tr><td>sHistoryDesc</td><td>String</td><td>Ignored</td><td>-</td><td>History description</td></tr><tr><td>dStartDate</td><td>Date/Time</td><td>Ignored</td><td>-</td><td>History Start Date</td></tr><tr><td>dEndDate</td><td>Date/Time</td><td>Ignored</td><td>-</td><td>History End Date</td></tr><tr><td>nExpenses</td><td>Integer</td><td>Ignored</td><td>-</td><td>Expenses</td></tr><tr><td>yPortal</td><td>Yes/No</td><td>Ignored</td><td>-</td><td><p>Make this history entry visible on the Self Service Portal? Values:</p><ul><li>True = history entry is visible on the Self Service Portal</li><li>False = history entry not displayed on the Self Service Portal</li></ul></td></tr><tr><td>lSecurityProfile</td><td>Lookup Field</td><td>Ignored</td><td>-</td><td>Security Profile to apply to the timesheet entry</td></tr><tr><td>aCustomParameters</td><td>Array</td><td>No</td><td>“”</td><td>See Defining Custom Parameters.</td></tr></tbody></table>

#### Return Values: CallResponse

See CallResponse for more information.