ipushpull Technical Reference
ipushpull Plugin Options
IPushPullPluginOptions
Options available in ipushpull plugin; allows users to collaborate and share data in powerful ways
boolean
Whether AdapTable should try log in to ipushpull automatically at start-up
false
'lightTheme' | 'darkTheme'
The color theme to use when styling data pushed to ipushpull pages
derived from Adaptable's current theme (lightTheme or darkTheme)
boolean
Whether AdapTable will include System Reports (e.g. 'All Data', 'Selected Cells' etc) in the ipushpull toolbar dropdown
true
The config required to run ipushpull; use your ipushpull credentials
string
The user's ipushpull password; if supplied, pre-populates the login screen's password textbox
number
How many miliseconds AdapTable should throttle when sending data updates to ipushpull
2000
string
User's ipushpull user name (usually email address); if supplied, pre-populates the login screen's username textbox
ipushpull Config
IPushPullConfig
Connection config for the ipushpull REST API.
Only api_key and api_secret are required -- api_url defaults to the
ipushpull test environment (https://test.ipushpull.com/api/1.0).
string
OAuth Client ID
string
OAuth Client Secret
ipushpull API
IPushPullApi
The ipushpull plugin: login, the current report, and sending a snapshot or live data.
void
Adds a new page to ipushpull using given name in the supplied folder
boolean
Retrieves AutoLogin from ipushpull options; if true AdapTable will automatically log user in to ipushpull at start-up
string | undefined
Retrieves Password from ipushpull state -- AFTER someone logs in
string | undefined
Retrieves Username from ipushpull state - AFTER someone logs in
IPushPullReport | undefined
Retrieves current ipushpull Report from ipushpull state; A Report contains Name, Folder and ipushpull Page
number
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
any
Retrieves the current ipushpull instance (if one has been provided by the User at design time in ipushpull state)
string | undefined
Retrieves Password from ipushpull options (if provided)
number | undefined
Retrieves Throttle Time from ipushpull State; how often a Live report will update ipushpull (if data changes)
string | undefined
Retrieves Username from ipushpull options (if provided)
string[]
Retrieves all pages in given ipushpull domain
boolean
Whether to display System Reports in ipushpull toolbar
boolean | undefined
Checks if an ipushpull instance has been provided by the user
boolean | undefined
Checks if a report is sending Live Data to ipushpull
boolean
Checks if given report is currently 'live' (i.e. sending updates as data changes)
boolean | undefined
Checks to see if ipushpull is running (i.e. a user has successfully logged in)
void
Logins in user to ipushpull with given credentials; if successful ipushpull toolbar will display full set of controls
void
Logs out the current user from ipushpull (changes ipushpull toolbar to show Login button)
void
Publishes an ipushpull Report as a one-off export (i.e. with no live data)
void
Sets given Domains as those for the current User
void
Replaces the ipushpull instance AdapTable is using. Prefer the login methods.
void
Sets Throttle time for ipushpull; how often a Live report will update ipushpull (if data changes)
void
Opens iPushPullPopup (though its currently empty!)
void
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
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();