a!sblUpdateFieldValue() Function

Updates the values of the given record in Siebel.

Syntax

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

Common Parameters:

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 hostname of the Siebel server. For example, siebel.example.com.

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".

Specific Parameters:

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.

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.

Returns

Writer

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

See also:

Examples

Update an Order Status

Copy and paste the expression into the INTERFACE DEFINITION in EXPRESSION MODE, save it, then call the interface in a Tempo Report to test.

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
45
46
=load(
  local!updateItemFunction: bind(
    null,
    rule!sblUpdateFieldValues(_)
  ),
  with(
    {
        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",
          placeholderLabel: "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
                }
              )
            )
          }
        )
    }
  )
)
FEEDBACK