Controls

To add a control to a View, select the Controls tab in the Toolbox. Click on the required control in the list and drag and drop it on the View canvas.

In order to change the type of a control that is linked to a field, click on the control on the canvas, then click on the Change Control icon in the Toolbar. The Change Control dialog opens. Select the new control type and click OK.

When a control is dragged from the Toolbox of a View, it is bound to that SmartObject property. When using the same control more than once on a View, all of those controls stay bound to that property unless you specifically unbind the control. Controls can be unbound by selecting the control and clicking on the Unbind button in the canvas Toolbar. When one of the controls bound to the property is updated, all of the related controls linked to that property will be updated as well.
It is therefore important to note that when using the dependent drop down scenario on a List View, for example, one needs to unbind the parent controls from the foreign keys that were originally dragged upon the canvas. When one drop down changes, it applies the change to the next control, which is bound to the same field, and will attempt to update all the related controls. This will cause a repeating cycle of events.
This is also applicable if a foreign key value is transferred from the one drop down to the other as the primary key value. When the ID's stop matching, this will seem as if the wrong data is returned to the user or unexpected behavior may occur.
The last control that is changed and also linked to a property, determines that property’s value. It is imperative to remember that if a control is not specifically required to save (or show) a particular property’s value, it should not be bound to that property.

Keyboard accessibility features are available to most input and certain other controls to ease the use of controls at runtime. Access keys can be used for accessibility to interact with controls or using the keyboard.
Examples:

• Esc key - Cancels the request or resets the control to its former state
• Space bar key - Activates the control with input focus; activates a selection
• Arrow keys - The arrow keys move input focus among the control. Pressing the right arrow key moves input focus to the right or up, whereas pressing the left arrow moves input focus to the left or down. The up and down arrow keys move the input focus up and down
• Enter key - Makes a selection
• Tab key - Move forward through options; navigating within a window

Tip when using Safari Browser
When tabbing between controls using the Safari browser, ensure that the setting Press Tab to highlight each item on a webpage is selected under Preferences > Advanced. Without this setting selected all anchor elements (contained in controls that have buttons) will be skipped when you tab through the controls and thus be unreachable with the keyboard

When using a control, it is important to know that all files and images are saved as base64 encoded values.

Supported File Types

Support are included but not limited to the following file types for use with controls.

You can specify what types of files and limit the size of files for the Attachment control. See the following sections for items that need to be considered when specifying file types and sizes as they will impact runtime behavior of the control.

Attachment Control Properties

The following properties are available on the attachment controls:

Properties	Description
Allowed Types	Represents specific types of files allowed for each individual control. Examples include jpg, gif or pdf, docx. Separate multiple file types with a comma. See the Image Attachment control and File Attachment control topics for more detail. If specific files are configured in the Allowed Types property, only those types are allowed. The Allowed Types property filters the files at runtime according to the Blacklist, which are always excluded, and those specified in the property, so you will only see files with that extension for upload. See the Blacklist files section for more details. The Blacklist overrides the file types configured in the Allowed Types property. If a file should be allowed and is configured in the Allowed Types control property, the file type should also be removed from the Blacklist if listed there. If the Allowed Types property is blank in the designer, all files are allowed except what is specified in the Blacklist.
Max Size	Represents the file size limit set for each individual control (can be specified in KB,MB,GB or TB). The following are examples of denominations that can be used: 5 5 mb 5mb 5MB 5 MB The value of the Max Size property should always be lesser or equal to the value of the MaxRequestLength setting in the <install drive>:\Program Files (x86)\K2 blackpearl\K2 smartforms Designer\Web.config and <install drive>:\Program Files (x86)\K2 blackpearl\K2 smartforms Runtime\Web.config. If you want the Max Size to be more than 16 MB, you’ll have to change the MaxRequestLength setting in the web.config to the same size. See the Considerations section for more detail. The Max Size property is measured in kilobytes (KB) but other values are also accepted. If MB,GB or TB is used, it should be specified in the property for example 20 MB. If you do not specify a size measurement in the Max Size property, it is treated as KB.

When configuring these properties, the application of the Blacklist and Web.config file entries should also be considered.

Web.config Entries

The Web.config entries are available in the following locations and can be changed according to business requirements.

<install drive>:\Program Files (x86)\K2 blackpearl\K2 smartforms Designer\Web.config

