Dispatch SDK

43min
For every Execution Task﻿, a corresponding pre-coded module is expected in the app as part of SDK. This module executes the Task on the device running the Delivery Agent app. Thus, the Dispatcher SDK allows you to build this app with the minimum amount of effort.
The Mobile App SDK will orchestrate the execution of Tasks. Objective status updates will flow back as objective events to dispatch service through API calls made by the SDK and they will be stored in the Objective Events Store. This SDK can be used to render execution task screens on UI, maintain their states, and manage Movement Tracking System﻿.
Dispatch SDK is an expo-based SDK that is written in Typescript and some Modules in Java/Kotlin. 
Currently supports SDK>=21 (Android).
Features
Sync Manager: Provides Sync Manager for syncing events & Docs in the background with retry functionality.
Execution Tasks: Provides a list of Execution Tasks which are as follows: Deliver, Capture Input, Deliver Cash, Complete-Success, Complete-Failure, Pickup, Doodle, Forms, Display, Verify Location, Verify OTP, Verify String, Scan QR/Barcode, Image Capture, Init Payment, Process Payment, and Complete Payment.
Execution Engine: Provides methods for Executing a given Workflow/Job in a dispatch.
Firebase Cloud Messaging: Provides a method for receiving Firebase Cloud Messaging.
Async Storage: Provides async storage for storing key-value pairs.
Higher-Order ETs: Provides a way to customize Execution Task UI.
Asynchronous Event Handling: Provides a method for handling Execution Tasks asynchronously.
Installation
Setup Expo (For non-expo projects only)
Text
npx install-expo-modules
npx install-expo-modules
﻿
Install Dispatch SDK Package
Text
npm install @os1-platform/dispatch-mobile@latest_version
npm install @os1-platform/dispatch-mobile@latest_version
﻿
Text
yarn add @os1-platform/dispatch-mobile@latest_version
yarn add @os1-platform/dispatch-mobile@latest_version
﻿
Install these dependencies
JSON
{
  "dependencies": {
    "@apollo/client": "^3.5.6",
    "graphql": "^16.2.0",
    "@expo-google-fonts/ibm-plex-sans": "*",
    "@os1-platform/mts-mobile": "^1.0.0",
    "@react-native-async-storage/async-storage": "^1.15.5",
    "@react-native-community/datetimepicker": "^3.5.2",
    "@react-native-community/netinfo": "^6.0.2",
    "@react-native-community/slider": "^4.1.8",
    "@react-native-firebase/analytics": "^14.1.0",
    "@react-native-firebase/app": "^14.1.0",
    "@react-native-firebase/messaging": "^14.1.0",
    "@react-native-firebase/remote-config": "^14.1.0",
    "@react-navigation/native": "^6.0.6",
    "@react-navigation/native-stack": "^6.2.5",
    "axios": "^0.24.0",
    "expo": "^43.0.4",
    "expo-barcode-scanner": "^11.2.1",
    "expo-file-system": "~13.0.3",
    "expo-font": "~10.0.3",
    "expo-image-manipulator": "^10.1.2",
    "expo-image-picker": "^11.0.3",
    "expo-location": "^13.0.4",
    "expo-sqlite": "^10.0.3",
    "react": "17.0.2",
    "react-native": "0.66.1",
    "react-native-paper": "^4.9.2",
    "react-native-safe-area-context": "^3.3.2",
    "react-native-screens": "^3.9.0",
    "react-native-vector-icons": "^9.0.0"
  }
}
{
  "dependencies": {
    "@apollo/client": "^3.5.6",
    "graphql": "^16.2.0",
    "@expo-google-fonts/ibm-plex-sans": "*",
    "@os1-platform/mts-mobile": "^1.0.0",
    "@react-native-async-storage/async-storage": "^1.15.5",
    "@react-native-community/datetimepicker": "^3.5.2",
    "@react-native-community/netinfo": "^6.0.2",
    "@react-native-community/slider": "^4.1.8",
    "@react-native-firebase/analytics": "^14.1.0",
    "@react-native-firebase/app": "^14.1.0",
    "@react-native-firebase/messaging": "^14.1.0",
    "@react-native-firebase/remote-config": "^14.1.0",
    "@react-navigation/native": "^6.0.6",
    "@react-navigation/native-stack": "^6.2.5",
    "axios": "^0.24.0",
    "expo": "^43.0.4",
    "expo-barcode-scanner": "^11.2.1",
    "expo-file-system": "~13.0.3",
    "expo-font": "~10.0.3",
    "expo-image-manipulator": "^10.1.2",
    "expo-image-picker": "^11.0.3",
    "expo-location": "^13.0.4",
    "expo-sqlite": "^10.0.3",
    "react": "17.0.2",
    "react-native": "0.66.1",
    "react-native-paper": "^4.9.2",
    "react-native-safe-area-context": "^3.3.2",
    "react-native-screens": "^3.9.0",
    "react-native-vector-icons": "^9.0.0"
  }
}
﻿
Async Storage Size Increase
Add the following line in gradle.properties file for increasing storage (AsyncStorage_db_size_in_MB=10)
JSON
android:allowBackup="false"
tools:replace="android:allowBackup"
android:allowBackup="false"
tools:replace="android:allowBackup"
﻿
Add jcenter() if not added already added in the Project-level build.gradle (/build.gradle): (Android only)
JSON
buildscript {

    repositories {
        ...
        jcenter()
    }
}

