Tally Developer Reference

https://help.tallysolutions.com/article/DeveloperReference
Admin
This documentation provides comprehensive information for developers on Tally Definition Language...
Tokens:189,125
Snippets:2,442
Trust Score:10
Update:1 month ago
Show doc for...
Tokens:
Raw
### Import Event Implementation Example

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_3_0.htm

A complete example demonstrating how to use Start, Object, and End import events to modify voucher data and display status messages.

```TDL
[#Import File : Vouchers]
On :  Start  I  mport  : Yes : Call : Start  I  mport 
On :  Import  Object  : Yes : Call : Change Values 
On :  Import  Object  : Yes :  Import  Object 
On :  End  Im  p  ort  : Yes : Call : End Im  p  ort 

[Function : Start Import]
00 : MSGBOX : “Status” : “Sta  r  ting Im  p  ort Pr  o  cess” 

[Function : Change Values]
00 : SET VALUE : Narration : $N  a  rration + “  -  U  pdated  b  y + 
Import Object Event” 
10 : SET TARGET : LedgerEntries[  1  ] 
20 : SET VALUE : LedgerName : “Branch Ledger” 

[Function : End Import]
00 : MSGBOX : “St  a  tus” : “Imported data success  f  ully”
```

--------------------------------

### Start

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_4_6.htm

Starts recording a sequence of keystrokes as a macro.

```APIDOC
## Start

### Description
Starts recording a macro. If no name is provided, it defaults to 'Macro'.

### Syntax
Start[:<Macros name>]

### Example
START : BSView
```

--------------------------------

### Launch Tally.ERP 9 with /NODEF Parameter

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_3_0.htm

Example command line usage to start Tally.ERP 9 with minimal TDL loading, excluding default TDLs and INI TDLs.

```text
D:\Tally.ERP9\Tally.Exe/NODEF/NOINITDL/TDL:"D: \Party\CustomReports.TDL"
```

--------------------------------

### Schedule Automatic Backup Example

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_2_0.htm

A complete example demonstrating how to define a timer for automatic backups, start it on system startup, and provide a menu key to stop it.

```TDL
[System : Event] 
;; Setting up timer event to call a function 
Auto Backup : TIMER : TRUE : CALL : Take Backup Function 
;; Starting the Timer when Tally Application Starts 
Schedule Backup : System Start : TRUE : START TIMER : Auto Backup : 3600 
;; Adding Keys to ‘Company Info’ Menu 
[#Menu : Company Info.] 
Add : Keys : Stop Backup Timer 
;; Declaring a Key to Stop the Timer 
[Key : Stop Backup Timer] 
Key : Alt + S 
Action : Stop Timer : Auto Backup 
Title : “Stop Backup”
```

--------------------------------

### ZIP Action Examples

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_4_7.htm

Examples demonstrating the syntax and parameter usage for the ZIP system action.

```text
ZIP : “.\Target.zip” : “tally.ini”: “Tally” : No
```

```text
ZIP: “D:\Target.zip”: “D:\Work\*.txt”: “Tally”: No: Yes: Yes
```

--------------------------------

### Start Recording

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_4_6.htm

Starts recording keystrokes into memory with a specified macro name.

```APIDOC
## Start Recording

### Syntax
Start Recording[:<Macro Name>]

### Parameters
- **Macro Name** (String) - Optional - The name of the macro to be recorded in memory. Defaults to 'Macro'.
```

--------------------------------

### Open File Action Examples

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_2_0.htm

Examples demonstrating the OPEN FILE action with various parameters for file format, mode, and encoding.

```TDL
10 : OPEN FILE : “Output.txt” : Text : Write : ASCII
```

```TDL
10 : OPEN FILE : “https://www.tallysolutions.com/Output.txt” : Text
```

```TDL
10 :  OPEN  F  I  LE  :  “C  :  \  Outpu  t  .xls”  :  Excel  :  Read
```

--------------------------------

### Data Source Configuration Examples

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_5_5_2.htm

Examples demonstrating the usage of Rule Set, Flag Set, and Num Set as data sources.

```TDL
[Collection: DSRepo]  Data Source: Rule Set: DSRuleSet
```

```TDL
[Collection: DSRepo]  Data Source: Flag Set: $FlagSetValue  OR  Data Source:Flag Set: ##FlagSetValue
```

```TDL
[Collection: DSRepo]  Data Source: Num Set: $NumSetValue OR  Data Source:Num Set:##NumSetValue
```

--------------------------------

### Close File Action Example

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_2_0.htm

Example showing the closure of an opened source file.

```TDL
10 : OPEN FILE : “Output.xls” : Excel : Read
.
.
30 : CLOSE FILE
```

--------------------------------

### Example Usage of Response Report

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_4_8.htm

Implementation example showing how to associate a custom report with an Import File definition.

```tdl
[Import File : Vouchers] 
Response Report : TallyCustomResponse 
;; Report to be defined with appropriate XML Tags
```

