Skip Navigation

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 their
Microsoft SharePoint
repositories on their devices, make sure that they have the "Read" permission level and the "Browse Directories" permission assigned.
  1. In 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 only applies for personal (my)
    SharePoint
    or
    OneDrive for Business
    sites.
    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 type that you selected in step 6.
    Storage type
    Description
    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
    If your storage provider is
    Microsoft OneDrive for Business
    , complete this task. 
    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 instructions, 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
    checkbox 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. Select
    Manage access through WatchDox
    if you have a
    BlackBerry Workspaces
    server in your environment, have configured the Unified Content Connector, and you want 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
    . If the save fails and the issue is determined, the appropriate error message is displayed (for example, if you have a repository named Marketing and you create another repository with the same name, the error message
    Repository already exists with name Marketing
    is displayed). Resolve the issue that is specified and save again.
To remove the offline files and folders, select the checkbox beside the files or folders to delete. Click
Delete
.