Mobile Application Guide

Access DataMagik dashboards and applications on mobile devices with secure authentication and extended sessions.

Table of Contents

1. Overview
2. Getting Started
3. Authentication
4. Mobile Dashboards
5. Mobile Applications
6. Session Management
7. For Administrators

1. Overview

DataMagik provides mobile access to dashboards and applications through a native mobile app powered by responsive web views. Key features include:

• OAuth Single Sign-On — Log in with Google or Microsoft credentials
• Extended Sessions — Stay logged in for up to 60 days on mobile
• Mobile-Optimized Views — Dashboards and apps render in responsive, embedded layouts
• Full API Access — All DataMagik APIs are accessible from mobile clients

2. Getting Started

Step 1: Install the App

Download the DataMagik mobile app from the App Store or Google Play.

Step 2: Log In

Tap Sign In and authenticate with your Google or Microsoft account. The app uses OAuth for secure, passwordless authentication.

Step 3: Access Your Content

After login, you'll see dashboards and applications that have been enabled for mobile access by your administrator.

3. Authentication

OAuth Login Flow

1. Tap Sign In in the mobile app
2. A browser window opens for Google or Microsoft authentication
3. After authenticating, a one-time token is securely passed back to the app
4. The app exchanges this token for a session (valid for 60 days)

Security

• One-time tokens expire after 10 minutes and can only be used once
• Session tokens are stored securely on the device
• All communication uses HTTPS encryption
• MFA policies configured by your administrator apply to mobile logins

4. Mobile Dashboards

Dashboards with Show on Mobile enabled appear in the mobile app.

Features

• Charts, metric cards, and data tables render responsively
• Auto-refresh keeps data current based on the dashboard's refresh interval
• Screen parameters and filters work as on desktop
• Charts scale to fit the mobile viewport
• Data tables become horizontally scrollable

How Dashboards Are Rendered

Mobile dashboards use embedded HTML fragments — the dashboard content is rendered without the desktop navigation wrapper, providing a clean, full-screen experience optimized for smaller screens.

5. Mobile Applications

Applications with Show on Mobile enabled appear in the mobile app.

Features

• All component types (tables, charts, forms, cards, reports) are supported
• Tab navigation works on mobile
• Data tables support touch scrolling
• Report panels render inline
• PDF generation is available from report panels

How Applications Are Rendered

Like dashboards, applications render as embedded HTML fragments in the mobile app's webview. Editor controls are hidden — only the viewer mode is shown.

6. Session Management

Session Duration

Sessions use a sliding window — every API call extends the expiry. You stay logged in as long as you use the app within the session window.

Logging Out

Tap your profile icon and select Log Out. This immediately invalidates the session on the server.

Multiple Devices

You can use DataMagik on multiple devices simultaneously. Each device maintains its own independent session.

7. For Administrators

Enabling Mobile Access

To make content available on mobile:

Dashboards

1. Open the dashboard in the Dashboard Designer
2. Go to Settings
3. Enable Show on Mobile
4. Save the dashboard

Applications

1. Open the application in the Application Designer
2. Edit the app settings
3. Enable Show on Mobile
4. Save the application

Monitoring Mobile Sessions

Mobile sessions appear in the account activity logs. You can identify mobile sessions by their extended expiry (60 days vs. 4 hours for web sessions).

Security Considerations

• MFA enforcement — MFA policies apply to mobile logins through OAuth
• Session revocation — Admins can invalidate mobile sessions if a device is lost or compromised
• Audit trail — All API calls from mobile clients are logged the same as web requests
• Permission controls — Mobile users see only the dashboards and apps their permissions allow

Tips for Mobile-Friendly Content

• Keep dashboards simple — Fewer elements work better on small screens
• Use metric cards — They display well on mobile viewports
• Test on mobile — Preview how your dashboards and apps look on a phone
• Consider tab layout for apps — Tabs work well for organizing mobile app content