Import a microapp

Import a microapp that you created in another instance. You can then edit or add pages or notifications or both.

Follow these steps:

  1. Upload the .mapp file containing the microapp to the Application Integration.
  2. Verify needed table entities. Add new entities if necessary.
  3. Add pages or notifications or both or open existing pages or notifications.
  4. Customize the pages and notifications using the builder.
  5. Manage access.

Upload .mapp file containing the microapp to the Application Integration

After you upload the new microapp, it appears under the related integration on the Integrations page.

Import microapp

  1. From the Integrations page, select the menu next to the integration to which you want to add a microapp.
  2. Select Import, choose a microapp file that you have available in .mapp format, and drag it to the import panel.

After you add the imported microapp, it appears under the related integration on the Integrations page.

  1. To modify details for the microapp, return to the Integrations page and select the newly imported microapp from the list under the integration.

    The Properties page opens.

  2. Change the microapp’s name and description if needed.
  3. If needed, select Microapp Icon and choose an appropriate icon from menu. There are App Icons, Action and Notification Icons, and Microapps and Data icons from which you can select.

You are ready to verify and add required table entities.

Verify needed table entities and add new entities if necessary

Check an existing integration to ensure that the tables that you require exist already in Microapps. If you find a required table missing, you must add it. For more information, see Map database table entities.

Edit microapp schema

  1. From the Integrations page, select the menu next to the integration to which you want to add a microapp.
  2. Select Edit.

    The Tables page opens with an overview of how the database is divided into database tables.

  3. To find your required table, select Edit Schema, and filter for the required entity and confirm that it exists.

You are ready to customize your microapp.

Add new pages and notifications

After you verify needed entities, you need to create Action Pages or Notifications or both.

Add new page and notifications

Add Action Pages

Add an action page for this microapp. Select from the starting templates, then customize the page in the builder.

Follow these steps:

  1. Select the microapp to which you want to add a page.
  2. Select Pages, and Add New Page.
  3. Give the Page a name.
  4. Select a starting template for the page:
    • Detail
    • Form
    • Table
    • Static content

    The following screenshot shows what the New Page screen looks like:

    Add new page templates; Detail, Form, Table, Static content

  5. To set the table columns that you want your page to be prepopulated with, click Select Fields and select related field names.

  6. Select Set Columns, and Add.

The new page is added to the Pages list and is ready to be customized.

Add Event Notifications

Create triggers for events to be sent to the client application, such as new PTO request or notification that a record changed. Select from the template types, then customize the event in the builder.

Follow these steps:

  1. Select the microapp to which you want to add an event.

  2. Select Create New Notification at the bottom of the page.
  3. Give the Notification a name.
  4. Select your desired trigger and notification type from the following:

    • New Records - Send notification. when a new record is created.
    • Changed records
    • Matching record
    • Delete records
    • Periodic report
    • Periodic notification (user action)
    • Date reminder

    The following screenshot shows what the New Notification screen looks like:

    New notification

  5. Verify the data source and select your data table.
  6. Select Add.

The new notification is added to the Notifications list and is ready to be configured.

Customize the pages and notifications using the builder

For more information about customizing pages and notifications, see Page builder components and Build event notifications.

Manage subscriptions

Manage microapp subscribers to enable the microapps for specific users and user groups within your organization. For more information, see Assign subscribers.

Import a microapp