Using Scribe Online IS, you can connect to any source or target text file that is on the same network domain as your Scribe Online Agent – it doesn't need to be in the default Agent directory, as the Text as Source Wizard UI may suggest! This is great if you have multiple users pulling reports or performing exports that all need to be sent through Scribe. Here's a quick tutorial for configuring your connection to a networked drive.
- Scribe Online account with an IS trial or subscription
- An On-Premise Agent in your Local Area Network
- Have user access to a networked location where your files will reside
There are three steps to connecting to your networked text file: add the folder location to the ScribeAccess.txt, change the Scribe Online Agent to run as a domain user and configure the text connection in Scribe Online.
Adding the UNC path to the Scribe FolderAccess.txt file
After installing an On-Prem Agent, navigate to the installation directory and find the Text Connector folder, typically located at: (C:\Program Files (x86)\Scribe Software\Scribe Online Agent\Connectors\Scribe.Connector.Text).
There is a file named FolderAccess.txt you will need to add the UNC path of your networked folder to. Even though on my computer, I can access my text file by going to S:\Nate\TextLeads.txt, it's best practice to add the full path to my FolderAccess file.
I found my UNC path by right-clicking on TextLeads.txt > choosing Properties > clicking Details > and scrolling to the Computer column. Using the computer name, I navigated in a Windows Explorer window to find my folder:
\\My Server Name\Users\Nate\
Now I can add the UNC path to my FolderAccess.txt back on the Scribe Agent server, save it:
Changing the Scribe Online Agent to be run by a domain user
Since this is a networked drive, my company has only allowed access to this folder to specific domain users. I need to make sure that my local Scribe Online Agent Windows Service is running as a user with access to that folder. By default my Agent is running as Local System, which does not have access to it.
- Assuming you're a user that has access to this file, you can use your own account.
- If you do not want to use your account or your company has a service user account, verify that user has permissions to the folder location: right-click the folder > Security > check for the user or group that includes the user exists on that list. You may need to contact your Network admin to add rights to this folder.
To change the user, open your Services (services.msc) and scroll to the Scribe Online Agent.
Select the Scribe Online Agent > right-click and choose Properties > navigate to the Log On tab > click the This Account radio button. Now enter your username or domain\username and password, then click apply and OK. Now restart your Scribe Online Agent by right-clicking the service and choosing Restart.
Creating a connection to your Text file in Scribe Online
The next thing to do is create the connection in Scribe Online. Login > navigate to the Connections tab > click New. Create your own Text as Source or Text as Target Connection as you normally would or by using the Help Center's guides.
Make sure that if you have multiple Agents, the Agent that would have connectivity to the file is chosen. Now add the same UNC path you added to the FolderAccess file to the "Directory Path"
One thing to note about Text as Source is the ability to archive the text file after it has been processed by a map. The below configuration would move my file to another folder and rename it similar to"Contacts_Test-01-31-2013101629576Z.csv"
This has similar functionality to the Archiver.exe that Insight users may use in Integration processes.