allprojects {
    repositories {
        ...
        jcenter()
        ...
    }
}
buildscript {

    repositories {
        ...
        jcenter()
    }
}

allprojects {
    repositories {
        ...
        jcenter()
        ...
    }
}
﻿
Fix for Apollo GraphQL Client (metro.config.js)
Add the following changes in the metro.config.js file. Issue Link﻿
JSON
const { getDefaultConfig } = require('metro-config');
const { resolver: defaultResolver } = getDefaultConfig.getDefaultValues();
exports.resolver = {
  ...defaultResolver,
  sourceExts: [...defaultResolver.sourceExts, 'cjs'],
};
const { getDefaultConfig } = require('metro-config');
const { resolver: defaultResolver } = getDefaultConfig.getDefaultValues();
exports.resolver = {
  ...defaultResolver,
  sourceExts: [...defaultResolver.sourceExts, 'cjs'],
};
﻿
Usage
Init Dispatch SDK
JS
import { DispatchSDKManager } from '@os1-platform/dispatch-mobile';

await DispatchSDKManager.getInstance().initDispatchSDK({
  userName: 'testuser',
  userID: 'testID',
  tenantID: 'TENANTID',
  tenantBaseURL: 'baseURL',
  accessToken: 'accessToken',
});
import { DispatchSDKManager } from '@os1-platform/dispatch-mobile';

await DispatchSDKManager.getInstance().initDispatchSDK({
  userName: 'testuser',
  userID: 'testID',
  tenantID: 'TENANTID',
  tenantBaseURL: 'baseURL',
  accessToken: 'accessToken',
});
﻿
Init Execution Engine
JS
import { DispatchStateContainer } from '@os1-platform/dispatch-mobile';

/**
 * Call this function when dispatch data is fetched successfully
 * @param dispatchID
 * @param jobs
 * @param logging
 * @param maxTaskReattempt
 */

await DispatchStateContainer.getInstance().initDispatchExecutor(
  dispatchID,
  dispatch.data.dispatch.jobs.data as Job[],
  false
);
import { DispatchStateContainer } from '@os1-platform/dispatch-mobile';

/**
 * Call this function when dispatch data is fetched successfully
 * @param dispatchID
 * @param jobs
 * @param logging
 * @param maxTaskReattempt
 */

await DispatchStateContainer.getInstance().initDispatchExecutor(
  dispatchID,
  dispatch.data.dispatch.jobs.data as Job[],
  false
);
﻿
Query Objective Status
JS
import { DispatchStateContainer } from '@os1-platform/dispatch-mobile';

/**
 *
 * @param objRef
 * @param jobID
 */

DispatchStateContainer.getInstance().fetchObjectiveState(
  'objective_ref',
  'job_id'
);
import { DispatchStateContainer } from '@os1-platform/dispatch-mobile';

/**
 *
 * @param objRef
 * @param jobID
 */

DispatchStateContainer.getInstance().fetchObjectiveState(
  'objective_ref',
  'job_id'
);
﻿
Start Objective Execution
JS
interface sdkError {
  code: string;
  message: string;
}
// Error Handling from the calling Screen
React.useEffect(() => {
  if (route.params?.sdkError) {
    console.log(JSON.stringify(route.params.sdkError));
    Alert.alert('Error', JSON.stringify(route.params.sdkError));
  }
}, [route.params?.sdkError]);

