Skip to content

Class: SectionProxy

SectionProxy is a developer-facing class that provides access to a section within sectioned table for application specific customizations.

Hierarchy

Implements

Summary

Constructors

Properties

Accessors

Methods

Constructors

constructor

+ new SectionProxy(context: IContext): SectionProxy

Overrides ClientAPI.constructor

Parameters:

Name Type
context IContext

Returns: SectionProxy

Properties

Protected _context

• _context: IContext

Inherited from ClientAPI._context

Accessors

actionResults

• get actionResults(): any

Inherited from ClientAPI.actionResults

Access to the action results from the client data

Returns: any

binding

• get binding(): Object

Inherited from ClientAPI.binding

Access to the context's binding property

Returns: Object

currentPage

• get currentPage(): any

Inherited from ClientAPI.currentPage

Get the topmost page in the navigation stack

Returns: any

dataSubscriptions

• get dataSubscriptions(): string[]

Get the section dataSubscription array

Returns: string[]

• set dataSubscriptions(dataSubscriptions: string[]): void

Set the section dataSubscriptions

Parameters:

Name Type
dataSubscriptions string[]

Returns: void

filterTypeEnum

• get filterTypeEnum(): FilterType

Inherited from ClientAPI.filterTypeEnum

Returns Enum for specifying filterType in createFilterCriteria API. Has two values, Filter and Sorter.

Returns: FilterType

searchString

• get searchString(): string

get the search string

Returns: string

Methods

Protected _clientAPIProps

▸ _clientAPIProps(): IClientAPIProps

Inherited from ClientAPI._clientAPIProps

Returns: IClientAPIProps

Protected _getExecuteSource

▸ _getExecuteSource(): ExecuteSource

Overrides ClientAPI._getExecuteSource

Returns: ExecuteSource

base64StringToBinary

▸ base64StringToBinary(base64: string): Promise‹any›

Implementation of IClientAPI

Inherited from ClientAPI.base64StringToBinary

This method converts base64 string to binary data

Parameters:

Name Type Description
base64 string base64 string

Returns: Promise‹any›

a promise with a binary data once it is resolved

callFunction

▸ callFunction(serviceName: string, oFunction: object, headers?: Object): Promise‹any›

Inherited from ClientAPI.callFunction

Invoke an OData function import. Returns a Promise which resolves to the result(if existing) of the operation

Parameters:

▪ serviceName: string

service name

▪ oFunction: object

function name

Name Type
Name string
Parameters? object

▪Optional headers: Object

optional -- request headers

Returns: Promise‹any›

returns a Promise which resolves to the result(if existing) of the operation

convertFilterCriteriaArrayToJSONString

▸ convertFilterCriteriaArrayToJSONString(filters: Array‹FilterCriteria›): string

Implementation of IClientAPI

Inherited from ClientAPI.convertFilterCriteriaArrayToJSONString

Convert array of FilterCriteria to JSON string, user can store it and restore back later using convertJSONStringToFilterCriteriaArray().

Example:

let jsonString = clientAPI.convertFilterCriteriaArrayToJSONString(sectionedTable.filters);

Parameters:

Name Type Description
filters Array‹FilterCriteria› array of FilterCriteria, e.g. filters of the sectioned table.

Returns: string

the JSON string

convertJSONStringToFilterCriteriaArray

▸ convertJSONStringToFilterCriteriaArray(jsonString: string): Array‹FilterCriteria›

Implementation of IClientAPI

Inherited from ClientAPI.convertJSONStringToFilterCriteriaArray

Convert JSON string to array of FilterCriteria, JSON string can be used the return value from convertFilterCriteriaArrayToJSONString().

Example:

sectionedTable.filters = clientAPI.convertJSONStringToFilterCriteriaArray(jsonString);

Parameters:

Name Type Description
jsonString string JSON string returned from convertFilterCriteriaArrayToJSONString().

Returns: Array‹FilterCriteria›

the array of FilterCriteria

count

▸ count(serviceName: string, entitySet: string, queryOptions?: string, headers?: Object, requestOptions?: Object): Promise‹any›

Implementation of IClientAPI

Inherited from ClientAPI.count

Perform a count on an entity set.

Parameters:

Name Type Description
serviceName string service name
entitySet string entityset name
queryOptions? string query options
headers? Object request headers
requestOptions? Object request options

Returns: Promise‹any›

