Documentation
Related Topics

Labels
All Versions
Invoking an App as a Third-Party Application
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:
State of AppStudio App | ||
Current state | Invocation without query string | Invocation with query string |
---|---|---|
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:
|
Invoke with query string | Pass pyxis://pyxismoibile.com as the app URI and then pass the optional parameters using Intent putExtra() method
|
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); |
|
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 |
|
Invoking with query string |
where:
|
Usage Example
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>
|
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.