<install drive>:\Program Files (x86)\K2 blackpearl\K2 smartforms Runtime\Web.config

<!--<add key="Forms.Designer.Controls.Attachment.Blacklist" value="ade,adp,app,asa,ashx,asmx,asp,aspx,bas,bat,cdx,cer,chm,class,cmd,cnt,com,config,cpl,crt,cs,csh,der,dll,exe,fxp,gadget,

grp,hlp,hpj,hta,htr,htw,ida,idc,idq,inf,ins,isp,its,its,jar,javascript,jscript,js,jse,json,ksh,lib,lnk,mad,maf,mag,mam,maq,

mar,mas,mat,mau,mav,maw,mcf,mda,mdb,mde,mdt,mdw,mdz,msc,msh,msh1,msh1xml,msh2,msh2xml,mshxml,msi,ms-one-stub,msp,mst,ocx,ops,pcd,pif,pl,plg,prf,prg,printer,ps,ps1,ps1xml,ps2,ps2xml,psc1,psc2,pst,pst,reg,reg,scf,scr,sct,sct,shb,

shs,shs,shtm,shtml,soap,stm,svc,sys,tmp,url,vb,vbe,vbs,vbscript,vxd,vscript,vsix,vsmacros,vsw,ws,wsc,wsf,wsh,xamlx,xnk" />-->

<!--<add key="Forms.Designer.Controls.Attachment.MaxSize" value="5120" />-->

• Blacklist - This entry is for the global Blacklist containing dangerous or unwanted file types. These file types can be maintained in the Web.config file to include additional or remove existing limitations. These files will be restricted at runtime.
• MaxSize - This entry is for the attachment controls file upload restrictions. The value of this entry is used to restrict all uploads to a specific limit to allow for standardized files and file management and is measured in kilobytes (KB). This size relates directly to the Max Size property of the File Attachment and Image Attachment controls. The default maximum size is 5120 KB. To configure a larger size in the control's property, update this entry as the value of the MaxSize entry in the Web.config file overrides the value in the control's property. For example, if you want to upload files of a maximum of 10 MB in the Attachment control, the MaxSize entry in the Web.config file would be 10000.

These entries are commented by default but are enforced on the environment with their default values. If you want to change the default values, un-comment the entry and change the value.

Blacklist files

The following table is a list of Blacklist file types. These file types cannot be uploaded to the K2 server via the Attachment control. See the Backwards Compatibility section for details on releases prior to K2 smartforms 4.6.11.

