Siebel Finance Guide > Business Services for Siebel Financial Services > Using Data Transfer Utilities (DTU) >

Data Transfer Utilities Methods


This section describes the following Data Transfer Utilities business service methods:

DataTransfer Method

The DataTransfer method transfers data from the source business component to the destination business component.

Argument
Description

Data Map Object (Required)

The name of the data map object that defines the mapping.

Operation (Required)

Valid entries include Insert, Update, Delete, and Upsert.

GotoView (Optional)

The name of a view that appears to users after the data transfer operation.

Option (Optional)

A text field that allows you to specify additional options for the operation. Supported options include:

  • NewSrcBusObj. Force to instantiate a new Source business object. Use instead of NewBusObj.
  • NewDstBusObj. Force to instantiate a new destination business object.
  • RootNotCommitted. Suggest DTU not to commit the root component, if possible.
  • SrcRootAdminMode. Set the source Buscomp of the root data map component to Admin mode. This is valid only if the root source Buscomp has not been executed.
  • BatchMode. This is a performance enhancement option that suppresses runtime events, disables undo, and defers field pre-defaults until committing the record. Batch mode is only enabled for source or destination business objects that are not the active (initiator) business object.

The following syntax is recommended for defining Option:

/option1 /option2 ...

For example,

/NewSrcBusObj /NewDstBusObj

Initiator Business Object (Optional)

Used as a sanity check. If the BusObject that invokes DTU is different from what is specified by the InitBO argument, DTU exits as an external error.

Initiator Business Object is part of the invocation context. DTU receives a reference of the initiator business object only when invoked from Runtime Evens, Buscomp Named Methods, or workflow processes with its business object defined. See About Auto Application as an example. In Siebel Finance 7.7, DTU can be invoked without an initiator business object.

Initiator Business Component (Optional)

By default, the Buscomp that invokes DTU serves as the InitBC. Initiator Buscomp plays an important role in determining how records are transferred. Use the InitBC argument to set other Buscomp in the Initiator BusObject as the Initiator Buscomp.

Initiator Search Specification / Initiator Sort Specification (Optional)

Initiator Buscomp search spec and sort spec.

Initiator Buscomp Enumerate Flag (Optional)

Y/N. By default, Initiator Buscomp Enumerate Flag is N. When it is true, DataTransfer is applied to each record in the initiator Buscomp. When InitSearchSpec or InitSortSpec is specified, InitEnumFlag is implicitly true, even if InitEnumFlg is set to N.

MockMethodReplied

Y/N.

NOTE:  It is recommended that you specify both InitBO and InitBC specifically when invoking DTU.

DTU requeries the initiator buscomp when InitSearchSpec, InitSortSpec, InitEnumFlg are used.

FAFireEventxxx Method

FAFireEventxxx is a hidden method that you can use to create a toolbar command. It invokes the method "EventMethodxxx" on the primary business component of the active view. "EventMethodxxx" triggers the event manager, which invokes either a workflow or a business service.

GetActiveViewProp Method

This is an auxiliary function to retrieve the active view's properties. It does not take any input arguments.

Argument
Description

Business Object

Business object name.

View

Active view name.

Screen

Active screen name.

Thread Applet

Thread applet name.

Is Administration Mode

Y or N.

View Mode Code

An integer representing Siebel view mode:

  • 0: SalesRep View
  • 1: Manager View
  • 2: Personal View
  • 3: AllView

TryMockMethod Method

This is an advanced auxiliary function for administration of the tool bar button workflow. It does not take any input arguments.

Argument
Description

MockMethodReplied

Y or N.

QueueMethod Method

Launch a queue method on an applet in another view. When invoked, the UI navigates to the view specified, and then the Queue method is invoked on the specified applet.

Other input arguments of this method will be cached into the application Shared Global, which can be retried back.

DTU DataTransfer method has built-in integration with the QueueMethod. When the input argument DataMapObject has the format:

SharedGlobal: NameofSharedGlobal

The data map object name can be retrieved from Shared Global with the name NameofSharedGlobal.

Argument
Description

GotoView

Name of the view to go to.

Applet

Applet name.

Method

Queued method to be invoked on the applet.

Siebel Finance Guide