# Bulletin 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 %}

Transactions are also provided for sending bulletin board entries to Users, groups and analysts.

### BulletinCreate Transaction

The BulletinCreate transaction can be used to create a bulletin board entry.

#### Input Parameters: BulletinCreateRequest

<table data-header-hidden><thead><tr><th></th><th width="101"></th><th width="127"></th><th width="93"></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 transaction</td></tr><tr><td>sTitle</td><td>String</td><td>No</td><td>“”</td><td>Title of the Bulletin Board entry</td></tr><tr><td>dDateActive</td><td>Date/Time</td><td>Yes</td><td>Today</td><td>Date from which the Bulletin Board entry is active</td></tr><tr><td>dDateExpire</td><td>Date/Time</td><td>Yes</td><td>Today + 1 month</td><td>Date to which the Bulletin Board entry is active</td></tr><tr><td>bIsHTML</td><td>Boolean</td><td>No</td><td>False</td><td><p>Format in which the Bulletin Board entry will display. Values:</p><ul><li>True = Create Bulletin Board entry in HTML format.</li><li>False = Create Bulletin Board entry in Plain Text format.</li></ul></td></tr><tr><td>sBody</td><td>String</td><td>No</td><td>“”</td><td>Body of the Bulletin Board entry</td></tr><tr><td>lPriority</td><td>Lookup Field</td><td>No</td><td>0</td><td>Bulletin Board Priority</td></tr><tr><td>nCallNo</td><td>Integer</td><td>No</td><td>0</td><td>Number of the call linked to the Bulletin Board entry</td></tr><tr><td>nRequestNo</td><td>Integer</td><td>No</td><td>0</td><td>Number of the request linked to the Bulletin Board entry</td></tr><tr><td>nTaskNo</td><td>Integer</td><td>No</td><td>0</td><td>Number of the task linked to the Bulletin Board entry</td></tr><tr><td>yExtPortalVisible</td><td>Yes/No</td><td>No</td><td>N</td><td>Is this Bulletin Board entry visible to External Suppliers on the Self Service Portal?</td></tr><tr><td>yPortalVisible</td><td>Yes/No</td><td>No</td><td>N</td><td>Is this Bulletin Board entry visible to Users on the Self Service Portal?</td></tr><tr><td>yAlertInd</td><td>Yes/No</td><td>No</td><td>N</td><td>Send a pop-up message alert to analysts that the Bulletin Board has been updated?</td></tr><tr><td>yInternalInd</td><td>Yes/No</td><td>No</td><td>N</td><td>Send an internal message to specified recipients?</td></tr><tr><td>yMailInd</td><td>Yes/No</td><td>No</td><td>N</td><td>Send an email to specified recipients?</td></tr><tr><td>yPagerInd</td><td>Yes/No</td><td>No</td><td>N</td><td>Send a pager message to specified recipients?</td></tr><tr><td>lCMGroup</td><td>Lookup Field</td><td>No</td><td>-</td><td><p>Workflow Management group(s) to receive notification about the Bulletin Board entry.</p><p>Ignored if yFilterRecipientsByGroup is N.</p></td></tr><tr><td>lIPKGroup</td><td>Lookup Field</td><td>No</td><td>-</td><td><p>IPK group(s) to receive notification about the Bulletin Board entry</p><p>Ignored if yFilterRecipientsByGroup is N.</p></td></tr><tr><td>yFilterRecipientsByGroup</td><td>Yes/No</td><td>No</td><td>N</td><td><p>Filter Recipients by Group? Values:</p><ul><li>Y = will check both CM and IPK groups</li><li>N = ignores CMGroup and IPKGroup</li></ul></td></tr><tr><td>lPartition</td><td>Lookup Field</td><td>No</td><td>Analyst’s default partition</td><td>Partition in which the Bulletin Board entry will be created</td></tr><tr><td>lSecurityProfile</td><td>Lookup Field</td><td>No</td><td>0</td><td>Security Profile in which to apply to the Bulletin Board 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:BulletinResponse <a href="#bulletinresponse" id="bulletinresponse"></a>

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

### BulletinUpdate Transaction

The BulletinUpdate transaction can be used to modify an existing Bulletin Board entry.

#### Input Parameters: BulletinUpdateRequest