--------------------------------

### Close Target File Action Example

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_2_0.htm

Example showing the closure of an opened target file.

```TDL
10 : OPEN FILE : “Output.txt” : Text : Write
.
.
.
30 : CLOSE TARGET FILE
```

--------------------------------

### Action - StartService

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_4_5.htm

Starts a specified service.

```APIDOC
## Action: StartService

### Syntax
StartService : <Service Name>

### Parameters
- **Service Name** (string) - Expression evaluating to the name of the service.

### Example
Action : Start Service : "Tally.Server 9 - 1"
```

--------------------------------

### Hybrid Function Execution Examples

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/writing_remote_compliant_tdl_reports.htm

Examples showing how hybrid functions execute based on data availability context.

```tdl
$$FilterAmtTotal:$OpeningBalanc  e:Ledgers: MyFilter
```

```tdl
$$FilterAmtTotal:$Amount:Ledger  Entries:MyFilter
```

--------------------------------

### Start Recording Action

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_4_6.htm

Initiates a key recording session with a specified macro name.

```TDL
[Button: Start Recording]
Title : "Start"
Key : Alt + C
Action : Start Recording : "BS View"
```

--------------------------------

### Check Service Status and Installation

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_4_5.htm

Functions to verify if a specific service is currently running or installed on the system.

```TDL
[Function : TSPL Smp IsServiceRunning] 
00 : If : $$IsServiceRunning:"Tally.Server 9" 
10 : MSG Box : "Service Check" : "The Current Service \n is Running" 
20 : ELSE: 
30 : MSGBOX : "Service Check " : "The Current Service \n is not Running" 
40 : ENDIF
```

```TDL
[Function : TSPL Smp IsServiceRunning] 
00 : If : $$IsServiceInstalled:"AppMgmt" 
10 : Msg Box : "Service Check" : "The Current Service \n is installed" 
20 : ELSE : 
30 : MSGBOX : "Service Check" : "The Current Service \n is not Installed" 
40 : ENDIF
```

--------------------------------

### Browse URL Action Examples

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/actions_in_tdl.htm

Examples of using the Browse URL action to open web links from keys or fields.

```TDL
[Key : Execute Hyperlink]
Key : Left Click
Action : Browse URL : “www.tallysolutions.com”
```

```TDL
[Field : Hyperlink Company]
Color : Blue Border : Thin Bottom
Key : Execute Hyperlink
Set as : "Tally Solutions Pvt. Ltd"
Local : Key : Execute Hyperlink : Action : Browse URL: http://www.tally.co.in
```

--------------------------------

### Key Association Example

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/actions_in_tdl.htm

Examples demonstrating key association at different levels of the TDL hierarchy.

```TDL
[Key: Create Ledger]
Key : Alt + C
Action : Create : Ledger
[Field: CST Supplier Ledger]
Key : Create Ledger
```

```TDL
[Key: Part Display PgUp]
Key : PgUp
Action : Part PgUp
[System: Form Keys]
Keys : Part Display PgUp
```

--------------------------------

### Install 32-bit Tally.Developer 9 on 64-bit Windows

Source: https://help.tallysolutions.com/article/DeveloperReference/td9/getting-started-with-td9/installation/pre-installation.htm

Use this command in the Command Prompt to force a 32-bit installation on a 64-bit operating system.

```bash
setup.exe/bitness:32
```

--------------------------------

### Refresh TDL Action Example

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/general_and_collection_enhancements.htm

Example showing how to assign the Refresh TDL action to a key to reload TDL files dynamically.

```TDL
[Key : Refresh TDLs]
;; Any Key can be assigned if Report already have F5 assigned
Key : F5
Action : Refresh TDL
;; Refresh TDL will work from any Report
[#Form : Default]
Key : Refresh TDLs
```

--------------------------------

### FOR RANGE Loop Examples

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_1_6.htm

Examples demonstrating the use of FOR RANGE for numeric increments, date ranges by week, and date ranges by month.

```TDL
01 : FOR RANGE : It  e  ratorVar : Number : 2 : 10 : 2 
02 : LIST  ADD  :  Ev  e  nNo  :  ##It  e  ratorV  a  r 
03 : END  FOR
```

```TDL
09 : FOR RANGE : IteratorVar : Date :  #  #SVCurrentDate : $$MachineDate : 
1  :  "Wee  k  " 
10 : LOG : ##I  t  eratorVar 
20 : INCREME  N  T : Cnt 
30 : END  FOR 
50 : LOG : "No of weeks Back Dated : " + $$S  t  ring:  #  #Cnt 
60 : RETURN :  ##C  n  t
```

```TDL
09 : FOR RANGE : IteratorVar : Date : ##SVFromDate:##SVToDate : 1 : "Month" 
10 : LOG : $$MonthEnd:##IteratorVar 
20 : END FOR
```

--------------------------------

### START PROGRESS

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/user_defined_functions.htm