returns a Promise which resolves to the result of the operation

create

▸ create(serviceName: string, entitySet: string, properties: object, createLinks: ILinkSpecifierProxy[], headers?: object, requestOptions?: object): Promise‹any›

Inherited from ClientAPI.create

Perform an operation to create odata entity. Returns a Promise which resolves to the result of the operation.

Parameters:

▪ serviceName: string

service name

▪ entitySet: string

entityset name

▪ properties: object

an object to sotre the propterties object with key/value pair

Name Type
key string
value any

▪ createLinks: ILinkSpecifierProxy[]

list of readlinks

▪Optional headers: object

request headers

Name Type
key string
value any

▪Optional requestOptions: object

request options

Name Type
key string
value any

Returns: Promise‹any›

createFilterCriteria

▸ createFilterCriteria(filterType: FilterType, name: string, caption: string, filterItems: Array‹object›, isFilterItemsComplex: boolean): FilterCriteria

Implementation of IClientAPI

Inherited from ClientAPI.createFilterCriteria

Create filter criteria for non-supported controls(except Filter & Sorter formcell) to be used in Filter page.

Example of how to get FilterType from createFilterCriteria:

let filterResult6 = clientAPI.createFilterCriteria(clientAPI.filterTypeEnum.Filter, undefined, undefined, result6, true);

Parameters:

Name Type Default Description
filterType FilterType - filterTypeEnum value (Filter or Sorter).
name string - Property name on which the filter is applied.
caption string - Name of the control.
filterItems Array‹object› - Array of filter items.
isFilterItemsComplex boolean false True if the filterItems contains logical/lambda operators, default is false. If set to true, name and caption properties are ignored.

Returns: FilterCriteria

the created FilterCriteria

createLinkSpecifierProxy

▸ createLinkSpecifierProxy(property: string, entitySet: string, queryOptions?: string, readLink?: string): ILinkSpecifierProxy

Implementation of IClientAPI

Inherited from ClientAPI.createLinkSpecifierProxy

Create LinkSpecifierProxy to be consumed by odata link action. one of queryOptions or readLink is required.

Parameters:

Name Type Description
property string property name
entitySet string entityset name
queryOptions? string query options
readLink? string readlink name

Returns: ILinkSpecifierProxy

deleteODataCacheImages

▸ deleteODataCacheImages(): void

Inherited from ClientAPI.deleteODataCacheImages

Delete OData Cache images

Returns: void

dismissActivityIndicator

▸ dismissActivityIndicator(id?: number): void

Implementation of IClientAPI

Inherited from ClientAPI.dismissActivityIndicator

Dismiss activity indicator

Parameters:

Name Type Description
id? number The id of the activity indicator to be dismissed. If no id is provided, the top activity indicator will be dismissed. Using ids ensures that the right text will be shown at all times if multiple indicators can be displayed, for example due to chained actions.

Returns: void

downloadInProgressForPage

▸ downloadInProgressForPage(page: string): boolean

Implementation of IClientAPI

Inherited from ClientAPI.downloadInProgressForPage

Determine if a dowload is in progress for this page

Parameters:

Name Type
page string

Returns: boolean

▸ downloadInProgressForReadLink(readLink: string): boolean

Implementation of IClientAPI

Inherited from ClientAPI.downloadInProgressForReadLink

Determine if a dowload is in progress for this readLink

Parameters:

Name Type
readLink string

Returns: boolean

evaluateTargetPath

▸ evaluateTargetPath(path: string): any

Implementation of IClientAPI

Inherited from ClientAPI.evaluateTargetPath

Evaluate the target path and return the value from the resulting context.

Parameters:

Name Type Description
path string the target path to be evaluated

Returns: any

the value from the resulting context. If an element is on the context, consider that the final value. Otherwise use binding.

evaluateTargetPathForAPI

▸ evaluateTargetPathForAPI(path: string): IClientAPI

Implementation of IClientAPI

Inherited from ClientAPI.evaluateTargetPathForAPI

Evaluate the target path and return the ClientAPI instance which encapsulates the result

Parameters:

Name Type Description
path string the target path to be evaluated. Cannot be undefined or empty

Returns: IClientAPI

a ClientAPI instance holding the result of target path evaluation, which can vary from a simple string to a view representation.

executeAction

▸ executeAction(actionPath: string): Promise‹IActionResult›

Implementation of IClientAPI

