EqContext class

August 19, 2020

Encapsulates all information about EasyQuery components on some webpage and provides some basic operation over those components Each context includes the following main components:

  • one data model,
  • one query,
  • one result set
  • several UI widgets.

Index

Constructors

Public Properties

Protected Properties

Public Methods

Constructors

constructor

⊕ new EqContext(): EqContext

Public Properties

clientListRequestHandler

● clientListRequestHandler: (data: any, callback: (list: any) => void) => boolean

defaultModelId

● defaultModelId?: string

defaultQueryId

● defaultQueryId?: string

initialQuery

● initialQuery?: QueryData

loadModelOnStart

● loadModelOnStart: boolean = true

loadQueryOnStart

● loadQueryOnStart: boolean = false

resultContent

● resultContent?: string

resultSet

● resultSet?: EqDataTable

resultStatement

● resultStatement?: string

useBootstrap

● useBootstrap: boolean = false

Protected Properties

antiForgeryToken

● antiForgeryToken: string

Public Methods

addDefaultExporters

▸ addDefaultExporters(): void

Returns void

addEventListener

Adds event listener for event type.

▸ addEventListener(eventType: "ready",handler: () => void): string

Parameters:

  • eventType: "ready" - The event type
  • handler: () => void - The handler for event

Returns string

▸ addEventListener(eventType: "loadModel" | "initialModelLoad",handler: (model: DataModel) => void): string

Parameters:

  • eventType: "loadModel" | "initialModelLoad"
  • handler: (model: DataModel) => void

Returns string

▸ addEventListener(eventType: "loadQuery",handler: (query: Query) => void): string

Parameters:

  • eventType: "loadQuery"
  • handler: (query: Query) => void

Returns string

▸ addEventListener(eventType: "processStart" | "processEnd",handler: (message: StatusMessage) => void): string

Parameters:

  • eventType: "processStart" | "processEnd"
  • handler: (message: StatusMessage) => void

Returns string

▸ addEventListener(eventType: "error",handler: (error: StatusMessage) => void): string

Parameters:

Returns string

addLocale

Adds the translations of the EasyQuery messages for some locale

▸ addLocale(locale: string,localeTexts: any): void

Parameters:

  • locale: string - the ISO code of the locale (like en or uk)
  • localeTexts: any - The translations of EasyQuery texts and messages. We expected an object with the struture of TextResources class here.

Returns void

addQueryChangedCallback

Register a new handler for 'query changed' event

▸ addQueryChangedCallback(callback: any): void

Parameters:

  • callback: any -

Returns void

addWidget

Add a new widget to the context. After that the widget will start to receive messages from other context components.

▸ addWidget(widget: Widget): void

Parameters:

Returns void

callWhenModelLoaded

▸ callWhenModelLoaded(callFunc: any): void

Parameters:

  • callFunc: any

Returns void

clearQuery

Clears the content of the current query

▸ clearQuery(): void

Returns void

clearResult

Clears all query results (the data set and the statement, if any)

▸ clearResult(): void

Returns void

endProcess

Notifies all context components about the finishing of some long process

▸ endProcess(message: StatusMessage,groups?: WidgetGroup): void

Parameters:

Returns void

executeQuery

Executes the current query and processes the result.

▸ executeQuery(options?: any): void

Parameters:

  • options: any, Optional - The content of the options parameter depends on QueryExecutor implementation. Usually it contains page property which defines the page of the executed result (e.g. 2), success and error callbacks

Returns void

Example:


context.executeQuery({
     page: 2
})

exportResult

Executes the current query and exports the result to the specified format.

▸ exportResult(options?: any): void

Parameters:

  • options: any, Optional - The content of the options parameter depends on EqExporter implementation. Usually it contains format property which defines the format of the exported data (e.g. csv), success and error callbacks

Returns void

Example:


context.exportResult({
     format: csv
});

fireEvent

Fires event.

▸ fireEvent(eventType: "ready"): any

Parameters:

  • eventType: "ready" - The event type.

Returns any

▸ fireEvent(eventType: "loadModel" | "initialModelLoad",data: DataModel): any

Parameters:

  • eventType: "loadModel" | "initialModelLoad"
  • data: DataModel

Returns any

▸ fireEvent(eventType: "loadQuery",data: Query): any

Parameters:

  • eventType: "loadQuery"
  • data: Query

Returns any

▸ fireEvent(eventType: "processStart" | "processEnd",data: StatusMessage): any

Parameters:

Returns any

▸ fireEvent(eventType: "error",data: Error): any

Parameters:

  • eventType: "error"
  • data: Error

Returns any

getBaseEndpoint

▸ getBaseEndpoint(): string

Returns string

getBroker

Gets the current broker component. REMOVE!!!!!

▸ getBroker(): this

Returns this

getExporter

▸ getExporter(format: string): EqExporter | null

Parameters:

  • format: string

Returns EqExporter | null

getListRequestHandler

Gets the handler for 'GetList' requests

▸ getListRequestHandler(): any

Returns any

getModel

