Interface ControlPageApi

ControlPageApiBase extension that provides more functionality.

interface ControlPageApi {
    events: PageEventsApiBase;
    field: ControlPageFieldApi;
    file: ControlFileApi;
    isExternalObject: boolean;
    isHomepage: boolean;
    masking: MaskingPageApi;
    objectId: string;
    objectName: string;
    addRefreshableControl(control: Control<TypeAttributes>, refreshFn: (() => void), options?: RefreshablePageControlOptions): void;
    cancelEdit(closeTab: boolean): Promise<{
        userSaved: boolean;
    }>;
    edit(): Promise<any>;
    getMode(): PageMode;
    getPageDirty(): undefined | boolean;
    getPageModel(): PageModel;
    hasAnyRefreshableControlRequiresIndex(): boolean;
    isInEditMode(): undefined | boolean;
    isSlidingPanelPinned(): undefined | boolean;
    isToolbarDisabled(): boolean;
    onChange(handler: ((change: PageDataChange | PageModeChange) => void)): void;
    onNavigationStart(callback: (() => void)): void;
    onPropertyChange(handler: ((category: string, property: string, currentValue: any, previousValue: any) => void)): (() => void);
    raiseNotification(notification: string, type: string, autoDismissDuration?: number): void;
    refreshAttachments(): void;
    reloadPage(): Promise<void>;
    reloadRefreshableControls(categoryToRefresh?: string, controlToRefresh?: Control<TypeAttributes>): void;
    removeRefreshableControl(controlToRemove: Control<TypeAttributes>): void;
    save(stopEditing: boolean, closeObject: boolean): Promise<void>;
    setPageDirty(): void;
    setToolbarItemDisabled(actionName: string, setDisabled: boolean): void;
    toggleSlidingPanel<T>(sectionLabel?: string, content?: SlidingPanelContent<T>, panelProperties?: SlidingPanelProperties, onClose?: (() => void), focusPreviousActiveElementOnClose?: boolean): void;
}

Hierarchy (view full)

Properties

events field file isExternalObject isHomepage masking objectId objectName

Methods

addRefreshableControl cancelEdit edit getMode getPageDirty getPageModel hasAnyRefreshableControlRequiresIndex isInEditMode isSlidingPanelPinned isToolbarDisabled onChange onNavigationStart onPropertyChange raiseNotification refreshAttachments reloadPage reloadRefreshableControls removeRefreshableControl save setPageDirty setToolbarItemDisabled toggleSlidingPanel

Properties

events

events: PageEventsApiBase

Methods related to the hookable events associated with the page.

Readonlyfield

field: ControlPageFieldApi

Methods that relate to object fields associated with the page.

file

file: ControlFileApi

Methods related to the files associated with the page.

ReadonlyisExternalObject

isExternalObject: boolean

Checks if the object is external.

ReadonlyisHomepage

isHomepage: boolean

Checks if the page is a Home page.

masking

masking: MaskingPageApi

Access the Page Data Masking API.

ReadonlyobjectId

objectId: string

The object ID. Returns an empty string ("") if not applicable.

ReadonlyobjectName

objectName: string

The object name. Returns an empty string ("") if not applicable.

Methods

addRefreshableControl

  • addRefreshableControl(control, refreshFn, options?): void

  • Adds a refreshable control to the page.

    Parameters

    • control: Control<TypeAttributes>

      {Control} Control to add.

    • refreshFn: (() => void)

      {function} Function to be called when the control is refreshed. There are no parameters. Returns void.

        • (): void

        • Returns void

    • Optionaloptions: RefreshablePageControlOptions

      {RefreshablePageControlOptions} Options to be added to the refreshable control.

    Returns void

    Method

cancelEdit

  • cancelEdit(closeTab): Promise<{
        userSaved: boolean;
    }>

  • Takes a page out of edit mode. Promise resolves with a boolean value to determine if the user has saved or not. If the user has not saved, the user is prompted to do so.

    Parameters

    • closeTab: boolean

      {boolean} Checks if the tab should close after edit mode is canceled.

    Returns Promise<{
        userSaved: boolean;
    }>

    A Promise that resolves when the edit has been canceled.

    Method

edit

  • edit(): Promise<any>

  • Sets the page to be in edit mode. Used when clicking the Edit button.

    Returns Promise<any>

    A Promise that resolves when the page is put in edit mode.

    Method

getMode

getPageDirty

  • getPageDirty(): undefined | boolean

  • Gets the dirty state of the page.

    Returns undefined | boolean

    Method

getPageModel

  • getPageModel(): PageModel

  • Returns the model of the page in which the calling control resides.

    Returns PageModel

    The current page model object.

    Method

hasAnyRefreshableControlRequiresIndex

  • hasAnyRefreshableControlRequiresIndex(): boolean

  • Returns boolean

    True if any RefreshableControls have options.requiresIndex present. Otherwise, false.

    Method

isInEditMode

  • isInEditMode(): undefined | boolean

  • Checks if a page is in edit mode.

    Returns undefined | boolean

    A boolean value that checks if a page is in edit mode. Undefined if there is no page model.

    Method