Inherited from ClientAPI.executeAction

Execute an action. To ensure that the application waits for the action to complete, you must return the Promise returned by this method as the result of the rule. Not doing this may cause the action binding and pressed item to be reset before the action completes.

Parameters:

Name Type Description
actionPath string the action path

Returns: Promise‹IActionResult›

formatBase64String

▸ formatBase64String(base64: string, contentType: string): string

Implementation of IClientAPI

Inherited from ClientAPI.formatBase64String

This method formats MDK base64 string with content type

Parameters:

Name Type Description
base64 string base64 string
contentType string base64 content type like "image/jpeg", "application/pdf"

Returns: string

formatted base64 string.

formatCurrency

▸ formatCurrency(value: number, currencyCode: string, customLocale?: string, customOptions?: any): string

Implementation of IClientAPI

Inherited from ClientAPI.formatCurrency

This method is to format number into currency display format according to selected locale

Parameters:

Name Type Description
value number numeric value to be formatted into currency display format
currencyCode string currency code to format
customLocale? string custom locale to be used in formatting the value
customOptions? any custom options to be used in formatting the value. The available options are:
  • minimumIntegerDigits: The number of integer digits allowed as output. Default is 1 (System default).
  • minimumFractionDigits: The minimum number of digits after the decimal separator allowed as output. Default is 0 (System default).
  • maximumFractionDigits: The maximum number of digits after the decimal separator allowed as output. The default is managed by system default based on currency code.
  • useGrouping: Determines whether the display should show the group separator. The default is managed by system default based on currency code.

Example: {maximumFractionDigits:2,useGrouping:true}

Returns: string

formatted number in currency display format

formatDate

▸ formatDate(date: Date, customLocale?: string, customTimeZone?: string, customOptions?: any): string

Implementation of IClientAPI

Inherited from ClientAPI.formatDate

This method is to format date object into locale Date string

Parameters:

Name Type Description
date Date date value to be formatted into locale string. Accepted values are datetime object, datetime in UTC string, timestamp number, datetimeoffset string
customLocale? string custom locale to be used in formatting the value
customTimeZone? string custom time zone to be used in formatting the value, must be a valid time zone name e.g. UTC, GMT+8, Europe/Berlin
customOptions? any custom options (in JSON object format) for formatting the value. Currently, the supported key is 'format' with the following possible value:
  • 'short'
  • 'medium'
  • 'long'
  • 'full'
Default: medium

Returns: string

formatted string

formatDatetime

▸ formatDatetime(date: Date, customLocale?: string, customTimeZone?: string, customOptions?: any): string

Implementation of IClientAPI

Inherited from ClientAPI.formatDatetime

This method is to format date object into locale DateTime string

Parameters:

Name Type Description
date Date date value to be formatted into locale string. Accepted values are datetime object, datetime in UTC string, timestamp number, datetimeoffset string
customLocale? string custom locale to be used in formatting the value
customTimeZone? string custom time zone to be used in formatting the value. Must be a valid time zone name e.g. UTC, GMT+8, Europe/Berlin
customOptions? any custom options (in JSON object format) for formatting the value. Currently, the supported key is 'format' with the following possible value:
  • 'short'
  • 'medium'
  • 'long'
  • 'full'
Default: medium (date), short (time)

Returns: string

formatted string

formatNumber

▸ formatNumber(value: number, customLocale?: string, customOptions?: any): string

Implementation of IClientAPI

Inherited from ClientAPI.formatNumber

This method is to format number according to selected locale

Parameters:

Name Type Description
value number numeric value to be displayed in format according to selected locale
customLocale? string custom locale to be used in formatting the value
customOptions? any custom options to be used in formatting the value. The available options are:
  • minimumIntegerDigits: The number of integer digits allowed as output. Default is 1 (System default).
  • minimumFractionDigits: The minimum number of digits after the decimal separator allowed as output. Default is 0 (System default).
  • maximumFractionDigits: The maximum number of digits after the decimal separator allowed as output. Default is 2 (MDK default).
  • useGrouping: Determines whether the display should show the group separator. Default is true (MDK default).

Example: {maximumFractionDigits:2,useGrouping:true}

Returns: string

formatted number

formatPercentage

▸ formatPercentage(value: number, customLocale?: string, customOptions?: any): string

Implementation of IClientAPI

Inherited from ClientAPI.formatPercentage

