Additional attributes for link item. Extension for both undefined link and userLink

interface ivA_link {
    IDfield?: string;
    UIdataEl?: object;
    UIdataElType?: IntUIdataElType;
    _bClear?: HTMLElement;
    _bView?: HTMLElement;
    _enabled?: boolean;
    _enumLimit?: string;
    _hint?: string;
    _objectName?: string;
    _readonly?: boolean;
    _tooltip?: string;
    _translation?: string;
    _visible: boolean;
    a?: string;
    alwaysSendServer?: boolean;
    block?: string;
    blockStyle?: object;
    box?: string;
    buttonIcon?: string;
    buttons?: string[];
    command?: iCommandData;
    dataAttr: iDataAttribute;
    default?: string | false;
    editable?: string;
    enabled?: string | boolean;
    enum?: string;
    enumLimit?: string;
    enumType?: iattrDataType;
    eval?: string;
    hidden?: boolean;
    hitem?: HTMLElement;
    icon?: string;
    label?: string | boolean;
    name: string;
    newValue?: string;
    noLink?: boolean;
    noSave?: boolean;
    objAllowed?: string[];
    oldValue?: string;
    onLeave?: string;
    oper?: string;
    order?: string;
    placeholder?: string;
    purpose?: ViewPurpose;
    readonly?: string | boolean;
    remote?: string;
    required?: boolean;
    right?: string;
    selectNothing?: string;
    short?: boolean;
    shortcut?: string;
    small?: boolean;
    source?: iobjAttrDataSource;
    strangeEval?: string;
    style?: object;
    type?: iattrDataViewType;
    view?: string;
    viewSelect?: string;
    visible?: string | boolean;
    whenVisible?: "RO" | "WO" | "NO" | "always";
    where?: string;
    whereForNew?: string;
}

Hierarchy (view full)

Properties

IDfield?: string
UIdataEl?: object
UIdataElType?: IntUIdataElType

type of the element in the UIdateEl - internal, never loaded

_bClear?: HTMLElement

optional buttons for view detail created only when no required

_bView?: HTMLElement

optional buttons for view created only when double click is disabled

_enabled?: boolean

internal represetnation of the disabled field

_enumLimit?: string
_hint?: string
_objectName?: string
_readonly?: boolean

readonly status calculated from readonly (Note: not calculated for list views, only for detail)

_tooltip?: string
_translation?: string
_visible: boolean

visibility status calculated from visible - use ths value to hide or show columns

a?: string

action that is started by click or self-defined view command

  • When used together with the field in the list, system creates a button that activates operation
  • When used in the detail with the item of the view type, it is used instead of view defition in view. Here can be used any a... command.
    • Link can freely defined and even evaluated by fval. When evaluated by fval, it allow total control over the attributes, but it does not get default attributes!
    • @example: object linked if the tskReminder
    • It can manage readonly settings and e.g. allow to have view item editable even when master object is readonly
    • @example: tskRelTaskUser linked in tskTask
alwaysSendServer?: boolean

Optional mark requesting to send value of the field always to the serer When value s marked true, update always send value to the server - in the group field if modified and in the group attrParam when not modified Use when value is necessary for preUpdate/postUpdate function

block?: string

Optional name of the block. Use block to get more small items to single line User blockStyle to set the style of the block

blockStyle?: object

Style applied to the block blockStyle is always applied only with the first attribute. When block is created the style from next placed block is never applied

box?: string

string or number of box in which the attribute is placed DEPRECIATED: Do not use box but split attribute to the box definitinos

buttonIcon?: string

Optional name of the icon used at the button that selects object to link Default button is used according to the linked object but especially for multi-overloaded object that might not have reason

buttons?: string[]
command?: iCommandData

Possibility to completedy change what command is processed instead of open select - it can start another command Note: There is no right control and who can select item, can start command in this feild

Example

server.sysArea._lastUser
dataAttr: iDataAttribute
default?: string | false

Default value for field when object is new. Equal with dataAttribute.default Use only in case that there is more views and default value is different for them User false value of fields to disable using default value

editable?: string

command evaluated in order to check if user can edit field. Negation of the readonly. Has lower priority and is disregarded in case that readonly is defined. Do not use both of them

enabled?: string | boolean

Optional attributes says that attributes should be totally ignored and view behaves as as attribute doesn't exists Use when extneding object should ignore some attributes from parent object WARNING: Curently implemented only for listView, detail does not yet supported it

enum?: string

Optional name of enum Uses id dataAttribute is not defined or view uses different enum

enumLimit?: string

Optional name of the condition use to select part of the filter if contains = it is expected to be condition usef to evaluate - see enumLimit description at data attribute