Initializes a progress bar with a defined number of steps and optional display text.

```APIDOC
## START PROGRESS

### Description
Sets up the Progress Bar by specifying the total number of steps and optional UI labels.

### Syntax
START PROGRESS : <Number of steps> :< Title> [:< Sub Title> :< Subject>]

### Parameters
- **Number of steps** (Number) - Required - The total number of steps in the task.
- **Title** (String) - Optional - The title of the progress bar.
- **Sub Title** (String) - Optional - The subtitle of the progress bar.
- **Subject** (String) - Optional - The subject description of the progress bar.

### Example
START PROGRESS : ##TotalSteps : "TDS Migration":@@CmpMailName : "MigrationgVouchers.."
```

--------------------------------

### Report Level Object Association Examples

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/objects_and_collections.htm

Examples demonstrating how to associate objects with a Report, either by type or with a specific identifier.

```TDL
[#Form : Sales Color]
Delete : Print
Add : Print : New Sales Format

[Report : New Sales Format]
Object : Voucher
```

```TDL
[Report: Sample Report]
Object : Ledger : “Cash”
```

--------------------------------

### Start Profiling Action

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_4_6.htm

Button definition to initiate the profiling process.

```tdl
[Button : Start Profiling]
Key : Alt + S
Action : Start Profile
```

--------------------------------

### Launch Login Activity

Source: https://help.tallysolutions.com/article/DeveloperReference/auth-lib/android_platform.htm

Start the TallyLoginActivity using an Intent to initiate the authentication flow.

```java
Intent loginIntent =  ** new  ** Intent(  ** this  ** , TallyLoginActivity.  ** class  ** ); 
startActivityForResult(loginIntent, 1);
```

--------------------------------

### Set Object Values Action Example

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/general_and_collection_enhancements.htm

Example of using the Set Object Values action to update an object in memory.

```TDL
[Key : My Key]
Action : Set Object Values : Opening Balance : ($$AsAmount : 10)
```

--------------------------------

### TDL Variable and Field Dependency Example

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_3_0.htm

A basic example demonstrating how a field's 'Set as' attribute establishes a dependency on a variable.

```TDL
[Variable : My Variable] 
Type : String 
[Field : My  F  ield] 
Type : String 
Set  a  s : ##MyVaria  b  le
```

--------------------------------

### Start Macro Recording

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_4_6.htm

Begins recording keystrokes under a specified macro name.

```text
Start[:<M  a  cros name>]
```

```text
START : BSView
```

--------------------------------

### Execute Tally with /VARIABLE parameter

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_1_5.htm

Starts Tally and initializes a logical system variable.

```text
"C:\Tally.ERP 9 \Tally.exe" /LOAD:00009 /VARIABLE : MyLogicalVar : Logical
```

--------------------------------

### $$GetStartDateTime

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_4_7.htm

Calculates the starting DateTime based on an ending DateTime and a duration.

```APIDOC
## $$GetStartDateTime

### Description
Returns the initial/starting DateTime value given a final/ending DateTime and a duration value.

### Syntax
$$GetStartDateTime : <DateTime Expression> : <Value>

### Parameters
- **DateTime Expression** (Expression) - Required - A valid Date/DateTime value.
- **Value** (Duration) - Required - The duration to subtract from the ending DateTime.
```

--------------------------------

### Trigger Key Enhanced Syntax Examples

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_4_7.htm

Examples demonstrating the use of the <Key>:<Number> syntax to trigger keys multiple times in sequence.

```text
Trigger Key : DD, Enter : 5, “Item 1”, Enter
```

```text
Trigger Key : DD, Enter, Enter, Enter, Enter, Enter, “Item 1”, Enter
```

```text
Trigger Key : DS, Enter:3
```

--------------------------------

### Part Level Object Association using Object Ex (Example 1)

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/general_and_collection_enhancements.htm

Example of associating a primary Ledger object with a Part using the Object Ex attribute.

```TDL
[Part : Sample Part]
Object Ex : (Ledger, "Customer 1").
```

--------------------------------

### Send GET Request with HTTP Headers

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/objects_and_collections.htm

Example of using a collection to perform a GET request with JSON data exchange.

```TDL
[Collection: TSPL Get Employees JSON] 
Export Header : "Accept:application/json" 
Data Source : HTTP JSON: "  http://localhost/ExportHeader/getempdetails.php  " :UTF8
```

--------------------------------

### Specify Function Parameters

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/user_defined_functions.htm

Example of defining an input parameter for a function.

```TDL
[Function: FactorialOf] 
Parameter : InputNumber : Number
```

--------------------------------

### Read Data via GET Request

Source: https://help.tallysolutions.com/article/DeveloperReference/integration-capabilities/json_based_export_import.htm

Example of a collection configured to fetch branch data from a remote URL using a GET request.

```TDL
[Collection: TSPLGetBranchesColl] 
Data Source : HTTP JSON: "  http://localhost/HttpJson/getbranchlist.php  "   
JSON Object Path: "BranchName:1"
```

