Auto Book

User Tools

Site Tools

Trace:
setting_up_the_bat_for_auto_book

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
setting_up_the_bat_for_auto_book [2021/12/02 05:33]
autobook 		setting_up_the_bat_for_auto_book [2022/01/01 05:54] (current)
autobook
Line 1: Line 1:
-===== - Setting up The Bat for Auto Book =====+===== Setting up The Bat for Auto Book =====
  
-The Bat is an email client that allows for running a program and passing email contents such as text body, subject, etc. as parameters to that program via a hotkey.+The Bat is an email client that allows for running a program and passing email contents such as text body, subject, etc. as parameters to that program via a hotkey (available for download on the [[https://www.ritlabs.com/en/products/thebat/|publisher's website]], although not free).
  
 Thus, Auto Book can access all relevant data associated with an email and process them using extraction schemes. Thus, Auto Book can access all relevant data associated with an email and process them using extraction schemes.
Line 9: Line 9:
 1) In case you don't only need information from the email text body, but also information contained in the email's headers such as subject, sender name, sender address, or date, Auto Book will receive and process all data by pressing a single hotkey, while normally, you would have to either concatenate the data beforehand or open and select the email source. 1) In case you don't only need information from the email text body, but also information contained in the email's headers such as subject, sender name, sender address, or date, Auto Book will receive and process all data by pressing a single hotkey, while normally, you would have to either concatenate the data beforehand or open and select the email source.
  
-2) Using The Bat allows you to associate the extraction scheme and database you want to use with a hotkey, i.e. you can set up different hotkeys to pre-select different extraction schemes/databases in the [[start#Data Preview]], e.g. depending on the client that sent the email.+2) Using The Bat allows you to associate the Extraction Scheme and Database you want to use with a hotkey, i.e. you can set up different hotkeys to pre-select different Extraction Schemes/Databases in the [[start#Data Preview]], for example depending on the client that sent the email.
  
 Here's how to set up The Bat for data transmission to Auto Book: Here's how to set up The Bat for data transmission to Auto Book:
Line 21: Line 21:
 [{{:autobook-v1.0-thebat-sortingoffice.png?direct&900|The Bat Sorting Office with filter for Auto Book}}] [{{:autobook-v1.0-thebat-sortingoffice.png?direct&900|The Bat Sorting Office with filter for Auto Book}}]
  
 +\\
 The settings of the new filter are shown in the right-hand panel of the Sorting Office. The settings of the new filter are shown in the right-hand panel of the Sorting Office.
  
-⯈ On tab **General**, which is opened by default, enter a name for the filter into the **Name:**, e.g. Auto Book.+⯈ On tab **General**, which is opened by default, enter a name for the filter into the **Name:** field, for example "Auto Book".
  
 ⯈ In the **Condition:** field below, The Bat shows an incomplete filter condition reading **Sender contains**. Click on the word **Sender** and select **Any message** (the bottommost option in the dropdown menu that opens). ⯈ In the **Condition:** field below, The Bat shows an incomplete filter condition reading **Sender contains**. Click on the word **Sender** and select **Any message** (the bottommost option in the dropdown menu that opens).
Line 31: Line 32:
 ⯈ From the dropdown menu that opens, select **Run external action**. ⯈ From the dropdown menu that opens, select **Run external action**.
  
-⯈ In the dialog that opens, if you do //not// want to pre-select a specific extraction scheme or database, paste the following text into the **Command line** field, replacing "C:\Auto Book\" with your Auto Book folder (the folder where AutoBook.exe is located):+[{{:autobook-v1.0-thebat-runexternalaction.png?direct&400|The Bat Actions Dropdown menu}}] 
 + 
 +\\ 
 +⯈ In the dialog that opens, if you do //not// want to pre-select a specific extraction scheme or database, paste the following text into the **Command line** field, replacing "C:\Auto Book" with your Auto Book folder (the folder where AutoBook.exe is located):
  
 <code> <code>
Line 37: Line 41:
 </code> </code>
  
-In this case, Auto Book will decide which extraction and database to pre-select in the [[start#Data Preview]], i.e. the software will pre-select the Default Extraction Scheme selected on Auto Book's **Home** tab and, if configured, its //Connected Database//. If no Database is connected, the Default Database will be used.+In this case, Auto Book will decide which extraction and database to pre-select in the [[start#Data Preview]], i.e. the software will pre-select the Default Extraction Scheme selected on Auto Book's **Home** tab and, if configured, its [[start#Connecting a Database|Connected Database]]. If no Database is connected, the Default Database will be used.
  
-⯈ To indicate a specific extraction scheme and database, paste the following text into the **Command line:** field, replacing [extraction scheme] with the name of the extraction you want to use (the name shown in the **Extraction Schemes** panel of Auto Book's **Home** tab) and [database] with the database name you want to use (the name shown in the **Databases** panel).+⯈ To indicate a specific extraction scheme and database, paste the following text into the **Command line:** field, replacing [extraction scheme] with the name of the extraction you want to use (the name shown in the **Extraction Schemes** panel of Auto Book's **Home** tab) and [database] with the database name you want to use (the name shown in the **Databases** panel), and replacing "C:\Auto Book" with your Auto Book folder (the folder where AutoBook.exe is located). //Do not include the square brackets.//
  
 <code> <code>
Line 45: Line 49:
 </code> </code>
  
-⯈ To indicate only a specific Extraction Scheme, but not a Database, use the following line instead, replacing [extraction scheme] with the name of the extraction you want to use (the name shown in the **Extraction Schemes** panel of Auto Book's **Home** tab):+Example:  
 + 
 +<code> 
 +C:\Auto Book\DataInput.exe "%TEXT //$// %OSUBJ //$// %ODATESHORT //$// %OFROMNAME //$// %OFROMADDR //$// Client1 //$// OverseasClients" 
 +</code> 
 + 
 +⯈ To indicate only a specific Extraction Scheme, but not a Database, use the following line instead, replacing [extraction scheme] with the name of the extraction you want to use (the name shown in the **Extraction Schemes** panel of Auto Book's **Home** tab) and replacing "C:\Auto Book" with your Auto Book folder (the folder where AutoBook.exe is located).  //Do not include the square brackets.//
  
 <code> <code>
Line 51: Line 61:
 </code> </code>
  
-In this case, Auto Book will pre-select the indicated Extraction Scheme in the [[start#Data Preview]] and its Connected Database, if configurated. Otherwise, the Default Database will be pre-selected.+In this case, Auto Book will pre-select the indicated Extraction Scheme in the [[start#Data Preview]] and its Connected Database, if configured. Otherwise, the Default Database will be pre-selected.
  
 ⯈ Leave the other options unchanged and click **OK**. ⯈ Leave the other options unchanged and click **OK**.
Line 59: Line 69:
 ⯈ Activate the checkbox **Execute actions of this filter by pressing this Hot Key**. ⯈ Activate the checkbox **Execute actions of this filter by pressing this Hot Key**.
  
-⯈ In the field below, choose the hotkey you want to use for transmitting data to Auto Book.+⯈ In the field below, choose an arbitrary hotkey you want to use for transmitting data to Auto Book (obviously, avoid common hotkeys such as CTRL+S, CTRL+A, etc., as well as Auto Book's other hotkeys (shown on the **Hotkeys** tab).
  
 ⯈ Below, activate the checkbox **This rule is executed only by pressing the hotkey**. This makes sure Auto Book is not called every time you receive an email. ⯈ Below, activate the checkbox **This rule is executed only by pressing the hotkey**. This makes sure Auto Book is not called every time you receive an email.
  
-All done. Exit the Sorting Office, click on an email and press the hotkey you have chosen to see if the Auto Book Data Preview opens. (If not, you probably haven't provided the proper path to the Auto Book folder.)+[{{:autobook-v1.0-thebat-filteroptions.png?direct|The Bat Filter Options}}] 
 + 
 +\\ 
 +All done. Exit the Sorting Office, click on an email and press the hotkey you have chosen to see if the Auto Book [[start#Data Preview]] opens. (If not, you probably haven't provided the proper path to the Auto Book folder.)
  
 +Note there are other ways to configure The Bat depending on your needs. For example, you could leave the checkbox **This rule is executed only by pressing the hotkey** unchecked and restrict the filter to a specific folder on the filter's **Folders** tab if you have a specific email folder where only purchase orders are received and you want to call Auto Book automatically whenever that happens. Or you could configure a filter that calls Auto Book automatically when a certain trigger word such as "purchase order" is included in the subject line. The Bat offers a lot of flexibility and savvy users might have other ideas.
  
setting_up_the_bat_for_auto_book.1638419599.txt.gz · Last modified: 2021/12/02 05:33 by autobook

Page Tools

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki