Configuring Miracle Mobile’s Pre-Built Connectors

Miracle Mobile Platform allows your enterprise mobile app to be linked to your company’s third-party systems through Connectors. These connectors allow data to be fetched from and written to existing ERP systems, databases, CMS, and other kinds of business data systems. You can use multiple connectors in a single application to connect to different data stores and systems.

Accessible from the Connections section in MiracleStudio, the following pre-built connectors can be customized:

  • MsSql Connector
  • MySql Connector
  • ADFS SAML Authentication Connector
  • Active Directory Authentication Connector
  • SOAP Connector
  • REST Connector
  • SharePoint 2013 Connector

Through these connectors, your app can include, but will not be limited to, the following functions:

  • Authenticate app users after configuring an authentication connector
  • Manage the published list of entities or services accessible through a connector
  • Allow create, read, update, and delete (CRUD) services in an entity

To help you properly select the right connectors for your page or form, the following lines will provide you with a comprehensive overview of the connectors that you can use while creating your app.

MsSql Connector allows data from forms to be submitted to MsSQL databases. This is a powerful tool as it creates data structure for data storage such as tables for forms and columns for controls.

To add an MsSql Connector to your app, follow the steps below.

  1. Click the Connections section under ‘Integrate’ and select MySql Connector.
  2. Fill in the following mandatory fields:
    • Connection Name – Enter a name for the MsSql Connector you are creating.
    • Server – Enter the server’s address, i.e. the name or IP where the MsSQL server is hosted.
    • User ID – Type in the user name you use to access the MsSQL server.
    • Password – Enter the password for the ID you provided. If you have not specified a password, you can tick the Empty Password option below the field.
    • Database – Type the name of the database used in this connector instance. Keep in mind that only a single database can be used per connector instance.
  3. Test the connection. You can save the connection once it has been set up.

Adding an ADFS SAML authentication connector will enable your mobile app to authenticate users with the help of an existing Enterprise Active Directory. As a result, you can easily use Single Sign On for all your enterprise applications.

To integrate an ADFS SAML Authentication Connector, use the following steps.

  1. Click the Connections section under ‘Integrate’ and select ADFS SAML Authentication Connector.
  2. Fill in the following mandatory fields:
    • Connection Name – Enter a name for your connection.
    • ADFS Endpoint URL – Type in the Federation Service Endpoint Uniform Resource Locator, which is the public URL used to contact all federation servers in a server farm.
    • Relying Party Trust Identifier – Enter the identifier used to identify the relying party. It is used when issuing claims to the relying party.
  3. Test the connection. You can save the connection once it has been set up.

A MySql Connector is another database connector that can connect your app to MySQL databases. In addition to storing your data there, the connector will automatically create the underlying data structure for data storage such as tables.

To integrate a MySql Connector, here are the steps you should follow.

  1. Click the Connections section under ‘Integrate’ and select MySql Connector.
  2. Fill in the following mandatory fields:
    • Connection Name – Enter a name for your connection.
    • Server – Enter the server’s address, i.e. the name or IP where your MySQL server is hosted.
    • User ID – Type in the user name you use to login to MySQL server.
    • Password – Enter the password for the ID you provided. If you have not specified a password, you can tick the Empty Password option below the field.
    • Database – Type the name of the database used in this connector instance. Keep in mind that only a single database can be used per connector instance.
  3. Test the connection. You can save the connection once it has been set up.

A SOAP Connector can be used to integrate SOAP web services in the app. That way, you can boost the functionality of the app while fully utilizing the web services your company is already subscribed to.

To create a connector for SOAP web services, follow these steps.

  1. Click the Connections section under ‘Integrate’ and select SOAP Connector.
  2. Fill in the following mandatory fields:
    • Connection Name – Enter a name for your connection.
    • WSDL URL – Type in the web service’s WSDL URL address.
    • Entities – Add the entities of the service in this field.
  3. Test the connection. You can save the connection once it has been set up.

A REST Connector is another web services connector. By integrating this into your app, you can enhance its functionality with REST web services.

To create a REST Connector, here are the steps you need.

  1. Click the Connections section under ‘Integrate’ and select REST Connector.
  2. Fill in the following mandatory fields:
    • Connection Name – Enter a name for your connection.
    • Service URL – Type in the service’s URL address.
    • Entities – Add the entities of the service here.
  3. Test the connection. You can save the connection once it has been set up.

Integrating a SharePoint 2013 Connector into your app will allow you to enhance your app’s functionality with the web application platform’s features, which include content and document management, extranets and internal portals, and enterprise search.

To create a SharePoint 2013 Connector, follow the steps below.

  1. Click the Connections section under ‘Integrate’ and select SharePoint 2013 Connector.
  2. Fill in the following mandatory fields:
    • Connection Name – Enter a name for your connection.
    • Site Collection URL – Type the site collection URL of SharePoint in this field.
    • Username – Type in your username for SharePoint 2013.
    • Password – Enter the password for the username you provided. If you have not specified a password, you can tick the Empty Password option below the field.
    • Site URL Expression – Type the site or subsite expression in this field.
  3. Test the connection. You can save the connection once it has been set up.

Active Directory Authentication Connector is another authentication connector. When added to an app, it allows it to authenticate the users of an existing Enterprise Active Directory. While similar to an ADFS SAML Authentication Connector, it does not work with third-party systems.

To add an Active Directory Authentication Connector to your app, here are the steps you should follow.

  1. Click the Connections section under ‘Integrate’ and select Active Directory Authentication Connector.
  2. Fill in the following mandatory fields:
    • Connection Name – Enter a name for your connection.
    • Domain – Type in the Active Directory domain you wish to connect the app to.
  3. Test the connection and then save it once it has been set up.