Section Topics
Using InterAction Tokens with Services
You can include tokens for passing InterAction data as part of the program filename or command line parameters. This allows you to pass InterAction data to the application the service is launching. For instance, including the token %EADDR_ADDRESS% passes the selected email address.
Tokens work differently depending on whether you include them in the Program Filename or Command Line Parameters field in the New/Edit System Service dialog box:
-
If you include a token in the Program Filename field, the InterAction data is passed as part of the program filename, not as a command line parameter.
For example, assume a service with “Dialer.exe%PHONE_NUMBER%” in the Program Filename field. If the user selects the phone number “(555) 879-1234” and runs this service, it will attempt to launch a program called “Dialer.exe(555)879-1234.”
-
If you include the token in the Command Line Parameters field, the InterAction data is passed to the other application after the application is launched. This is the typical way of using command line parameters.
For example, assume a service with “Dialer.exe” in the Program Filename field and “d/%PHONE_NUMBER%” in the Command Line Parameters field. If the user selects the phone number “(555) 879-1234” and runs this service, it will launch the program “Dialer.exe” and pass it the parameter “d/(555) 879-1234”
When using tokens as command line parameters, be sure the application you are launching supports the parameters.
Supported Tokens
The following table lists the supported command line tokens you can use when setting up services. These tokens allow you to pass InterAction data to other applications when launching a service.
All InterAction tokens are enclosed in percent signs (%). When creating or editing a service, you can choose the Token button to insert one of these tokens from the list. This ensures the syntax is correct.
| Name | Description |
|---|---|
| %ACCOUNTNAME% | Account name of logged on user |
| %ACT_CONTACT_ID% | Contact ID of the contact on the currently selected activity |
| %ACT_DATE% | Date of the currently selected activity (mmddyyyy) |
| %ACT_ID% | Activity ID of the currently selected activity |
| %ACT_SRC_ID% | Activity source ID of the currently selected activity |
| %ACT_SUMMARY% | Summary of the currently selected activity |
| %ACT_TYPE_ID% | Activity type ID of the currently selected activity |
| %ACT_VISIBILITY_IND% |
Indicates visibility of the currently selected activity; 1 = Global, 0 = Folder Specific |
| %ADDRC_ADDR_SYS_ID% | Address system ID of the currently selected address |
| %ADDRC_CITY% | City of the currently selected address |
| %ADDRC_COUNTRY% | Country of the currently selected address |
| %ADDRC_ID% | Address ID of the currently selected address |
| %ADDRC_INDIVIDUAL% | Individual portion of the currently selected address |
| %ADDRC_LINE1% | Line one of the currently selected address |
| %ADDRC_LINE2% | Line two of the currently selected address |
| %ADDRC_LINE3% | Line three of the currently selected address |
| %ADDRC_NM% | Description of the currently selected address |
| %ADDRC_POSTAL_CD% | Zip / Postal code of the currently selected address |
| %ADDRC_RELTN_TYPE_ID% | Relationship type ID of the currently selected address |
| %ADDRC_SRC_ID% | Address source ID of the currently selected address |
| %ADDRC_STATE% | State / Province of the currently selected address |
| %ADDRC_SYS_ID% | System ID of the currently selected address |
| %ADDRC_SYS_SRC_ID% | System source ID of the currently selected address |
| %ADDRC_TYPE_ID% | Address type ID of the currently selected address |
| %ADDRD_ADDR_SYS_ID% | Address system ID of the currently selected contact’s mailing address |
| %ADDRD_CITY% | City of the current contact’s mailing address |
| %ADDRD_COUNTRY% | Country of the current contact’s mailing address |
| %ADDRD_ID% | Address ID of the current contact’s mailing address |
| %ADDRD_INDIVIDUAL% | Individual portion of the current contact’s mailing address |
| %ADDRD_LINE1% | Line one of the current contact’s default mailing address |
| %ADDRD_LINE2% | Line two of the current contact’s default mailing address |
| %ADDRD_LINE3% | Line three of the current contact’s default mailing address |
| %ADDRD_NM% | Description of the current contact’s mailing address |
| %ADDRD_POSTAL_CD% | Zip / Postal code of the current contact’s mailing address |
| %ADDRD_RELTN_TYPE_ID% | Relationship type ID of the current contact’s mailing address |
| %ADDRD_SRC_ID% | Address source ID of the current contact’s mailing address |
| %ADDRD_STATE% | State / Province of the current contact’s mailing address |
| %ADDRD_SYS_ID% | System ID of the current contact’s mailing address |
| %ADDRD_SYS_SRC_ID% | System source ID of the current contact’s mailing address |
| %ADDRD_TYPE_ID% | Address type ID of the currently selected mailing address |
| %CUST_FLD_ID% | Additional field ID of the currently selected additional field |
| %CUST_FLD_LABEL% | Label of the currently selected additional field |
| %CUST_FLD_SRC_ID% | Additional field source ID of the currently selected additional field |
| %CUST_FLD_SYS_ID% | Additional field system ID of the currently selected additional field |
| %CUST_FLD_SYS_SRC_ID% | Additional field system source ID of the currently selected additional field |
| %CUST_FLD_VALUE% | Value of the currently selected additional field |
| %DIR_ID% | ID of the current folder |
| %DIR_NM% | Name of the current folder |
| %DIR_OWNER_ID% | User ID of the owner of the current folder |
| %DIR_SRC_ID% | Source ID of the current folder |
| %DIR_SRV_ID% | Database ID |
| %DIR_SRV_NM% | Database name |
| %DIR_TYPE_ID% | Folder type ID of the current folder |
| %EADDR_ADDRESS% | Address of the currently selected electronic address |
| %EADDR_ID% | Electronic address ID of the currently selected electronic address |
| %EADDR_NM% | Description of the currently selected electronic address |
| %EADDR_RELTN_TYPE_ID% | Relationship type ID of the currently selected electronic address |
| %EADDR_SRC_ID% | Electronic address source ID of the currently selected electronic address |
| %EADDR_SYS_ID% | Electronic address system ID of the currently selected electronic address |
| %EADDR_SYS_SRC_ID% | Electronic address system source ID of the currently selected electronic address |
| %EADDR_TYPE_ID% | Electronic address type ID of the currently selected electronic address |
| %INIFILENAME% | Application initialization file |
| %LIST_ASSISTANT_NM% | Assistant name of the current contact |
| %LIST_CO_LIST_ID% | Contact ID of the company contact to which the current contact is associated; valid only for Person contacts |
| %LIST_CO_LIST_SRC_ID% | Contact source ID of the company contact to which the current contact is associated; valid only for Person contacts |
| %LIST_COMPANY_COMMON_NM% | Company Also Known As of the current contact |
| %LIST_COMPANY_FULL_NM% | Company name of the current contact |
| %LIST_DEPARTMENT% | Department name of the current contact |
| %LIST_DIR_ID% | Folder ID of the current contact’s owning folder |
| %LIST_DIR_SRC_ID% | Folder source ID of the current contact’s owning folder |
| %LIST_DISPLAY_NM% | Name of the current contact as it appears in the contacts list on the main screen |
| %LIST_FIRST_NM% | First name of the current contact, valid only for Person contacts |
| %LIST_GOESBY_NM% | Goes By name of the current contact, valid only for Person contacts |
| %LIST_ID% | ID of the current contact |
| %LIST_LAST_NM% | Last name of the current contact, valid only for Person contacts |
| %LIST_MIDDLE_NM% | Middle name of the current contact, valid only for Person contacts |
| %LIST_POSITION_NM% | Position name of the current contact, valid only for Person contacts |
| %LIST_SRC_ID% | Source ID of the current contact |
| %LIST_SUFFIX% | Suffix for the current contact, valid only for Person contacts |
| %LIST_SYS_ID% | System ID of the current contact |
| %LIST_SYS_SRC_ID% | System source ID of the current contact |
| %LIST_TITLE% | Title of the current contact, valid only for Person contacts |
| %LIST_TYPE_IND% |
Indicator of the current contact’s type: 1 = Company, 0 = Person |
| %LST_NOTE_ID% | Contact Note ID of the currently selected note |
| %LST_NOTE_SRC_ID% | Contact Note source ID of the currently selected note |
| %LST_NOTE_VISIBILITY_IND% |
Indicates visibility of the currently selected note; 1 = Global, 0 = Folder Specific |
| %PASSWORD% | Account password of logged on user |
| %PHONE_EXT% | Extension of the currently selected phone number |
| %PHONE_ID% | Phone ID of the currently selected phone number |
| %PHONE_NM% | Description of the currently selected phone number |
| %PHONE_NUMBER% | Number of the currently selected phone number |
| %PHONE_RELTN_TYPE_ID% | Relationship type ID of the currently selected phone number |
| %PHONE_SRC_ID% | Phone source ID of the currently selected phone number |
| %PHONE_SYS_ID% | Phone system ID of the currently selected phone number |
| %PHONE_SYS_SRC_ID% | Phone system source ID of the currently selected phone number |
| %PHONE_TYPE_ID% | Phone type ID of the currently selected phone number |
| %TAG_LIST_COUNT% | Number of marked contacts in the current view |
| %USER_ID% | ID of logged on user |
| %USERNAME% | Full name of logged on user |