Extension	Description
ade	Access Project Extension (Microsoft)
adp	Access Project (Microsoft)
app	Executable Application
asa	ASP declarations file
ashx	ASP.NET Web handler file. Web handlers are software modules that handle raw HTTP requests received by ASP.NET.
asmx	ASP.NET Web Services source file
asp	Active Server Page
aspx	ASP.net
bas	BASIC Source Code
bat	Batch Processing
cdx	Compound index
cer	Internet Security Certificate File
chm	Compiled HTML Help
class	Java class file
cmd	DOS CP/M Command File, Command File for Windows NT
cnt	Help Contents file
com	Command
config	Configuration file
cpl	Windows Control Panel Extension (Microsoft)
crt	Certificate File
cs	C# code file
csh	csh Script
der	DER Encoded X509 Certificate File
dll	Windows dynamic-link library
exe	Executable File
fxp	FoxPro Compiled Source (Microsoft)
gadget	Windows Vista gadget
grp	SmarterMail group file
hlp	Windows Help File
hpj	Help project file
hta	Hypertext Application
htr	Script file
htw	HTML document
ida	Internet Information Services file
idc	Internet database connector file
idq	Internet data query file
inf	Information or Setup File
ins	IIS Internet Communications Settings (Microsoft)
isp	IIS Internet Service Provider Settings (Microsoft)
its	Internet Document Set, Internet Translation
jar	Java Archive
javascript	JavaScript Source Code
jscript	JavaScript Source Code
js	JavaScript Source Code
jse	JScript Encoded Script File
json	JavaScript Object Notation file
ksh	UNIX Shell Script
lib	Windows static-link library
lnk	Windows Shortcut File
mad	Access Module Shortcut (Microsoft)
maf	Access (Microsoft)
mag	Access Diagram Shortcut (Microsoft)
mam	Access Macro Shortcut (Microsoft)
maq	Access Query Shortcut (Microsoft)
mar	Access Report Shortcut (Microsoft)
mas	Access Stored Procedures (Microsoft)
mat	Access Table Shortcut (Microsoft)
mau	Media Attachment Unit
mav	Access View Shortcut (Microsoft)
maw	Access Data Access Page (Microsoft)
mcf	Multimedia Container Format
mda	Access Add-in (Microsoft), MDA Access 2 Workgroup (Microsoft)
mdb	Access Application (Microsoft), MDB Access Database (Microsoft)
mde	Access MDE Database File (Microsoft)
mdt	Access Add-in Data (Microsoft)
mdw	Access Workgroup Information (Microsoft)
mdz	Access Wizard Template (Microsoft)
msc	Microsoft Management Console Snap-in Control File (Microsoft)
msh	Microsoft Shell
msh1	Microsoft Shell
msh1xml	Microsoft Shell
msh2	Microsoft Shell
msh2xml	Microsoft Shell
mshxml	Microsoft Shell
msi	Windows Installer File (Microsoft)
ms-one-stub	Microsoft OneNote stub
msp	Windows Installer Update
mst	Windows SDK Setup Transform Script
ocx	Object Linking and Embedding (OLE) Control Extension
ops	Office Profile Settings File
pcd	Visual Test (Microsoft)
pif	Windows Program Information File (Microsoft)
pl	Perl script
plg	Developer Studio Build Log
prf	Windows System File
prg	Program File
printer	Printer file
ps	Windows PowerShell
ps1	Windows PowerShell
ps1xml	Windows PowerShell
ps2	Windows PowerShell
ps2xml	Windows PowerShell
psc1	Windows PowerShell
psc2	Windows PowerShell
pst	MS Exchange Address Book File, Outlook Personal Folder File (Microsoft)
reg	Registration entries
scf	Windows Explorer command file
scr	Windows Screen Saver
sct	Windows Script Component, Foxpro Screen (Microsoft)
shb	Windows Shortcut into a Document
shs	Shell Scrap Object File
shtm	HTML file that contains server-side directives
shtml	HTML file that contains server-side directives
soap	Simple Object Access Protocol file
stm	HTML file that contains server-side directives
svc	Windows Communication Foundation (WCF) service file
sys	Real mode device driver
tmp	Temporary File/Folder
url	Internet Location
vb	VBScript File or Any Visual Basic Source
vbe	VBScript Encoded Script File
vbs	VBScript Script File, Visual Basic for Applications Script
vbscript	VBScript Script File, Visual Basic for Applications Script
vxd	Virtual document exchange
vscript	VBScript Script File, Visual Basic for Applications Script
vsix	Visual Studio Extension
vsmacros	Visual Studio .NET Binary-based Macro Project (Microsoft)
vsw	Visio Workspace File (Microsoft)
ws	Windows Script File
wsc	Windows Script Component
wsf	Windows Script File
wsh	Windows Script Host Settings File
xamlx	Visual Studio Workflow service file
xnk	Exchange Public Folder Shortcut

Rule integration

Rules can be used to set file types and sizes at runtime such as the Set a control’s properties rule action. See the Control and Form Properties Actions topic for more detail.

Considerations

• The global maximum File and Image size that can be attached is dictated by the following setting in the Web.config file in the system.web section.

  <httpRuntime maxRequestLength="16384" />

  When creating a Form that consists of many Views and multiple States the Form rules might not be visible after adding an additional State. This occurs when the Form definition increases and exceeds the Maximum Request Length specified in the Web.config. The maxRequestLength can be edited to enlarge the size of the Form definition. The default maximum value is set as 16384 KB (kilobyte) which is an integer value and can be changed to the required value in kilobytes. See the following link for more details about the maxRequestLength setting: https://msdn.microsoft.com/en-us/library/system.web.configuration.httpruntimesection.maxrequestlength(v=vs.110).aspx
  The Web.config file is found in the following locations:
  <install drive>:\Program Files (x86)\K2 blackpearl\K2 smartforms Designer
  <install drive>:\Program Files (x86)\K2 blackpearl\K2 smartforms Runtime
  

• The runtime maxRequestLength setting in the Web.config file overrides the MaxSize setting in the Web.config file and the Max Size control property setting.