<table data-header-hidden><thead><tr><th></th><th width="138"></th><th></th><th width="94"></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>Bulletin Entry</td></tr><tr><td>sTitle</td><td>String</td><td>No</td><td>“”</td><td>Title of the Bulletin Board entry</td></tr><tr><td>dDateActive</td><td>Date/Time</td><td>Yes</td><td>Today</td><td>Date from which the Bulletin Board entry is active</td></tr><tr><td>dDateExpire</td><td>Date/Time</td><td>Yes</td><td>Today + 1 month</td><td>Date to which the Bulletin Board entry is active</td></tr><tr><td>bIsHTML</td><td>Boolean</td><td>No</td><td>False</td><td><p>Format in which the Bulletin Board entry will display. Values:</p><ul><li>True = Create Bulletin Board entry in HTML format.</li><li>False = Create Bulletin Board entry in Plain Text format.</li></ul></td></tr><tr><td>sBody</td><td>String</td><td>No</td><td>“”</td><td>Body of the Bulletin Board entry</td></tr><tr><td>lPriority</td><td>Lookup Field</td><td>No</td><td>0</td><td>Bulletin Board Priority</td></tr><tr><td>nCallNo</td><td>Integer</td><td>No</td><td>0</td><td>Number of the call linked to the Bulletin Board entry</td></tr><tr><td>nRequestNo</td><td>Integer</td><td>No</td><td>0</td><td>Number of the request linked to the Bulletin Board entry</td></tr><tr><td>nTaskNo</td><td>Integer</td><td>No</td><td>0</td><td>Number of the task linked to the Bulletin Board entry</td></tr><tr><td>yExtPortalVisible</td><td>Yes/No</td><td>No</td><td>N</td><td>Is this Bulletin Board entry visible to External Suppliers on the Self Service Portal?</td></tr><tr><td>yPortalVisible</td><td>Yes/No</td><td>No</td><td>N</td><td>Is this Bulletin Board entry visible to Users on the Self Service Portal?</td></tr><tr><td>yAlertInd</td><td>Yes/No</td><td>No</td><td>N</td><td>Send a pop-up message alert to analysts that the Bulletin Board has been updated?</td></tr><tr><td>yInternalInd</td><td>Yes/No</td><td>No</td><td>N</td><td>Send an internal message to specified recipients?</td></tr><tr><td>yMailInd</td><td>Yes/No</td><td>No</td><td>N</td><td>Send an email to specified recipients?</td></tr><tr><td>yPagerInd</td><td>Yes/No</td><td>No</td><td>N</td><td>Send a pager message to specified recipients?</td></tr><tr><td>lCMGroup</td><td>Lookup Field</td><td>No</td><td>-</td><td><p>Workflow Management group(s) to receive notification about the Bulletin Board entry.</p><p>Ignored if yFilterRecipientsByGroup is N.</p></td></tr><tr><td>lIPKGroup</td><td>Lookup Field</td><td>No</td><td>-</td><td><p>IPK group(s) to receive notification about the Bulletin Board entry</p><p>Ignored if yFilterRecipientsByGroup is N.</p></td></tr><tr><td>yFilterRecipientsByGroup</td><td>Yes/No</td><td>No</td><td>N</td><td><p>Filter Recipients by Group? Values:</p><ul><li>Y = will check both CM and IPK groups</li><li>N = ignores CMGroup and IPKGroup</li></ul></td></tr><tr><td>lPartition</td><td>Lookup Field</td><td>No</td><td>Analyst’s default partition</td><td>Partition in which the Bulletin Board entry will be created</td></tr><tr><td>lSecurityProfile</td><td>Lookup Field</td><td>No</td><td>0</td><td>Security Profile in which to apply to the Bulletin Board 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: BulletinResponse

See BulletinResponse for more information.

### BulletinRetrieve Transaction

The BulletinRetrieve transaction can be used to retrieve a Bulletin Board entry.

#### Input Parameters: BulletinEntityRequest

<table data-header-hidden><thead><tr><th></th><th width="96"></th><th width="162"></th><th width="100"></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>Bulletin Board entry 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: BulletinRetrieveResponse

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

### BulletinDelete Transaction

The BulletinDelete transaction can be used to delete a Bulletin Board entry.

#### Input Parameters: BulletinDeleteRequest

<table data-header-hidden><thead><tr><th></th><th width="110"></th><th></th><th width="100"></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>Bulletin board entry to delete</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: BulletinResponse

See BulletinResponse for more information.