--------------------------------

### Define a TDL Part

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/tdl_components.htm

Example of the basic syntax for creating a Part definition in TDL.

```TDL
[Part : PartOne]
```

--------------------------------

### Define Indent Attribute

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/dimensions_and_formatting.htm

Example of using the Indent attribute to specify a starting point for a line or field.

```TDL
Indent : @@IndentByLevel
```

--------------------------------

### Unload TDL Action Example

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_4_8.htm

Demonstrates how to trigger the dynamic unloading of a compiled TDL file using its GUID.

```TDL
[Button : Unload Dynamic TDL] 
Key :  Alt  +  U 
Action : Un  l  oad TDL : @@TCPFileGU  I  D 
[System :  Fo  r  mula] 
TCPFileGUID :  “c29  0  1088-3  4  9b-434b  -  946c-9  a  da601fd  6  b7”
```

--------------------------------

### Retrieve Printer Information using $$PrinterInfo

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_3_6.htm

Example usage of the $$PrinterInfo function to get the print size in inches for a specific printer.

```TDL
$$PrinterInfo : HPLaserJet4250PCL6 : PrintSizeInInches
```

--------------------------------

### Configure Blackberry 10 Project Headers and Libraries

Source: https://help.tallysolutions.com/article/DeveloperReference/auth-lib/blackberry_10_platform.htm

Add these statements to the <YourAppName>.pro file before the include(config.pri) statement to register the necessary headers and link the device library.

```qmake
HEADERS += $$quote(<Path_where_library_is_extracted>/public/TallyLoginScreen.hpp)
HEADERS += $$quote(<Path_where_library_is_extracted>/public/TallyLoginInterface.hpp)
HEADERS += $$quote(<Path_where_library_is_extracted>/public/TallyAppEventHandler.hpp)
HEADERS += $$quote(<Path_where_library_is_extracted>/public/TallyNetworkManager.hpp)
LIBS  += -lbbdevice
```

--------------------------------

### Load TDL Action Example

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_4_8.htm

Demonstrates how to trigger the dynamic loading of a TDL file using a button action.

```TDL
[Button : Load Dynamic TDL] 
Key : Alt + L 
Action : Load TDL : @@TDLFilePath 
[System : Formula] 
TDLFilePath : “C:\Tally.ERP9\TDL\Samples.tcp”
```

--------------------------------

### Help

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_4_6.htm

Displays a list of all recording commands.

```APIDOC
## Help

### Syntax
HELP
```

--------------------------------

### Copy File Action and FTP Path Configuration

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_2_0.htm

Demonstrates the Copy File action syntax and the construction of FTP paths using the $$MakeFTPName function.

```TDL
CopyFile : ##MyDstFilePath : ##MySourceFilePath
```

```TDL
SET : MyDstFilePath : $$MakeFTPName : ##SVFTPServer : ##SVFTPUser : ##SVFTPPassword : @SCFilePathName
```

--------------------------------

### Invalid TDL Expression Example

Source: https://help.tallysolutions.com/article/DeveloperReference/td9/troubleshooting/error_code_0041.htm

An example of an incomplete TDL expression that triggers error T0041.

```TDL
[#Menu: Gateway of Tally] 
Add: Item: "MyReport" :Display: MyReport : If ##MyVar then Yes Else 
[Report: MyReport] 
Use: Balance Sheet 
[System: Variables] 
Variable: MyVar: Logical
```

--------------------------------

### Configure and Display Login Screen

Source: https://help.tallysolutions.com/article/DeveloperReference/auth-lib/blackberry_10_platform.htm

Sets the library mode, initializes the login screen object, connects authentication signals to slots, and displays the interface.

```cpp
TallyLoginInterface::setOnlineMode(true);
TallyLoginInterface::setDeveloperMode(true);
TallyLoginScreen *screen = new TallyLoginScreen();
connect(screen, SIGNAL(authenticationCompletedSignal()), this, SLOT(logincompleted()));
connect(screen, SIGNAL(CancelButtonPressedSignal()), this, SLOT(logincancelled()));
screen->showLoginScreen();
```

--------------------------------

### Modify Object Action Examples

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/actions_in_tdl.htm

Examples demonstrating the modification of ledger object properties and bill allocations.

```TDL
[Key : Alter My Object]
Key : Ctrl + Z
Action : Modify Object : (Ledger,"MyLedger").BillAllocations [First, $Name="MyBill"].OpeningBalance : 100,Address[Last].Address :"Bangalore"
```

```TDL
[Key : Alter My Object]
Key : Ctrl + Z
Action : Modify Object :(Ledger,"MyLedger").BillAllocations[1].OpeningBalance :1000,Name: ”My New Bill”,+
..Address[First].Address :"Hongasandra Bangalore", Opening Balance:5000
```

--------------------------------

### Create a Zip Archive with Overwrite

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_4_7.htm