This method is to format number to into percent display format

Parameters:

Name Type Description
value number numeric value to be formatted into percent display string
customLocale? string custom locale to be used in formatting the value
customOptions? any custom options to be used in formatting the value. The available options are:
  • minimumIntegerDigits: The number of integer digits allowed as output. Default is 1 (System default).
  • minimumFractionDigits: The minimum number of digits after the decimal separator allowed as output. Default is 0 (System default).
  • maximumFractionDigits: The maximum number of digits after the decimal separator allowed as output. Default is 2 (MDK default).
  • useGrouping: Determines whether the display should show the group separator. Default is true (MDK default).

Example: {maximumFractionDigits:2,useGrouping:true}

Returns: string

formatted number in percentage

formatScientific

▸ formatScientific(value: number, customLocale?: string, customOptions?: any): string

Implementation of IClientAPI

Inherited from ClientAPI.formatScientific

This method is to format scientific style number according to selected locale

Parameters:

Name Type Description
value number numeric value to be displayed in scientific style according to selected locale
customLocale? string custom locale to be used in formatting the value
customOptions? any custom options to be used in formatting the value: The available options are:
  • minimumIntegerDigits: The number of integer digits allowed as output. Default is 1 (System default).
  • minimumFractionDigits: The minimum number of digits after the decimal separator allowed as output. Default is 0 (System default).
  • maximumFractionDigits: The maximum number of digits after the decimal separator allowed as output. Default is 2 (MDK default).
  • useGrouping: Determines whether the display should show the group separator. Default is true (MDK default).

Example: {maximumFractionDigits:2,useGrouping:true}

Returns: string

formatted number

formatTime

▸ formatTime(date: Date, customLocale?: string, customTimeZone?: string, customOptions?: any): string

Implementation of IClientAPI

Inherited from ClientAPI.formatTime

This method is to format date object into locale Time string

Parameters:

Name Type Description
date Date date value to be formatted into locale string. Accepted values are datetime object, datetime in UTC string, timestamp number, datetimeoffset string
customLocale? string custom locale to be used in formatting the value
customTimeZone? string custom time zone to be used in formatting the value. Must be a valid time zone name e.g. UTC, GMT+8, Europe/Berlin
customOptions? any custom options (in JSON object format) for formatting the value. Currently, the supported key is 'format' with the following possible value:
  • 'short'
  • 'medium'
  • 'long'
  • 'full'
Default: short

Returns: string

formatted string

getActionResult

▸ getActionResult(key: string): IActionResult

Implementation of IClientAPI

Inherited from ClientAPI.getActionResult

Get the action result stored under the unique key

Parameters:

Name Type
key string

Returns: IActionResult

getAppClientData

▸ getAppClientData(): IClientData

Implementation of IClientAPI

Inherited from ClientAPI.getAppClientData

Get the Application context client data object. This starts out as a plain JavaScript object, and can be modified to hold application state. Can only be accessed for IClientAPI instances associated with a UI element, because that guarantees that the data will last for the lifetime of that element.

Returns: IClientData

getAppEventData

▸ getAppEventData(): any

Implementation of IClientAPI

Inherited from ClientAPI.getAppEventData

Get the data which provides additional information about an app event, such as an app launch or exit, if such an event just occurred.

Returns: any

getAppearanceMode

▸ getAppearanceMode(): "light" | "dark"

Implementation of IClientAPI

Inherited from ClientAPI.getAppearanceMode

This method is to get current ui appearance of the app.

Returns: "light" | "dark"

return the current ui appearance as light or dark

getAvailableThemes

▸ getAvailableThemes(): string[]

Implementation of IClientAPI

Inherited from ClientAPI.getAvailableThemes

This method is to get available themes in app settings.

Returns: string[]

return available themes in array

getBindingObject

▸ getBindingObject(): Object

Implementation of IClientAPI

Inherited from ClientAPI.getBindingObject

Get the current context's binding object

deprecated - use the new property getter

Returns: Object

getCircularImage

▸ getCircularImage(base64EncodedImageStr: string): string

Implementation of IClientAPI

Inherited from ClientAPI.getCircularImage

Converts a regular rectangular image into a circular one.

Parameters:

Name Type Description
base64EncodedImageStr string The Base64 image string which is to be made circular

Returns: string

A Base64 string of the circular image, this image will be in PNG format.

getClientData

▸ getClientData(): IClientData