navigation.navigate('DispatchExec', {
  success: true,
  objectives: [], // Pass objective List
  successRoute: 'SuccessScreen',
  failureRoute: 'FailureScreen',
  initRoute: 'TaskDetail',
  // Calling Screen name (optional parameter). Used to throw errors back to calling screen
});
interface sdkError {
  code: string;
  message: string;
}
// Error Handling from the calling Screen
React.useEffect(() => {
  if (route.params?.sdkError) {
    console.log(JSON.stringify(route.params.sdkError));
    Alert.alert('Error', JSON.stringify(route.params.sdkError));
  }
}, [route.params?.sdkError]);

navigation.navigate('DispatchExec', {
  success: true,
  objectives: [], // Pass objective List
  successRoute: 'SuccessScreen',
  failureRoute: 'FailureScreen',
  initRoute: 'TaskDetail',
  // Calling Screen name (optional parameter). Used to throw errors back to calling screen
});
﻿
FCM
Setup (Android only)
Add the Firebase Android configuration file to your app:
Create a Firebase project (Check Firebase instructions for creating an app).
Click Download google-services.json to obtain your Firebase Android config file (google-services.json).
Move your config file into the module (app-level) directory of your app.
To enable Firebase products in your app, add the Google services plugin to your Gradle files.
In your module (app-level) Gradle file (usually app/build.gradle), apply the Google Services Gradle plugin:
JSON
apply plugin: 'com.android.application'
// Add the following line:
apply plugin: 'com.google.gms.google-services'  // Google Services plugin

android {
  // ...
}
apply plugin: 'com.android.application'
// Add the following line:
apply plugin: 'com.google.gms.google-services'  // Google Services plugin

android {
  // ...
}
﻿
In your root-level (project-level) Gradle file (build.gradle), add rules to include the Google Services Gradle plugin. Check that you have Google's Maven repository, as well.
JS
buildscript {

  repositories {
    // Check that you have the following line (if not, add it):
    google()  // Google's Maven repository
  }

  dependencies {
    // ...

    // Add the following line:
    classpath 'com.google.gms:google-services:4.3.10'  // Google Services plugin
  }
}

allprojects {
  // ...

  repositories {
    // Check that you have the following line (if not, add it):
    google()  // Google's Maven repository
    // ...
  }
}
buildscript {

  repositories {
    // Check that you have the following line (if not, add it):
    google()  // Google's Maven repository
  }

  dependencies {
    // ...

    // Add the following line:
    classpath 'com.google.gms:google-services:4.3.10'  // Google Services plugin
  }
}

allprojects {
  // ...

  repositories {
    // Check that you have the following line (if not, add it):
    google()  // Google's Maven repository
    // ...
  }
}
﻿
Get FCM Token
JS
import {
  getFCMToken,
  requestFirebasePermissions,
} from '@os1-platform/dispatch-mobile';
//Get FCM Token
let token = await getFCMToken();

//Request Notifications permissions (ios)
// It will ask for user permissions for showing alert/notifications
let enabled = await requestFirebasePermissions();
import {
  getFCMToken,
  requestFirebasePermissions,
} from '@os1-platform/dispatch-mobile';
//Get FCM Token
let token = await getFCMToken();