Demonstrates creating a zip file and overwriting it if it already exists.

```TDL
Start ZIP : “Target.zip” : Yes 
/* Overwrite the File Target.zip, if it exists */ 
Zip Add Path : “tally.ini” 
End Zip
```

--------------------------------

### Open a project in a new instance with /new parameter

Source: https://help.tallysolutions.com/article/DeveloperReference/td9/getting-started-with-td9/td9_command_line_parameters.htm

Launches a new instance of Tally.Developer 9 to open the specified project.

```bash
“C:\Tallydeveloper\tallydeveloper.exe” “/PROJECT:C:\Demo TDLs\Demo TDLs.tpj”/new
```

```bash
“C:\Tallydeveloper\tallydeveloper.exe”/new “/PROJECT:C:\Demo TDLs\Demo TDLs.tpj”.
```

--------------------------------

### GET Requests with Headers

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/objects_and_collections.htm

Configuring a collection to perform a GET request to a remote server with custom HTTP headers.

```APIDOC
## [Collection] GET Request with Headers

### Description
Configures a collection to send a GET request to a specified URL with custom HTTP headers. This operation does not include a request body.

### Syntax
[Collection: <Collection Name>]
Export Header: <String Expression>
Remote URL : <Target URL>
OR
Data Source : HTTP JSON : <Target URL> [: <Encoding>]
OR
Data Source : HTTP XML : <Target URL> [: <Encoding>]

### Parameters
- **Collection Name** (string) - Required - The name of the collection where the data is populated.
- **Target URL** (string) - Required - The URL to which the request is to be sent.
- **Encoding** (string) - Optional - Encoding type (ASCII, UNICODE, UNICODE8, UTF8, or UTF16). Defaults to UTF16.
```

--------------------------------

### Open a project with /PROJECT parameter

Source: https://help.tallysolutions.com/article/DeveloperReference/td9/getting-started-with-td9/td9_command_line_parameters.htm

Opens Tally.Developer 9 and loads the specified TDL project file.

```bash
“C:\Tallydeveloper\tallydeveloper.exe” “/PROJECT:C:\Demo TDLs\Demo TDLs.tpj”
```

--------------------------------

### Persisting and Loading All System Scope Variables

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_3_0.htm

Demonstrates using the wildcard '*' to save all system scope variables to a file and subsequently loading them.

```TDL
[#Menu : Gateway of Tally]
Add : Button : SLSystemSco  p  eSave,  S  LSystemScopeLo  a  d

[Button : SLSystemS  c  opeSave]
Key : Alt  +  F
Action : SAVE VARIABLE : SL  S  ystemScope.pvf : *
Title : “Save Sys Var”

[Button : SLSystemS  c  opeLoad]
Key : Alt + L
Action : LOAD VARIABLE : SL  S  ystemScope.pvf
Title : “Load Sys Var”
```

--------------------------------

### Report Scope Variable Declaration Example

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_2_0.htm

Example demonstrating simple, typed, and list variable declarations within a report.

```TDL
[Report : SMP Report]
Variable : Emp Name
Variable : Emp Relation : String
List Variable : Employee1
List Variable : Employee2 : String : “Prem”
[Variable : Emp Name]
Type : String
[Variable : Employee1]
Variable : EmpName : String
Variable : EmpID : String
```

--------------------------------

### Navigating to .NET Framework Directory

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_4_6.htm

Commands to switch to the directory containing regasm.exe for 32-bit and 64-bit systems.

```shell
cd /d C:\Windows\Microsoft.NET\Framework\v4.0.30319
```

```shell
cd /d C:\Windows\Microsoft.NET\Framework64\v4.0.30319
```

--------------------------------

### Create Pre-Request Report and Variables

Source: https://help.tallysolutions.com/article/DeveloperReference/integration-capabilities/case_study_using_xml.htm

Sets up a report to capture user input and a global variable to store the stock item name.

```TDL
[Field : StkPreReqFld] 
Modifies : SVStkItem 
[System: Variables] 
SVStkItem : "" 
[Variable: SVStkItem] 
Type : String
```

--------------------------------

### Modify Object Action Examples

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/general_and_collection_enhancements.htm

Examples demonstrating the use of the Modify Object action to alter ledger and voucher object methods.

```TDL
[Key : Alter My Object]
Key : Ctrl + Z
Action : Modify Object :(Ledger,"MyLedger").BillAllocations [First,$Name="MyBill"].OpeningBalance +
: 100,..Address[Last].Address : "Bangalore"
```

```TDL
[Key : Alter My Object]
Key : Ctrl + Z
Action : Modify Object :(Ledger,"MyLedger").BillAllocations[1].OpeningBalance : 1000, Name:”My New Bill”,+
..Address[First].Address : "Hongasandra Bangalore", + Opening Balance : 5000
```

