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.