Application module

Important

The finance and operations (Dynamics 365) mobile app and platform are no longer supported. The platform components supporting the mobile app will be removed in a future update. The mobile app has also been removed from app stores. Previously installed instances of the app will continue to work. For more information, see Removed or deprecated platform features.

An application is a unit of runtime execution with sandboxing around concepts and data used inside of it. Each application consists of pages, actions, data queries, and logic that glue them together. An application is primarily described with a declarative metadata system, and can have an accompanying imperative extension model.

The imperative extension of the application is typically defined in a script module with a designated entry point, the main function, which allows the imperative logic to integrate with the application life cycle.

Index

Types

Functions

Types

Application

Hierarchy

Application

Properties

Name Signature Description
minVersion minVersion: string (optional)
An optional marker to indicate the minimum platform version required by this component. When this value is specified and the component tries to load in an older version of the platform, the corresponding workspace is not loaded and user is directed to install a newer version of the platform.

Methods

Name Signature Description
appInit appInit(metadata: ApplicationMetadata): any This method is invoked at the point the application is about to run, with the instance of the application metadata loaded. The metadata passed in can be still modified to change behaviors before this method returns.

ApplicationMetadata

Hierarchy

ApplicationMetadata

Properties

Name Signature Description
ColorName ColorName: string (optional)
The theme color of the application
Configs Configs: [name: string]: any (optional)
An application can have a set of named config supplied by the author or the resource provider
Description Description: string (optional)
The description of the application
IconName IconName: string (optional)
The representative icon of the application
ID ID: string
The unique identifier of the application
Title Title: string
The title of the application

Functions

main

main(metadataService: MetadataService, dataService: DataService, cacheService: CacheService, asyncService: AsyncService): Application

The main method of a business logic module. Each business logic module (as JavaScript file) must contain one main method. The method is invoked when the module is loaded and is being initialized. The method must return the component to run from this module.

Parameters

Name Type Description
metadataService MetadataService
dataService DataService
cacheService CacheService
asyncService AsyncService

Returns Application