Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry Enterprise Mobility Server 3.8
  3. Configuring the BlackBerry Docs service
  4. Steps to configure the Docs service in an on-premises environment
  5. Managing Repositories in an on-premises environment
  6. Steps to define admin-defined repositories and repository lists
  7. Define a repository

Define a repository

Microsoft Active Directory
 users and groups must be added to a repository definition or a list definition before access permissions can be configured. Users and groups added automatically receive the default access permissions.
For users to access
Microsoft SharePoint
 repositories on their devices, verify that they have the "Read" permission level and the "Browse Directories" permission assigned.
  1. On the
    BlackBerry Enterprise Mobility Server Dashboard
    , under
    BlackBerry Services Configuration
    , click
    Docs
    .
  2. Click
    Repositories
    .
  3. Click the
    Admin defined
     tab.
  4. Click
    New Repository
    .
  5. In the
    Display Name
     field, type the name of the repository that will be displayed to users granted mobile access to the repository.
    The repository name must be unique and can contain spaces. The following special characters cannot be used due to third-party limitations:
    • Microsoft SharePoint
       2016, and 2019: ~ " # % & * : < > ? / \ { | }
    • File Share: \ / : * ? " < > |
    • Box
      : \ / |
  6. In the
    Storage
     drop-down list, select a storage provider.
    If you select
    SharePoint
     or
    SharePoint Online
    , and the share is running
    SharePoint
     2016 or later, select the
    Add sites followed by users on this site
     check box to make this feature available to users of this share. This setting applies for personal (my)
    SharePoint
     or
    OneDrive for Business
     sites only.
    If your environment is configured for
    Microsoft OneDrive for Business
    , select the
    SharePoint Online
     storage provider.
  7. In the
    Path
     field, specify the path to the share. Complete one of the following tasks based on the storage provider that you selected.
    Storage type
    Task
    Box
    Enter a fully qualified URL with or without
    Microsoft Active Directory
     attributes.
    FilesShare
    The Path can include
    Microsoft Active Directory
     attributes.
    For example, \\fileshare1\<
    sAMAccountName
    > or <
    homeDirectory
    >.
    SharePoint
    SharePoint Online
    Microsoft OneDrive for Business
    Enter a fully qualified URL with or without
    Microsoft Active Directory
     attributes.
    To add "my" or personal
    SharePoint
     sites, specify the URL for the "my" site. For example,
    • If your environment uses
      SharePoint
       and
      SharePoint Online
      , https://<
      Microsoft SharePoint server
      >/my.
    • If your environment uses
      Microsoft OneDrive for Business
      ,
      https://<
      your O365 domain
      >-my.sharepoint.com/personal/admin_<domain>_onmicrosoft_com/_layouts/15/onedrive.aspx
    If the personal site includes usernames or other Microsoft Active Directory attributes, enter the path including these attributes. For example, https://sharepoint.example.com/my/<
    sAMAccountName
    >.
    Optionally, to automatically add followed sites, complete the following steps:
    1. Add a repository for the "my" or personal
      SharePoint
       site.
    2. Select the
      Add sites followed by users on this site
       for the repository.
    3. On the
      User-defined
       tab, enable a user-defined repository permission. Make sure that you select the
      Enable 'User Defined Shares'
       and
      Automatically add sites followed by users
       check boxes. For more information, see Enable user-defined repository permissions.
    CMIS-based
    For storage providers using CMIS support that you have added to
    BEMS
    , both AtomPub and Web Services web addresses are supported. A repository ID may be optionally specified and a path inside the repository may also be optionally specified.
    If no repository ID is specified, then all repositories that a user has access to are listed to the user. If no path is specified, then the listing starts at the repository root.
    Following is the format of the paths for
    BEMS
    Docs
     repositories for accessing CMIS repositories:
    • <
      ATOM-PUB-URL
      >?RepositoryId=<
      REPOSITORY-ID
      >&RelativePath=<REPOSITORY-PATH>
    • <
      WEB-SERVICES-URL
      >?RepositoryId=<
      REPOSITORY-ID
      >&RelativePath=<REPOSITORYPATH>&BindingType=WebService
      • Where <ATOM-PUB-URL> and <WEB-SERVICES-URL> is specific to the CMIS vendor. Contact your CMIS vendor for more information.
      • Where <REPOSITORY-ID> is the CMIS repository ID (optional).
      • Where <REPOSITORY-PATH> is the path inside the CMIS repository (optional).
  8. Optionally, in the
    List
     drop-down list, select an existing list that you want this repository to belong to. If no list is defined, you can create one later or leave this field blank.
    If a List is selected, select the
    Enable inheriting of access control of repository list
     check box to apply the Access Permissions of the List to the repository. If the check box is not selected, you must define specific access permissions for this share (repository).
  9. If your organizes uses
    BlackBerry Workspaces
    , select
    Manage access through WatchDox
     to manage access permissions from the
    BlackBerry Workspaces
     server. For more information about the Unified Content Connector, contact
    BlackBerry Technical Support Services
    .
  10. In the
    Access permissions
     section, click
    Add Users/Groups
    .
  11. In the
    Search In
     field, enter a new domain or keep the default domain.
  12. In the
    Search for Users in Active Directory
     field, type a full or partial search string. Click
    Search
    .
  13. In the search results, select one or more entries.
  14. Optionally, select the
    Use Different Credentials
     and enter a username and password to configure a different username and password for accessing this repository by these users.
  15. Click
    Add
    .
  16. Optionally, specify files and folders to synchronize to users' Offline folder in the
    BlackBerry Work
    Docs
     app.
    1. Click
      Add
      .
    2. Navigate to the file or folder that you want to synchronize to users' offline folder.
    3. Click
      Add
      .
    4. Repeat steps a to c for each file and folder that you want to synchronize.
  17. Click
    Test
     and enter the test user login credentials to validate the repository information on behalf of the user, including the repository path, access to the user account, and the offline files and folders path. If the test fails, the appropriate message is displayed (for example, "No user or user group assigned permission to access the repository" or "Could not validate path(s) <
    file/folder path
    >"). Resolve the issue that is specified and test again.
  18. Click
    Save
    .
  • To remove the offline files and folders, select the check box beside the files or folders to delete. Click
    Delete
    .
  • To edit the repository, on the
    Admin defined
     tab, click the repository that you want to edit, and make the required changes.