Implementation of IClientAPI

Inherited from ClientAPI.getClientData

Get the client data object. This starts out as a plain JavaScript object, and can be modified to hold application state. Can only be accessed for IClientAPI instances associated with a UI element, because that guarantees that the data will last for the lifetime of that element.

Returns: IClientData

getControl

▸ getControl(name: string): IControlProxy

Implementation of ISectionProxy

Find a control based on the name. It returns FormCell controls in section.

Parameters:

Name Type Description
name string the name of the control to match

Returns: IControlProxy

ControlProxy instance or undefined if not found

getControls

▸ getControls(): IControlProxy[]

Implementation of ISectionProxy

Get the list of controls in the Section if it is a FormCell Section.

Returns: IControlProxy[]

getDefinitionValue

▸ getDefinitionValue(target: string): Promise‹any›

Implementation of IClientAPI

Inherited from ClientAPI.getDefinitionValue

Return the value for given definition.

Parameters:

Name Type Description
target string : any valid definition like rule/action path/global path/binding/targetpath etc

Returns: Promise‹any›

Promise resolution.

getExtensions

▸ getExtensions(): IView[]

Implementation of ISectionProxy

Returns the extensions the section is using.

Returns: IView[]

getGlobalDefinition

▸ getGlobalDefinition(globalPath: string): any

Implementation of IClientAPI

Inherited from ClientAPI.getGlobalDefinition

Get the global definition for the specified path

Parameters:

Name Type
globalPath string

Returns: any

getGlobalSideDrawerControlProxy

▸ getGlobalSideDrawerControlProxy(): ISideDrawerControlProxy

Inherited from ClientAPI.getGlobalSideDrawerControlProxy

Get the global side drawer control proxy

Returns: ISideDrawerControlProxy

getIconTextImage

▸ getIconTextImage(iconText: string, width: number, height: number, isCircular: true, stylesJSON?: string): string

Implementation of IClientAPI

Inherited from ClientAPI.getIconTextImage

Creates an Image out of text provided in the iconText parameter. A max of two letters can be displayed on the image.

Parameters:

Name Type Description
iconText string Text that is to be used for generating the IconTextImage
width number Width of the image
height number Heght of the image
isCircular true Decides whether the image should be circular in shape
stylesJSON? string FontSize, FontColor and BackgroundColor can be given in a Json to style the IconTextImage

Returns: string

a Base64 string of IconTextImage.

getLanguage

▸ getLanguage(): string

Implementation of IClientAPI

Inherited from ClientAPI.getLanguage

This method is to get current app language from app settings.

Returns: string

app language

getLoadedItemsCount

▸ getLoadedItemsCount(): number

Implementation of ISectionProxy

This method returns the number of loaded items in the section.

Returns: number

getLogger

▸ getLogger(): LoggerManager

Implementation of IClientAPI

Inherited from ClientAPI.getLogger

Get the singleton instance of the LoggerManager. If it has not been initialized yet, it throws exception

Returns: LoggerManager

getMobileServiceAppId

▸ getMobileServiceAppId(): string

Implementation of IClientAPI

Inherited from ClientAPI.getMobileServiceAppId

This method is to get AppId used for application in SAP Mobile Services.

Returns: string

getMobileServiceEndpointUrl

▸ getMobileServiceEndpointUrl(): string

Implementation of IClientAPI

Inherited from ClientAPI.getMobileServiceEndpointUrl

This method is to get Endpoint Url of connection to application in SAP Mobile Services.

Returns: string

getName

▸ getName(): string

Implementation of ISectionProxy

Get the section name

Returns: string

getODataProvider

▸ getODataProvider(serviceName: string): ODataProviderProxy

Implementation of IClientAPI

Inherited from ClientAPI.getODataProvider

Get OData provider based on service name

Parameters:

Name Type
serviceName string

Returns: ODataProviderProxy

getPageDefinition

▸ getPageDefinition(pagePath: string): any

Implementation of IClientAPI

Inherited from ClientAPI.getPageDefinition

Get Page metadata definition for the specified path as JSON object.

Parameters:

Name Type
pagePath string

Returns: any

getPageProxy

▸ getPageProxy(): IPageProxy

Implementation of ISectionProxy

Return the page proxy, which the SectionedTable belongs to

Returns: IPageProxy

getPasscodeSource

▸ getPasscodeSource(): number