```TDL
[Key : Alter My Object]
Key : Ctrl + Z
Action:ModifyObject:LedgerEntries[1].BillAllocations[1].Name : “Test1”, Amount :“1000.00”, ..BillAllocations[2]+
.Name:“Test2”, Amount : “2000.00”, ().Date : “1.4.08”
```

--------------------------------

### Help Command

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_4_6.htm

Lists all available recording commands.

```text
HELP
```

--------------------------------

### Implement After Import Object Logging

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_4_8.htm

Example showing how to trigger a log update after each object import and display the log upon completion.

```TDL
[Import File : All Masters] 
On : After Import Object : Yes : Call : Update Log 
On : End Import : Yes : Call : Show Log 

[Function : Update Log] 
00 : If : $$ImportAction = "Errors" 
;; New Function introduced to check whether the updation of current object is successful or encountered with an error 
10 : Log : $$LastImportError 
;; New Function to return the Error encountered during last Import Object 
20 : End If 

[Function : Update Log] 
10 : Exec Command : TDLFunc.Log
```

--------------------------------

### Stock Items Collection Example

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/actions_in_tdl.htm

A complete example of a Collection definition for Stock Items using Trigger, Report, and Variable attributes.

```TDL
[Collection : Stock Items in Display Collection] 
Type : Stock Item 
Trigger : Stock Item Selection Interface 
Report : Stock Item Final Report 
Variable : Stock Item Name
```

--------------------------------

### Start Progress Bar Action

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/user_defined_functions.htm

Initializes a progress bar with a total step count and optional display labels.

```TDL
START PROGRESS : ##TotalSteps : ”TDS Migration”:@@CmpMailName : ”MigrationgVouchers..”
```

--------------------------------

### $$FinYearBeg

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_4_7.htm

Fetches the starting date of the company's financial year based on a specified date and the company's financial year start date.

```APIDOC
## $$FinYearBeg

### Syntax
$$FinYearBeg : <First Date Expression> : <Second Date Expression>

### Description
Fetches the starting date of the company's financial year, corresponding to a particular specified date. The first parameter is the date to evaluate, and the second is the company's financial year beginning date.
```

--------------------------------

### Initialize Login Screen

Source: https://help.tallysolutions.com/article/DeveloperReference/auth-lib/blackberry_7_platform.htm

Instantiate the TallyLoginScreen by providing the online mode status and the callback object.

```java
final TallyLoginScreen loginScreen = new TallyLoginScreen(true, onScreenCloseCallback);
```

--------------------------------

### Example Collection with Banking Attributes

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_4_8.htm

A complete example of a Pay Link collection utilizing Transaction Type, Primary Status, and Secondary Status attributes.

```TDL
[Collection : Pay Link Coll]
Type : Pay Link
Child of : "ICICI"
Transaction Type : $$SysName:NEFT
Primary Status : $$SysName:StatusTransacted
Secondary Status : $$SysName:NotApproved
Fetch : *
```

--------------------------------

### Zip Multiple Paths and Sub-directories

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_4_7.htm

Shows how to include multiple source paths, including specific file patterns and entire folders with sub-directories.

```TDL
Start Zip : “Target.zip” : Yes 
Zip Add Path : “.	Tally.ini” 
Zip Add Path : “D:	Documents\*.doc” : Yes 
/* Include Sub-Folders also */ 
Zip Add Path : “C:	Work” 
/* The Folder Work and the Files within this folder will be included in the Zip File */ 
End Zip
```

--------------------------------

### TDL Function Dependency Limitation Example

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_3_0.htm

An example illustrating a scenario where a user-defined function fails to establish a dependency link, preventing automatic UI refresh.

```TDL
[Variable : My Variable] 
Type : String 
[Field : My  F  ield] 
Type : String 
Set  a  s : $$MyUserFu  n  ction 
[Function : My User  F  unction] 
Returns : String 
01 : RETURN : ##MyVariable
```

--------------------------------

### Log Target Action Example

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_1_5.htm

Demonstrates the use of the Log Target function-specific action to log the target object's details.

```TDL
[Function :  FuncLe  d  Exp]
|
05 : Set  Tar  g  et
|
10 : Log Target : LedgerObj.txt
```

--------------------------------

### Control UI Regeneration with START XSUB and END XSUB

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_3_0.htm

Enclose statements within START XSUB and END XSUB to defer UI element regeneration during execution mode.

```TDL
[Function : ModifyC  u  rrentObj]
01 : S  T  ART XSUB
02 : SET VALUE : Va  l  ue1 : “Somethi  n  g else”
03 : SET VALUE : Va  l  ue2 : “Another value”
04 : E  N  D XSUB
```

--------------------------------

### Part Level Object Association using Object Ex (Example 2)

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/general_and_collection_enhancements.htm

Example of associating a secondary Bill Allocation object with a Part using the Object Ex attribute.

```TDL
[Part : Sample Part]
Object Ex : (Ledger,"Customer").BillAllocations [1,@@Condition1]

[System : Formula]
Condition1 : $Name = "Bills 2"
```

--------------------------------

