contentACCESS documentation – version 3.5

  1. Introduction to contentACCESS
    1. Services provided by contentACCESS
    2. Software requirements
  2. contentACCESS setup package
    1. Installation of contentACCESS
      1. EULA
      2. Installation type
      3. Components
      4. Prerequisites
      5. Base folder
      6. Service settings
      7. Database connection
      8. contentACCESS Central Administration
      9. contentACCESS Web Services (Proxy)
      10. contentWEB
      11. Central login
      12. Virtual drive
      13. Search service
      14. SMTP server
      15. Overview
      16. Installation
      17. Summary
  3. contentACCESS components
    1. contentACCESS Central Administration
      1. Central administration login
      2. contentACCESS Automated single sign on
      3. Central Administration logout
      4. contentACCESS Central Administration user interface
    2. contentWEB
      1. Logging in to contentWEB
      2. contentWEB Automated single sign on
    3. Virtual drive
    4. contentACCESS Web Services (Proxy)
    5. Central login page
  4. contentACCESS Tools
    1. Installing Outlook forms
    2. Legacy email archive connectors
    3. Legacy archive connector for Metalogix Archive Manager Exchange Edition (MAM EE)
    4. Legacy archive connector for Email Lifecycle Manager (ELM)
    5. Installing TECH-ARROW’s WinShortcutter
    6. contentACCESS Outlook add-in
      1. Installation of contentACCESS Outlook add-in
      2. How to use contentACCESS Outlook add-in
  5. Tenants in contentACCESS
    1. How to create a new tenant
    2. Tenant limitations
    3. How to provide access to a tenant (adding new tenant administrators)
    4. Tenant administrator invitation types
    5. Tenant associations
      1. Tenant - database association
      2. Tenant - user association
    6. Tenant deletion
  6. General system configurations
    1. Connection
    2. User interface
    3. Users in contentACCESS
    4. Invitations
    5. Roles
      1. Creating roles
      2. Role details
      3. Role assignment
      4. Defining specific permissions of a role assignment
      5. Editing roles, editing role assignments
      6. Role cloning
      7. General use cases of how to create/assign roles
      8. Managing access to contentACCESS objects
    6. Login providers
      1. Login providers’ context menu options
      2. External login provider configuration
        1. Configuring Google OAuth
        2. Configuring Office 365 login provider
        3. Exchange login provider
        4. External AD login provider
      3. Associating an enabled provider with a user login
      4. contentACCESS users in third party systems
    7. System
    8. Licensing
      1. How to activate your license key
    9. Notifications
    10. Monitoring — how to find out possible misconfigurations / reasons of potential system/job failures
    11. Auditing
    12. Distributed environment in contentACCESS — Clusters
    13. Statistics
    14. Legal hold
    15. Task runner
    16. Indexing
    17. SMTP Servers
    18. SMTP Mappings
    19. How to create/configure databases — All databases
  7. Common features
    1. Databases
    2. Schedules
    3. Retentions
    4. Storages
      1. Google drive storage
      2. Amazon S3
    5. Exchange connections
      1. Exchange performance settings – turning off the Exchange throttling policies
      2. Hybrid Exchange environments in the Email Archive system
    6. Importing contentACCESS configurations from files
      1. Manual import of Exchange servers/groups/mailboxes to the contentACCESS Address book
      2. Importing File Archive root folders to be archived
  8. Creating new jobs in contentACCESS
  9. Jobs’ page, jobs’ context menu
  10. File Archive
    1. Introduction to File system archive
    2. File archive settings
    3. File archive Databases
    4. File archive System settings
    5. File archive Retentions
    6. File archive Storages
    7. Root folders
    8. Aliases
    9. File archive Schedules
    10. Provisioning settings and managing access to contentWEB
    11. Remote agents
    12. Configuring aliases
    13. Configuration of jobs available in contentACCESS File Archive
    14. Configuration of File system archive job
    15. Configuration of a File system restore job
    16. Configuration of File system recovery job
    17. Configuration of Delete job in File archive
    18. Configuration of File system shortcut synchronization job
    19. Configuration of Remote shortcutting job
    20. Active/inactive documents in File system archive
  11. Email Archive
    1. Important settings before creating an Email Archive job
    2. Database settings
    3. Email archive System settings
    4. Email archive Provisioning settings
    5. Retention settings
    6. Shortcuts in email archiving
    7. Storing of archived emails
      1. LoboDMS storage
    8. Creating email archive schedulers
    9. User experience
    10. Exchange 2013+: Mail app in OWA 2013+ or on MS Outlook 2013+ desktop version
    11. Exchange 2010: OWA 2010 integration
    12. Address book objects
      1. Adding address book objects manually
    13. Granting access rights for mailbox users and explicit users to view the mailbox archive
    14. Creating contentWEB users (option 1)
    15. Manage access to a mailbox archive (option 2)
    16. Database and store assignment in email archiving
    17. How to assign database, storage and index zone to an Exchange group?
    18. How to assign database, storage and index zone to a mailbox?
    19. How to move data from source database/storage into a second (target) database/storage?
    20. Creating Email archive jobs: archive, restore, recovery, delete, mailbox move, shortcut synchronizaion, shortcut repair
    21. Email archive job
      1. Email archive job configuration
      2. Email archive journal processing
    22. Email restore job
      1. Email restore job configuration
    23. Email recovery job
      1. Email recovery job configuration
    24. Configuration of Delete job in Email archive
    25. Mailbox move job
      1. Mailbox move job configration
    26. Shortcut synchronization job
      1. Shortcut synchronization job configuration
    27. Shortcut repair job
      1. Shortcut repair job configuration
    28. Public folder archiving
      1. How to configure a job to archive public folders
      2. Public folders in the contentWEB archive
      3. User permissions to public folders
      4. Public Folder archiving in hybrid Exchange environments
    29. SMTP archiving
  12. SharePoint archive plugin
    1. SharePoint Archive settings
    2. SharePoint Archive job configuration
    3. SharePoint recovery job configuration
    4. Configuration of Delete job in SharePoint archive
    5. SharePoint archive Provisioning settings
    6. SharePoint Publishing job
    7. SharePoint in the contentWEB archive
  13. GDPR plugin
    1. GDPR Settings
      1. GDPR Databases
      2. GDPR Schedules
      3. GDPR Index zones
    2. GDPR Processing
      1. GDPR File system settings
      2. GDPR Exchange settings
      3. GDPR Applications
      4. GDPR Jobs
        1. GDPR File system job
        2. GDPR Exchange job
        3. GDPR Application job
  14. Custom plugins
    1. Email management job configuration
    2. Storage replication plugin
    3. Sharing plugin
    4. Datengut plugin
    5. Email synchronizer plugin
    6. Categorize to Public folders plugin
    7. LoboDMS plugin
  15. ThreatTest
    1. ThreatTest configuration
      1. ThreatTest Databases
      2. ThreatTest System settings
      3. ThreatTest Schedules
      4. ThreatTest User experience
      5. ThreatTest Statistics
      6. ThreatTest Job
    2. Using ThreatTest App
  16. officeGATE
  17. contentACCESS Mobile
  18. Virtual drive configurations
  19. Application settings
  20. Terms of use
  21. FAQ
    1. Download sample for the file to be imported does not work
    2. Archiving is not working if MAPI is set to communicate with the Exchange server
    3. Virtual drive is still appearing after the uninstall
    4. Outlook forms problems
    5. Unable to open shortcuts of archived files on the server side
    6. Samples are not shown using 'Show sample" option in the Import dialog
    7. Do I need to create separate tenants for file archiving and email archiving
    8. What is the recommended database size for email, file and Sharepoint archiving
    9. The TEMP folder is running out of space when archiving big files
    10. The attachment could not be opened
    11. After updating Exchange 2013, the EWS connection might not work in contentACCESS
    12. If Windows authentication is not working in contentACCESS and an alias was created for contentACCESS
    13. contentACCESS Outlook add-in certificate issue
    14. PowerShell scripts for setting up Email archive
    15. Solution for Outlook security patches
    16. Solution for Outlook security patches through GPO
    17. Solution for indexing PDF files
    18. Mycompanyarchive SuperUser mailbox configuration
    19. Office365 journaling

