AppStudio client apps can be invoked from a third-party app. Use the AppStudio app specifier in the third-party app to invoke AppStudio app. You can also pass optional query strings along with the app specifier to invoke a navigation in the AppStudio app. Below are the optional query strings that you can use:

Screen object name and view object name - to navigate to the specified screen and view within the AppStudio app
Filter fields - to perform drill down operation after navigation.
Screen object name and view object name is mandatory when using filter fields.
Check the Expose Object Name property in the destination view before using an optional query string.

Depending on the current state of the AppStudio app in the background, the invocation for the AppStudio app will result in one of the the following states of the AppStudio app:

Current state	Invocation without query string	Invocation with query string
State of AppStudio App
App not launched	Prompts for login	Prompts for login and navigates to the desired workflow
App active (on a screen/view) in the background	Navigates to the last accessed screen	Navigates to desired workflow
App in background on a login page/expired session	Prompts for login	Prompts for login and navigates to the desired workflow

Invoking an app from Android apps

To invoke AppStudio apps on Android from the third-party app, you must pass the AppStudio app URI from the third-party app. The app URI for the AppStudio app for Android is in the form of pyxis://pyxismoibile.com. For more detail refer to the table below:

App URI Scheme

Default Invocation

Pass pyxis://pyxismoibile.com as the app URI

Example:

Uri uri=Uri.parse("pyxis://pyxismoibile.com");

Invoke with query string

Pass pyxis://pyxismoibile.com as the app URI and then pass the optional parameters using Intent putExtra() method

Example:

// Pass the screen object name

intent.putExtra("ScreenObjectName","scrObj");

// Pass the view object name

intent.putExtra("ViewObjectName","vwObj"); //Name of the view obj

// Pass the filter fields. Prefix filterfield name with NextToNavigationQueryStringPrefix_

intent.putExtra (“NextToNavigationQueryStringPrefix_FilterFieldName”,”value”);

Usage example

Default Invocation Invocation with query string

Uri uri=Uri.parse("pyxis://pyxismoibile.com");
Intent intent=new Intent(Intent.ACTION_VIEW);
intent.setData(uri);
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
startActivity(intent);

Uri uri=Uri.parse("pyxis://pyxismoibile.com");
Intent intent=new Intent(Intent.ACTION_VIEW); intent.setData(uri);
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);

//Set the screen object name (here scr50)
intent.putExtra("ScreenObjectName","scr50");

//Set the view object name (here vw47)
intent.putExtra("ViewObjectName","vw47");

//Set the filter field name (here priority) and value (here P3) intent.putExtra("NextToNavigationQueryStringPrefix_priority","P3");
startActivity(intent);

Invoking an app from iOS apps

To invoke AppStudio apps on iOS from the third-party app you will need to pass the AppStudio app URI from the third-party app. The app URI for the AppStudio app for iOS is in the form of pyxisappsettings://. For more detail refer to the table below:

App URI Scheme

Default Invoke

pyxisappsettings://

Invoking with query string

pyxisappsettings://?ScreenObjectName=scrObj&ViewObjectName=vwObj&FilterFieldName=Value

where:

ScreenObjectName: Name of the screen
ViewObjectName: Name of the view
FilterFieldname: Name of the filter field and value

Usage Example

Default Invocation

Invocation with query string

NSString *urlString = [NSString stringWithFormat:@"pyxisappsettings://"];
NSURL *url= [NSURL URLWithString:urlString];
if([[UIApplication sharedApplication] canOpenURL:url]){
 [[UIApplication sharedApplication] openURL: url];
}

NSString *urlString = 
    [NSString stringWithFormat:@"pyxisappsettings://?ScreenObjectName=%@&ViewObjectName=%@&city=%@",@"scr50",@"vw74",@"Boston"];
NSURL *url= [NSURL URLWithString:urlString];
if([[UIApplication sharedApplication] canOpenURL:url]){
 [[UIApplication sharedApplication] openURL: url];
}

Invoking an app from BlackBerry apps

To invoke AppStudio apps on BlackBerry from the third-party app you will need to pass the AppStudio app cod name from the third-party app. For more detail refer to the table below:

App URI Scheme

Default Invoke

Application Cod Name

Invoke with query string

Application Cod Name with query strings as arguments. The query string format is below:

<ScrObj>&ViewID=<VwObj>&<FilterFieldName>=<Value>

scrObj: Name of the screen object
vwObj: Name of the view object
FilterFieldName: Name of the filter field
Value: Filter field value

The following is a sample app designed to open a Contact Summary screen. Add this sample code to your BlackBerry app and substitute the appropriate strings: the screen to invoke, app name, and query string.

Documentation

Related Topics

Labels

All Versions

Invoking an App as a Third-Party Application

Invoking an app from Android apps

Usage example

Invoking an app from iOS apps

Usage Example

Invoking an app from BlackBerry apps