Typedef
| Static Public Summary | ||
| public |
ActionExecution(intentType: StandardIntent | string, intentOptions: Object): Object: function(intenType: IntentType, options: Object): Promise<Object> | Object The execute function of an Action |
|
| public |
The metadata of an action. |
|
| public |
ActionsMetadata: Object<IntentType, ActionMetadata> The metadata of a collection of actions implemented in one action.js file. |
|
| public |
|
|
| public |
Context: Object<EntityType, Array<EntityId> | Array<EntityObject>> The result of a context query. |
|
| public |
ContextChangeHandler: function(ipro: InsightProvider, contextQuery: ContextQuery): void Callback function to inform an application that the context of an insightProvider has changed. |
|
| public |
An Object whose keys are the EntityTypes to query and whose values are the ContextQueryOptions for the requested entity. |
|
| public |
The options for a context query for a specific EntityType. |
|
| public |
Indicates the return type of the context query. |
|
| public |
this typedef is experimental.
Enum of context return types. |
|
| public |
enum of ContextSelector's . Exposed into global namespace |
|
| public |
Defines what result set should be returned from a |
|
| public |
An identifier for a single entity. |
|
| public |
An object which describes an entity. |
|
| public |
An EntityType as string. |
|
| public |
this typedef is experimental.
The supported features of an ipro. |
|
| public |
this typedef was deprecated. In PDMS 1.0 SP00 the application was loading UI5 and NATIVE (other) ipros differently. As of PDMS 1.0 SP02 all ipros are loaded in the same way, hence this information is not required anymore.
the ui framework being used by the ipro. |
|
| public |
this typedef is experimental. Not actively used by any application as of PDMS 1.0 FP02.
The data input and output for an ipro. |
|
| public |
The metadata of an ipro. |
|
| public |
Options for creating an ipro |
|
| public |
IntentHandler(insightProvider: Object, intentType: StandardIntent | string, intentParams: IntentParams): function(): void Callback function to inform an application of an intent of an insightProvider. |
|
| public |
IntentParams: any The intent specific parameters. |
|
| public |
this typedef is experimental. Not actively used by any application or ipro as of PDMS 1.0 FP02.
Allows to restrict the number of entities returned from a context query. |
|
| public |
The size of an ipro |
|
| public |
enum for standard intents. |
|
Static Public
public ActionExecution(intentType: StandardIntent | string, intentOptions: Object): Object: function(intenType: IntentType, options: Object): Promise<Object> | Object source
The execute function of an Action
public ActionMetadata: Object source
The metadata of an action.
Properties:
| Name | Type | Attribute | Description |
| execute | ActionExecution | The execute function of an action |
|
| apiVersion | string |
|
The API version of an action. This document describes API version "3.0.0". |
public ActionsMetadata: Object<IntentType, ActionMetadata> source
The metadata of a collection of actions implemented in one action.js file.
Example:
{
sampleAlertAction: {
execute: function(options() {
...
})
}
}
public Configuration: Object source
Properties:
| Name | Type | Attribute | Description |
| id | string | The id of an ipro configuration |
public Context: Object<EntityType, Array<EntityId> | Array<EntityObject>> source
The result of a context query. A ContextResult is an object whose keys are EntityTypes and whose values are Arrays of EntityIds or EntityObjects
Example:
{
PrimaryObject: ['1000', '1001', '1003'],
DerivedSignal: [{foo: 'bar'}, {hello: 'world'}]
}
public ContextChangeHandler: function(ipro: InsightProvider, contextQuery: ContextQuery): void source
Callback function to inform an application that the context of an insightProvider has changed.
In a typical implementation of this function an application will evaluate which context has changed,
call the getContext method of insightProvider to retrieve the new context,
and then call setContext of interested ipros to pass in the new context.
{Object} insightProvider - The ipro that has changed the context
{ContextQuery} contextQuery - The context that has changed.
public ContextQuery: Object<EntityType, ContextQueryOptions> source
An Object whose keys are the EntityTypes to query and whose values are the ContextQueryOptions for the requested entity. In general the ContextQuery expresses which information the application requests from the ipro.
Example:
{PrimaryObject: {selector: sap.pdms.ipro.api.ContextSelector.SELECTED}}
public ContextQueryOptions: Object source
The options for a context query for a specific EntityType.
Properties:
| Name | Type | Attribute | Description |
| selector | ContextSelector | Choose which slice of the overall ipro context should be returned from |
|
| contextResultType | ContextResultType |
|
The type / structure an ipro should return for the given contextQuery. |
| pagination | Pagination |
|
Allows to limit the resultset size and skip a number of elements in the resultset. |
public ContextResultType: string source
Indicates the return type of the context query. Possible values are sap.pdms.ipro.api.ContextReturnType.ID or sap.pdms.ipro.api.ContextReturnType.OBJECT. If sap.pdms.ipro.api.ContextReturnType.OBJECT is specified an array of ids is returned. If sap.pdms.ipro.api.ContextReturnType.OBJECT is specified an array of plain JavaScript objects is returned.
public ContextReturnType: Object source
Enum of context return types. Exposed into global namespace sap.pdms.ipro.api.ContextReturnType
public ContextSelector: Object source
enum of ContextSelector's . Exposed into global namespace sap.pdms.ipro.api.ContextSelector
public ContextSelector: string source
Defines what result set should be returned from a getContext call.
Possible values are: sap.pdms.ipro.api.ContextSelector.SELECTED or sap.pdms.ipro.api.ContextSelector.ALL.
sap.pdms.ipro.api.ContextSelector.SELECTED indicates that the ipro is supposed to
return all entities that are currently selected usually through a user interaction. E.g. In table based ipro this
refers normally to the selected rows or more specifically the context of those selected rows (e.g. all primaryObjectsIds associated with the selected context).
sap.pdms.ipro.api.ContextSelector.ALL indicates that the ipro is supposed to return all entities.
public EntityObject: Object source
An object which describes an entity. The object structure is specific to every EntityType.
public Feature: Object source
The supported features of an ipro.
Properties:
| Name | Type | Attribute | Description |
| pagination | boolean |
|
public Framework: Object source
the ui framework being used by the ipro. Exposed into global namespace sap.pdms.ipro.api.Framework
public InsightProviderDataInterface: Object source
The data input and output for an ipro. Whenever the context for an EntityType listed in
input has changed the application will call the ipro setContext method to pass in the new context.
By adding a EntityType to output an ipro signals to an application that it might change the context
for that EntityType. Declaring input and output enables an application to discover possible data flows
between ipros. An output context of one ipro can be declared as an input context of another.
Declaring a InsightProviderDataInterface is optional. If not declared the following
InsightProviderDataInterface is assumed by default:
{
input: ['PrimaryObject'],
output: ['PrimaryObject']
}
Properties:
| Name | Type | Attribute | Description |
| input | Array<EntityType> |
|
|
| output | Array<EntityType> |
|
public InsightProviderMetadata: Object source
The metadata of an ipro.
Properties:
| Name | Type | Attribute | Description |
| apiVersion | string |
|
The API version of an ipro ui. This document describes API version "3.0.0". |
| type | string |
|
The unique type id of an ipro. This should match the |
| uiFramework | string |
|
defines the ui framework used by the implementation. Possible values are sap.pdms.ipro.api.Framework.NATIVE (default) and sap.pdms.ipro.api.Framework.UI5. |
| dataInterface | InsightProviderDataInterface |
|
<Experimental> Defines the data interface of an ipro. |
| features | Feature |
|
<Experimental> The supported features of an ipro. |
| preferredSize | Size |
|
<Experimental> The preferred size of an ipro. |
public InsightProviderOptions: Object source
Options for creating an ipro
Properties:
| Name | Type | Attribute | Description |
| baseUrl | string | The base url of the ipro. This is the absolute path or url under which the ipro.js is externally exposed via pdms-router.
For example if the ipro.js is exposed under /ipro/work-activity/ipro.js baseUrl shall contain |
|
| size | Size |
|
The size of an ipro inside an application. This is the size the application 'asks' the ipro to render itself, so that it exactly fits in the uiContainer provided by the application. |
| locale | string |
|
The locale which an ipro is supposed to use. If not provided the ipro has to determine the locale by itself or use an ipro specific default. |
| uiContainer | Element | The DOM element into which the ipro is requested to render / place itself. |
|
| config | Configuration |
|
The requested configuration / variant of the ipro. |
| variantId | string |
|
The variantId an ipro should load. This is to be consumed by variant management enabled ipros. Variant management enabled ipros should not consume the older |
| contextChangeHandler | ContextChangeHandler |
|
(deprecated) The contextChangeHandler callback function. |
| intentHandler | IntentHandler |
|
(deprecated) The intentHandler callback function (depricated with v2.1.0). |
| intentManager | IntentManager |
|
intentManager to execute intents. |
public IntentHandler(insightProvider: Object, intentType: StandardIntent | string, intentParams: IntentParams): function(): void source
Callback function to inform an application of an intent of an insightProvider. An intent is an action that an ipro wants to trigger without knowing the exact details of that action. The one intent currently being defined is sap.pdms.ipro.api.StandardIntent.NAVIGATE_TO_CONTEXT. For instance, an ipro might expose a "Details" button to allow the user to navigate to the details page for a given EntityType. The ipro does not know what would be a suitable details page for this EntityType. So it communicates to the application the intent to navigate and then it is up to the application to implement the actual navigation. An intent can be thought of as an action whose implementation details are unknown to the ipro and thus represents an additional level of decoupling between actors expressing an intent and actors reacting to it.
public IntentParams: any source
The intent specific parameters. The expected parameter structure has to be defined by the intent type.
Example:
{PrimaryObject: '1001'}
public Pagination: Object source
Allows to restrict the number of entities returned from a context query. This parameter implies that the context query results are returned in a specific order.
public StandardIntent: Object source
enum for standard intents. Exposed into global namespace sap.pdms.ipro.api.StandardIntent
Properties:
| Name | Type | Attribute | Description |
| NAVIGATE_TO_CONTEXT | string | navigation intent |
|
| NAVIGATE_TO_TARGET | string | navigation intent for specified target |
|
| PROMOTE_CONTEXT | string | intent to promote of context to other ipros |
|
| WORKACTIVITY_CREATE | string | intent to create work activity |
|
| SCHEDULE_MAINTENANCE | string | intent to schedule maintenance |