Implementation of IClientAPI

Inherited from ClientAPI.getPasscodeSource

Return Passcode Source.

0 - no passcode or unknown, 1 - user, 2 - device(iOS Only) 3 - Device and User (Android Only) Note: Android must always have a passcode for biometrics hence value 3

Returns: number

getPendingDownload

▸ getPendingDownload(page: string): any

Implementation of IClientAPI

Inherited from ClientAPI.getPendingDownload

This method delgates to the AppSettingsManager to determine if the current page has a pending download.

Parameters:

Name Type Description
page string page object path

Returns: any

returns a pending download for this page, which is a JSON action binding associated with the download. Otherwise undefined

getProperty

▸ getProperty(): string

Implementation of ISectionProxy

Get the property name being bound, one of the property names in a section definition

Returns: string

▸ getReadLink(path: string): string

Implementation of IClientAPI

Inherited from ClientAPI.getReadLink

get the current context's binding's read link if any. Undefined otherwise

Parameters:

Name Type Description
path string target path into the binding

Returns: string

getRegion

▸ getRegion(): string

Implementation of IClientAPI

Inherited from ClientAPI.getRegion

This method is to get current app region from app settings.

Returns: string

app region

getRegions

▸ getRegions(): Object

Implementation of IClientAPI

Inherited from ClientAPI.getRegions

This method is to get list of regions

Returns: Object

list of regions in key value pairs

getSAPPassportHeaderValue

▸ getSAPPassportHeaderValue(componentName: string, action: string, traceFlag: string, componentType: string, prevComponentName?: string, userId?: string): string

Implementation of IClientAPI

Inherited from ClientAPI.getSAPPassportHeaderValue

Get SAP Passport header value

Parameters:

Name Type Description
componentName string Name of the initial component. Default to 'MDK' if empty or null.
action string Name of executed action. Default to 'HTTP_Request' if empty.
traceFlag string Trace configuration. Accepted values are: StatisticsOnly, SAPTraceLevel_SQL, SAPTraceLevel_Buffer, SAPTraceLevel_Enqueu, SAPTraceLevel_RFC, SAPTraceLevel_Permission, SAPTraceLevel_Free, SAPTraceLevel_CFunction, DSR_ABAP_Trace_Flag, SAPTraceLevel_ABAPCondens0, SAPTraceLevel_ABAPCondens1, DSR_SAT_Trace_Flag, ESP_WebService_Flag, HTTP, TRCLVL_None, TRCLVL_Low, TRCLVL_Medium, TRCLVL_High Default to 'TRCLVL_Low' if empty or null.
componentType string Type of initial component. Accepted values are: Undefined, Webas, J2EE, Trex, ICM, Gateway, CPIC, Browser, TraceLib, DotNet, Eclipse, PI_For_SAP_Sender, SCP_For_NonSAP_Sender, PI_For_NonSAP_Sender, SAP_Partner, SCP_Request_Or_Determination_Later_In_Processing, S4, SFSF, Ariba, Concur, Fieldglass, Callidus, BYD, IBP, Hybris, SMB_B1, Industry_Cloud, Leonardo, Customer_Checkout, CoPilot Default to 'Undefined' if empty or null.
prevComponentName? string Optional. Name of previous component. Default to initial component name if unspecified.
userId? string Optional. ID of user who is processing the request. Default to '' if unspecified.

Returns: string

it returns a string of SAP Passport value to be used on request header. The header name to be used is "SAP-PASSPORT"

getSupportedLanguages

▸ getSupportedLanguages(): Object

Implementation of IClientAPI

Inherited from ClientAPI.getSupportedLanguages

This method is to get list of supported languages

Returns: Object

list of supported languages in key value pairs

getTheme

▸ getTheme(): string

Implementation of IClientAPI

Inherited from ClientAPI.getTheme

This method is to get current theme from app settings.

Returns: string

return the current theme

getType

▸ getType(): string

Implementation of ISectionProxy

Get the section type

Returns: string

getVersionInfo

▸ getVersionInfo(): Object

Implementation of IClientAPI

Inherited from ClientAPI.getVersionInfo

Get the versions of application, definitions, SDK & etc

Returns: Object

it returns an array of key/value pairs to represent the versions for different components. iOS app and Android app may have different components and versions.

iOS app may inlcude the following keys: "Application Version", "Definitions Version", "SAPMDC", "SAPCommon", "APFiori", "SAPFioriFlows", "SAPFoundation", "SAPOfflineOData", "SAPOData"