### Action: Browse URL

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/general_and_collection_enhancements.htm

Opens a web browser with a specified URL formula and optional command line parameters. Exec Command is an alias for this action.

```APIDOC
## Action: Browse URL

### Description
Opens a web browser with a specified URL formula and optional command line parameters.

### Syntax
Action : Browse URL : <URL Formula> [:<command line parms>]

### Parameters
- **URL Formula** (expression) - Required - An expression that evaluates to a website link.
- **command line parms** (string) - Optional - A list of command line parameters separated by spaces.
```

--------------------------------

### Configure GET Requests with Headers

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/objects_and_collections.htm

Specify HTTP headers and target URLs for GET requests using Export Header alongside Remote URL or Data Source attributes.

```TDL
[Collection: <Collection Name>]
Export Header: <String Expression>
Remote URL : <Target URL>
OR 
Data Source : HTTP JSON : <Target URL> [: <Encoding>] 
OR 
Data Source HTTP XML : <Target URL> [: <Encoding>]
```

--------------------------------

### Control UI Regeneration with START SUB and END SUB

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_3_0.htm

Enclose statements within START SUB and END SUB to defer UI element regeneration until the function exit in evaluation mode.

```TDL
[Function : My User functio  n  ]
01 : START SUB
02 : SET :  M  y Varia  b  le : “First Value”
03 : SET :  M  y Varia  b  le : ##MyVaria  b  le + “, Second Value”
04 : END SUB
```

--------------------------------

### Execute Tally with /PREACTION parameter

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_1_5.htm

Loads a company and executes a function before the main menu appears.

```text
"C:\Tally.ERP 9 \Tally.exe"/LOAD : 00009/PREACTION : CALL : BackupBeforeEntry
```

--------------------------------

### Start Tally Service

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_4_5.htm

Initiates the specified service.

```TDL
Action : Start Service : "Tally.Server 9 - 1"
```

--------------------------------

### Execute Script File via Command Prompt

Source: https://help.tallysolutions.com/article/DeveloperReference/dict-mgr/working-on-dictionary-manager/generating_the_script_file.htm

Use this syntax to run a generated script file from the command line.

```text
dctmgr –s <Script File path>
```

--------------------------------

### $$IsServiceInstalled

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_4_5.htm

Checks if a specified service is installed on the system.

```APIDOC
## $$IsServiceInstalled

### Description
Checks if the specified service is installed on the system. Returns TRUE if the service is installed.

### Syntax
$$IsServiceInstalled : <Service Name>

### Parameters
- **Service Name** (String) - Required - Expression evaluating to the service name.
```

--------------------------------

### Log Object Action Example

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_1_5.htm

Demonstrates the use of the Log Object global action within a function to log ledger details to a file.

```TDL
[Function : FuncLedExp]
|
Object : Ledger
|
10 : Log Object : LedgerObj.txt
```

--------------------------------

### Example of an internal collection

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/objects_and_collections.htm

A collection containing Ledger objects.

```TDL
[Collection : My Collection]
Type : Ledger
```

--------------------------------

### Execute Tally with /NOINITDL and /TDL parameters

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_1_5.htm

Starts Tally while ignoring TDLs in Tally.ini and loading specific TDL files.

```text
"C:\Tally.ERP 9\Tally.exe" /NOINITDL /LOAD:00009 "/TDL:C: \Tally.ERP 9 \TDL \SecurityTDL.txt" /TDL:MasterTDL.txt
```

--------------------------------

### Define COM Interface and Math Library Class

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_4_61.htm

Example showing a C# class and its corresponding TDL COM Interface definition.

```csharp
using System;  using System.Collections.Generic;  using System.Linq;  using System.Text;  namespace MathLib  {  public class MathClass  {  public double Add(double pDouble)  {  return pDouble + 9;  }  }  }
```

```tdl
[COM Interface : TSPL Smp Add]  Project : MathLib  Class : MathClass  Interface : Add  Parameters : p1 : Number : In  Returns : Number
```

--------------------------------

### $$GetEndDateTime

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_4_7.htm

Calculates the ending DateTime based on a starting DateTime and a duration.

```APIDOC
## $$GetEndDateTime

### Description
Returns the final/ending DateTime value given an initial starting DateTime and a duration value.

### Syntax
$$GetEndDateTime : <DateTime Expression> : <Value>

### Parameters
- **DateTime Expression** (Expression) - Required - A valid Date/DateTime value.
- **Value** (Duration) - Required - The duration to add to the starting DateTime.
```

--------------------------------

### $$YearEnd

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_4_7.htm

Returns the last date of the year starting from the specified date.

```APIDOC
## $$YearEnd

### Syntax
$$YearEnd : <Date Expression>

### Description
Returns the last date of the year, considered to be starting from the date specified as the parameter.
```

--------------------------------

### Initialize TallyAuthenticationLibrary

Source: https://help.tallysolutions.com/article/DeveloperReference/auth-lib/ios_platform.htm