7.4.5.6.Importing contentACCESS configurations from files

contentACCESS allows to import data from files in the following available file formats: CSV, XML, Tab delimited files and Space delimited files. This simplifies adding of huge amount of data to different configuration sections in contentACCESS instead of entering each entry manually. There’s an option to set if we want to overwrite the existing items, update or skip them. The user may also download a sample file to check if the file that he wishes to import contains all necessary information (column) for the given configuration section. Column names are displayed in the sample file if the “First row is header” option is turned on in the respective importer dialog.

Important!!! When importing Email archive and Email restore configuration sections, it is highly recommended to define the mailbox folders to be imported with wildcards (e.g. %INBOX%). Wildcards ensure, that the given mailbox folder (e.g. the “INBOX” folder) will be processed regardless of the language settings of the mailbox. This is important mainly for companies who archive mailboxes using different languages.

After browsing the file to be uploaded and configuring the importer, the file can be uploaded. After the initial upload, the file’s columns can be mapped to the importable entry’s fields by dragging the column headers. When the mapping is finished, the newly imported entries will be added to the configuration section.

contentACCESS allows to import the folders to be archived/restored/recovered/excluded:

  1. to File archive, File restore, File recovery jobs
    The import option is available on the respective job configuration page, under sections “Folders to process” and “Exclude folders”:
  2. cACCESS 2.9 doc 99

    An importable file with Folders to process contains the following rows:

    Root – mandatory
    Relative path – nullable

    Example in case of a CSV file:

    FA folders to process sample

    An importable file with Folders to exclude contains the

    Exclude pattern, e.g. if folder called “test” needs to be excluded, the CSV will look like this:

    FA folders to exclude sample

  3. to Email archive, Email restore, Email recovery jobs
    The import option is available on the respective job configuration page, under section “Exclude folders” and “Exclude addresses”:
  4. cACCESS 2.9 doc 100cACCESS 2.9 doc 101

    An importable file with Excludable folders contains the Exclude pattern, e.g. if mailbox folder called “test” needs to be excluded, the CSV will look like this:

    FA folders to exclude sample

    An importable file with Exclude addresses contains the:

    Address(es) to include
    Exclude type(s) – Sender/Recipients/All

    Example in case of a CSV file:

    EA addresses to excl

  5. File Archive provisioning job (used to synchronize the users in the Active Directory with contentACCESS) also uses this feature to import the objects to be provisioned:
  6. cACCESS 2.9 doc 102

    The importable file must include the:

    Name
    Object type

    Example in case of a tab delimited file:

    provisioning import

  7. The root folders used in File Archive may be also imported into contentACCESS from files (read more here):

    cACCESS 2.9 doc 103
  8. Servers/groups/mailboxes can be imported from files to the contentACCESS Address book using options “Import servers manually”/ “Import groups manually”/ “Import mailboxes manually” on the respective tabs as well (read more here):