Android app may include the following keys: "Application Version", "Definitions Version", "MDKClient Version", "com.sap.cloud.android:foundation", "com.sap.cloud.android:onboarding", "com.sap.cloud.android:fiori", "com.sap.cloud.android:odata", "com.sap.cloud.android:offline-odata"

WebApp may include the following keys: "Definition Version", "WebClient Version", "@ui5/webcomponents Version", "ui5-webcomponents-mdk Version"

getVisible

▸ getVisible(): boolean

Implementation of ISectionProxy

Get the section visible property

Returns: boolean

initializeLogger

▸ initializeLogger(fileName: any, maxFileSize: any): void

Inherited from ClientAPI.initializeLogger

Initializes the LoggerManager and adds the log file handlers

Parameters:

Name Type Default Description
fileName any undefined Optional, File name of the local log file on the client device. If missing, default value is ClientLog.txt
maxFileSize any undefined Optional, Max file size before rollover of the local log file on the client device. If missing, default value is 5MB

Returns: void

isAppInMultiUserMode

▸ isAppInMultiUserMode(): Boolean

Implementation of IClientAPI

Inherited from ClientAPI.isAppInMultiUserMode

Determine if the application is in single or multi user mode.

Returns: Boolean

isCurrentPage

▸ isCurrentPage(pageName: string): boolean

Implementation of IClientAPI

Inherited from ClientAPI.isCurrentPage

Determine if the page is the topmost page in the navigation stack

Parameters:

Name Type
pageName string

Returns: boolean

isDemoMode

▸ isDemoMode(): Boolean

Implementation of IClientAPI

Inherited from ClientAPI.isDemoMode

Determine if it is in demo mode

Returns: Boolean

isMediaLocal

▸ isMediaLocal(serviceName: string, entitySet: string, readLink: string): Promise‹boolean›

Implementation of IClientAPI

Inherited from ClientAPI.isMediaLocal

Get whether or not the media object for the supplied readLink exists and is local

Parameters:

Name Type Description
serviceName string service name
entitySet string entityset name
readLink string readlnk name

Returns: Promise‹boolean›

a promise with a boolean result once it is resolved

isStaticSection

▸ isStaticSection(): boolean

Implementation of ISectionProxy

The bound object type, if true binding object is definition

Returns: boolean

localizeText

▸ localizeText(key: string, dynamicParams?: string[]): string

Implementation of IClientAPI

Inherited from ClientAPI.localizeText

This method is to localize text

Parameters:

Name Type Description
key string key of text to be localized
dynamicParams? string[] -

Returns: string

localized text

read

▸ read(serviceName: string, entitySet: string, properties: string[], queryOptions?: string, headers?: Object, requestOptions?: Object): Promise‹any›

Implementation of IClientAPI

Inherited from ClientAPI.read

Perform a query on an entity set. Returns a Promise which resolves to the result of the operation

Parameters:

Name Type Description
serviceName string service name
entitySet string entityset name
properties string[] list of properties to be read
queryOptions? string query optins
headers? Object request headers
requestOptions? Object request options

Returns: Promise‹any›

returns a Promise which resolves to the result of the operation

redraw

▸ redraw(fullSection: boolean): Promise‹any›

Implementation of ISectionProxy

Redraw the section

Parameters:

Name Type Default Description
fullSection boolean false false whether redraw full section or redraw on update items only

Returns: Promise‹any›

sendMobileServiceRequest

▸ sendMobileServiceRequest(path: string, params?: any): Promise‹any›

Implementation of IClientAPI

Inherited from ClientAPI.sendMobileServiceRequest

Send a request to application's SAP Mobile Services

deprecated - use the new sendRequest API

Parameters:

Name Type
path string
params? any

Returns: Promise‹any›

sendRequest

▸ sendRequest(path: string, params?: any): Promise‹IHttpResponse›

Implementation of IClientAPI

Inherited from ClientAPI.sendRequest

This method is to send a request to application's SAP Mobile Services.

  • Example of the params parameter: 
    {
  "method": "<string>",
  "header": {
    "<key1>": "<value as string>",
    "<key2>": "<and so on>",
  },
  "body": "<string>"
}

Parameters:

