Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Reverted from v. 40

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

Use the stream attributes properties tab to specify the characteristics of the the data in a table column.  

This setting is not available from the repository browser. It opens from:

  • the Stream properties → Attributes table
  • other attribute lists. 

Stream Attribute Properties

...

Basic Settings

...

  • String for text strings 
  • Bigstring for text
  • Integer for text
  • Float for text
  • Decimal for text
  • Date for text
  • Datetime for text
  • Graphic for text
  • TrueFalse for text

...

Length

...

This field is available when Type is String. Enter the maximum number of characters allowed in text data. For unlimited text strings, set a Type of  Bigstring

...

For example, to specify numbers must have two digits before and after the decimal point, such as 12.34, enter:

Significant Figures  4

Decimal Places  2

...

This field is available when Type is Decimal. Enter the maximum number of digits allowed after the decimal point.

This must be less than the number of significant figures.

...

The order of the attributes in the stream. Stream attribute expressions are evaluated in this order. 

This is important when you need to use the results of a calculation in another attribute:

  • either in its expression
  • or in a $ variable 

In the attribute list, the attribute that calculates the result must come before the attribute that requires the result.

...

Advanced

...

To improve performance, index an attribute when the stream has a large data set and an output pipe from the stream uses this attribute to:

  • filter the stream data
  • sort or group the stream data.

...

Note
This option affects the behaviour of filters for PhixFlow instances running on Oracle or MariaDB (MySQL) databases.
For PhixFlow instances running on a SQL Server database, filters are always case-independent.

...

Enter an expression to be evaluated for each stream item (data record) in the stream. The expression can

  • either use the value of this attribute
  •  or calculate a different value

Once calculated, the cache key value persists throughout subsequent stream calculation, rather than being created from scratch for each stream item as normal. This allows you to keep track of the calculation as it progresses.

This means you can use a "persistent" attribute value in other expressions. 

CHECK THIS

Access Permissions

...

to do

...

If you load data without specifying a type what happens?

Does PhixFlow make a best guess at what the type is and if it's not sure, assumes string??

All stream attributes have a type. The default is String. 

What if you want to change a format - e.g set a decimal or date format?

Once the stream has data the attribute type can only be changed if the database allows the change. This is database dependent and you will see an error if your change is not allowed. If the stream has no data then any change in attribute type is possible.

Which fields can have "null"?

String

Apply a string type to sequences of characters (i.e., letters, numerals, symbols and punctuation marks). By default string attribute types have a fixed length of 50. The minimum length is 1 and the maximum length is 4000.

do we need to tell users about any information-loss if data that is naturally a different type gets loaded as a string?

...

Apply a bigstring type to text strings over 4000 characters long. Bigstring is a different data type to string and has some restrictions on filtering, sorting and aggregation.

For PhixFlow instances that use an Oracle database, bigstrings cannot be sorted or aggregated. On Oracle bigstrings may only be filtered with the conditions:

  • (not) contains
  • is (not) null
  • (not) starts with
  • (not) ends with.

The maximum bigstring size can be configured in System Configuration → System Tuning → Maximum Bigstring Size.

Integer

Apply an integer type to whole numbers (not a fractions or decimals) that can be positive, negative, or zero. 

What happens if you attempt to load a float or decimal number into an integer attribute? If you store a number with decimal places as an integer it will be truncated.

Integer has a precision which is the maximum number of digits. The default is 10. The minimum is 1 and maximum is 38.

Float

Apply a float type to non-integer numbers with an undefined level of precision.

...

Apply a decimal type to non-integer numbers with a set level of precision. Decimals have a specific number of:

  • significant figures: the total number of digits stored, 
  • decimal places: the number of digits after the decimal place.

The maximum number of integer digits is therefore the significant figure minus the decimal places. By default, decimals have 10 significant figures and 2 decimal places, and therefore 8 integer digits.

If the number of integer digits present in a decimal field exceeds the specified format, running analysis will fail and PhixFlow will report an error.

If the number of decimal digits present in a decimal field exceeds the specified format, PhixFlow will round to the required precision. For example, if a data record includes the number 12.3456, but the decimal type can have 4 significant figures and 2 decimal places, PhixFlow records 12.35.

Note

Ensure your decimal type has the number of decimal places you need for your data. Once the data is loaded into PhixFlow, you will not be able to recover excess decimal places.

Date

Apply a date type to representations of a calendar day.

