Application Parameters

Application Parameters are defined per Mobile Applications and are categorized. They are either system defined or App defined.

Administrator can define the parameter value for each parameter from a given drop down or free text entry.

System Defined Parameters

The following parameters are system defined and available in all mobile applications.

Device Parameters

The following parameters are used to configure the mobile applications on the device.

General Device Parameters

The following parameters are used to configure general settings of the mobile application on the device.

Parameter Description Default Value
SEND_LOGS_WITH_DATA_DEFAULT Send Device Logs Default Setting. Used by IFS Aurena Native Apps only FALSE
TREE_STRUCTURE_MAIN_ACTION Tree structure app setting. Used by IFS Aurena Native Apps only PinNode

 

Data Synchronization Parameters

The following parameters are used to configure the way data is synchroinzed between IFS Applications and the mobile application devices.

Parameter Description Default Value
DEFAULT_SYNC_INTERVAL Identifies the interval before the next synchronization with IFS Applications 60
DATA_CHUNK_SIZE Maximum data chunk size before data is split 100
SERVER_CAPABILITIES Server Capabilities. Used by IFS Aurena Native Apps only ConnectMedia^
SYNC_DATA_TRANSFER_MODE Sync Data Transfer Mode. Used by IFS Aurena Native Apps only GROUPED

 

Device Barcode Scanning Parameters

The following parameters are used to configure the mobile applications barcode scanning capabilities on the devices.

Parameter Description Default Value
BARCODE_SCANNING_ENABLED Determines whether to enable barcode scanning for all text data using the context menu. Used by IFS Aurena Native Apps only TRUE
SCANDIT_APP_KEY_ANDROID Android App Key for Scandit Barcode Scanner provided by Scandit  
SCANDIT_APP_KEY_IOS iOS App Key for Scandit Barcode Scanner provided by Scandit  
SCANDIT_APP_KEY_WINDOWS Windows App Key for Scandit Barcode Scanner provided by Scandit  
ENABLE_BARCODE_SCANNING Determines whether to enable barcode scanning for all text data using the context menu on iOS and Android. Not used by IFS Aurena Native Apps Y

 

Note 1: If the Scandit License Key is set then Scandit will be used for scanning bar codes

Note 2: If the Scandit License Key is invalid then it will be impossible to scan bar codes.

 

Device Location Parameters

The following parameters are used to configure the device location settings used within the mobile applications.

Parameter Description Default Value
LOCATION_TRACKING_MODE Whether the app should continually track location and, if so, how accurate the locations should be. Used by IFS Aurena Native Apps only COARSE
LOCATION_TRACKING_INTERVAL_MIN The length of time between updates when continually tracking location. Used by IFS Aurena Native Apps only 15
LOCATION_ON_DEMAND_MODE Whether the app should be able to obtain the device location when requested and, if so, how accurate the location should be. Used by IFS Aurena Native Apps only FINE
GPS_LOCATION_INTERVAL_MIN Identifies the number of minutes before the GPS location is automatically recorded. Not used by IFS Aurena Native Apps only 15

 

Embedded Map Parameters

The following parameters are used to configure embedded maps

Parameter Description Default Value
EMBEDDED_MAP_ANDROID Specifies if and what embedded map is used within the mobile app on Android. Used by IFS Aurena Native Apps only Disabled
EMBEDDED_MAP_IOS Specifies if and what embedded map is used within the mobile app on iOS. Used by IFS Aurena Native Apps only Disabled
EMBEDDED_MAP_WINDOWS Specifies if and what embedded map is used within the mobile app on Windows. Used by IFS Aurena Native Apps only Disabled

 

Device Security Parameters

The following parameters are used to configure the device security settings used within the mobile applications.

Parameter Description Default Value
PIN_AUTHENTICATION PIN authentication enabled. Used by IFS Aurena Native Apps only FALSE

 

Picture Handling Parameters

The following parameters are used to configure picture handling used within the mobile application devices.

Parameter Description Default Value
PICTURE_MAX_DIMENSION Maximum picture dimension when synchronizing. Any larger sizes than stated value would be resized to value entered. 2000
PICTURE_MAX_BYTES Maximum picture bytes when synchronizing. Any larger sizes than stated value would be resized to value entered. 1048576
EXISTING_DEVICE_MEDIA_ALLOWED Exisiting device media allowed. Used by IFS Aurena Native Apps only TRUE
COMPRESS_IMAGES_ON_DOWNLOAD Compress images on download. Used by IFS Aurena Native Apps only NO_COMPRESSION
SYNC_MEDIA_TO_MOBILE Sync Media to Mobile. Not used by IFS Aurena Native Apps only TRUE

 

Synchronization Process Parameters

The following parameters are used to control the synchronization process.

Database Process Parameters

The following parameters are used to configure the database processes used to collect and send data to the mobile application devices.

Parameter Description Default Value
GROUPED_PUSH_DATA_INTERVAL Grouped Push data restartup interval (seconds) 10
GROUPED_PUSH_ENABLED Grouped Push data available ON
MAX_PUSH_EVENTS_ERROR_COUNT Maximum number of error lines display when retry create push triggers 10
PUSH_DATA_INTERVAL Push data restartup interval (seconds) 10
PUSH_ENABLED Push data available ON
SERVER_LOG Database Extended logging OFF

 

Push Notification Parameters

The following parameters are used to configure the push notifications to be sent to the mobile application devices.

