Free cookie consent management tool by TermsFeed
View this page in the latest version of Appian.

a!sblUpdateFieldValue() Function

Function
Copy link to clipboard

a!sblUpdateFieldValue( scsExternalSystemKey, usePerUserCredentials, hostname, port, enterpriseApp, appManager, language, fieldValues, parameters )

Updates the values of the given record in Siebel.

See also: Writer, bind().

Parameters
Copy link to clipboard

Keyword Type Description

scsExternalSystemKey

Text

The key from the Third Party Credentials admin console page that corresponds to the set of credentials that should be used to authenticate.

usePerUserCredentials

Boolean

If true the credentials set in the Third-Party Credentials settings page by the current user running the expression will be used. If false the site-wide credential values will be used.

hostname

Text

The application server host of the SAP server (ASHOST). The value can be an IP address, a fully-qualified domain name, or SAP's router string format. For example, "/H/sap_router/W/password/H/app_host/S/service_port".

port

Number (Integer)

The port the Siebel server is listening on. For example, 2321.

enterpriseApp

Text

The enterprise application of the target system. For example, "SBA_82".

appManager

Text

The active application manager of the target system. For example, "SSEObjMgr_enu".

language

Text

The target system language. For example, "enu".

fieldValues

Any Type

The field values of the new record to update, given as a dictionary with the field names based on the fields of the Business Object and values set to the desired new field values.

parameters

Any Type

The record on which the values will be set, given as a dictionary with the field structure of the Siebel Business Component and Business Object to create. The dictionary should contain an Id field with the value of identifier of the record to update.

Returns
Copy link to clipboard

Writer

This function returns a writer and must be used with the bind() function.

Examples
Copy link to clipboard

Copy and paste an example into an Appian Expression Editor to experiment with it.

Update an order status
Copy link to clipboard

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

=load(
  local!updateItemFunction: bind(
    null,
    rule!sblUpdateFieldValues(_)
  ),
  {
    a!textField(
      label: "Id",
      readonly: fn!true(),
      value: ri!selectedItem.Id,
      saveInto: ri!selectedItem.Id
    ),
    a!textField(
      label: "Order Number",
      value: ri!selectedItem.'Order Number',
      saveInto: ri!selectedItem.'Order Number'
    ),
    a!dropdownField(
      label: "Status",
      placeholder: "Select a status...",
      choiceLabels: cons!SIEBEL_STATUS,
      choiceValues: cons!SIEBEL_STATUS,
      value: ri!selectedItem.Status,
      saveInto: ri!selectedItem.Status
    ),
    a!buttonLayout(
      primaryButtons: {
        a!buttonWidget(
          label: "Update Order",
          value: null,
          style: "PRIMARY",
          saveInto: a!save(
            local!updateItemFunction,
            value: {
              Id: ri!selectedItem.Id,
              'Order Number': ri!selectedItem.'Order Number',
              Status: ri!selectedItem.Status
            }
          )
        )
      }
    )
  }
)

Copy

Feature compatibility
Copy link to clipboard

The table below lists this function's compatibility with various features in Appian.
Feature Compatibility Note
Portals Partially compatible

Can be used with Appian Portals if it is connected using an integration and web API.
Offline Mobile Partially compatible

Can be used with offline mobile if it is loaded at the top of the form.
Sync-Time Custom Record Fields Incompatible
Real-Time Custom Record Fields Incompatible

Custom record fields that evaluate in real time must be configured using one or more Custom Field functions.
Process Reports Incompatible

Cannot be used to configure a process report.
Process Events Incompatible

Cannot be used to configure a process event node, such as a start event or timer event.

Feedback
Copy link to clipboard