//Request Notifications permissions (ios)
// It will ask for user permissions for showing alert/notifications
let enabled = await requestFirebasePermissions();
﻿
Background FCM Messages
Register a callback for receiving FCM Messages in the background.
📘 NOTE﻿
Call this function in the root component, i.e, in the `index.js file of the app. 
﻿
JS
import { registerBackgroundHandler } from '@os1-platform/dispatch-mobile';

registerBackgroundHandler((message: object) => {
  // Handle FCM Message here
});
import { registerBackgroundHandler } from '@os1-platform/dispatch-mobile';

registerBackgroundHandler((message: object) => {
  // Handle FCM Message here
});
﻿
Foreground FCM Messages
useFcmMessage() custom hook in functional components to receive FCM Messages in Foreground.
JS
import { useFCMMessage } from '@os1-platform/dispatch-mobile';

const fcmMessage = useFCMMessage();
if (fcmMessage != null) {
  // update UI here to show the message
}
import { useFCMMessage } from '@os1-platform/dispatch-mobile';

const fcmMessage = useFCMMessage();
if (fcmMessage != null) {
  // update UI here to show the message
}
﻿
OR
Extend FCM base class in case of class components
JS
import { FCM } from '@os1-platform/dispatch-mobile';

class ClassComponent extends FCM {
  //implement these methods
  handleFcmMessage(remoteMessage: object): void {}

  //implement these methods
  handleNotification(remoteMessage: object): void {}
}
import { FCM } from '@os1-platform/dispatch-mobile';

class ClassComponent extends FCM {
  //implement these methods
  handleFcmMessage(remoteMessage: object): void {}

  //implement these methods
  handleNotification(remoteMessage: object): void {}
}
﻿
MTS
In the case of the dispatch mobile app, the Location Tracking module of the SDK provides a configurable way to capture and stream location data from the mobile device to the MTS﻿service, without any user intervention. To learn more, see Dispatch Documentation﻿.
MTS Default Config
JSON
export class MTSDefaults {
  locationFrequency: number = 10000; // in milli seconds (no. of seconds after which location updates will happen)
  distanceAccuracyLimit: number = 250; // in metres
  speedLimit: number = 28; // in m/s
  mode: MTSMode = MTSMode.HYBRID;
  environment: MTSEnv = MTSEnv.DEV;
  batchSize: number = 25;
  isMqttCleanSession: boolean = true;
  mqttKeepAliveInterval: number = 15 * 60; //in seconds
  maxLocationAge: number = 15000; // in milliseconds
  maxTraceSession: number = 24 * 3600 * 100; //in milliseconds
  isOdometerEnabled: boolean = true;
  retriesBeforeFallback: number = 1;
  httpFailureLimit: number = 5;
  dataSendDelay: number = 30000; // in milli seconds
  alarmTime: number = 60000; // in milli seconds
  missingSeqCheckDuration: number = 5 * 60 * 1000; // in milli seconds
  odometerPushFrequency: number = 5 * 60 * 1000; // in milli seconds
  qosLevel: number = 1; // values can be 0 ,1
}
export class MTSDefaults {
  locationFrequency: number = 10000; // in milli seconds (no. of seconds after which location updates will happen)
  distanceAccuracyLimit: number = 250; // in metres
  speedLimit: number = 28; // in m/s
  mode: MTSMode = MTSMode.HYBRID;
  environment: MTSEnv = MTSEnv.DEV;
  batchSize: number = 25;
  isMqttCleanSession: boolean = true;
  mqttKeepAliveInterval: number = 15 * 60; //in seconds
  maxLocationAge: number = 15000; // in milliseconds
  maxTraceSession: number = 24 * 3600 * 100; //in milliseconds
  isOdometerEnabled: boolean = true;
  retriesBeforeFallback: number = 1;
  httpFailureLimit: number = 5;
  dataSendDelay: number = 30000; // in milli seconds
  alarmTime: number = 60000; // in milli seconds
  missingSeqCheckDuration: number = 5 * 60 * 1000; // in milli seconds
  odometerPushFrequency: number = 5 * 60 * 1000; // in milli seconds
  qosLevel: number = 1; // values can be 0 ,1
}
﻿
Check For Mandatory MTS Permissions
JSON
let granted = await MtsLib.requestPermissionsForMTS();
// if granted = true : all permissions granted
// granted = false : one or more permissions denied
let granted = await MtsLib.requestPermissionsForMTS();
// if granted = true : all permissions granted
// granted = false : one or more permissions denied
﻿
Init MTS
JSON
import type { MTSInitRequest } from '@os1-platform/mts-mobile';

let mtsDefaults = new MtsLib.MTSDefaults();
mtsDefaults.speedLimit = 5000;
mtsDefaults.locationFrequency = 10000;
mtsDefaults.environment = MtsLib.MTSEnv.PRE_PROD;
mtsDefaults.isOdometerEnabled = false;

//Change MTS default values as per your use case

// ...Use this for Initiating MTS
let mtsInitReq: MTSInitRequest = {
  appName: 'app_name',
  appVersion: '1',
  mtsDeviceID: 'deviceId', // use FCM ID here
  configData: mtsDefaults,
  baseURL: 'https://{tenantId}.example.io/{mtsEndpoint}',
  accessToken: 'token',
  tenantID: 'TENANTID',
};
await MtsLib.initMTS(mtsInitReq);
//See Error Codes for Possible error types
import type { MTSInitRequest } from '@os1-platform/mts-mobile';

let mtsDefaults = new MtsLib.MTSDefaults();
mtsDefaults.speedLimit = 5000;
mtsDefaults.locationFrequency = 10000;
mtsDefaults.environment = MtsLib.MTSEnv.PRE_PROD;
mtsDefaults.isOdometerEnabled = false;

//Change MTS default values as per your use case

// ...Use this for Initiating MTS
let mtsInitReq: MTSInitRequest = {
  appName: 'app_name',
  appVersion: '1',
  mtsDeviceID: 'deviceId', // use FCM ID here
  configData: mtsDefaults,
  baseURL: 'https://{tenantId}.example.io/{mtsEndpoint}',
  accessToken: 'token',
  tenantID: 'TENANTID',
};
await MtsLib.initMTS(mtsInitReq);
//See Error Codes for Possible error types
﻿
Start MTS
JSON
let startReq: MTSStartRequest = {
  accessToken: 'token', // update access token
  resetSequence: false,
  dispatchID: '12345', // pass dispatch ID here
  expiryTime: Date.now() + 24 * 2600 * 1000, // expiry time after which MTS will stop automatically
};
await MtsLib.startMTS(startReq);
let startReq: MTSStartRequest = {
  accessToken: 'token', // update access token
  resetSequence: false,
  dispatchID: '12345', // pass dispatch ID here
  expiryTime: Date.now() + 24 * 2600 * 1000, // expiry time after which MTS will stop automatically
};
await MtsLib.startMTS(startReq);
﻿
Publish Event
JSON
await MtsLib.publishEvent('TESTEVENT', { battery: 56, network: 100 });
await MtsLib.publishEvent('TESTEVENT', { battery: 56, network: 100 });
﻿
Stop MTS
JSON
await MtsLib.stopMTS();
await MtsLib.stopMTS();
﻿
Error Codes
JSON
PERMISSIONS_ERROR[2500] = 'Mandatory Android Permissions not provided';
MTS_INIT_ERROR[2501] = 'MTS INIT Not called! MTS Device ID is Empty';
PARAM_MISSING[2502] = 'Mandatory Paramater is missing in request';
PERMISSIONS_ERROR[2500] = 'Mandatory Android Permissions not provided';
MTS_INIT_ERROR[2501] = 'MTS INIT Not called! MTS Device ID is Empty';
PARAM_MISSING[2502] = 'Mandatory Paramater is missing in request';
﻿
Sync Manager
Import Sync Manager
JSON
import { AppSyncManager, SdkSyncType } from '@os1-platform/dispatch-mobile';

// Start Events sync
await AppSyncManager.getInstance().startSyncing(
  false, // pass true for force sync
  SdkSyncType.EVENTS_SYNC
);

//Start Documents sync
await AppSyncManager.getInstance().startSyncing(
  false, // pass true for force sync
  SdkSyncType.DOCUMENT_SYNC
);

//Get All Events By Dispatch ID
await AppSyncManager.getInstance().getAllEvents('dsp_id');

//Get all documents By Dispatch ID
await AppSyncManager.getInstance().getAllDocuments('dsp_id');
import { AppSyncManager, SdkSyncType } from '@os1-platform/dispatch-mobile';

// Start Events sync
await AppSyncManager.getInstance().startSyncing(
  false, // pass true for force sync
  SdkSyncType.EVENTS_SYNC
);

//Start Documents sync
await AppSyncManager.getInstance().startSyncing(
  false, // pass true for force sync
  SdkSyncType.DOCUMENT_SYNC
);

//Get All Events By Dispatch ID
await AppSyncManager.getInstance().getAllEvents('dsp_id');

//Get all documents By Dispatch ID
await AppSyncManager.getInstance().getAllDocuments('dsp_id');
﻿
Start Sync Manager as a Foreground Service in Android
JSON
import { NativeSyncManager } from '@os1-platform/dispatch-mobile';

NativeSyncManager.startSyncManager(
  interval,
  notificationTitle,
  notificationText
);
// interval will be in seconds
NativeSyncManager.startSyncManager(
  2000,
  'Dispatch Service',
  'Syncing events...'
);

//To stop the foreground android service
NativeSyncManager.stopSyncManager();
import { NativeSyncManager } from '@os1-platform/dispatch-mobile';

NativeSyncManager.startSyncManager(
  interval,
  notificationTitle,
  notificationText
);
// interval will be in seconds
NativeSyncManager.startSyncManager(
  2000,
  'Dispatch Service',
  'Syncing events...'
);

//To stop the foreground android service
NativeSyncManager.stopSyncManager();
﻿
Asynchronous Event Handling
The Dispatch SDK support handling Execution Tasks asynchronously by emitting two events for each ET. This lets your apps to listen to these events and perform necessary actions.
For every ET, two events will be triggered in a fire-and-forget mode:
Task Start event: Triggered upon arrival of the ET, along with input data
Task End event: Triggered just before moving to the next ET, with the output data of objectives executed in that ET and the ID of the next ET to be executed.
To use this feature, you need to work with the eventListener method, which is used to listen and remove events. It contains the following methods:
.on: To listen to a specific event
.remove: To remove a specific event
JS
eventListener = {
	on(event, callback) { //Add event listener and execute callback with event data }
	remove(event) { //Add remove event listener fn  }
}
eventListener = {
	on(event, callback) { //Add event listener and execute callback with event data }
	remove(event) { //Add remove event listener fn  }
}
﻿
Example
JS
import { eventListener } from "@dispatch-sdk";

eventListener.on("eventName", (eventData) => { console.log(eventData); });

eventListener.remove("eventName");
import { eventListener } from "@dispatch-sdk";

eventListener.on("eventName", (eventData) => { console.log(eventData); });

eventListener.remove("eventName");
﻿
Event Payloads
See the examples below to describe event payloads using a CaptureImage Event
On Task Start
Triggered before starting the execution of ET
JS
onTaskStart:{ETCustomName} = {
  "timestamp":"number",
  "taskId":"string",
  "etData":{
     "jobId1":{
        ...ET inputs
     },
     "jobId2":{
        ...ET inputs
     }
  }
}
onTaskStart:{ETCustomName} = {
  "timestamp":"number",
  "taskId":"string",
  "etData":{
     "jobId1":{
        ...ET inputs
     },
     "jobId2":{
        ...ET inputs
     }
  }
}
﻿
On Task End
Triggered after the completion of ET and before moving to the next ET.
JS
onTaskEnd:{ETCustomName} = {
  timestamp: string,
  taskId: string,
  nextTaskId: string,
  "etData":{
     "jobId1":{
        "success":"boolean",
        "eventCode":"string",
        "reasonCode":"string",
        ...ET output
     },
     "jobId2":{
        "success":"boolean",
        "eventCode":"string",
        "reasonCode":"string",
        ...ET output
     }
  },
  "meta"?:{},
}
onTaskEnd:{ETCustomName} = {
  timestamp: string,
  taskId: string,
  nextTaskId: string,
  "etData":{
     "jobId1":{
        "success":"boolean",
        "eventCode":"string",
        "reasonCode":"string",
        ...ET output
     },
     "jobId2":{
        "success":"boolean",
        "eventCode":"string",
        "reasonCode":"string",
        ...ET output
     }
  },
  "meta"?:{},
}
﻿
On Task Back
Triggered when goBack is executed for an ET, before moving to the next ET.
JS
onTaskBack:{ETCustomName} = {
  timestamp: string,
  taskId: string,
  nextTaskId: string,
  "etData":{
     "jobId1":{
        "success":"boolean",
        "eventCode":"string",
        "reasonCode":"string",
        ...ET output
     },
     "jobId2":{
        "success":"boolean",
        "eventCode":"string",
        "reasonCode":"string",
        ...ET output
     }
  },
  "meta"?:{},
}
onTaskBack:{ETCustomName} = {
  timestamp: string,
  taskId: string,
  nextTaskId: string,
  "etData":{
     "jobId1":{
        "success":"boolean",
        "eventCode":"string",
        "reasonCode":"string",
        ...ET output
     },
     "jobId2":{
        "success":"boolean",
        "eventCode":"string",
        "reasonCode":"string",
        ...ET output
     }
  },
  "meta"?:{},
}
﻿
Sample Events for CaptureImage
JSON
{
   "data":{
      "etData":{
         "job:aab73b6a-dc00-49c8-8d5a-7884bbdbc4eb":{
            "resolution":{
               "length":6000,
               "breadth":6000
            },
            "fileSizeLimit":600,
            "captureMode":"MULTI",
            "title":"Image Capture",
            "applicableReasons":{
               "E-010":[
                  
               ],
               "E-011":[
                  
               ]
            }
         },
         "job:d9f3c351-8eaf-4b74-a8e5-310aa6430a48":{
            "resolution":{
               "length":6000,
               "breadth":6000
            },
            "fileSizeLimit":600,
            "captureMode":"MULTI",
            "title":"Image Capture",
            "applicableReasons":{
               "E-010":[
                  
               ],
               "E-011":[
                  
               ]
            }
         },
         "job:28246b42-1a84-43e3-9564-301f195dd9cb":{
            "resolution":{
               "length":6000,
               "breadth":6000
            },
            "fileSizeLimit":600,
            "captureMode":"MULTI",
            "title":"Image Capture",
            "applicableReasons":{
               "E-010":[
                  
               ],
               "E-011":[
                  
               ]
            }
         }
      },
      "taskId":"etask:9370d00a-8d84-5bf9-94bb-cd8cc73eeeec",
      "timestamp":1677149461591
   }
}
{
   "data":{
      "etData":{
         "job:aab73b6a-dc00-49c8-8d5a-7884bbdbc4eb":{
            "resolution":{
               "length":6000,
               "breadth":6000
            },
            "fileSizeLimit":600,
            "captureMode":"MULTI",
            "title":"Image Capture",
            "applicableReasons":{
               "E-010":[
                  
               ],
               "E-011":[
                  
               ]
            }
         },
         "job:d9f3c351-8eaf-4b74-a8e5-310aa6430a48":{
            "resolution":{
               "length":6000,
               "breadth":6000
            },
            "fileSizeLimit":600,
            "captureMode":"MULTI",
            "title":"Image Capture",
            "applicableReasons":{
               "E-010":[
                  
               ],
               "E-011":[
                  
               ]
            }
         },
         "job:28246b42-1a84-43e3-9564-301f195dd9cb":{
            "resolution":{
               "length":6000,
               "breadth":6000
            },
            "fileSizeLimit":600,
            "captureMode":"MULTI",
            "title":"Image Capture",
            "applicableReasons":{
               "E-010":[
                  
               ],
               "E-011":[
                  
               ]
            }
         }
      },
      "taskId":"etask:9370d00a-8d84-5bf9-94bb-cd8cc73eeeec",
      "timestamp":1677149461591
   }
}
﻿
JSON
{
   "data":{
      "meta":{ },
      "etData":{
         "job:aab73b6a-dc00-49c8-8d5a-7884bbdbc4eb":{
            "entityCode":"0011",
            "success":true,
            "eventCode":"E-010",
            "reasonCode":"",
            "captures":[
               {
                  "url":"",
                  "timestamp":1677065789173,
                  "file":{
                     "folder":"dsp_20230222",
                     "name":"IMG_1677065789173.jpg"
                  }
               }
            ]
         },
         "job:d9f3c351-8eaf-4b74-a8e5-310aa6430a48":{
            "entityCode":"0011",
            "success":true,
            "eventCode":"E-010",
            "reasonCode":"",
            "captures":[
               {
                  "url":"",
                  "timestamp":1677065789173,
                  "file":{
                     "folder":"dsp_20230222",
                     "name":"IMG_1677065789173.jpg"
                  }
               }
            ]
         },
         "job:28246b42-1a84-43e3-9564-301f195dd9cb":{
            "entityCode":"0011",
            "success":true,
            "eventCode":"E-010",
            "reasonCode":"",
            "captures":[
               {
                  "url":"",
                  "timestamp":1677065789173,
                  "file":{
                     "folder":"dsp_20230222",
                     "name":"IMG_1677065789173.jpg"
                  }
               }
            ]
         }
      },
      "taskId":"etask:9370d00a-8d84-5bf9-94bb-cd8cc73eeeec",
      ‘nextTaskId’: “etask:cea7c9a7-3ee7-52e9-ab3e-82849675d745”,
      "timestamp":1677149655294
   }
}
{
   "data":{
      "meta":{ },
      "etData":{
         "job:aab73b6a-dc00-49c8-8d5a-7884bbdbc4eb":{
            "entityCode":"0011",
            "success":true,
            "eventCode":"E-010",
            "reasonCode":"",
            "captures":[
               {
                  "url":"",
                  "timestamp":1677065789173,
                  "file":{
                     "folder":"dsp_20230222",
                     "name":"IMG_1677065789173.jpg"
                  }
               }
            ]
         },
         "job:d9f3c351-8eaf-4b74-a8e5-310aa6430a48":{
            "entityCode":"0011",
            "success":true,
            "eventCode":"E-010",
            "reasonCode":"",
            "captures":[
               {
                  "url":"",
                  "timestamp":1677065789173,
                  "file":{
                     "folder":"dsp_20230222",
                     "name":"IMG_1677065789173.jpg"
                  }
               }
            ]
         },
         "job:28246b42-1a84-43e3-9564-301f195dd9cb":{
            "entityCode":"0011",
            "success":true,
            "eventCode":"E-010",
            "reasonCode":"",
            "captures":[
               {
                  "url":"",
                  "timestamp":1677065789173,
                  "file":{
                     "folder":"dsp_20230222",
                     "name":"IMG_1677065789173.jpg"
                  }
               }
            ]
         }
      },
      "taskId":"etask:9370d00a-8d84-5bf9-94bb-cd8cc73eeeec",
      ‘nextTaskId’: “etask:cea7c9a7-3ee7-52e9-ab3e-82849675d745”,
      "timestamp":1677149655294
   }
}
﻿
SDK Utility Methods
JS
import { SdkUtils } from '@os1-platform/dispatch-mobile';

await SdkUtils.getRemoteConfig(3000);
// 3000 is the number of seconds to cache the config
import { SdkUtils } from '@os1-platform/dispatch-mobile';

await SdkUtils.getRemoteConfig(3000);
// 3000 is the number of seconds to cache the config
﻿
Download API from Public URL
JS
/**
 * Function to download apk file from a public URL
 * @param apkURL - URL where apk is hosted
 * @param version - expected version of apk (used for naming the file)
 * @param callback - callback for getting progress of download
 */
await SdkUtils.downloadAPK('https://apk_url.com', '1', (progress) =>
  console.log(progress.totalBytesWritten)
);
/**
 * Function to download apk file from a public URL
 * @param apkURL - URL where apk is hosted
 * @param version - expected version of apk (used for naming the file)
 * @param callback - callback for getting progress of download
 */
await SdkUtils.downloadAPK('https://apk_url.com', '1', (progress) =>
  console.log(progress.totalBytesWritten)
);
﻿
Open and Install an APK file
JS
/**
 * Opens & Install an APK file
 * @param uri - source of apk file
 */

await SdkUtils.openAPKFile(result.uri);
/**
 * Opens & Install an APK file
 * @param uri - source of apk file
 */

await SdkUtils.openAPKFile(result.uri);
﻿
Send events to Firebase analytics
JS
/**
 *
 * @param eventName-> string
 * @param tag -> string
 * @param message -> string
 */
await Logger.getInstance().sendToFirebaseAnalytics('ev_name', 'tag', 'message');
/**
 *
 * @param eventName-> string
 * @param tag -> string
 * @param message -> string
 */
await Logger.getInstance().sendToFirebaseAnalytics('ev_name', 'tag', 'message');
﻿
Log events to console
JS
/**
 *
 * @param TAG
 * @param message
 * @param logType
 */
Logger.getInstance().logEvent('tag', 'message', LOG_TYPE.SDK_ERROR);
/**
 *
 * @param TAG
 * @param message
 * @param logType
 */
Logger.getInstance().logEvent('tag', 'message', LOG_TYPE.SDK_ERROR);
﻿
Error Codes
JS
const enum BaseErrorCodes {
  InvalidArgumentError = '100100',
  InvalidBaseURL = '100101',
  SyncManagerNotInitialized = '100102',
  MissingOrInvalidProps = '100103',
  SQLiteDBIssue = '100104',
  AppSyncNotInitialized = '100105',
  FMS_FOLDER_CREATION_ERROR = '100106',
  REASON_CODE_API_ERROR = '100107',
  MERGING_ERROR = '100108',
  LOCATION_PERMISSION_DENIED = '100109',
  CAMERA_PERMISSION_DENIED = '100110',
  STORAGE_PERMISSION_DENIED = '100111',
  GRAPHQL_CLIENT_NOT_INITIALIZED = '100112',
  FMS_GRAPHQL_API_ERROR = '100113',
  INTERNET_NOT_ENABLED = '100114',
  LOCATION_OR_GPS_NOT_ENABLED = '100115',
  EXECUTION_ENGINE_ERROR = '100116',
  UNEXPECTED_ERROR = '100117',
}
const enum BaseErrorCodes {
  InvalidArgumentError = '100100',
  InvalidBaseURL = '100101',
  SyncManagerNotInitialized = '100102',
  MissingOrInvalidProps = '100103',
  SQLiteDBIssue = '100104',
  AppSyncNotInitialized = '100105',
  FMS_FOLDER_CREATION_ERROR = '100106',
  REASON_CODE_API_ERROR = '100107',
  MERGING_ERROR = '100108',
  LOCATION_PERMISSION_DENIED = '100109',
  CAMERA_PERMISSION_DENIED = '100110',
  STORAGE_PERMISSION_DENIED = '100111',
  GRAPHQL_CLIENT_NOT_INITIALIZED = '100112',
  FMS_GRAPHQL_API_ERROR = '100113',
  INTERNET_NOT_ENABLED = '100114',
  LOCATION_OR_GPS_NOT_ENABLED = '100115',
  EXECUTION_ENGINE_ERROR = '100116',
  UNEXPECTED_ERROR = '100117',
}
﻿
﻿
Updated 28 Feb 2024
Did this page help you?
MTS SDK
AAA SDK