To import a file follow these steps:

  • Click the import button on the respective configuration page. The importer dialog opens.
  • From the Import method dropdown list select an import method to be applied (in our case CSV) and download a sample file using the Download sample option. Based on the sample file, prepare the file to import and verify if your prepared file contains all necessary information for the respective configuration section.

    cACCESS 2.9 doc 104 cACCESS 2.9 doc 105
  • Further click “Browse” and locate the file to be imported. (On the picture below we have selected a CSV file.)

    cACCESS 2.9 doc 106
  • Further specify how the selected file should be imported. Choose one from the 3 available options (the available options are configuration specific, not all are available by all configurations):

    Make a new list, delete all existing items – select this option to create a completely new list of items; any already set items will be deleted

    Skip existing items, import new ones – select this option to add the new items from the list; the already configured items will be skipped

    Update existing items, import new ones – this option is available for importing root folders from files; it can be applied if the password has been changed and should be updated

  • Depending on the selected import method, the user is further required to specify the following settings:


    In case of CSV:

    Specify the CSV separator (in our case it is a comma). If the first row in the CSV file is a header, mark the respective checkbox. Further specify the escape character, if such exists in your CSV file (in our case quotation marks)

    cACCESS 2.9 doc 107

    In case of Tab delimited file
    If the first row of the file is a header, mark the respective checkbox. Further specify the escape character, if such exists in the file.

    cACCESS 2.9 doc 108

    In case of Space delimited file
    If the first row of the file is a header, mark the respective checkbox. Further specify the escape character, if such exists in the file.

    cACCESS 2.9 doc 109

    In case that the file to be imported is an XML, no further settings are required.

    cACCESS 2.9 doc 110

    • Click Upload selected file to upload the file with the desired items.

      cACCESS 2.9 doc 111
    • Click “OK”. The list of imported items will be added to the respective section.

      In a file containing multiple columns the user may specify, which column should be imported. Simply drag and drop the column header (on the picture below the Database ID header) over the respective column that should be imported.

      cACCESS 2.9 doc 112
  • Yes No Suggest edit
    Suggest Edit