Access Microsoft Azure File Share via REST

Use the following procedure to configure folder import settings to access files via Microsoft Azure File Share using REST (REpresentational State Transfer).

  1. Start Capture Plug-In configuration in one of the following ways:
    • On a Tungsten Capture Network Server remote site, go to Windows Start menu > Tungsten > Capture Plug-In.

    • On other Tungsten Capture installations, start Tungsten Capture Administration and select Capture Plug-In > Configuration.

  2. Connect Capture Plug-In to a Message Connector or edit one of the existing connections. See Add a connection.
  3. In the Connection configuration window, click Add and select Folder import.
  4. In the Display name box, enter a descriptive name. .
  5. In the Poll cycle in seconds field, how often the folder is checked for new documents. (Maximum: 86400 seconds (24 hours))
  6. Select Storage type as Microsoft Azure File Share via REST to access the cloud folder location.
  7. In the Watched folder url box, enter the URL to access the watch folder on Azure File Share.
  8. In the Storage account box, enter the cloud storage account name of the watched folder.
  9. In the Storage access key box, enter the access key of the cloud storage account.
  10. Click Test folder import to verify that Tungsten Import Connector can connect to the specified folder.

    You cannot test the folder connection for a network folder and if the folder is open in Windows Explorer.

  11. Optional. Go to the Advanced tab to configure additional parameters. Otherwise, continue with step 16.
  12. Select Process subfolders to monitor the immediate subfolders of the watched folder. Select Include watched folder to monitor the watched folder itself. In the Maximum subfolder level, configure the level of nested subfolders to process.

    In Windows operating system, the maximum path length is 260 characters. If the number of characters in the path exceeds this limit, the path is considered invalid, and the files are not imported.

  13. To delete the empty subfolders after importing the files, select Delete empty folder structures.
  14. In the File mask field, enter a comma-separated list of files that should be imported from the folder. You can use wildcards: The asterisk character ("*") substitutes for any zero or more characters, and the question mark ("?") substitutes for any one character. If you are using trigger files, this field is disabled (see below).
  15. Select File Detection Mode to ensure the files are completely copied to the watched folder before importing. Select one of the options:
    • File not modified since: To force Tungsten Import Connector to wait for the specified number of seconds after the file was last accessed.

    • Use trigger: First copy a document (or a folder containing documents) to the watched folder and then create a trigger file to indicate that the document (or folder) is ready for importing.

    1. In the Trigger file mask box, enter a trigger file, such as "*.trg" (or a comma-separated list of trigger files). You can use wildcards: the asterisk character ("*") substitutes for any zero or more characters, and the question mark ("?") substitutes for any one character.
    2. Select one of the following options to specify whether the trigger refers to documents or folders:
      • Files in the same directory with the same base name: The extension is removed from the trigger file name and documents with the same base name are searched in the same folder. For example, with trigger file mask "*.trg" and trigger file "001.trg", all documents matching "001.*" (except the trigger file) are imported.

      • All files in the same directory: All documents from the same folder (except the trigger file) are imported. For example, when the trigger file ready-to-be-imported.trg appears in a watched folder, all other documents in the folder are imported.

      • All files in the subfolder with the same base name: The extension is removed from the trigger file name and a subfolder with the same name is searched. All documents from the subfolder are imported.

        The trigger file must have an extension.

      • Import all files in a folder matching file mask: A folder with a name that matches the trigger file mask is searched. All documents from the folder are imported.

    3. Select one of the options to specify what to do with the trigger files after import:
      • Delete: The file is deleted.

      • Rename extension to: The file is renamed based on the extension provided.

    4. Select Import trigger file import the trigger file content. If clear, the trigger file content is deleted or renamed after the other documents are imported.
  16. Select File Import Mode to determine how XML documents are handled.
    • Automatic: Parses the XML documents. If an XML document is identified as one of the configured XML types, it is handled accordingly. If the document structure does not match any of the configured XML types, it is considered as a binary document.

    • Custom: Restricts the type of XML accepted. For example, if you select only "Tungsten Capture XML", all incoming XML files are treated as XML Import Connector compatible files.

    • Binary: Imports XML documents as binary files.

  17. Click OK to close the connection configuration window. Restart the Capture Plug-In service.

Additional configuration options related to folder import are available in the Message Connector configuration, in the Security Options tab.

  • Disable Folder Import to disable the feature completely.

  • Folder Input Base Directory to restrict the folder which can be configured as the watched folder.

Tungsten Import Connector cannot import documents that have the read-only attribute enabled.

For information about importing EML and MSG files, see Import MSG and EML files from folder.