Space Index
|
|||||||||||||||||||||||||||||||
0-9 |
AA Typical Backend LinkageInteractions, through the answerSpace, can link to a myriad of different back end systems: linkages1.png
About answerSpaces
answerSpaces are containers for Interactions. Within the answerSpace, Interactions can be reused, and exist in different areas within the answerSpace. Because of this, users can have a highly customised experience, with different groups of users seeing di
About Browser Modes
The BlinkMobile Platform functions on all browsers, however there are differences in how an answerSpace will interact with your users, based upon the Mode that the Platform detects. Our Interaction Manager allows certain settings to be overridden based on
About Catergories
About Master Categories Master Categories Please note: Master Categories have been deprecated in future releases. The first level of navigation in the BlinkMobility Platform are ‘Master Categories’. These are used when you know that you will have groups of Categories within yo
About the Platform
Throughout our documentation, you will see the term ‘Blink Mobility Platform’ used. The word “Platform” is used to describe a number of different levels of capability. Rather than a set of libraries, the Blink Mobility Platform differs in that it is an En
Accessibility
Active Forms List (Pending Queue) The Active Forms List (formerly known as the Pending Queue) is a special-purpose Interaction or view that displays any form records that have not yet been submitted to the server. Future functionality of this list will include draft records, and records t
Add image annotations support for BlinkForms
Step-by-step guide Add the following javascript code to the answerSpace. * SET CAMERA / IMAGE ANNOTATIONS FOR BMP * Modified Ray Pearce 3/11/2014 * BIC2 Only at this stage. * Answerspace setup=>Native Application=>camera options must be set to allowEdit t
Adding NFC Reader Functionality
The following code example is Javascript is used within a Message Interaction View Code In Github https://github.com/blinkmobile/examples/blob/master/javascript/nfcReadTag.js Or Download the sample code file below.
Adding Pan and Zoom
Since the inclusion of jQuery mobile in the BMP you can now use a number of third party libraries to achieve new and useful UI functionality. Zoom already exists within most operating systems but there are times when to want to enlarge the content with th
Address Book Integration
Simply add this code into a mADL interaction. You should get a notification the first time you attempt to access the address book and then after that you should have full access. You can add a filter to limit returned results. Android app shell will requi
Administrator Management
Advanced Interactions Authentication - submitForm() madl Function On occasions when you are retrieving a page source into an Interaction you may require authorisation from a login form. This is often known as a "PassThru"... To get around this issue you can use the "submitFor
Advanced-Mode Devices
These Browsers support most, if not all HTML5 and CSS3 capabilities. HTML5 is the new standard for HTML. Most of the major browsers support many of the new HTML5 elements and APIs. Desktop Browsers: Google Chrome Apple Safari Microsoft Internet Explorer 9
All Icons by Device Type
iPhone-only Apps The following information was derived from: http://developer.apple.com/library/ios/#qa/qa1686/_index.html http://developer.apple.com/library/ios/#qa/qa1686/_index.html Size File Name Used For Required Status Notes 29x29 Icon-Small.png Spo
Amazon S3
In the event of your service encountering a failure an alternative solution could we use (thats easy to implement with your system) to record the xml post data incase there's a web service bug. We are working on features to help with web service connecti
An Interaction that populates a personal Data Suitcase
Here's the example mADL (PHP) code for an Interaction that populates a personal Data Suitcase and presents links that feed records out of the suitcase to the desired Form Interactions. For good measure, it even displays the contents of the Data Suitcase f
Android
Android (operating system) Versions Each version after "Astro" and "Bender" is named in alphabetical order after a dessert or sugary treat, with 1.5 "Cupcake" being the first and every update since following this naming convention. Code name Version number Initial release date API level 1
Android Devices
answerSpace answerSpace creation and modification requests Answerspace JS Events Global Variables BICv2 (MyAnswers) MyAnswers This is the primary global object for Answerspace manipulation. Use console.log to examine it's available properties. Key properties Property Type Usage activityIndicator DOM reference Used to show or hide the
answerSpace Maintenance
answerSpace Setup This is the main area where you manage your answerSpace. In this window, you can set a number of default options that control how your answerSpace looks and behaves. You access this via ‘answerSpace Setup’. The following options can be set in this window,
answerSpace Styling
answerSpace Styling For Non Designers
answerSpace Tools
API App Cache Fetcher Native app shells can be build from answerSpaces via several methods. The App Factory The App Cache Fetcher acf flow .jpg The App Cache Fetcher is a service which can turn any BIC3 (BIC JQM) answerSpace in the BMP into a stand alone Cordova app project. N
App Cache Fetcher Commands
Help: All commands can be found by opening a terminal or command line prompt and type the following code. blinkm acf --help Usage Usage: blinkm acf [options] <url> <output> Options Short cut Description blinkm acf -help -h output usage information blinkm
Approved Hybrid Cordova Plugins
You at times may want extend your answerSpace functionality by using the native app shells built in Cordova Plugins. Below is a list of the current available Cordova plugins available in the Blink Native App Shell projects. Each contains a link to the som
Authentication
Available Cordova In Built Plugins You at times may want extend your answerSpace functionality by using the native app shells built in Cordova Plugins. Below is a list of the current available Cordova plugins available in the Blink Native App Shell projects. Each contains a link to the som
|
||||||||||||||||||||||||||||||
BBackups and Disaster RecoveryThe BlinkMobile Platform offers robust backup and recovery capabilities. Amazon’s Relational Database Service http://aws.amazon.com/rds/ (RDS) is set to automatically backup the platform on a continual basis, enabling point in time recovery. A full daily
Barcode
There are several ways to incorporate barcode / QR codes into the BMP via Blink's native app shells. This can be done by calling the cordova plugin (barcodereader) /* * Custom code for reading Barcodes into a form field (native apps only). * To be added a
Basic-Mode Devices
Basic Mode Basic mode refers to all Browsers: all devices not catered to by advanced-mode (see above). Note regarding Internet Explorer 6: We do not support use of our administration tools in Microsoft Internet Explorer 6 and older. Further, we do not off
Beacons
BIC - JQM (jQuery Mobile version) aka BIC3 Bic3 Forms 3 https://travis-ci.org/blinkmobile/bic-jqm.png https://travis-ci.org/blinkmobile/forms.png https://badges.gitter.im/Join%20Chat.svg BIC3 is a jQuery Mobile implementation of The Blink Intelligent Client. This project uses Require.JS http
BIC and PouchDB
If you want to access PouchDB directly, you may do so via Require.JS: require(['pouchdb'], function (PouchDB) { var db; console.log(PouchDB.version); // e.g. outputs "3.2.1" as the library version db = new PouchDB('dbname'); // do things with `db` as per
BIC Versions
Currently the BMP provides two Blink Intelligent Clients.
BIC-jQM and Require.JS
This project uses Require.JS http://requirejs.org/ to lazy-load components as they are needed, and to enable the development of isolated modules. As such, any JavaScript code you add to this environment may need minor adjustments before it will actually e
BIC-jQM APIs
BIC-jQM Navigation APIs BMP.BIC.view.home() This will navigate the answerSpace back to the default Home interaction. View APIs
BIC-JQM persistent storage
For more information on BIC-JQM persistent storage and the newest of the persistent storage APIs click here https://github.com/blinkmobile/bic-jqm/blob/develop/docs/persistent-storage.md What's out? Our collections avoid using any of the following mechan
BIC-jQM: Forms Interaction Process
This is the Forms-specific process that the InteractionView performs during the navigation process. the InteractionView creates a new FormView https://github.com/blinkmobile/bic-v3/blob/develop/src/view-form.js the FormView creates a new FormActionView ht
BIC-jQM: Navigation Process
user clicks a hyperlink or button which changes the URL in the location bar jQueryMobile triggers its pagebeforeload http://api.jquerymobile.com/1.3/pagebeforeload/ event the router https://github.com/blinkmobile/bic-v3/blob/develop/src/router.js parses t
BIC-jQM: Pending Queue
For the newest documentation on the pending queue and APIs offered by the Web Platform click here https://github.com/blinkmobile/bic-jqm/blob/develop/docs/pending-queue.md non-deterministic initialisation As described here https://blinkmobile.atlassian.ne
BIC-jQM: Pending Queue Process
the user clicks the submit button the click-handler for the submit button is the formSubmit() method of the FormControlView https://github.com/blinkmobile/bic-v3/blob/develop/src/view-form-controls.js formSubmit() calls the addToQueue(status) method, with
BIC-jQM: publicly-accessible values
Note: this document assumes you are familiar with JSDoc 3 namepaths https://github.com/blinkmobile/docs/wiki/Code-Style:-JSDoc-3. BIC-jQM creates and maintains state across JavaScript objects and values. If you know where to look, you may access this stat
BICv2 (The Built in platform version)
https://camo.githubusercontent.com/8336c7cc5d24f8d9f07a2c85299b76e945956923/68747470733a2f2f7472617669732d63692e6f72672f626c696e6b6d6f62696c652f6269632d76322e706e67 https://travis-ci.org/blinkmobile/bic-v2 https://camo.githubusercontent.com/cced2bed85b53f
Blacklisted PHP functions
Below is a list of illegal PHP commands Effective July 2015 Function Notes shell_exec exec putenv passthru system proc_open popen curl_multi_exec parse_ini_file show_source phpinfo chgrp chown disk_free_space disk_total_spac
Blink App Shells
What is Applification? In most cases answerSpaces managed under the Blink Mobility Platform are delivered to devices as web apps, often with associated data being packaged and shipped to the device as “Data Suitcases”. However, there are certain reasons w
Blink App Shells and Appification
In most cases answerSpaces managed under the BlinkMobile Platform are delivered to devices as web apps, often with associated data being packaged and shipped to the device as “Data Suitcases”. However, there are certain reasons why the standard web app an
Blink Forms JS Events
Standard Javascript can be used to manipulate Blink Forms. BMP also provides a custom object for managing Form Data, BlinkForms BlinkForms.currentFormObject The Blink Forms object provides fast access to the currently loaded Blink Form. To examine the pro
Blink Intelligent Client (BIC)
Blink Server BlinkGap Cache Reset In iOS App Shells built with a template version greater than version 2.2 it’s possible to trigger a reset of the device’s URL cache using a cordova command. Usage if (navigator && navigator.bgcachereset) { navigator.bgcachereset.resetCache(); } else { w
BlinkMobile Forms v3
BlinkMobile Forms execute a definition, creating Models and Views to capture data from users https://travis-ci.org/blinkmobile/forms.png https://travis-ci.org/blinkmobile/forms Semantic Versioning This project follows Semantic Versioning http://semver.org
BlinkMobile Technical Documentation Centre
Live Search this documentation Word Search Page Navigation Recently Updated Pages Featured Pages
BlinkMolbile Forms
BlinkNow Database BMP CLI The CLI utility allows you access to answerSpace Interactions in the Blink Mobility Platform via a CLI (Command Line Interface) instead of the traditional CMS (Content Management System . https://blinkm.co/admin https://blinkm.co/admin). bmpcli_flow.png U
BMP CLI Authorisation Tokens
BMP CLI authorisation tokens are unique to each answerSpace in the BMP. While in your answerSpace admin area in the CMS, blinkm.co/admin/ https://blinkm.co/admin, authorisation tokens can be created from the main menu panel, navigate to Tools → API Token
BMP CLI Commands
Help: All BMP CLI commands can be found by opening a terminal or command line prompt and type the following command. blinkm bmp --help Initial Settings: Command Description scope outputs the current scope scope [<url>] sets the current URL scope login st
BMP CLI Deploy
Deploy Requests blinkm bmp deploy A deploy request will upload all current interaction files to the BMP database from your local copy on your computer. pull flow.png Deploy --prune Requests blinkm bmp deploy --prune A deploy request will upload all curren
BMP CLI Pull
Pull Requests blinkm bmp pull A pull request will download all current interaction files from the BMP database down to your local copy on your computer. pull flow.png if you are already using version control, then we recommend that you save any local chan
BMP CLI Scope
What is Scope? Before accessing an answerSpace via the BMP CLI, each answerSpace needs to have a reference to its location within the BMP and the file location on your computer. This is called the project Scope. scipe flow.png This process is only require
BMP HTTP Response Codes
Our first pass at assigning response codes to conditions used only standard codes. However, in some cases this stretched or even ignore the original purpose for the codes in question. Thus, we are switching to a better scheme as time permits. HTTP Standar
BMP mADL Sandbox
BMP executes all custom PHP (MADL) code within a sandbox environment for security. Sandboxing is the practice of running code in a restricted security environment, which limits the access permissions granted to the code. All custom PHP which you include a
|
CCalculations & FunctionsCategory Settings This area allows you to set specific Category defaults that will override any settings made at the Master Category or answerSpace level, and be applied to any Interactions that they may contain (unless overridden at the Category level). The following opti
Change Password
Child Browser Window Overview The InAppBrowser window (Child Browser) behaves like a standard web browser, and can't access Cordova APIs. For this reason, the InAppBrowser is recommended if you need to load third-party (untrusted) content, instead of loading that into the mai
Chrome Dev Tools
Problem How can I debug issues within the Blink Mobility Platform? Solution We used Chrome Dev Tools to debug where this issue originated. You could have done this yourself using Chrome Dev Tools. We suggest that you take a look at this very good (free) c
Client Side Errors
timeout 0 image00.png timeout 0 occurs when the predefined client timeout has been reached. After pressing submit on a form, the client has been waiting with no response (generally from the server) for more than 60 seconds. In the Blink Platform, the clie
Code Examples
Code Helper Conditional Rules Connections Manager Database Connection Manager.pdf
Content Delivery Network
Content Delivery Network (CDN) Using Assets in MADL and CSS CDN locations are stored by an Organisation. These CDN locations can be accessed across multiple server instances. i.e. Assets stored in a CDN location in d.blinkm.co http://d.blinkm.co/ can also be used on blinkm.co http://bl
Cordova / Phonegap iBeacon plugin
Features available on both Android and iOS Ranging Monitoring Features exclusive to iOS https://github.com/petermetz/cordova-plugin-ibeacon#features-exclusive-to-ios Region Monitoring (or geo fencing), works in all app states. Advertising device as an iBe
Cordova Plugin (AppVersion) Example
This can be done by calling the cordova plugin (AppVersion) Example # Display in an alert box. Javascript : AppVersion.getAppVersion(function (version) { alert(version); }); Example # Display in javascript console.. Javascript : AppVersion.getAppVersion(f
Cordova Plugin (barcodereader) Example
Adding Barcode / QR Code Reader Functionality To A Native App Shell. There are several ways in incorporate barcode / QR codes into the BMP via Blink's native app shells. This can be done by calling the cordova plugin (barcodereader) Example 1 # Within a B
Creating A Custom Login Process
This Custom Authentication Process can be used to override the current login systems and can be extended to external authentication APIs. This example uses an array to store users and groups in the "loginprompt" interaction.. 1.png To include a Custom A
Creating Interactions
Currently the Blink Mobility Platform has 5 Interaction types: For a full list of interaction settings click here https://blinkmobile.atlassian.net/wiki/display/TD/Interaction+Settings Creating a Message or HTML Interaction A Message Interaction is a stat
Creating interactions Via CLI
Creating or removing Interactions can now be done outside the CMS via the BMP CLI. Create interaction blinkm bmp create interaction <name> --type<type> --remote Using the create interaction function will create a local version of the interaction on your
CSS Class Parser
It may be convenient to encode definition Settings as a CSS class value. We provide (and use) a helper function to decode such Settings. This allows designers to configure JavaScript components using CSS. We extracted this out into separate projects here:
|
||||||||||||||||||||||||||||||
DData At RestdataRest.png The Blink Mobility Platform is a pass-through service, and as such does not store data. However, there are times when data will need to be stored on a mobile device, such as when a user is using offline mode. Offline mode is designed to allow
Data Suitcase Functions
A Mobile Object Journey Object (MOJO) or now known as Data Suitcase is an XML file stored on the Blinkmobile server. When a MOJO has been transferred to a mobile device it is a Mobile Journey object (MoJO). XSLT code interactions check currency of any req
Data Suitcase JS Events
Description Function Returns This global function triggers the process of retrieving all public Data Suitcases for an answerSpace. processMoJOs () @returns {jQueryPromise} To store a data suitcase with Javascript you can use MyAnswers.store.set('mojoX
Data Suitcases (MOJO)
A Journey Object (MOJO) or now known as Data Suitcase is an XML file stored on the Blinkmobile server. When a MOJO has been transferred to a mobile device it is a Mobile Journey object (MoJO). XSLT code interactions check currency of any required MoJOs It
Data Transfer Security
dataTrfer.png Data transfer is the process of sending data to and from a mobile device and a server. The software running on the server will depend on the needs of the particular answerSpace (or Web App or App Shell). The answerSpace may be connecting to
Device Compatibility
.centre{ margin:0 auto; text-align:center; } .left{ text-align:left; } table#matrix{ /*border:1px solid #000; -moz-box-shadow: 3px 3px 5px 6px #ccc; -webkit-box-shadow: 3px 3px 5px 6px #ccc; box-shadow: 3px 3px 5px 6px #ccc;*/ border-collapse:collapse; ma
Device Specific
Devices Displaying a QR Code in $message After submitting a form the standard message displayed on the screen "$message https://portal.blinkmobile.com.au/helpdesk/kb_article.php?ref=2347-OPGH-1381". By using submitted form data you can create a contact QR code as part of the success message. Ste
Displaying the Cordova Version Of An Native App Shell
The javascript will return to an interaction all the current Cordova details of your installed application shell. Simply install the code below in the answerspace->setup->HTML Head and create an interaction to display the returned results. View Code In Gi
Distributing an Android app
Distributing an Android app To distribute Android apps internally or outside via one of the numerous Android app stores (Google, Amazon, various carriers, etc) the process is quite simple. Currently not available in the Blink App Factoryl. The process i
Distributing an iOS app via Apple’s Enterprise Distribution
Sign up to the Apple Enterprise Development Program. https://developer.apple.com/programs/ios/enterprise/ Key points to note are: The cost is $A299 per year (NOT any other option) The organisation must have a DUNS number from Dun & Bradstreet The organisa
Distributing an Microsoft Windows app
Distribution via App Stores If a client organisation wishes to also (or only) lodge the app in the various app stores for more general distribution they must review the submission guidelines provided by the respective app store, for example: appstore (1).jpg The Apple iTunes App Sto
|
EEmail attachments exceeding 10MBTraditionally the best practice for email servers and gateways have been to set limit on the size on email attachments to 10MB. With the introduction of modern mobile phone cameras we have identified a number of BMP form submissions have contained a numbe
Email Functions
$t->Email The Blink Mobility Platform has a simple email helper located at $t->email. $t->email sends an email to specified email address, from another specified email Parameters # An array of options including the following. $to Email address that is t
Email Notifications
Embed Prezi prezi.png Prezi http://prezi.com/ is a web based virtual blackboard that is used to create presentations or communicate ideas to your users. You can embed Prezis into a Message Interactions by simply copying the embed code from any of your Prezis and cop
Environment Variables
BMP_SCOPE By default, this tool determines your project scope by reading the .blinkmrc.json file in the current working directory or its parent directory (or its parent's parent directory, etc). You may set this variable instead. BMPUSERCONFIG_DIR By defa
Exception Handling Functions
When scrapping a site there are times when you need to provide some event handling in the case of error. For example a Fetch command may not return any data due to changes to the master source, so what do you do and how do you detect such errors. Using th
Execution Functions
$t->runInteraction( ) This will execute the named Interaction. This technique can be useful for defining common classes and functions in one Interaction, so that many other Interactions can re-use them without unnecessary copy-pasting. Some clients provid
Export AnswerSpace
V3. Is the current export file format and is compatible with older services. V4. Now exports all answerspace data into an export file structure which makes version management control accessible via the use of Diffs. Now any two v4 un-zipped exports can b
|
||||||||||||||||||||||||||||||
FFetching Functions$t→fetch() Given a URL and post data, the fetch function makes a HTTP request and sets $t->result to be the resulting source code. By convention we work with a string, $t, applying mADL functions to it. In the fetch function we load the string $t with the
Field Calculation Logic
Field Cascading Select Lists Logic Field Conditional Logic Field Properties List By Field Type See Field Properties the full property definitions and Form View listings. Textbox image2014-9-22 12:44:2.png Textarea image2014-9-22 12:43:3.png Password image2014-9-22 12:44:34.png Email image2014-9-22 12:44:53.png URL image2014-9-22 12:45:14.png Phon
Fields
Field properties By Type List Field Types Field Type Icon Type HTML Element Description / Notes Text Box image2014-9-22 12:44:2.png Keyboard Input input [type=text] Alphanumeric. Text Area image2014-9-22 12:43:3.png Keyboard Input textarea Multiline and a
Floating Images and Messages
You may want to float a message to the user or create a simple image display that focuses the user's attention on what is being displayed. Whilst there are a number of freely available scripts that can be integrated within an answerSpace, the following is
Form Configuration
Form Custom Code Form Definition Form Records (Tuples) Data Suitcases Populating A BlinkForm As most uses of this involve XPath queries under your control, the precise tag used for the root element is not important, although valid XML specifies exactly 1 root element. This format is used for network transmiss
Form Variables And Functions
Form Views And Actions Formatting Functions When using a Fetch( )) https://blinkmobile.atlassian.net/wiki/display/TD/Fetching+Functions function to retrieve the data from a url or other source, you can specify and filter results in your Interactions. These functions can be naturally generated by th
Forms Builder
Forms v2 Data Flow This diagram is a basic overview of how filling out a form and submitting it is actually carried out. If we were going to be overhauling this, then each step should be asynchronous and as much as possible should be optional. Note: similar to the previous
Forms v2 Form Blobs Data Flow
This diagram adds to the previous diagram, explaining how blobs (e.g. images, signatures, arbitrary binary files, etc) are handled and submitted. If we were going to be overhauling this, then I'd try to come up with a way to make this optional as well, as
Functions
mADL is the myAnswers Distillation Language which is used in the INTERACTION Code area of the definition of INTERACTION functionality. mADL is designed to simplify the development of user interaction functions desired of INTERACTIONS. Most INTERACTION fun
|
GGeneral AnswerSpace DesignResolution Of Design When creating your psd file or eps file, aim to fit your design into a resolution of 600w x 720 h. This ensures the images are crisp for a small screen such as iPhone 3gs and a large screen such as a iPad. Page Size This is a matter o
Generating and saving PDFs on Android
How to create a PDF for the visible DOM elements using the jsPDF http://parall.ax/products/jspdf library.. To generate and save pdf's on Androids you will need: Blink Android app shell version 1.1.0 https://portal.blinkmobile.com.au/helpdesk/kb_article.ph
Generating PDFs
Generating PDFs on Android How to create a PDF for the visible DOM elements using the jsPDF library. Step-by-step guide Add the steps involved: You need to use the latest code from their github page https://github.com/MrRio/jsPDF. You need to add jsPDF and rasterizeHTML.js http://c
Global Settings
Glossary Of Terms The Blink Mobility Platform brings a very powerful approach to delivery of mobile systems throughout an organisation. Being able to de- scribe this is key. This Glossary aims to establish a common language for describing components and functions of the B
Google Map Basic
$t->map("drawBasicMap", $mapOptions); $mapOptions An array of options including the following settings. longitude A string : containing the locations longitude latitude : A string : containing the locations latitude zoom An integer : from 1 to 20, the hig
Google Map From A KML File
KML is a file format used to display geographic data in an Earth browser such as Google Earth, Google Maps, and Google Maps for mobile. KML uses a tag-based structure with nested elements and attributes and is based on the XML standard. For more informat
Google Map With Directions
$t->map("directions", $mapOptions); $mapOptions An array of options including the following settings. origin A string : containing the original location address. If set to "1" the device's current location will be used destination A string : containing th
Google Map With Search
$t->map("drawMapFromAddress", $mapOptions); $mapOptions An array of options including the following settings. address A string : containing the location's address. zoom An integer : from 1 to 20, the higher the number the map is more zoomed in. If Blank t
Graphics & Icons
The assets or Application Shell artwork sizes differ due to the device builds. If you are requesting an Application Shell to be created you must provide the following assets. The following are the divisions and - required naming convention. iOS Devices Re
Guidelines for installing custom enterprise apps on iOS
Trust is established automatically if the app is installed by Mobile Device Management (MDM). If you install an app manually you must also manually establish trust as described below. Apple recommends using an (MDM) solution to distribute the apps because
|
||||||||||||||||||||||||||||||
HHow Strong Is Your iPhone Signal?Have you ever wondered how strong your iPhone signal really is? Sure you can count the number of bars on your screen, but it’s not really specific. With this new tip, we’ll show you how you can convert the signal bars into an actual number. The digits are
How to retrieve iOS Crash Reports
After the app crashes, it leaves some logs on your device. These logs are helpful for determining why an application has crashed or behaving badly. To retrieve the crash reports you will need to take the following steps: Step 1 Sync your iPhone to iTunes.
How-to articles
HTML Hybrid Blink App Shells (Cordova) Prerequisites Node.js https://nodejs.org/ 0.12.x or newer NPM 3.0.x or newer (Node.js 5.x includes this) latest Cordova CLI http://cordova.apache.org/docs/en/5.1.1/guide/cli/index.html#link-2 the App Cache Fetcher CLI tool basic familiarity with command l
|
IImage Annotation / Scaling / CroppingImage Annotation in the Blink Native Client is added in 2.2.1 (Master App 1.12) in iOS and 0.11.2 and above in Android. It has been implemented as an enhancement to the TouchDraw plugin, but backwards compatibility has been maintained. There are two ways
Images Sizes and Forms
Image Field Types The following field types are decoded and encoded in Base64 http://en.wikipedia.org/wiki/Base64 format into forms and some maximum do apply. image2014-9-22 12:54:6.png Camera Fields image2014-9-22 12:54:58.png Image Library Fields image2
Import AnswerSpace
Installing App Cache Fetcher Installation https://camo.githubusercontent.com/e3447387286372aea9a40ec71a5d8e9123359617/68747470733a2f2f696d672e736869656c64732e696f2f6e706d2f762f40626c696e6b6d6f62696c652f61707063616368652d666574636865722e737667 https://www.npmjs.com/package/@blinkmobil
Installing BMP CLI
Installation https://img.shields.io/npm/v/@blinkmobile/bmp-cli.svg https://www.npmjs.com/package/@blinkmobile/bmp-cli https://travis-ci.org/blinkmobile/bmp-cli.svg?branch=master https://travis-ci.org/blinkmobile/bmp-cli Open a terminal or command line pro
Interaction Settings
This set of options allows you to set specific behaviours on Interactions as well as do some limited styling. The following options can be set in this window. Note: All options set here affect the specific Interaction and only that Interaction. Gener
Interaction Types
Interactions are the building blocks of an answerSpace. An Interaction is a self-contained micro-app which models a single user interaction with any data source. Interactions are programmed in MADL or Xpath and use HTML and/or XSLT to display. Interact
Interactions
Interactions are the building blocks of an answerSpace. An Interaction is a self-contained micro-app which models a single user interaction with any data source. Interactions are programmed in mADL (PHP) or Xpath and use HTML and/or XSLT to display. In
iOS
iOS Devices iProximity Is the Blink Mobility Platform available for Windows Phone 7? Observations 1. The Blink Mobility Platform was originally designed to run specifically on Phone and Tablet-specific Operating Systems. Our target platforms have been the SmartPhone environments of iOS, android, BlackBerry, and Windows Phone 7. We also
iTunes Store Artwork Sizes
To add an application to the iTunesconnect web page you must provide screenshots of your application to display in the iTunes App Store itunes.jpg Here are the itunes store screenshot sizes. A large version of your app icon that will be used on the Ap
|
||||||||||||||||||||||||||||||
JJavascriptDepending on which BIC (Blink Intelligent Client) you use BICv2 (The Built in platform version) BIC - JQM (jQuery Mobile version) aka BIC3 The BMP provides a large number of API's. Contents Overview Where do I use Javascript? Javascript can be stored in
jQuery.AJAX and the "always" callback
This effects some of the JavaScript work-around code we have in circulation, especially the GeoLocation code (from memory). I've found (and officially complained about: http://bugs.jquery.com/ticket/11548 http://bugs.jquery.com/ticket/11548) the way AJAX
|
K |
||||||||||||||||||||||||||||||
LLevels Of Severity [Support Requests]BlinkMobile’s Tech Support is your primary point of contact for fault reporting and escalation of issues. Through the Tech Support Group, we will: Provide you with a 24x7 fault reporting facility; Provide you with a 24x7 Emergency Fault Reporting Service;
Lightboxes and other Things
There are times where you want to display content in a Lightbox. Information that can be displayed in Lightboxes include such things as detailed information (such as an enlarged graphic or a more detailed description of something) or feedback or confrima
List of Android WebViews
Device Android Default WebView HTC One X 4.2.2 Android WebKit Android WebKit Wolfgang Whoop 4.2.2 Android WebKit Android WebKit Samsung Galaxy Note 4.1.2 Android WebKit Android WebKit Sony Xperia S 4.1.2 Android WebKit Android WebKit HTC M8 5.0.1 Chromium
Logging In and Out
Once you have set up the scope for the project you will need to login using the BMP CLI. Login Firstly you will need the authorisation token generated for the answerSpace. blinkm bmp login Paste your authorisation token when prompted, hit enter and you sh
Login
This Custom Authentication Process can be used to override the current login systems and can be extended to external authentication APIs. To include a Custom Authentication Process in your answerspace you first need to create two mADL interactions. Inter
|
MmADL (PHP)Overview MADL interactions are dynamic pages, able to get data to the user from a variety of sources. mADL interactions are a self contained micro applications designed using BlinkAnswers Distillation Language mADL. MADL is not a different language - it i
Manage answerSpace
Manage Assets How Do I Manage My Assets? The term 'assets' when used in BlinkMobile terms refers to those objects in your answerSpaces that define how it looks and in some cases, behaves. Examples might be javascripts or graphic images. The Asset Manager tool allows yo
Manage BlinkForm Objects
The BlinkForms Builder will step you through the process of creating a BlinkForm. There are 6 Steps associated with creating a BlinkForm. You must complete each Step in order in order to save your form. However, should you leave your form before the comp
Manage Catergories
Manage Interactions Interactions are the building blocks of an answerSpace. An Interaction is a self-contained micro-app which models a single user interaction with any data source. Interactions are programmed in MADL or Xpath and use HTML and/or XSLT to display. Interact
Manage Master Catergories
Manage User Groups Maps Finding Your Current Location // $answerSpace = 'support'; // the answerSpace you are in $interaction = 'gps'; // the interaction you are editing NOTE: no spaces allowed! if($_POST['coords']){ // you get in here after a successful GeoLocation read //$t->
Master Categories Settings
This area allows you to set specific Master Category defaults that will override any settings made at the Master Master Category or answerSpace level, and be applied to any Interactions that they may contain (unless overridden at the Master Category level
My Interaction is displaying strange ASCII characters?
Step-by-step guide Go to answerspace setup =>Localisation=>character encoding Set the interaction level to UTF-8 This solution is for BIC2 only. BIC3 answerSpaces should be set to UTF8 by default. Related articles Related articles appear here based on
|
||||||||||||||||||||||||||||||
NNavigationBMP provides the following built-in events for navigating your answerSpace. A more future-proof, maintainable, and easier scheme would look like: Link Type Description <a keyword="k1" ...> link to K1</a> // for backwards compatibility only <a interaction
Navigation & Categories
NFC (Near Field Communications) There are several ways to incorporate NFC into the BMP via Blink's native app shells. This can be done by calling the cordova plugin (barcodereader) <p id="message" style="max-width:100%;word-wrap:break-word">To scan an NFC tag, tap the back of your devic
notification.alert( ) --aka alert( )
notification.alert() navigator.notification.alert(message, alertCallback, [title], [buttonName]) A replacement for the vanilla Javascript alert(). Displays a javascript alert box Parameters # message: Dialog message (String) alertCallback: Callback to inv
notification.beep()
notification.beep( ) navigator.notification.beep(times); The device will play a beep sound. Parameters # times: The number of times to repeat the beep (Number) Supported Platforms # Android BlackBerry WebWorks (OS 5.0 and higher) iOS (OS 4.0 and higher) E
notification.confirm( )
notification.confirm() navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels]) Shows a customisable confirmation dialog box. Parameters # message: Dialog message (String) alertCallback: Callback to invoke with index of button pre
notification.vibrate( )
notification.vibrate( ) navigator.notification.vibrate(milliseconds) Vibrates the device for the specified amount of time. Parameters # time: Milliseconds to vibrate the device. 1000 milliseconds equals 1 second (Number) Supported Platforms # Android Blac
|
OObsolete mADL / PHP FunctionsBelow is a list of obsolete or now illegal mADL and PHP commands Effective July 2015 Function Note paginate createMap superceded by $t->map() mapReplace nothing to do with cartography _mapReplace as above removeTags superceded by $t->stripTags(string
Offline login caching
This sample code demonstrates how to achieve offline login caching in an answerSpace. goBackToHome(); if (navigator && navigator.bgcachereset && navigator.onLine) { navigator.bgcachereset.resetCache(); } $(document).ready(function() { var oldRequestLogi
Offline Mode
One of the most powerful features of the Blink Mobility Platform is its capability to work in disconnected mode in both web app and native app implementations. HOWEVER this whole area of operation needs precise understanding when discussing platform capab
|
||||||||||||||||||||||||||||||
PPDF FunctionsPDF functionality to MADL which is accessible in the custom code area of BlinkForms Builder or can be used within a mADL Interaction. $t->createPDF( ) The createPDF() MADL function returns a string for use in email, fetches, etc. The following sample cod
Platform Addons
Platform Credentials Management Once you have been assigned a new answerSpace, all maintenance and development is done via the answerSpace Administration area. See answerSpace creation on how to be assigned or modify answerSpaces answerSpace Administration The url is located at (yourser
Platform Menu Structure
Platform Process Diagrams These diagrams are not 100% complete (there's a near-infinite level of detail to which one could descend) but they're a start. Let us know if there are specific areas that need expanding.
Platform Release Process
Platform Security Data security within Blink Mobility Platform (BMP) can be separated into three main areas: User Authentication: User Authentication is the process of validating a user when logging in to an app running on the BMP. Data Transfer:Data transfer is the proces
Platform Structure Overview
The Blink Mobility Platform uses Amazon Web Services to deliver an extremely scalable and robust deployment platform, using most aspects of the AWS to achieve superior results. PlatformStructureOverview.pngPlatform Structure Overview To allow us to allow
Platform Support Services
Platform Technical Reference Platform User Documentation Positioning Functions When using a Fetch( ) function to retrieve the data from a url or other source, you can specify and filter results in your Interactions. These functions can be naturally generated by the "Code Builder" in the Interactions Manager. Basic Madl components us
Process: Client-Server Transmission
This diagram is fundamental to the others, and points out that data needs to be transformed on either side of a network transaction in order to survive as expected. Note: this applies to persistent storage as well (although the terms would be slightly dif
Push Notifications
|
Q |
||||||||||||||||||||||||||||||
RReading and Displaying FunctionsWhen using a Fetch( ) function to retrieve the data from a url or other source, you can specify the display of results in your Interactions. These functions can be naturally generated by the "Code Builder" in the Interactions Manager. Basic Madl component
Refreshing Cached Results
While rare,there may be times where the cache on a user's device fills up, or causes the answerSpace to display outdated information. You may also wish to force refresh the cache in preparation for another Interaction. You can do this by creating an Inter
Release Notes - Android App Framework
[2.0.0] - 2015-11-16 (Requires BIC3 version >= 4.2.4) Fixed ANDROID-184 # Prevent the splash screen from being dismissed too soon when booting BIC3 answerSpaces [1.3.0] - 2015-05-04 Added ANDROID-180 # Add Cordova NFC plugin (v0.6.2) ANDROID-174 # Add JS
Removing the large scrollable footer space on Android app shells
Often an Blink Android application shell will leave a large scrollable footer space on your answerspace. This is caused by the web view assuming the answerspace is longer and it cannot set the page size. Simply add the following code in the answerspace se
|
SSamsung and Android 4.0 Ice Cream Sandwich?== tablets == Samsung Galaxy Note 10.1 (10.1" display + proper stylus) ships with Android 4.0 Samsung Galaxy Tab 2 10.1 (10.1" display) ships with Android 4.0 Samsung Galaxy Tab 2 7.0 (7" display) ships with Android 4.0 Samsung Galaxy Tab 10.1 (10.1" disp
Sandbox Restrictions
BMP executes all custom PHP (MADL) code within a sandbox environment for security. Sandboxing is the practice of running code in a restricted security environment, which limits the access permissions granted to the code. All custom PHP which you include a
Screens
Server Environments Session Functions These are good reasons for interfacing to pages using a web API if it is available! Many interactive enquiry systems set a verification string and/or a session id. In this case two fetches may need to be made to access data. The first may set up the verif
Sharepoint
SharePoint offers a Web Services integration option, which can be used by the Blink Mobility Platform (BMP) for users who need extra flexibility or access to SharePoint data. Web Service integration is an advanced method designed to be used by developers
Simple FaceBook Integration
facebook.png Integrating with Facebook is simple if you are building a web app. The following page describes how to integrate Facebook with a standard web app only. If you wish to integrate with Facebook whilst using our App Shell, you will need to be ve
Social Media and Interactions
You can embed a number of social media types into an Interaction. Bear in mind, that some media (such as YouTube) can consume a large amount of data and bandwidth, so consider carefully both the type of social media you wish to make available, as well as
Step 1 (Form Setup)
This first screen is Step 1, and this is where you set up your form. Name your form. Ensure you do not use any spaces or any special characters (@ $ Z % ? & : ; - etc.) Click ‘Generate Interactions’ to generate the associated answerSpace Form Interactions
Step 2 (Create Fields)
This step is where you create your fields for your form. Make sure you keep in mind the Design Considerations https://education.blinkmobile.com.au/courses/4/wiki/mobile-form-design-considerations discussed earlier. After clicking 'Next Step' in Step 1, th
Step 3 (Configure Fields)
This step is where you define what type of fields you wish in your form, how they will behave and how they will appear to your user. configurefields1.png The Form Field table contains checkboxes that determine whether a particular Field appears on your f
Step 4 (Configure Form)
This step is where you configure the basic look and feel of your form. You can choose a different Look and Feel for each Form Type. For example, a user who is just entering data gets a different Heading than one that is viewing a list of entered data. St
Step 5 (Configure Notifications)
This Step allows you to define an email notification that will be sent at a particular point in the Form’s lifecycle. Step5a.png Click 'Add Notification' and fill in the information in the resulting screen. Step5b.png Choose at which point to send the not
Step 6 (Save & Generate Form)
It is in this Step that your Form is saved, the fields are created, the database tables are built, Form Interactions are created and any links to Sub- forms are established. step6.png You will receive an error message if there has been a failure in the cr
Storing JS, CSS & HTML
Subforms Submitted Form's Sequence Of Events The sequence of events for form submission are: User presses submit button Data is stored in the pending queue if this fails then "Error storing form data in pre-submission queue." is displayed to the user via BMP.alert() and the process terminates The fo
Support Request Requirements [Support Requests]
What information do I need to help diagnose my issue? A Good Steps To Reproduces Example Steps may include: Login as test. Password :Test Browse to Construction > Update Jobs > Edit Enter BLINK for the Vendor, Add a Material, and select any Material (eg.
|
||||||||||||||||||||||||||||||
TThe App Factoryapps3.jpg What is it? A web based self service portal for Blink partners can Facility for partners to create their own Blink app shells Upload artwork assets Upload signing certificates and provisioning profiles http://developer.apple.com/library/ios/#do
The Current State of Telephone Links
Problem Telephone links are a thing. Like an anchor link you tap to (probably) go to another page, these are links you tap to call a number on a phone-capable device. They’ve been around for quite some time. Yet, they cause me a lot of confusion. For exam
The Forms Builder
The Interaction Manager he Interaction Manager is the heart of the BlinkMobile Platform. The Interaction Manager is the administration interface for answerSpaces. All of the configuration of answerSpaces is performed in it and Interactions are programmed in it. Once you have lo
The mADL Code Builder
The Code Builder helps you build and generate the correct mADL Code for your Interaction. Once the Code Builder window opens, type in the source URL: build1.png Click the 'Load' button. The source code opens and is displayed in the next pane: build1a.png
Troubleshooting And Errors
Troubleshooting articles |
UUser AuthenticationuserAuth.png User Authentication is a process that allows an app to validate the user’s details, usually against a remote server. Validating and identifying a user allows the app to not only restrict access to authorised users, but it also allows the data
Using Bing Maps In A Windows App Shell
You need to follow the Bing Maps SDK instructions here: https://github.com/blinkmobile/cordova-plugin-map#installation https://github.com/blinkmobile/cordova-plugin-map#installation (don't bother actually installing the Cordova plugin unless you intend to
Using Google Fonts
Part of creating POCs and Pilot answerSpaces involves being able to customise the look and feel of the answerSpace. Full instructions on this will be available in an upcoming course - Styling Your answerSpace. However, simply put, you can create your own
Using mADL Rows
Now that you understand the principles of a basic mADL scrape, you can refine that scrape to only show those items on a page that are relevant. You do this by using Rows. Rows are basic repeating patterns that are found on a web page. The system looks for
Using REST With The BMP
You can incorporate REST services into BMP Interactions <arg> <prefix>Latitude:</prefix> <preload>-33.42</preload> </arg> <arg> <prefix>{NL}Longitude:</prefix> <preload>151.34</preload> </arg>$debug = true; $str = ''; $url = 'http://api.geonames.org/count
Using SOAP With The BMP
We haven't build it into mADL, however you can just use the standard PHP SOAP class, seehttp://php.net/manual/en/book.soap.php http://php.net/manual/en/book.soap.php <arg> <prefix>Number 1:</prefix> <preload>3</preload> </arg> <arg> <prefix>{NL}Number 2:<
Using Tamper Data To Troubleshoot APIs
Problem Debugging API and arguments between page submissions. Solution Methods for getting into troublesome APIs. You can sometimes get away with the Chrome->Inspect Element->Network tab, However Tamperdata actually allows the interception of data (get/po
Using the Admin Interface
Using the Form Builder |
||||||||||||||||||||||||||||||
VVersioningViewing AJAX arguments in the JS Console This snippet has to be run after jQuery. For BIC v2, I put this in a JavaScript-hosting interaction and link the interaction in externalJavaScript in answerSpace Setup. Then all you need to do is use the answerSpace, submit forms, etc and you'll see (in
|
WWeb AppsAn answerSpace can be made to look like a native application simply through the use of styling and graphics. (See our course titled "Introduction to Styling Your answerSpace https://education.blinkmobile.com.au/courses/5" for more information). The Web A
Web Services
Connecting to External Webservices $t->fetch is the primary BMP utility for connecting to external web services. HTTP Authentication $usr = 'username';$pwd = 'password'; // method 1 - login details in URL $url = "https://$user:$pwd@webservice.dmz.google.c
What is a BlinkForm?
Often, the mobile Interactions you wish to deliver to your users require integration with existing forms-based systems. You might also wish to deploy new mobile forms and data capture capabilities within your answerSpace. The BlinkForms Builder provides t
What is the Blink Intelligent Client
What’s a BIC anyway? If how your application looks and performs is as important as what it does, then you’ll need to know about the capabilities of the Blink Intelligent Client, or BIC to its friends. There are all sorts of changes in the BIC right now th
Where do I store Javascript in my answerSpace?
Sometimes an interaction may require some additional javascript. It maybe part of a form, a object or element function, or just an alert message. Javascript can be stored in several places. Where can I insert Javascript? Within the interaction itself. Wit
Whitelisted domains
A Blink Application Shell is designed to function within the selected answerspace and host domain. i.e. blinkm.co http://blinkm.co. The BMP platform will often require several domains to use their services as part of functionality, maps and storage etc. A
Whoami
This will return the the answerSpace url and your user name and email address. blinkm bmp whoami Its good practice to call this function before a Pull or Deploy to check the correct Scope. Next steps: Pull Requests
Why is a Navigation Structure so important?
The small screens of mobile Internet devices, combined with the increasing complexity of mobile tasks, can create a serious obstacle to usability in the mobile Internet. The mobile phone/tablet display is not likely to become much larger, for the need for
Windows Devices
Windows Phone |
||||||||||||||||||||||||||||||
XXML & XSLT |
YYouTube Integrationimages.jpeg You can embed a number of social media types into an Interaction. Bear in mind, that some media (such as YouTube) can consume a large amount of data and bandwidth, so consider carefully both the type of social media you wish to make available,
|
||||||||||||||||||||||||||||||
Z |
!@#$ |
||||||||||||||||||||||||||||||
LikeBe the first to like this