Create an instance of the library and set the delegate.

```objective-c
TallyAuthenticationLibrary  * AuthObj = [[  TallyAuthenticationLibrary  alloc]  init  ]; 
[AuthObj  SetDelegate  :  self  ];
```

```objective-c
TallyAuthenticationLibrary  * AuthObj = [[  TallyAuthenticationLibrary  alloc] 
initWithDelegate  :  self  ];
```

--------------------------------

### Specify Object Context

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/user_defined_functions.htm

Example of setting the object context for a function.

```TDL
[Function : Sample Function] 
Object :  L  e  dger  :  “Party”
```

--------------------------------

### Execute an application and wait using BrowseURLEx

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_3_61.htm

Runs an executable with command line parameters and waits for the process to complete before continuing.

```TDL
Action : BrowseURL Ex: “C:\7zip.exe”: “d software.7z”
```

--------------------------------

### Initialize Tally Authentication Library

Source: https://help.tallysolutions.com/article/DeveloperReference/auth-lib/windows_8.htm

Instantiate the login service within the main page constructor.

```csharp
TallyLoginService ls;
public  MainPage()
{
this  .InitializeComponent();
ls  =  new  TallyLoginService  ();
trrm =  new  TestRequestResponseMgr  ();
}
```

--------------------------------

### Example of an external collection

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/objects_and_collections.htm

A collection of user-defined objects with specific methods.

```TDL
[Collection :  Emp] 
Object  :  E  mp1,  Emp2 
[Object  :  E  mp1] 
EmpName :  "  Ram Kumar" 
Age : "25" 
[Object :  E  mp2] 
EmpName  :  "  Krishna  Yadav" 
Age : "30"
```

--------------------------------

### Handling Stock Item Deletion Events

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_4_8.htm

Example implementation showing how to trigger functions before and after a Stock Item is deleted.

```TDL
[System : Event]
BeforeStockItemDeletion : Before Delete Object : $$IsStockItem:Call:BeforeDeleteObjectFunc
AfterStockItemDeletion : After Delete Object : $$IsStockItem:Call:AfterDeleteObjectFunc

[Function : BeforeDeleteObjectFunc]
00 : Log : "Before Delete Object Event starts here"
10 : Log : $Name + “under the Stock Group” + $Parent + “is being deleted by ” + $$CmpUserName
20 : Log : $MasterID
30 : Log : "Before Delete Object Event ends here"

[Function : AfterDeleteObjectFunc]
00 : Log : “Stock Item ” + $Name + “ Deleted”
```

--------------------------------

### WRITE ROW

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_2_0.htm

Writes multiple values to a row starting from a specific column.

```APIDOC
## WRITE ROW

### Description
Writes multiple comma-separated values to a row starting from the specified column index.

### Syntax
WRITE ROW : <Row No> : <Initial Column No> : <Comma Separated Values>

### Parameters
- **Row No** (number) - Required - The row index.
- **Initial Column No** (number) - Required - The starting column index.
- **Comma Separated Values** (data) - Required - The values to be written.
```

--------------------------------

### Implement Union Approach for Collection Aggregation

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/release_3_0.htm

Example demonstrating the traditional union approach where a source collection is traversed multiple times for different sub-object aggregations.

```TDL
;;The source collection “Voucher Source” is a Collection of Vouchers 
[Collection : VoucherSource] 
Type : Voucher 
;;The collection using “Vo  u  cher Source” as a source  c  ollection, and walking over Ledger  E  ntries Sub-Object, aggregating Amount by  gr  o  upin  g  ove  r  Ledge  r  Name 
[Collection : Ledger Details] 
Source Collection : VoucherSource 
Walk : AllLedgerEntries 
By : Particulars : $LedgerName 
Aggr Compute : Tot Amount : Sum: $Amount 
Keep Source : (). 
;;The collection using  V  oucher Source as a source collection,  a  nd  w  alking over Inventory Entries Sub-Object, aggregating Amount by grouping over  S  tock Item Name 
[Collection : StockItem Details] 
Source Collection : Vouche  r  Source 
Walk : AllIn ventoryEn  t  ries 
By : Particulars: $StockIt  e  mName 
Aggr Compute : Tot Am  o  unt : Sum: $Amount 
Keep Source : (). 
;;The Resul  t  ant Collection, which is a union of objec  t  s from the above two collections “  L  edger  D  etails” and “  S  to  c  kItem De  t  ails” 
[Collection : Union LedStk Vouchers] 
Collection : Ledger  D  etails, StockI  t  em Det  a  ils
```

--------------------------------

### Specify Return Value

Source: https://help.tallysolutions.com/article/DeveloperReference/tdlreference/user_defined_functions.htm

Example of defining the return data type for a function.

```TDL
[Function : FactorialOf] 
Parameter : InputNumber : Numb  e  r 
Returns :  Number 
Variable :  Factorial  :  Number
```
Tokens:
Raw