Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

Creating a case in a mobile app using the Mashup SDK for iOS

Updated on June 14, 2018

You use the Mashup SDK in a native iOS app to display an embedded Pega® Platform application in a hybrid web view. The Mashup SDK allows a user to create a case, open an existing case, show a harness, open an assignment, or run an activity in a mobile environment. For example, if a native iOS app is used as a custom application to support plant maintenance, a user can create a case in a hybrid web view to report failing machinery.

Prerequisites

Before you continue, make sure that you have set up the Mashup SDK for an iOS app development. Make sure that you also have access to the documentation that is included with the Pega Mashup SDK distribution package.

Authenticate to the Pega Platform

Before you create a case in a Pega Platform application, you must authenticate with Pega Platform. Use the PMSnapStartLoginController controller to log in to a Pega Platform instance. You use an existing storyboard in your iOS app to display a login screen. To authenticate with Pega Platform, enter your Pega Platform user name and password.

  1. In the Interface Builder, open the main storyboard of an iOS app.
  2. Open or create a scene that allows the user to navigate to the authentication scene.
  3. Add an object to the scene that you use to initiate the login process, for example:
    1. From the Object Library, drag a Button object to the canvas.
    2. In the Attributes inspector, change the name of the button to, for example, More info.
  4. From the Object Library, create the authentication scene by dragging a View Controller object to the Interface Builder.
  5. In the Outline view of the Interface Builder, click the View Controller icon, and in the Identity inspector, set the custom class of the view controller to PMSnapStartLoginController.
  6. In the Attributes inspector, set the Server URL field to the Pega Platform endpoint URL.

    The URL address must be specified in the following format:

    http://<SERVER_NAME>:<PORT>/prweb/

  7. From the Object Library, create two text fields by dragging a Text field object from the Object Library to the authentication scene.
  8. From the Object Library, drag a Button object to the authentication scene. In the Attributes inspector, change the name of the button to Login.
  9. In the Outline view of the Interface Builder, right-click the Snapstart Login View Controller icon to display the list of available outlets.
  10. Connect the username and password outlets to the two text fields that you added to the authentication scene.
  11. Connect the loginButton with the button that you added to the authentication scene.
  12. Connect the More info button to the authentication scene, and select Show from the Action Segue menu.

Create a case in a hybrid web view

Use the PMSnapStartCreateCaseController controller to create a case in an embedded Pega Platform application screen as a hybrid web view.

  1. From the Object Library, create the case scene by dragging a View Controller object to the Interface Builder.
  2. In the Outline view of the Interface Builder, click the View Controller icon and in the Identity inspector, set the custom class of the view controller to PMSnapStartCreateCaseController.
  3. In the Attributes inspector, set the Class name field to the name of the case, for example, Wb-MachineryIssue-Case.
  4. Right-click the Login button and in the Attributes inspector, change the name of the button to Login and create case.
  5. Connect the Login and create case button to the create case scene and select Show in the Action Segue menu.
  6. Select the action segue and in the Attributes inspector, change the identifier of the action segue to createCase.

Related articles

Pega Mobile SDK 7.4Mashup SDKAuthenticating with the Mashup SDK on iOS

Tags

Pega Platform 7.3.1 Pega Mobile Mashup Mobile Pega Express Communications and Media Consumer Services Financial Services Government Healthcare and Life Sciences Insurance Healthcare and Life Sciences Manufacturing Consumer Services Consumer Services

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us