CTItem

Purpose

Defines the mapping of an InForm form item to a Clintrial panel item. The attributes of CTItem describe the attributes of the item in the Clintrial software.

Syntax

Attributes

REFNAME="name"

RefName of the item. Required.

DESCRIPTION="text"

Description of the item. Optional.

ITEMDATATYPE="TEXT|FIXED|FLOAT|DATE|DATETIME"

Data type for the value of the item. The options are:

Text
Fixed
Float
Date
DateTime

Required.

SUBSETVALUE="text"

Value the item takes if it is the subset key for subset page sections based on the panel. Optional.

BLOCKKEYVALUE="text"

Value of the Clintrial block key. If you specify this value, it overrides the visit RefName as the block key. Optional.

PAGEKEYVALUE="text"

Value of the Clintrial page key. If you specify this value, it overrides the form RefName as the page key. Optional.

DATEPART="n"

Part of a date time control to be mapped to a Clintrial item. Use this attribute if you are mapping parts of a date time control to separate Clintrial items. The options are:

0—Undefined
1—Year
2—Month
3—Day
4—Hour
5—Minute
6—Second

Optional.

ISDERIVED="true|false"

Indicates whether the value of the item is determined from a derivation associated with the panel. The options are true or false. False is the default. Optional.

ISREQUIRED="true|false"

Indicates whether the item is required. The options are true or false. Required.

DBFORMAT="format"

Format in which the Clintrial software stores values for the item in the Oracle database. The Oracle database formats are:

VARCHAR2(n)
DATE
NUMBER(xx)
NUMBER(xx,yy)
NUMBER(xx,0).x

Required.

SASNAME="name"

Name of the item when data is sent to SAS through the Clintrial SAS interface. The name must be eight characters or fewer and conform to SAS naming requirements. Optional.

CONTEXTTYPE="n"

Context type of the item. Context items are associated with each record in a clinical data table defined by a panel of Types, 1, 2, 3, 4, or 5 and are included in the ContextPanel definition for a protocol. Types are:

0—Not a context item.
1—Subject-related context item.
2—Visit-related context item.
3—Page-related context item.
4—Other context item.

Required.

ISREPEAT="true|false"

Indicates whether an item is one for which multiple values can be entered within a page section.

CODELIST="text"

Name of a codelist associated with the item. CODELIST and CHECKLIST are mutually exclusive. A codelist encodes entered values. Only codes or values in the codelist can be entered as values of the item. Optional.

CHECKLIST="text"

Name of a checklist associated with the item. CODELIST and CHECKLIST are mutually exclusive. A checklist is a type of codelist that is used to view suggested entries for a field. Optional.

RANGELB="n"

Minimum value that can be entered for the value of the item. Optional.

RANGEUD="n"

Maximum value that can be entered for the value of the item. Optional.

KEYORDER="n"

The order in which the item appears in the concatenation of key items, if the item is part of the panel's key. 0 (not a key item) is the default. Optional.

COPYWITHPANEL="true|false"

Indicates whether the item should be included with the panel if the panel is copied. Options are true or false. True is the default. Optional.

LOCKSTATUS="n"

Indicates whether the protocol in which the item is included is locked:

0—item is modifiable
1—item is not modifiable, but it can be reset to modifiable
2—item is not modifiable and cannot be made modifiable.

The default is 0. Optional.

ISKEY="true|false"

Indicates whether the item is part of the panel's key. False is the default. Optional.

Example

This example specifies the mapping of three items in the CLIN1 panel.

</EXTERNALMAP>