You're currently browsing the Ignition 8.0 docs. Click here to view the latest docs.


Overview

The Ignition Perspective App is a native mobile application that can be downloaded and installed on Android and iOS mobile devices. It provides users with a single location to access all of their Perspective projects. While a Perspective Session can be launched from a mobile device's web browser, the Perspective App enables the use of many built in pieces of hardware within your mobile device, such as the camera, the accelerometer, or the NFC Scanner. Data from these tools can be pulled into the Perspective Session and used in various ways: a barcode can be scanned and the data inserted into a database, the accelerometer can be used to remote control a device with motion rather than buttons, or an NFC tag can provide vital information about a system. For information about setting up native app actions in Perspective, see Perspective Events and Actions.

Download the App

You can download the Ignition Perspective App from a local online app stores, such as the Google Play Store for Android or the App Store for iOS. 

  1. In your app store, search for Ignition Perspective.
  2. Click the Install button.



  3. Once installation is complete, click the Open button, or click on the Perspective   icon on your device's home screen.



  4. The homepage is displayed. This will show a list of your projects. Initially, just the OnlineDemo is listed.


On this page ...

IULocgo

Perspective App


Launch a Perspective Session

On the home screen, you can launch the Online Demo, which is on the Ignition 8.0 Demo Server or launch a project on a different Gateway.

Launch the Online Demo

To launch the demo, just click the Perspective icon or click on the demo description.

Launch a Project

  1. To launch a different project, click the Plus   icon in the lower right corner of your screen. 
  2. You then have two options:
    • Scan a QR Code
    • Search for an available Gateway with Perspective projects.

  3. For this example, we'll search for available Gateways. Click on Gateway Search.



  4. Select the Gateway you want to connect to.



    1. If the Perspective App doesn't find the Gateway automatically, you can manually input a Gateway host name and port. Click on Manually Input Gateway.
    2. Type in the host name including the port, for example: https://10.10.115.3.8088.



  5. Click on the project you want to open.



  6. If security is set up on the project, you'll be prompted to sign in with your credentials.

Switch to a Different Application

When you are running a project or the demo app, you can switch to a different application, as follows:

  1. Click the App Bar   icon (down arrow in the lower right corner. 
  2. Click the Exit   icon. 
  3. At the confirmation prompt, click Exit. 


Additional Options

Click on the Search    icon at the top of the screen to filter the project list.

Click on the Settings  icon at the top of the screen to view the settings for the Perspective app. Here you can organize your list of available Gateways. You can also turn the Auto-Launch option on and select a project that will be automatically launched when the Perspective App is opened on this device. 





Managed Configurations

The Ignition Perspective App can be configured via iOS and Android enterprise services, allowing third-party tools to install the app with some initial configurations. The actual configurations are pushed out by the Enterprise Mobile Management (EMM) solution, so there are no configurations to be made on the Ignition side.

For Android devices, EMMs pull the keys from the APK and manages the configuration from a console in the EMM software. 

For iOS devices, you will need to provide the EMM software with a sample PLIST. See Sample PLIST Template further down. 

The following keys will be made available to the EMM solution.

KeyDescription
auto_launch

Contains keys that control the auto-launch capability of the app, allowing you to determine if the app should immediately launch into a project or not. Contains the following keys:

KeyDescription
auto_launch_lockedIf true, prevents user from disabling auto-launch or changing the auto-launch URL within the app. 
prevent_exitIf true, prevents the user from exiting the auto launched project.
auto_launch_urlIf set with a project URL, auto launch is enabled and the project specified in the URL will automatically launch upon startup of the app.
hide_demoIf true, the built-in demo project will become hidden. 
initial_applications

Allows you to add projects to the main app page. Each application has the following keys:

KeyDescription
project_url

A URL leading directly to the application, for example:

http://www.someurl.com:8088/data/perspective/client/myproj 

OR 

perspective://www.someurl.com:8088/myproj
aliasThe name for the application, as it will appear in the project list. 
is_favoriteSets this project as a favorite. 
initial_gateways

Allows you to add Gateways to the Recent Gateways list. Each gateway has the following key:

KeyDescription
gateway_url

A URL to the Gateway you'd like to add to the list, for example:

http://www.someurl.com:8088

Sample PLIST Template

Below is a sample PLIST template that can be used when applying managed configurations for iOS.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
    <dict>
        <!-- Launches the project immediately upon starting the app -->
        <key>auto_launch</key>
        <dict>
            <!-- URL of project to Auto Launch -->
            <key>auto_launch_url</key>
            <string>https://demo.ia.io:443/data/perspective/client/OnlineDemo</string>
            <!-- Prevents user from changing auto launch setting -->
            <key>auto_launch_locked</key>
            <true/>
            <!-- Prevent user from leaving auto launch project to use rest of app -->
            <key>prevent_exit</key>
            <false/>
        </dict>
        <key>hide_demo</key>
        <true/>
        <!-- Applications that will be available to user on start of app -->
        <key>initial_applications</key>
        <array>
            <dict>
                <!-- URL of project -->
                <key>project_url</key>
                <string>https://demo.ia.io:443/data/perspective/client/OnlineDemo</string>
                <!-- Add the project to favorites -->
                <key>is_favorite</key>
                <true/>
                <!-- Provide an alternative name user will see when viewing project, in this
                case project name will be 'Perspective Demo' instead of 'OnlineDemo' -->
                <key>alias</key>
                <string>Perspective Demo</string>
            </dict>
        </array>
        <!-- Gateways that will be available to user on start of app. User's still need to
         add individual projects from each gateway. Gateways from projects included in
         initial_applications will already be included and don't need to specified again here. -->
        <key>initial_gateways</key>
        <array>
            <dict>
                <!-- URL of gateway -->
                <key>gateway_url</key>
                <string>https://demo.ia.io:443</string>
            </dict>
        </array>
    </dict>
</plist>




  • No labels