› Configure Capture Plug-In › Manage connections › Add a connection › Configure folders for import › Access local files/network share via SMB

Access local files/network share via SMB

Use this procedure to configure folder import settings to access files from a local computer or network-shared location using the Server Message Block (SMB) protocol.

  1. Start Capture Plug-In configuration. Do one of the following:

    • 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 an existing connection. See Add a connection.
  3. In the Connection configuration window, click Add and select Folder import.
  4. Enter a descriptive Display name.
  5. In the Poll cycle in seconds field, specify how often the folder is checked for new documents. The maximum value is 86400 seconds, that is, 24 hours.
  6. Select Storage type as Local files/network share via SMB to access folder location on the local computer or shared network.
  7. Enter the Watched folder, either by typing the path or selecting the folder via the Browse button. Use UNC syntax for network paths.

    • To poll documents from a folder, you can use more than one Message Connector. To avoid the import of duplicate documents when using multiple Message Connectors, see Prevent duplicate message import.

    • To avoid security vulnerabilities, access to the local watch folder is denied by default. To know how to enable access, see Folder input base directory in Security options tab in Tungsten Message Connector Help.

  8. Enter User and Password. The user accessing the watched folder requires read, write, or full control rights.

    • From one computer, only a single Windows user may access a network folder simultaneously. If you have another connection active (such as a Windows Explorer window displaying the folder) with a different user, Message Connector may not be able to access the folder, especially if the active user does not have sufficient rights.

    • By default, the "Password" field is always blank.

      When editing the folder settings, provide the password only if it is changed. Once you enter the new password and save the folder settings, the password provided here overrides the stored password.

  9. Click Test folder import to verify that Tungsten Import Connector can connect to the specified folder.

    If you are testing a network folder, having a Windows Explorer window open displaying the content of the folder might occasionally prevent the test button to connect.

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

    In the 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.

  12. To delete the empty subfolders after importing the files, select Delete empty folder structures.
  13. 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).
  14. Select File Detection Mode to ensuret 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 field, 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: Tungsten Import Connector removes the extension from the trigger file name and searches for documents with the same base name 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: Imports all documents from the same folder (except the trigger file). 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: Tungsten Import Connector removes the extension from the trigger file name and searches for a subfolder with the same name. All documents from the subfolder are imported.

        The trigger file must have an extension.

      • Import all files in a folder matching file mask: Tungsten Import Connector looks for a folder with a name that matches the trigger file mask. 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: Deletes the file.

      • Rename extension to: Specify an extension to rename it.

    4. Select Import trigger file to import the trigger file content. If clear, the trigger file content is deleted or renamed after the other documents are imported.
  15. Select File Import Mode to determine how XML documents should be 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 configured XML types, it is considered 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.

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

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

  • Disable Folder Import: Disables the feature completely.

  • Folder Input Base Directory: Restricts the folder that can be configured as the watched folder.

Tungsten Import Connector cannot import documents if the combined number of characters in file path and file name exceeds 211 or the read-only attribute is enabled for the document.

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

Configure shared folder on Azure VM for Tungsten Import Connector

Setting required on Azure VM

Configure Azure VM to respond ping or ICMP echo requests and SMB file sharing

  1. Navigate to Control Panel > System and Security > Windows Defender Firewall.
  2. Click Advanced settings on the left pane.

    The Windows Defender Firewall with Advanced Security on Local Computer window is displayed.

  3. Enable File and Printer Sharing (SMB-in) and File and Printer Sharing (Echo Request - ICMPv4-In).

Configure shared folder on Azure VM

  1. Right-click the folder to share and select Properties.

    The folder properties popup window is displayed.

  2. Select the Sharing tab and click Share.

    The Network access popup window is displayed.

  3. In the Choose people to share with box, enter the users or groups who can access the folder.

    You can enter Everyone to provide external access to the folder.

  4. Click Share, and then click Done.

    The shared folder can be accessed externally using the public IP of the VM from the Azure portal.

    For example: \\[VM_Public_IP]\[shared_folder_name

Configure Azure VM shared folder in Folder import settings in Capture Plug-In

  1. In the Folder import settings window, enter the IP address of the VM in the Watched folder text box to configure the watched folder outside the VM.

  2. Enter username and password.
  3. Click Test folder import to verify if the Import Connector can connect to the specified folder.
  4. Click OK.