/ doc / DocFrag / ARCCore.PropertyStreamLineParsed.TryParse / Attribute / Description

Description

Edit keys at this level only

= Generate list of 0x003C(IK key, Type valueType)0x003E together with value from value part.0x000D0x000A0x000D0x000AHas very few fail-scenarios (that is will almost always return TRUE).0x000D0x000ANote that the value itself will not be parsed (it is just returned in -Value- as a 'string?').0x000D0x000A0x000D0x000Athe valueType returned will always be an -IP- type.0x000D0x000A(but null for last key in hierarchy).0x000D0x000A0x000D0x000AThis is the first step in parsing a -PropertyStreamLine-, typically used by more higher level methods like0x000D0x000A-TryParseAndStore-,0x000D0x000A-TryParseDirectToIP-,0x000D0x000A-TryParseDirectToProperty-.0x000D0x000A0x000D0x000ANote that if the value part consists of individual items, like in -WholeCollection-, each of these has to be decoded individually again by the calling method (by calling -Decode-).0x000D0x000A0x000D0x000ADetails: For each key, decide which instance type of -IK- to use, that is, once of -PK-, -IKType-, -IKString- (or -IKLong- if an integer) in prioritized order).0x000D0x000A0x000D0x000AThe following priority is used for deciding -IK--keys:0x000D0x000A1) -PK- if a -PK- is recognized (like FirstName in 'Customer/42/FirstName:', based on a combination of found type 'Customer' and field 'FirstName')0x000D0x000A0x000D0x000A2) -IKType- if a -IP--derived type is recognized.0x000D0x000A(like 'Customer' in 'Customer/42/FirstName:')0x000D0x000A0x000D0x000A3) -IKString- for other cases (-IKLong- if an integer) .0x000D0x000A(like 42 in 'Custome/42/FirstName:'0x000D0x000A0x000D0x000AFor each key, decide what type of value-object to create if no object exists for that key (dedicated type like 'CustomerCollection' or 'Customer' if possible, if not -PRich-)0x000D0x000A0x000D0x000A        For 'Customer/42/FirstName = John', the tuple generated will look like this:0x000D0x000A        (which of the two alternative values are returned (IKType or IKString) depends on the actual type being known to the application (see -AllIPDerivedTypes-).0x000D0x000A        ---------------------------------------------------------------------------------------------------------0x000D0x000A                            key:                                                          valueType0x000D0x000A        Index 0 Customer    IKType(typeof(Customer)) / IKString('Customer')               CustomerCollection, alternatively PRich0x000D0x000A        Index 1 42          IKLong(42) (since integer, else IKString('42'))               Customer / PRich0x000D0x000A        Index 2 FirstName   PK (from CustomerP.FirstName) / IKString('FirstName')         Null. Left to IP to decide at call to SetP.0x000D0x000A0x000D0x000A        For 'Customer/42/PhoneNumber/90534333'  ('strange' syntax is related to -IndividualItems-), 0x000D0x000A        the tuple generated will look like this:0x000D0x000A        (which of the two alternative values are returned (IKType or IKString) depends on the actual type being known to the application (see -AllIPDerivedTypes-).0x000D0x000A        ---------------------------------------------------------------------------------------------------------0x000D0x000A                            key:                                                          valueType0x000D0x000A        Index 0 Customer    IKType(typeof(Customer)) / IKString('Customer')               CustomerCollection, alternatively PRich0x000D0x000A        Index 1 42          IKLong(42) (since integer, else IKString('42'))               Customer / PRich0x000D0x000A        Index 2 PhoneNumber PK (from CustomerP.PhoneNumber) / IKString('PhoneNumber')     Null. Left to IP to decide at call to SetP.0x000D0x000A0x000D0x000ANote that more complex representations like:0x000D0x000A  Customer/42/Car/1/Colour = Red0x000D0x000Ais also understood.0x000D0x000ASo if CustomerP.Car exists then for 'Car' that corresponding PK will be used, while for '1' the type to create will be the the PK's Type.0x000D0x000A0x000D0x000AThe above would be relevant for cardinality -IndividualItems- for CustomerP.Car).0x000D0x000AFor cardinality -HistoryOnly-, as in0x000D0x000A  Customer/42/Car/Colour = Red0x000D0x000Athen for 'Car' the corresponding CustomerP.Car will be used (as above), and for Colour the corresponding PK for CarP.Colour.0x000D0x000A0x000D0x000ASee also -TryParseDtr- which can deserialize whole records.0x000D0x000A

Edit keys at all sub levels.
NOTE: Edits are always additive. Use 'Invalid' in order to delete keys.

Generated 2025-06-18 06:38:13.902 UTC