Product Home
DTM Data Generation SDK Online Documentation Prev Page Prev Page
Product Profile
SDK components
Functions map
Low level API
Short Random
Integer Random
Random Symbol
Double Random
Random String
Random Date
Random Time
C/C++ example
Fill Methods level API
From list
From file
From table
From Values Library
Incremental
By maks
By SQL statement
Rule level API
Rule properties
Rule items
One rule item
Project level API
Project operations
Project properties
Project rules
Object handles
Database connection
Error handling
SDK limitations
Build application with SDK
License agreement

Rule item properties

SetItemProperty changes selected property of the specified item
C/C++
int SetItemProperty(ITEM_HANDLE handle, int PropertyID, char *value)

C#
int SetItemProperty(int handle, int PropertyID, string value)
returns
0 for success
-1 for invalid rule handle
-2 for unknown or unsupported property ID.

GetItemProperty retrieves property of the specified rule's item.
C/C++
char* GetItemProperty(ITEM_HANDLE handle, int PropertyID)

C#
string GetItemProperty(int handle, int PropertyID)
PropertyID is property code from DG_ITEM_PROPS list (see table below or DGSKD.H).

COM object offers "ItemProperty" string property for described functions. You should not use "SetItemProperty" and "GetItemProperty" functions directly in this case.

Property definitions

Name Property ID Description
IP_Name 1 Column (field) name
IP_Start 2 Start value for incremental fill method
IP_Step 3 Step value for incremental fill method
IP_Times 4 Use each value for incremental fill method
IP_Cycle 5 Cycle length for incremental fill method
IP_AfterLast 6 Insert value after last existing value for incremental fill method
IP_asMask 7 The library should use values as mask in case this value is non-zero.
IP_isUnique 8 The library should generate unique values fir this item in case this value is non-zero
IP_isSeqent 9 The library should use values from the list sequentially in case this value is non-zero
IP_method 10 Fill method: 0 to 10
IP_UseNulls 11 % of NULL velues
IP_SequenceLen 12 Sequnce length. How many times the program should use one generated value
IP_MinLength 13 Minimum value or length
IP_MaxLength 14 Maximum value or length
IP_asList 15 When this value is not 0 the program will use query result set as list, only first value otherwise
IP_RndSeparators 16 % seperators for random strings
IP_NoQuotas 17 Do not quote generated value
IP_Formula 18 Formula for corresponded fill method
IP_table 19 Linked table for "From Table" fill method
IP_column 20 Linked column for "From Table" fill method
IP_LibName 21 Library item for "From Library" fill method
IP_mask 22 Mask for "By Table" fill method
IP_sFormat 23 Output format string (%d, %5.2f, etc)
IP_Where 24 Where clause for "From Table" fill method
IP_Order 25 "Order by" clause for "From Table" fill method
IP_SQL 26 SQL statement for "By SQL" fill method
IP_incTimeMode 27 Time Mode for incremental method: 0 for second, 1 for minute, 2 for hour, 3 for day, 4 for month or 5 for year