• requestFiltering is a feature that can be configured in Internet Information Services (IIS).

  <system.webServer>

  <security>

  <requestFiltering>

  <requestLimits maxAllowedContentLength="1073741824"></requestLimits>

  </requestFiltering>

  </security>

  </system.webServer>

  See the following link for more detail: https://www.iis.net/configreference/system.webserver/security/requestfiltering/requestlimits

  If this setting is enabled on your environment, it is important to note that the minimum value of the maxRequestLength setting, the requestFiltering setting and the MaxSize setting will limit the attachments upload.

• Restricted file types are listed in the Blacklist.
• The Blacklist overrides the file types configured in the Allowed Types property. If a file should be allowed and is configured in the Allowed Types control property, the file type should also be removed from the Blacklist if listed there.
• Blacklist files with no extension by adding two commas in the blacklist with or without spaces, for example:
  
  
  

Backwards Compatibility

Beginning with K2 smartforms 4.6.11, previously allowed files may now not be allowed due to the inclusion of the Blacklist feature. To update the Blacklist to include or remove certain files, see the Web.config entries section of this topic. Change the Web.config file to exclude those files you want to upload and include files that should be restricted. Following is a list of Blacklist files restricted prior to K2 smartforms 4.6.11. This restriction was not previously configurable.

cpl, vxd, cmd, pif, com, msi, scr, ps, wsh, ocx, dll, bat, exe, vbs, vbe,.vb, aspx, vbscript, vscript, javascript, jscript, js.

When selecting the Controls tab in the Toolbox menu of a View or Form, a list of controls are displayed which can be used to design the View. Controls are supported differently per drop zone and type of View.
When a control is dragged from the Toolbox of a View from an existing field, it is bound to that SmartObject property (field). When using the same control more than once on a View, all of those controls stay bound to that field unless you specifically unbind the control. Controls can be unbound by selecting the control and clicking on the Unbind button in the canvas Toolbar. When one of the controls bound to the field is updated, all of the related controls linked to that field will be updated as well.
If a control is dragged from the Toolbox of a View into a blank drop zone such as the View toolbar or control bar, the control is unbound.

Item View

• Bound controls are supported in all drop zones of the View
• Unbound controls are supported in all drop zones of the Views

List View

• Bound controls are supported in the body section and  will return the values as text, with some capabilities to reflect file, image and hyperlink properties in their respective manners. The main supported controls in the body section are the Data Label and List Display controls, the latter showing associated data.
• Unbound control - only the Data Label is supported on the display template (body) and can be used to display a default value 

Editable List View

• Bound controls are supported in all drop zones of the View. The Add/Edit Item row supports all types of controls, while the body section supports the same controls as per the List View (see above).
• Unbound control - only the Data Label is supported and can be used to display a default value

Using the Data Label control to display a default value

To use the Data Label control to display a default value on the List View or Editable List View, follow the steps below:

1. Drag the Data Label control from the Toolbox onto the column.
2. Type the default value in the Text field of the control properties.
   

3.  The Data Label control will be blank when adding a new entry as the default will apply as soon as the entry is saved or a refresh is done.

   

The following matrix shows the properties applicable to each control and the properties that are common to all Controls. To apply formatting and styling on a control, see the Style Builder. Each control can have it's own format and style such as applying percentage or decimal formatting on a control for example.

Control Properties Matrix.pdf

Important Considerations when using Controls and Properties

When a control is dragged from the Toolbox of a View, it is bound to that SmartObject property. When using the same control more than once on a View, all of those controls stay bound to that property unless you specifically unbind the control. Controls can be unbound by selecting the control and clicking on the Unbind button in the canvas Toolbar. When one of the controls bound to the property is updated, all of the related controls linked to that property will be updated as well.
It is therefore important to note that when using the dependent dropdown scenario on a List View for example, one needs to unbind the parent controls from the foreign keys that were originally dragged upon the canvas. When one dropdown changes, it applies the change to the next control, which is bound to the same field, and will attempt to update all the related controls. This will cause a repeating cycle of events.
This is also applicable if a foreign key value is transferred from the one dropdown to the other as the primary key value. When the ID's stop matching, this will seem as if the wrong data is returned to the user or unexpected behavior may occur.
The last control that is changed and also linked to a property, determines that property’s value. It is imperative to remember that if a control is not specifically required to save (or show) a particular property’s value, it should not be bound to that property.