Since version 1.6.5.0, Ascendis Caller ID has supported a second script language, known as DWS.  DWS stands for Delphi Web Script, and is an open source scripting language based loosely on Delphi.  Its home is here:

http://sourceforge.net/projects/dws/

 

 

Specifically, Ascendis Caller ID supports DWS II 2.0.

 

DWS is a programming language similar to Delphi, which is itself an extended version of Pascal.  Here are some highlights:

 

An enhanced Backus-Naur definition of DWS provides a more complete definition.

 

All DWS scripts must contain the following line before any commands:

// LANGUAGE=DWS

This tells Ascendis Caller ID not to use the original script processor.

 

 

DWS in Ascendis Caller ID supports the following commands:

 

DeleteCall;

DeleteCall;

 

 

Export(<data to export>, <file format>, '<filename>');

Export(elCalls, efHTML, 'calls.htm');

Export(elContacts, efCSV, 'contacts.csv');

Export(elActions, efText, 'actions.txt');

 

 

HangUp;

HangUp;

 

 

Log('<filename>', '<log text>');

Log('C:\calls.txt', CallInfo.DateTimeStr + ' - Call from ' + CallInfo.Name + ' at ' + CallInfo.Number);

Log('D:\Documents\privateCalls.txt', CallInfo.DateTimeStr + ' :: Another anonymous call!');

 

 

LogActivity('<log text>');

LogActivity('Hanging up on {Name} at {Number}');

LogActivity(CallInfo.DateTimeStr + ' :: Another anonymous call!');

 

 

PerformAction('<actionName>');

PerformAction('Block');

PerformAction('Look for caller in Google');

PerformAction('Send email to cell phone');

 

 

PhoneSound('<filename>');

PhoneSound('Disconnect Tones.wav');

Notes:

waveOutOpen() -- The specified format is not supported or cannot be translated. Use the Capabilities function to determine the supported formats.

 

 

Run('<filename>'[, '<arguments>']);

Run('notepad');

Run('myprogram.exe', CallInfo.RawNumber);

Run('showargs.exe',

'"' + CallInfo.FirstName + '" ' +

'"' + CallInfo.LastName + '" ' +

'"' + CallInfo.RawNumber + '" ' +

'"' + CallInfo.DateTimeStr + '" ');

 

 

RunWait('<filename>'[, '<arguments>'][, <window state>]);

RunWait('MakeDataFile.exe', 'C:\Temp.dat ' + CallInfo.RawNumber);

if RunWait('GetSecretCode.exe', '"' + CallInfo.Number + '"', SW_SHOWMINNOACTIVE) > 0 then

begin

LogActivity('FATAL ERROR: could not get secret code');

Exit;

end;

 

 

SendMail('<from>', '<recipients>', '<subject>', '<message>' [, '<cc list>' [, '<bcc list>']]);

 

 

SendMailFromFile('<filename>');

 

 

ShowMessage('<message>' [, WARNING|ERROR|INFORMATION]);

ShowMessage('Entering untested code');

ShowMessage('{Name} should not be calling here anymore', WARNING);

 

 

Sound('<filename>');

 

 

Speak('<text>');

 

SpeakWait('<text>');

 

 

Volume(<volume>);

 

 

Some commands are also available as Easy Actions.

 

Information about the current call can be accessed through the CallInfo object.

 

 

Ascendis Caller ID includes the following standard DWS libraries:

 

For a more comprehensive list of functions included with DWS, please see the DWS documentation.  You can download it from the DWS web site.  Some functions or libraries may not be available from Ascendis Caller ID scripts; please test desired functions before assuming they will work.

 

Ascendis Caller ID adds the following functions to the standard DWS functions:

function CallCount: Integer;

 

function ContactCount: Integer;

 

function GetCanonicalNumber(<phone number string>): Integer;

 

function GetComputerName: String;

 

function GetDataFolder: String;

 

function GetRawNumber(<phone number string>): String;

 

function GetSettingBool(name: String): Boolean;

 

function GetSettingStr(name: String): String;

 

function GetTickCount: Integer;

 

function NewCallCount: Integer;

 

function PhoneCount: Integer;

 

function PhoneNumbersMatch(<phone number string 1>, <phone number string 2>): Boolean;

 

 

If you want to keep often used functions and procedures in a shared location, use one of the following $INCLUDE directives:

{$INCLUDE '<pathname>'}

{$INCLUDE 'C:\Dev\DWS\Functions.inc'}

{$INCLUDE 'D:\DateLib.pas'}

 

{$INCLUDE_ACTION '<action name>'}

{$INCLUDE_ACTION 'Outlook Lib'}

{$INCLUDE_ACTION 'My Library'}

 

 

You may find more information on specific script commands by browsing or searching the Ascendis Caller ID forums on our web site.