enumType?: iattrDataType

Optional enum type used in case that field is not from object (no dataAttr)

eval?: string

Iptional evaluation string - field can be evaluated before it is placed to the field; Should contain string evaluated with fields from row; supported by list and detail - for detail it make sense with readonly:true or some other type of content ocntrol

hidden?: boolean

user settings to hide the column - used only for list view - user can change this value and value is stored in the browser memory

hitem?: HTMLElement
icon?: string
label?: string | boolean

Optinonal commands about label false - no label is printed string - string to translate (used instead of fieldname) true - does not affects functionality (useless) evaluaated - (=obj.enumVal('x')) --- should return translated value, result is not translated. Remember that obj is empty (nevertheless defined) for new object

name: string
newValue?: string
noLink?: boolean

if true, only string is visible, no button for view, usable for readonly where is no detail button avilable

noSave?: boolean

Optinal attributes mark fields that are not from database and could not be saved. Use that for fields that are modified on the client application but shall not be saved because they are not from object table and save is made in som other way

  • Let's note that it is only rarely necessary, because strange items are mostly not updated and so never goes to the save
  • Field is not evaluated! use true for strange field that makes trouble during saving
objAllowed?: string[]

List of allowed related object

  • Use only in combination with attrtype objectPrincipal = In case that link is weak i.e. described in combination of attributes XObjectName xObjectID, field disregards in other case
  • Allowed special value 'any' in the 1.st item. In that case user can select from all objects allowed by list
  • for universal links base on the sysRelOO, value is filled from object attributes

Example

objAllowed:["sysUser", "tskTask", "tskInfItem"]

Field could be also defined directy in the attributes - naturally it is better location than in the view
oldValue?: string
onLeave?: string

Name of the object operation started when user leaves the item

  • use enabled attributes of the operation to check if operaion should be started or not. evaluation of the enabled string gets actual state of the object Enabled field is evalauted everytime when user leaves the item
oper?: string

Name of the operation linked with the attribute; used in the list (or lately also detail view attributes) Not supported in detail. User buttons:[] in detail Allowed content is:

  • name of the operation defined in object (e.g. tunEtwas), (for detail not yet implemented)
  • openSelfDetail, openSelfClip, openSelfModalDetail - only list
  • form.object.viewtype....., other operation except form are not allowed - only list
order?: string

Optional order string used to order attributes

placeholder?: string

optional placeholder text in the field Always translated, not evaluated

purpose?: ViewPurpose

Type of view when select - default is selectMulti, however for function runSelect is default selectOns

readonly?: string | boolean

Visible but not editable - used in the json defition file and converted to the _readonly according to the data. Do not use it with the data processing in the view

remote?: string

Optional name of the remote object - used only in case that there is no linked dataObject

required?: boolean

When true, field is considered to be required reqardless on the data attribute settings

right?: string

The same as visible

selectNothing?: string

Optional name of the method called in case that use clicks on the selectNothing (create new button). Remember:

  • selectNothing could be evaluated, if necessary (however, obj is the object from which it is called)
  • Field does not create selectNothing button itself, it shall be still defined in the view definition -> default view may not be used, use viewSelect together with this field @example: crmPersonSubject.parentSubject
short?: boolean

When true it says the input is for short - up to 5 digits and field could be also short Makes sense only for text-like fields like string and number and listbox

shortcut?: string

Optional shortcut

small?: boolean

Optional attribute source

strangeEval?: string

Optional eval values used for strange object; eval is never used for strange Used only in list table

style?: object

optional style for element See style option for boxElements for more details about the field

__Warning: supported currently only for view, image and some text fields;

  • Explicitly not supported for any object/file picker and event not for markdown editor

Optional view type that describes, how to present value

view?: string

Optional definition of the view for the view button - used to open detail (not for selection)

  • view does not support additional atrributes *

Default

clip.default

Example

tskArea.clip.full
viewSelect?: string

view to select (list view), default view is "default" - list view used to select object

  • viewSelect does not support additional atrributes

Default

list.default (with object from the field definition)

Example

"viewSelect":"tskAbstractArea.list.myActiveAreas", WARNINING: always including object, regardless of the type definition
visible?: string | boolean

system setting, that the row is necessary but not visible to allow e.g. keys for detail open - user cannot change this value; do not use the value, but use _visible instead of that

whenVisible?: "RO" | "WO" | "NO" | "always"

Optional field allows limits when field is visible. Don't set the value in default state when field shall be visible both in read and write mode

where?: string

where part for view to limit items that can be selected. if where string starts with the server evaluates content as a server command that should return the where condition

whereForNew?: string

where condition used only in case that object is new and its oID cannot be sent for view