isSlidingPanelPinned

  • isSlidingPanelPinned(): undefined | boolean

  • Checks if the sliding panel is pinned.

    Returns undefined | boolean

    A boolean value that checks whether the sliding panel is pinned.

isToolbarDisabled

  • isToolbarDisabled(): boolean

  • Returns the disabled status of the page toolbar.

    Returns boolean

    True, if the toolbar is disabled. Otherwise false.

    Method

onChange

  • onChange(handler): void

  • Registers a function to be invoked whenever a relevant change happens. The handler receives an object that gives information about the change event. There are two types of changes - PageDataChange when the data in the page model changes, and PageModeChange when the page mode changes.

    Parameters

    Returns void

    Method

onNavigationStart

  • onNavigationStart(callback): void

  • Register a callback function that is invoked when the page that contains the current control is navigated back to. Useful for updating homepage controls whose config sets "reuse" to true and need to update when the homepage is reloaded.

    Parameters

    • callback: (() => void)

      {function} The function to be invoked.

        • (): void

        • Returns void

    Returns void

    Method

onPropertyChange

  • onPropertyChange(handler): (() => void)

  • Registers a function to be invoked whenever one of the calling control's properties change.

    Parameters

    • handler: ((category: string, property: string, currentValue: any, previousValue: any) => void)

      {function} Function to be invoked on property change. Parameters are (category: string, property: string, currentValue: any, previousValue: any).

        • (category, property, currentValue, previousValue): void

        • Parameters

          • category: string
          • property: string
          • currentValue: any
          • previousValue: any

          Returns void

    Returns (() => void)

    A function that stops the handler from being invoked.

      • (): void

      • Returns void

    Method

raiseNotification

  • raiseNotification(notification, type, autoDismissDuration?): void

  • Triggers a certain type of notification for users. For example, a type EDIT_FAIL notification if a sheet has failed to be added to a workspace.

    Parameters

    • notification: string

      {string} Message to be displayed on the notification.

    • type: string

      {string} Type of notification. For example LOCK, EDIT_FAIL, VERSION_MISMATCH.

    • OptionalautoDismissDuration: number

      {number} Length of time before the notification should be dismissed.

    Returns void

    Method

refreshAttachments

  • refreshAttachments(): void

  • Refreshes the attachments grid to display new attachments when a new attachment is uploaded.

    Returns void

    Method

reloadPage

  • reloadPage(): Promise<void>

  • Reloads an instance of a page.

    Returns Promise<void>

    A Promise that resolves when the page is reloaded.

    Method

reloadRefreshableControls

  • reloadRefreshableControls(categoryToRefresh?, controlToRefresh?): void

  • Refreshes a control when updated data is displayed. By default, attempts to refresh all controls. Specify categoryToRefresh or controlToRefresh to restrict what is refreshed.

    Parameters

    • OptionalcategoryToRefresh: string

      {(string|undefined)} Name of the category to be refreshed.

    • OptionalcontrolToRefresh: Control<TypeAttributes>

      {Control} Individual control to be refreshed.

    Returns void

    Method

removeRefreshableControl

  • removeRefreshableControl(controlToRemove): void

  • Removes a refreshable control from the page.

    Parameters

    Returns void

    Method

save

  • save(stopEditing, closeObject): Promise<void>

  • Saves a page after editing.

    Parameters

    • stopEditing: boolean

      {boolean} Checks if the page should leave edit mode after it is saved.

    • closeObject: boolean

      {boolean} Checks if the page should be closed after it is saved.

    Returns Promise<void>

    A Promise that resolves when the page has been saved.

    Method

setPageDirty

  • setPageDirty(): void

  • Sets a page to be dirty, that is, when it has been edited and not saved.

    Returns void

    Method

setToolbarItemDisabled

  • setToolbarItemDisabled(actionName, setDisabled): void

  • Sets the toolbar control to be disabled.

    Parameters

    • actionName: string

      the toolbar action name.

    • setDisabled: boolean

      disable the toolbar item.

    Returns void

    Method

toggleSlidingPanel

  • toggleSlidingPanel<T>(sectionLabel?, content?, panelProperties?, onClose?, focusPreviousActiveElementOnClose?): void

  • Toggle the page-level sliding panel. This panel should be used to contain information that is supplementary to the document, for example attachments or workflow tasks.

    Type Parameters

    • T

    Parameters

    • OptionalsectionLabel: string

      {string} Describes the section; this should be internationalized.

    • Optionalcontent: SlidingPanelContent<T>

      {SlidingPanelContent} The content of the sliding panel.

    • OptionalpanelProperties: SlidingPanelProperties

      {SlidingPanelProperties} Properties for the panel. When providing a URL for content: the panel properties will be available on the controller's "slidingPanel" object. When providing a selector for content: the properties will be set on the element to be created.

    • OptionalonClose: (() => void)

      {function} A callback function invoked when the panel is dismissed. There are no parameters. Returns void.

        • (): void

        • Returns void

    • OptionalfocusPreviousActiveElementOnClose: boolean

      {boolean} Toggle for whether the app should apply focus to the last active element before the panel was opened.

    Returns void

    Method

Settings

Member Visibility

On This Page

Properties
Methods