Parameter Description Default Value
NOTIFICATION_HUB_PATH Notification Hub Path. Used by IFS Aurena Native Apps only  
NOTIFICATION_HUB_URL Notification Hub URL. Used by IFS Aurena Native Apps only  
NOTIFY_THROUGH_IFS_AURENA_BOT Send push notifications to the IFS Aurena Bot. Used by IFS Aurena Native Notify Me App only  

 

Note 1: An Azure Notification Hub is used to deliver Push Notifications from IFS Applications to the IFS Aurena Native Apps. It is possible to create your own Azure Notification Hub for sending of Push Notifications. To do this the NOTIFICATION_HUB_PATH must be set to the Azure Notification Hub Name and the NOTIFICATION_HUB_URL must be set to the Connection String relating to the Access Policy Name "DefaultFullSharedAccessSignature".

 

Grouped Push Parameters

If the mobile application uses the Synchronization Rule Delivery Method of Grouped Push then the following system parameters will be available.

Note 1: With the exception of Trace Level and Clean Up Parameters the default values of the Grouped Push Parameters are adequate for all installations. It is therefore only recommended to change Grouped Push Parameters with full understanding of these parameters and potential impact on the installation.

Trace Level Parameters

These parameters control the information collected in the Grouped Push Transaction Traces

Parameter Description Default Value
BATCH_TRACE_LEVEL Trace level for Grouped Push main task WARNING
INIT_TRACE_LEVEL Trace level for Grouped Push INIT sub-task WARNING
TRIGGER_TRACE_LEVEL Travel level for Grouped Push triggers WARNING


These parameters can be set with one of the following trace levels:

Note 1: Trace levels INFO, TRACE and DEBUG may generate huge number of records in Grouped Push Transaction Traces. It is therefore recommended to not leave these parameter set to any value other than STAT or WARNING for longer than a few hours.

Fetch Size Parameters

These parameters control the number of rows fetched to PL/SQL memory in one SQL call within the Grouped Push process. Changing these affects the trade-off between execution time and memory usage:

Parameter Description Default Value
FETCH_SIZE_DATA Number of entity data rows without LOB columns fetched from the database to PL/SQL memory in one SQL call 2000
FETCH_SIZE_LOB_DATA Number of entity data rows containing LOB columns fetched from the database to PL/SQL memory in one SQL call 500
FETCH_SIZE_LOG Number of transaction log rows fetched from the database to PL/SQL memory in one SQL call 5000
FETCH_SIZE_OBJKEY Number of OBJKEYs fetched from the database to PL/SQL memory in one SQL call 10000

Schedule and Interval Parameters

These parameters control teh frequency of background operations within the Grouped Push process

Parameter Description Default Value
CONFIG_REPEAT_INTERVAL Configuration cache tables will be refreshed when the configuration is changed, but not more often than the value of this parameter (in seconds) 10
INIT_SCHEDULE Scheduling expression for creation of INIT transactions in background (MobileSyncRule Syntax or Oracle Scheduler Calendaring Syntax) FREQ=DAILY; BYHOUR=1
INIT_REPEAT_INTERVAL INIT transactions are created according to schedule, but not more often than the value of this parameter (in seconds) 60
REFRESH_REPEAT_INTERVAL Refresh transactions are created according to schedule, but not more often than the value of this parameter (in seconds) 60
TRANSACTION_RETRY_INTERVAL Background processing of a failed transaction will be retried, but not more often than the value of this parameter (in seconds) 60
TRANSACTION_MOVE_INTERVAL All unprocessed (Grouped) transactions will be moved to current SCN time when the first one becomes older than the value of this parameter (in seconds) 3000

Validity Lifetime Parameters

These parameters define the maximum lifetime of database rows within the Grouped Push process

Parameter Description Default Value
CONFIG_VALID_LIFETIME Configuration cache tables will be refreshed not less often than the value of this parameter (in hours) 24
TRACE_STAT_LIFETIME Tracing data in table MOBILE_TRANSACTION_STAT_TAB older than the value of this parameter (in days) will be deleted by cleanup background job 30

Clean Up Parameters

These parameters control the background process deleting outdated Grouped Push data. Committing too many rows in one transaction may lead to unnecessary usage of rollback segments.

Parameter Description Default Value
CLEANUP_FETCH_SIZE Number of ROWIDs fetched from the database to PL/SQL memory in one SQL call when deleting outdated transactions 1000000
CLEANUP_COMMIT_CHUNK Number of rows to delete in one commit chunk when deleting outdated transactions 10000
CLEANUP_COMMIT_MESSAGE_CHUNK Number of rows to delete in one commit chunk when deleting outdated JSON messages 100

Grouped Push Processing Parameters

These parameters are used in the Grouped Push Processing

Parameter Description Default Value
MAX_MESSAGE_SIZE Maximum size in KB of uncompressed JSON data message sent to offline database 1000
MAX_TASK_EXECUTION_TIME Background task quits when there is nothing to do, or, when execution time becomes longer than the value of this parameter (in seconds) 60
PARALLEL_INIT_ENTITIES List of entities to generate PARALLEL query hint for during creation of INIT transaction: [:], [:], ...  

 

Note 1: In Oracle you can run a select with a hint to make it run in parallel over multiple cores utilising Oracle Parallel Query which can be used by the Group Push process by changing the PARALLEL_INIT_ENTITIES parameter. By default the Group Push process runs on a single core.