The utility can be invoked at the command line, and can thus be used in an automated routine. The command line parameters are as follows:
Usage: BatchUtility "input_filename.csv" "webservice URL" "agent_user_name" "password"
[-renameinput]
[-agentemail | -ticket | -notepublic | -noteprivate]
BatchUtility.exe – This is the name of the utility executable.
Input_Filename.csv – This is the full name and path to the input file that will be processed. For instance, if the file is located in the C:\import directory the parameter might be c:\import\pastdueaccounts.csv.
Webservice URL – The webservices URL path will define the tenant against which the utility will run. For on-premises clients, this might be a test tenant or a production tenant. The URL path must include the full name of the .asmx file. For example, your webservices URL might be https://1to1service.iServiceCRM.com/iservice.asmx.
Agent_User_Name – This is the UserID of the agent that is used to create the contacts and generate interactions. It will be recorded in history for each interaction created. Also, the segment access of this agent will be used when creating new contacts, and will be validated when agent emails are sent. Therefore, you must ensure the agent access for this User ID is appropriate for your mailing.
NOTE: Contact replies to your agent email are automatically reserved for the agent that sent the email. If you do not want replies to your mailing to be reserved for the UserID used during execution, you must set that agent’s properties for Empty Inbox to TRUE. This will cause any replies to the mailing to be re-queued and available for other agents.
Password – This is the iService password for the User ID above.
The command line usage allows you to create a batch file that contains multiple instances of the batch mailings, each with their own parameters. This batch file can then be executed on a predefined schedule using a Windows Task Scheduler.
RenameInput – This is an optional parameter that can be added to the command to rename the input file upon completion. The file will be renamed as shown below. Without this parameter the original file will be left in place.
originaldir\YYYYMMDD originalname.ext
- agentemail | -ticket | -notepublic | -noteprivate – These parameters indicate whether the input file contains agent emails, tickets, public notes, or private notes.