Are there any specific formats to say are recognised/not recognised?

What about word formats e.g. Tuesday the fourteenth of February? Words are not recognised except three letter month abbreviations eg 14 Feb 2019 is accepted.

"yyyyMMdd",
"dd/MM/yy",
"dd MM yy",
"dd-MM-yy",
"MM/dd/yy",
"MM dd yy",
"MM d yy",
"MM-dd-yy"

"dd/MMM/yy",
"dd-MMM-yy",
"dd MMM yy",
"MMM/dd/yy",
"MMM-dd-yy",
"MMM dd yy",
"MMM d yy"

"dd/MM/yyyy",
"dd-MM-yyyy",
"dd MM yyyy",
"MM/dd/yyyy",
"MM-dd-yyyy",
"MM dd yyyy",
"MM d yyyy"

"dd-MMM-yyyy",
"dd/MMM/yyyy",
"dd MMM yyyy",
"MMM/dd/yyyy",
"MMM-dd-yyyy",
"MMM dd yyyy",
"MMM d yyyy"

Datetime

Apply a datetime type to representations of a time, or day and time.

Are there any specific formats to say are recognised/not recognised?

Same formats as for date but with HH:mm:ss on the end.

"yyyyMMdd.HHmmss"

"dd/MM/yy HH:mm:ss",
"dd-MM-yy HH:mm:ss",
"dd MM yy HH:mm:ss",
"MM/dd/yy HH:mm:ss",
"MM-dd-yy HH:mm:ss",
"MM dd yy HH:mm:ss",
"MM d yy HH:mm:ss"

"dd/MMM/yy HH:mm:ss",
"dd-MMM-yy HH:mm:ss",
"dd MMM yy HH:mm:ss",
"MMM/dd/yy HH:mm:ss",
"MMM-dd-yy HH:mm:ss",
"MMM dd yy HH:mm:ss",
"MMM d yy HH:mm:ss"

"dd/MM/yyyy HH:mm:ss",
"dd-MM-yyyy HH:mm:ss",
"dd MM yyyy HH:mm:ss",
"MM/dd/yyyy HH:mm:ss",
"MM-dd-yyyy HH:mm:ss",
"MM dd yyyy HH:mm:ss",
"MM d yyyy HH:mm:ss"

"dd/MMM/yyyy HH:mm:ss",
"dd-MMM-yyyy HH:mm:ss",
"dd MMM yyyy HH:mm:ss",
"MMM/dd/yyyy HH:mm:ss",
"MMM-dd-yyyy HH:mm:ss",
"MMM dd yyyy HH:mm:ss",
"MMM d yyyy HH:mm:ss"

Graphic

Is this still available?

TrueFalse

Apply a TrueFalse type to fields that can have the values true or false.

What happens if the field is empty? Or has something other than True/False?

...

Insert excerpt
_Banners
_Banners
nameanalysis
nopaneltrue

This page is for data modellers and application designers who need to work with data in tables.

Overview

Use the attributes properties to specify the characteristics of the data in a column.  You can open attribute properties from:

  • the repository. Attributes are listed under their table.
  • the Table properties → Attributes section
  • other attribute lists. 

 

Insert excerpt
_property_toolbar
_property_toolbar
nopaneltrue

Insert excerpt
_property_tabs
_property_tabs
namebasic-h
nopaneltrue

Insert excerpt
_parent
_parent
nopaneltrue

Basic Settings

FieldDescription
Name

Enter the name of the attribute.

Tip

PhixFlow recognises the attribute name UID as a unique identifier for a record. As records are added, PhixFlow automatically increments the UID value.


Type

Select the type of data this attribute contains; see Understanding Data Types.

  • String
  • Bigstring
  • Integer
  • Float
  • Decimal
  • Date
  • Datetime
  • Graphic
  • TrueFalse

Length

This field is available when Type is String. By default strings are 50 characters long. Optionally specify a different string length of between 1 and 4000.

For strings longer than 4000 characters, set a Type of Bigstring

Precision

This field is available when Type is Integer. Enter the maximum number of digits allowed in whole numbers. By default, integers are 10 digits long. Optionally specify a different integer precision of between 1 digit and 38 digits.

Significant FiguresThis field is available when Type is Decimal. Enter the maximum number of total digits for decimal numbers.  By default decimals have 10 significant figures.


Panel
borderColor#01cff1
borderWidth4
titleBGColor#01cff1
titleExample

