ipushpull Technical Reference

View as Markdown

ipushpull Plugin Options

IPushPullPluginOptions

Options available in ipushpull plugin; allows users to collaborate and share data in powerful ways

autoLogin?

boolean

Whether AdapTable should try log in to ipushpull automatically at start-up

Default

false

cellStyles?

'lightTheme' | 'darkTheme'

The color theme to use when styling data pushed to ipushpull pages

Default

derived from Adaptable's current theme (lightTheme or darkTheme)

Whether AdapTable will include System Reports (e.g. 'All Data', 'Selected Cells' etc) in the ipushpull toolbar dropdown

Default

true

The config required to run ipushpull; use your ipushpull credentials

password?

string

The user's ipushpull password; if supplied, pre-populates the login screen's password textbox

How many miliseconds AdapTable should throttle when sending data updates to ipushpull

Default

2000

username?

string

User's ipushpull user name (usually email address); if supplied, pre-populates the login screen's username textbox

ipushpull Config


ipushpull API

IPushPullApi

The ipushpull plugin: login, the current report, and sending a snapshot or live data.

Adds a new page to ipushpull using given name in the supplied folder

getAutoLogin()
returns

boolean

Retrieves AutoLogin from ipushpull options; if true AdapTable will automatically log user in to ipushpull at start-up

getCurrentIPushPullPassword()
returns

string | undefined

Retrieves Password from ipushpull state -- AFTER someone logs in

getCurrentIPushPullUsername()
returns

string | undefined

Retrieves Username from ipushpull state - AFTER someone logs in

Retrieves current ipushpull Report from ipushpull state; A Report contains Name, Folder and ipushpull Page

Gets the Id of the ipushpull folder / Domain with the given name

Retrieves all the ipushpull domain to which the current user has access

An IPushPullDomain contains 3 properties:

- Name: the name of the Domain / Folder

- FolderId: the number of the Domain / Folder

- Pages: a string array containing the names of all the Pages in the Folder

Retrieves the current ipushpull instance (if one has been provided by the User at design time in ipushpull state)

getIPushPullPassword()
returns

string | undefined

Retrieves Password from ipushpull options (if provided)

getIPushPullThrottleTime()
returns

number | undefined

Retrieves Throttle Time from ipushpull State; how often a Live report will update ipushpull (if data changes)

getIPushPullUsername()
returns

string | undefined

Retrieves Username from ipushpull options (if provided)

Retrieves all pages in given ipushpull domain

Whether to display System Reports in ipushpull toolbar

isIPushPullAvailable()
returns

boolean | undefined

Checks if an ipushpull instance has been provided by the user

isIPushPullLiveDataRunning()
returns

boolean | undefined

Checks if a report is sending Live Data to ipushpull

Checks if given report is currently 'live' (i.e. sending updates as data changes)

isIPushPullRunning()
returns

boolean | undefined

Checks to see if ipushpull is running (i.e. a user has successfully logged in)

Logins in user to ipushpull with given credentials; if successful ipushpull toolbar will display full set of controls

Logs out the current user from ipushpull (changes ipushpull toolbar to show Login button)

Publishes an ipushpull Report as a one-off export (i.e. with no live data)

Sets given Domains as those for the current User

Replaces the ipushpull instance AdapTable is using. Prefer the login methods.

Sets Throttle time for ipushpull; how often a Live report will update ipushpull (if data changes)

Opens iPushPullPopup (though its currently empty!)

Publishes ipushpull Report as Live Data; any changes to underlying data in report will be sent to ipushpull

When this happens the 'play' button in the ipushpull toolbar changes to a red 'pause' button

stopLiveData()
returns

void

Pauses current Live Data report

When this happens the 'pause' button in the ipushpull toolbar changes back to a 'play' button

Accessing API

Because ipushpull is available via a Plugin, the easiest way to access the Api is as follows:

const ipushpullApi = adaptableApi.pluginsApi.getipushpullPluginApi();