Name Type Description
path string Relative path of request via application's SAP Mobile Services.
params? any Optional. An object consists of method, header, and body of request.
Note: If params is not given, request is set as GET method by default. See description above for the example.
  • method is string representing the HTTP Method to use. Supported value for methods are: GET, HEAD, POST, PUT, DELETE, PATCH, CONNECT, OPTIONS, and TRACE.
  • header should be an object with key-value pair
  • body should be request body String, Binary, FormData, JSON object or Array.
  • - String should be a string converted from data payload based on the "Content-Type" set in header.
  • - Binary should be native data from file. The "Content-Type" in header should be set according to the content of file.
  • - FormData is converted to binary with the request body specially formatted as a series of "parts", separated with MIME boundaries. The "Content-Type" in header should be set to multipart/form-data.
  • - JSON Object or Array is converted to JSON string. The "Content-Type" in header is set to application/json by default.
    		•

    Returns: Promise‹IHttpResponse›

    Returns a Http response object

    setApplicationIconBadgeNumber

    ▸ setApplicationIconBadgeNumber(badge: number): void

    Implementation of IClientAPI

    Inherited from ClientAPI.setApplicationIconBadgeNumber

    Set the application icon badge number Note: This function is for iOS only

    Parameters:

    Name Type Description
    badge number the number to set

    Returns: void

    setDebugSettings

    ▸ setDebugSettings(debugODataProvider: boolean, tracingEnabled: boolean, categories: string[]): void

    Implementation of IClientAPI

    Inherited from ClientAPI.setDebugSettings

    Client API to enable/override the DebugSettings during runtime

    Parameters:

    Name Type Default Description
    debugODataProvider boolean false boolean to add console logger to the OData provider set to Debug level
    tracingEnabled boolean false boolean to turns on tracing (execution time) for rules, actions, and so on.
    categories string[] [] array of tracing categories to enable the console log based on categories.

    Returns: void

    setIndicatorState

    ▸ setIndicatorState(newState: string, pressedItem: PressedItem): any

    Implementation of ISectionProxy

    Set the interacting object cell indicator's state in the section

    Parameters:

    Name Type Description
    newState string the new state of the indicator (possible values: toDownload, inProgress, open)
    pressedItem PressedItem the pressed object cell in the section

    Returns: any

    setLanguage

    ▸ setLanguage(languageKey: string): void

    Implementation of IClientAPI

    Inherited from ClientAPI.setLanguage

    This method is to set app language into app settings.

    Parameters:

    Name Type Description
    languageKey string language key

    Returns: void

    setRegion

    ▸ setRegion(region: string): void

    Implementation of IClientAPI

    Inherited from ClientAPI.setRegion

    This method is to set app region into app settings.

    Parameters:

    Name Type Description
    region string region

    Returns: void

    setTheme

    ▸ setTheme(newTheme: string): boolean

    Implementation of IClientAPI

    Inherited from ClientAPI.setTheme

    This method is to set theme into app settings and apply for application. Application will restart from main page, with new theme effect.

    Parameters:

    Name Type Description
    newTheme string theme name

    Returns: boolean

    return set theme result in boolean

    setVisible

    ▸ setVisible(value: boolean, redraw: boolean): Promise‹any›

    Implementation of ISectionProxy

    Sets the section's visible state with / without redraw

    Parameters:

    Name Type Default Description
    value boolean - visible state
    redraw boolean true true whether redraw the section after setting the visible state

    Returns: Promise‹any›

    showActivityIndicator

    ▸ showActivityIndicator(text?: string): number

    Implementation of IClientAPI

    Inherited from ClientAPI.showActivityIndicator

    Show activity indicator with specified text

    Parameters:

    Name Type Description
    text? string The text to be shown

    Returns: number

    The id which can be used to dismiss the activity indicator

    updateProgressBanner

    ▸ updateProgressBanner(message: string): void

    Implementation of IClientAPI

    Inherited from ClientAPI.updateProgressBanner

    Update an existing progress banner with new text. If no progress banner action is in progress, no banner will be displayed.

    Parameters:

    Name Type Description
    message string The text to show on the progress banner

    Returns: void

    Static Create

    ▸ Create(context: IContext): ClientAPI

    Inherited from ClientAPI.Create

    Create an instance of ClientAPI or its extended classes such as PageProxy, ControlProxy.

    Parameters:

    Name Type Description
    context IContext an object with IContext type to represent the UI element

    Returns: ClientAPI