To specify numbers must have two digits before and after the decimal point, such as 12.34, enter:

Significant Figures  4

Decimal Places  2



Decimal Places

This field is available when Type is Decimal. Enter the maximum number of digits allowed after the decimal point. By default, decimals have 2 decimal places.

This must be less than the number of significant figures.

Local

 

Insert excerpt
_check_box_untick
_check_box_untick
nopaneltrue
 to keep both table data and any result of using it in a calculation. 

Insert excerpt
_check_box_tick
_check_box_tick
nopaneltrue
 if you need to use the attribute in a calculation, but you do not need to keep the result.

Indexed

Insert excerpt
_check_box_untick
_check_box_untick
nopaneltrue
 to prevent this attribute being indexed in the PhixFlow database.

Insert excerpt
_check_box_tick
_check_box_tick
nopaneltrue
 to index this attribute in the PhixFlow database.

To improve performance, index an attribute when the table has a large data set and an output pipe from the table uses this attribute to:

  • filter the data
  • sort or group the data.
Primary Key

Insert excerpt
_check_box_tick
_check_box_tick
nopaneltrue
 indicates this attribute is a primary key. This means it contains a unique identifier for every record in the table. 

Foreign Key
Insert excerpt
_check_box_tick
_check_box_tick
nopaneltrue
 indicates this attribute is a foreign key. This means and ERD links this attribute to a primary key attribute in an other table; see Understanding ERDs.
Display Name
Insert excerpt
_check_box_tick
_check_box_tick
nopaneltrue
 indicates the name of this attribute is used as the label rather than the primary key attribute name.
Order

The order of the attributes in the table. Attribute expressions are evaluated in this order. 

This is important when you need to use the results of a calculation in another attribute:

  • either in its expression
  • or in a $ variable.

In the attribute list, the attribute that calculates the result must come before the attribute that requires the result.

ExpressionThe expression used to generate the attribute value. This is written as and expression; see Expressions and PhixScripts. It must evaluate to a single value, of the type specified in the Type field.

Advanced

FieldDescription
Filter conditions are
case-independent by default

Available when Basic Settings → Type is String or Bigstring.

Insert excerpt
_check_box_untick
_check_box_untick
nopaneltrue
 to use filters that are case-sensitive.

Insert excerpt
_check_box_tick
_check_box_tick
nopaneltrue
 to set new filter conditions on this attribute to be case-insensitive by default. The filter window → Ignore Case check box inherits this setting; see Filters on Data Views. For case-insensitive filters, there is no difference if the attribute is also indexed. 

Note
This option affects the behaviour of filters for PhixFlow instances running on Oracle or MariaDB (MySQL) databases.
For PhixFlow instances running on a SQL Server database, filters are always case-independent.


Key

Insert excerpt
_check_box_untick
_check_box_untick
nopaneltrue
 for in-memory table, to specify that this field is not a key value.

Insert excerpt
_check_box_tick
_check_box_tick
nopaneltrue
 for in-memory table, to specify that this field will be used as a key value. 

Translate Values 
Anchor
translate
translate

Available when Basic Settings → Type is String or Bigstring.

Insert excerpt
_check_box_untick
_check_box_untick
nopaneltrue
 to ignore this attribute when translating text in PhixFlow (the default).

Insert excerpt
_check_box_tick
_check_box_tick
nopaneltrue
 to include this attribute when translating text that appears in PhixFlow. To be translated, the attribute text must be included in a translation table; see Translating an Application Interface and Translation Table.

Cache Key

Enter an expression to be evaluated for each record in the table . The expression can:

  • either use the value of this attribute
  •  or calculate a different value

Once calculated, the cache key value persists throughout subsequent calculation, rather than being created from scratch for each record as normal. This allows you to keep track of the calculation as it progresses.

This means you can use a "persistent" attribute value in other expressions. 

Insert excerpt
_description
_description
nopaneltrue

Insert excerpt
_access
_access
nopaneltrue

Insert excerpt
_audit
_audit
nopaneltrue

Live Search
spaceKey@self
additionalnone
placeholderSearch all help pages
typepage

Panel
borderColor#00374F
titleColorwhite
titleBGColor#00374F
borderStylesolid
titleSections on this page

Table of Contents
maxLevel3
indent12px
stylenone

Learn More


Insert excerpt
_terms_changing
_terms_changing
nopaneltrue