Skip Navigation

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. To add a new version, click The Add icon and specify the version number, description, and service definition.
      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.