Manage BlackBerry Dynamics app services

App services are shared functions that are offered by a mobile or server-based app. Using the BlackBerry Dynamics SDKs, an app developer can expose a function of an app that other developers can use in their own BlackBerry Dynamics apps. Using the management console, you can register app services for your organization and supply the service definition from the developer. Your organization’s developers can review the registered app services and can leverage the available service definitions in the BlackBerry Dynamics apps that they create.

App services for select BlackBerry Dynamics apps and partner apps are also available for use, and you can view the associated service definitions in the management console. For more information about app service development, visit the BlackBerry Developer Community.

If you want to register an app service for your organization, verify that you have the app service ID, version number, and service definition.
  1. In the management console, on the menu bar, click Settings > BlackBerry Dynamics.
  2. Click App services.
  3. Perform any of the following tasks:

    Task

    Steps

    Register an app service for your organization.
    1. Click The Add icon.
    2. In the Service type drop-down list, perform one of the following actions:
      • If the app service is offered by a mobile app, click Application.
      • If the app service is offered by a server-based app, click Server.
    3. In the ID field, type the app service ID. The ID must be a unique string (all lowercase) in reverse DNS notation (for example, com.example.service.print).
    4. Type a name and description for the app service.
    5. In the Version field, type the version. The version number must include digits only. If you want to add one or more sub-version numbers (for example, the build version), use periods to separate the segments. Each segment cannot begin with 0 (for example, 1.1.5 is valid, 1.1.05 is not).
    6. Optionally, type a description for the version.
    7. In the Service definition field, type the service definition in JSON format.
    8. Click Save.

    Edit an app service.

    Use the following steps to edit an app service that was registered for your organization (for example, to add a new version). You cannot change the app service type or ID. You cannot edit a BlackBerry Dynamics app service or partner app service.

    1. Search for the app service that you want to edit.
    2. Click the app service name.
    3. Edit the app service details as necessary.
      Note: Deleting an app service version does not have any impact on the apps that offer or use the service, it simply removes the service definition from the management console so that your organization’s developers cannot refer to it.
    4. Click Save.

    Delete an app service.

    You cannot delete a BlackBerry Dynamics app service or partner app service. Deleting an app service from the management console does not have any impact on the apps that offer or use the service, it simply removes the service definition from the management console so that your organization’s developers cannot refer to it.

    1. Search for the app service that you want to remove.
    2. Click The Remove icon next to the service.
    3. Click Delete.
Optionally, you can bind an app service version to a managed app so that the management console can indicate that the app provides the service. For more information, see Manage settings for a BlackBerry Dynamics app.