Gets the current data model

▸ getModel(): DataModel

Returns DataModel

getQuery

Gets the current query

▸ getQuery(): Query

Returns Query

getServices

▸ getServices(): EqServiceProvider

Returns EqServiceProvider

init

Initializes the context

▸ init(options?: EqContextOptions): void

Parameters:

Returns void

loadDefaultModel

If defaultModelId property is define - this method calls loadModel function in the broker to load the model with such ID.

▸ loadDefaultModel(): void

Returns void

loadModel

Starts the process of the model loading. This method can initiate a request to EasyQueryServer backend or get the model from OData or GraphQL endpoint The content of the options parameter depends on concrete loader implementation.

▸ loadModel(options?: any): Promise<DataModel>

Parameters:

  • options: any, Optional - A map of options to pass to loadModel function (can be ommited)

Returns Promise<DataModel>

Example:


context.loadModel()
   .then(model => {
      alert("Model loaded!");
   });

loadModelFromData

Sets the content of the current data model

▸ loadModelFromData(modelPlainData: ModelPlainData): void

Parameters:

Returns void

loadQuery

Loads the query

▸ loadQuery(options?: any): void

Parameters:

  • options: any, Optional - The content of the options parameter depends on QueryStorage implementation. Usually it contains success, error callbacks and id option of query to load.

Returns void

Example:


context.loadQuery({
     id: "query-id"
});

loadQueryList

Loads the list of queries available for the current user.

▸ loadQueryList(options?: any): void

Parameters:

  • options: any, Optional - The content of the options parameter depends on QueryStorage implementation. Usually it contains success, error callbacks

Returns void

loadValueList

Sends a loadValueList requesthe server and processes the response.

▸ loadValueList(options?: any): void

Parameters:

  • options: any, Optional - A map of options to pass to loadValueList function.

Returns void

newQuery

Creates a new query and returns its content back to the client-side.

▸ newQuery(options?: any): void

Parameters:

  • options: any, Optional - The content of the options parameter depends on QueryStorage implementation. Usually it contains success, error callbacks and silent option

Returns void

Example:


context.newQuery({
   silent: true
});

refreshWidgets

This method is called automatically when some change was made either in context's data model or query

▸ refreshWidgets(groups?: WidgetGroup): void

Parameters:

  • groups: WidgetGroup, Default value = WidgetGroup.All -

Returns void

registerExporter

▸ registerExporter(format: string,resolver: EqExporterResolver): void

Parameters:

  • format: string
  • resolver: EqExporterResolver

Returns void

removeEventListener

Remove event handler for event type .

▸ removeEventListener(eventType: string,handlerId: string): void

Parameters:

  • eventType: string - The event type.
  • handlerId: string - The handler id.

Returns void

removeQuery

Removes the current query from some storage on the server-side.

▸ removeQuery(options?: any): void

Parameters:

  • options: any, Optional - The content of the options parameter depends on QueryStorage implementation. Usually it contains success and error callbacks

Returns void

removeQueryChangedCallback

Removes the function from the list of registerd handlers for 'query changed' event

▸ removeQueryChangedCallback(callback: any): void

Parameters:

  • callback: any -

Returns void

resetListCache

Clears the current list cache.

▸ resetListCache(): void

Returns void

resolveEndpoint

▸ resolveEndpoint(endpointKey: EqEndpointKey,options?: any): string

Parameters:

  • endpointKey: EqEndpointKey
  • options: any, Optional

Returns string

saveQuery

Saves the current query to some storage on the server-side.

▸ saveQuery(options?: any): void

Parameters:

  • options: any, Optional - The content of the options parameter depends on QueryStorage implementation. Usually it contains success and error callbacks

Returns void

setDefaultModelId

Sets the ID of the default model

▸ setDefaultModelId(modelId: string): void

Parameters:

  • modelId: string -

Returns void

setEndpoint

▸ setEndpoint(key: EqEndpointKey,value: string): void

Parameters:

  • key: EqEndpointKey
  • value: string

Returns void

setEnpointIfNotExist

▸ setEnpointIfNotExist(key: EqEndpointKey,value: string): void

Parameters:

  • key: EqEndpointKey
  • value: string

Returns void

setExternalListCache

Sets the external 'list cache' provider - an object which implements ExternalListCache inteface

▸ setExternalListCache(cache: ExternalListCache): void

Parameters:

Returns void

startProcess

Notifies context components about starting of some long process (e.g. model loading) This method raises onProcessStart event in the context and all its widgets

▸ startProcess(message: StatusMessage,groups?: WidgetGroup): void

Parameters:

Returns void

syncQuery

Syncronizes the current query.

▸ syncQuery(options?: any): void

Parameters:

  • options: any, Optional - The content of the options parameter depends on QuerySyncronizer implementation. Usually it contains success and error callbacks

Returns void

throwError

Throws the error passed in the function parameter. If onError event handler is defined - we call that method. Otherwise - just place the error message to the browser console.

▸ throwError(msg: StatusMessage): void

Parameters:

Returns void