Codeunit 5505364 M365 Json Dictionary
Codeunit 5505364 M365 Json Dictionary
Methods
ValuesKey
procedure ValuesKey(): Text
Returns a key name used to store the values.
Parameters / Return Value
Returns
Text[]
Return value of type Text.
TypesKey
procedure TypesKey(): Text
Returns a key name used to store the data types.
Parameters / Return Value
Returns
Text[]
Return value of type Text.
GetJsonDictionary
procedure GetJsonDictionary(var returnJsonDictionary: JsonObject; var returnJsonTypeDictionary: JsonObject): Boolean
Returns the current (internal) Json Dictionary and the corresponding type Json Dictionary.
Parameters / Return Value
returnJsonDictionary
JsonObject
JsonObject
returnJsonTypeDictionary
JsonObject
JsonObject
Returns
Boolean
Boolean
GetJsonDictionary
procedure GetJsonDictionary(var returnJsonDictionary: JsonToken; var returnJsonTypeDictionary: JsonToken): Boolean
Returns the current (internal) Json Dictionary and the corresponding type Json Dictionary.
Parameters / Return Value
returnJsonDictionary
JsonToken
JsonToken
returnJsonTypeDictionary
JsonToken
JsonToken
Returns
Boolean
Boolean
GetJsonDictionary
procedure GetJsonDictionary(var returnJsonDictionary: JsonObject): Boolean
Returns the current (internal) Json Dictionary.
Parameters / Return Value
returnJsonDictionary
JsonObject
JsonObject
Returns
Boolean
Boolean
GetJsonDictionary
procedure GetJsonDictionary(var returnJsonDictionary: JsonToken): Boolean
Returns the current (internal) Json Dictionary.
Parameters / Return Value
returnJsonDictionary
JsonToken
JsonToken
Returns
Boolean
Boolean
SetJsonDictionary
procedure SetJsonDictionary(newJsonDictionary: JsonObject; newJsonTypeDictionary: JsonObject; matchTypes: Boolean)
Sets a new (internal) Json Dictionary and the corresponding type Json Dictionary.
Parameters / Return Value
newJsonDictionary
JsonObject
JsonObject
newJsonTypeDictionary
JsonObject
JsonObject
matchTypes
Boolean
Boolean
SetJsonDictionary
procedure SetJsonDictionary(newJsonDictionary: JsonObject)
Sets a new (internal) Json Dictionary.
Parameters / Return Value
newJsonDictionary
JsonObject
JsonObject
Flatten
procedure Flatten(prefix: Text; var toDict: Codeunit "M365 Json Dictionary")
Flattens the (nested) dictionary (containing other dictionaries).
Structures like Key1:Value1 Key2:Dict2 Key1:Value3 Key2:Value4 will be flattened into a simple dictionary, appening the parent key name: Key1:Value1 Key2Key1:Value3 Key2Key2:Value4
This function allows an additional prefix to be added before the name.
Parameters / Return Value
prefix
Text[]
Text
toDict
Codeunit "M365 Json Dictionary"
Codeunit “M365 Json Dictionary”
Flatten
procedure Flatten(var toDict: Codeunit "M365 Json Dictionary")
Flattens the (nested) dictionary (containing other dictionaries).
Structures like Key1:Value1 Key2:Dict2 Key1:Value3 Key2:Value4
will be flattened into a simple dictionary, appening the parent key name: Key1:Value1 Key2Key1:Value3 Key2Key2:Value4
Parameters / Return Value
toDict
Codeunit "M365 Json Dictionary"
Codeunit “M365 Json Dictionary”
Serialize
procedure Serialize(var returnToStream: OutStream; valuesOnly: Boolean): Boolean
Serialize the Json Dictionary to an OutStream.
Parameters / Return Value
returnToStream
OutStream
OutStream
valuesOnly
Boolean
Boolean
Returns
Boolean
Boolean
Serialize
procedure Serialize(var returnToStream: OutStream): Boolean
Serialize the Json Dictionary to an OutStream.
Parameters / Return Value
returnToStream
OutStream
OutStream
Returns
Boolean
Boolean
Serialize
procedure Serialize(var returnText: Text; valuesOnly: Boolean): Boolean
Serialize the Json Dictionary to a text.
Parameters / Return Value
returnText
Text[]
Text
valuesOnly
Boolean
Boolean
Returns
Boolean
Boolean
Serialize
procedure Serialize(var returnText: Text): Boolean
Serialize the Json Dictionary to a text.
Parameters / Return Value
returnText
Text[]
Text
Returns
Boolean
Boolean
Serialize
procedure Serialize(var tempBlob: Codeunit "Temp Blob"; valuesOnly: Boolean): Boolean
Serialize the Json Dictionary to a TempBlob.
Parameters / Return Value
tempBlob
Codeunit "Temp Blob"
Codeunit “Temp Blob”
valuesOnly
Boolean
Boolean
Returns
Boolean
Boolean
Serialize
procedure Serialize(var tempBlob: Codeunit "Temp Blob"): Boolean
Serialize the Json Dictionary to a TempBlob.
Parameters / Return Value
tempBlob
Codeunit "Temp Blob"
Codeunit “Temp Blob”
Returns
Boolean
Boolean
Deserialize
procedure Deserialize(var fromStream: InStream): Boolean
Deserialize a Json Dictionary from an InStream.
Parameters / Return Value
fromStream
InStream
InStream
Returns
Boolean
Boolean
Deserialize
procedure Deserialize(jsonText: Text): Boolean
Deserialize a Json Dictionary from a text.
Parameters / Return Value
jsonText
Text[]
Text
Returns
Boolean
Boolean
Deserialize
procedure Deserialize(var tempBlob: Codeunit "Temp Blob"): Boolean
Deserialize a Json Dictionary from TempBlob.
Parameters / Return Value
tempBlob
Codeunit "Temp Blob"
Codeunit “Temp Blob”
Returns
Boolean
Boolean
Add
procedure Add(dictKey: Text; value: Variant; typeName: Text; force: Boolean): Boolean
Add an entry to the Dictionary and force the data type. Specify force to overwrite existing keys.
Parameters / Return Value
dictKey
Text[]
Text
value
Variant
Variant
typeName
Text[]
Text
force
Boolean
Boolean
Returns
Boolean
Boolean
Add
procedure Add(dictKey: Text; value: Variant; typeName: Text): Boolean
Add an entry to the Dictionary and force the data type.
Parameters / Return Value
dictKey
Text[]
Text
value
Variant
Variant
typeName
Text[]
Text
Returns
Boolean
Boolean
Add
procedure Add(dictKey: Text; value: Variant): Boolean
Add an entry to the Dictionary.
Parameters / Return Value
dictKey
Text[]
Text
value
Variant
Variant
Returns
Boolean
Boolean
AddRange
procedure AddRange(var newDict: Codeunit "M365 Json Dictionary"): Boolean
Add all entries of the passed Dictionary.
Parameters / Return Value
newDict
Codeunit "M365 Json Dictionary"
Codeunit “M365 Json Dictionary”
Returns
Boolean
Boolean
Set
procedure Set(dictKey: Text; value: Variant; typeName: Text): Boolean
Set an entry to the supplied value in the Dictionary.
Parameters / Return Value
dictKey
Text[]
Text
value
Variant
Variant
typeName
Text[]
Text
Returns
Boolean
Boolean
Set
procedure Set(dictKey: Text; value: Variant): Boolean
Set an entry to the supplied value in the Dictionary.
Parameters / Return Value
dictKey
Text[]
Text
value
Variant
Variant
Returns
Boolean
Boolean
Clear
procedure Clear()
Clear the dictionary.
Count
procedure Count(): Integer
Return the number of entries in the Dictionary.
Parameters / Return Value
Returns
Integer
Integer
Keys
procedure Keys(var dictKeys: List of [Text])
Returns the List of keys in the Dictionary.
Parameters / Return Value
dictKeys
List[Text]
List of [Text]
ContainsKey
procedure ContainsKey(dictKey: Text): Boolean
Returns true if the Dictionary contains the key.
Parameters / Return Value
dictKey
Text[]
Text
Returns
Boolean
Boolean
ContainsValue
procedure ContainsValue(value: Variant): Boolean
Returns true if the Dictionary contains the value.
Parameters / Return Value
value
Variant
Variant
Returns
Boolean
Boolean
Remove
procedure Remove(dictKey: Text)
Removes the Dictionary entry corresponding to the passed key.
Parameters / Return Value
dictKey
Text[]
Text
GetJToken
procedure GetJToken(dictKey: Text; var jToken: JsonToken): Boolean
Return the value of the specified key as a JsonToken.
Parameters / Return Value
dictKey
Text[]
Text
jToken
JsonToken
JsonToken
Returns
Boolean
Boolean
GetJToken
procedure GetJToken(dictKey: Text): JsonToken
Return the value of the specified key as a JsonToken.
Parameters / Return Value
dictKey
Text[]
Text
Returns
JsonToken
JsonToken
GetJValue
procedure GetJValue(dictKey: Text): JsonValue
Return the value of the specified key as a JsonValue.
Parameters / Return Value
dictKey
Text[]
Text
Returns
JsonValue
JsonValue
GetTypeObject
procedure GetTypeObject(dictKey: Text; var typeVariant: Variant): Boolean
Returns the type of the specified Dictionary entry.
Parameters / Return Value
dictKey
Text[]
Text
typeVariant
Variant
Variant
Returns
Boolean
Boolean
GetValue
procedure GetValue(dictKey: Text; var value: Variant): Boolean
Returns the variant value of the specified Dictionary entry.
Parameters / Return Value
dictKey
Text[]
Text
value
Variant
Variant
Returns
Boolean
Boolean
GetType
procedure GetType(dictKey: Text): Text
Returns the text type of the specified Dictionary entry.
Parameters / Return Value
dictKey
Text[]
Text
Returns
Text[]
Text
GetValue
procedure GetValue(dictKey: Text; var returnJsonDictionary: Codeunit "M365 Json Dictionary"): Boolean
Returns the Sub-instance of the specified key (as Codeunit).
Parameters / Return Value
dictKey
Text[]
Text
returnJsonDictionary
Codeunit "M365 Json Dictionary"
Codeunit “M365 Json Dictionary”
Returns
Boolean
Boolean
GetDictionary
procedure GetDictionary(dictKey: Text; var returnJsonDictionary: Codeunit "M365 Json Dictionary"): Boolean
Returns the Sub-instance of the specified key (as Codeunit).
Parameters / Return Value
dictKey
Text[]
Text
returnJsonDictionary
Codeunit "M365 Json Dictionary"
Codeunit “M365 Json Dictionary”
Returns
Boolean
Boolean
GetPath
procedure GetPath(dictPath: Text; var returnToken: JsonToken): Boolean
Returns a JsonToken after navigating to the specified path. A path of Config.State.Status refers to Object { “Config”: { “State”: { “Status”: “Running” } } }
Parameters / Return Value
dictPath
Text[]
The path to the value
returnToken
JsonToken
The found token
Returns
Boolean
true, if the path was found, false otherwise.
GetPath
procedure GetPath(dictPath: Text; var value: Variant): Boolean
Returns a variant value after navigating to the specified path. A path of Config.State.Status refers to Object { “Config”: { “State”: { “Status”: “Running” } } }
Parameters / Return Value
dictPath
Text[]
The path to the value
value
Variant
The found value
Returns
Boolean
true, if the path was found, false otherwise.
ToNameValueBuffer
procedure ToNameValueBuffer(var tempToNameValueBuffer: Record "Name/Value Buffer" temporary; keepExisting: Boolean): Boolean
Transfer the contents of this Dictionary to a temporary Name/Value Buffer. Specify keepExisting if you do not want existing records to be deleted.
Parameters / Return Value
tempToNameValueBuffer
Record "Name/Value Buffer"
Record “Name/Value Buffer”
keepExisting
Boolean
Boolean
Returns
Boolean
Boolean
ToNameValueBuffer
procedure ToNameValueBuffer(var tempToNameValueBuffer: Record "Name/Value Buffer" temporary): Boolean
Transfer the contents of this Dictionary to a temporary Name/Value Buffer.
Parameters / Return Value
tempToNameValueBuffer
Record "Name/Value Buffer"
Record “Name/Value Buffer”
Returns
Boolean
Boolean
FromNameValueBuffer
procedure FromNameValueBuffer(var fromNameValueBuffer: Record "Name/Value Buffer"; keepExisting: Boolean): Boolean
Transfer the contents of a (temporary) Name/Value Buffer to this Dictionary. Specify keepExisting if you do not want existing entries to be deleted.
Parameters / Return Value
fromNameValueBuffer
Record "Name/Value Buffer"
Record “Name/Value Buffer”
keepExisting
Boolean
Boolean
Returns
Boolean
Boolean
FromNameValueBuffer
procedure FromNameValueBuffer(var fromNameValueBuffer: Record "Name/Value Buffer"): Boolean
Transfer the contents of a (temporary) Name/Value Buffer to this Dictionary. Specify keepExisting if you do not want existing entries to be deleted.
Parameters / Return Value
fromNameValueBuffer
Record "Name/Value Buffer"
Record “Name/Value Buffer”
Returns
Boolean
Boolean
FromDictionary
procedure FromDictionary(fromDict: Dictionary of [Text, Text]; keepExisting: Boolean): Boolean
Transfer a BC Dictionary of [Text, Text] into this Dictionary. Specify keepExisting to if you want existing entries to be kept.
Parameters / Return Value
fromDict
Dictionary[Text,Text]
Dictionary of [Text, Text]
keepExisting
Boolean
Boolean
Returns
Boolean
Boolean
FromDictionary
procedure FromDictionary(fromDict: Dictionary of [Text, Text]): Boolean
Transfer a BC Dictionary of [Text, Text] into this Dictionary.
Parameters / Return Value
fromDict
Dictionary[Text,Text]
Dictionary of [Text, Text]
Returns
Boolean
Boolean
ToDictionary
procedure ToDictionary(var toDict: Dictionary of [Text, Text]; keepExisting: Boolean): Boolean
Convert this Dictionary to a BC Dictionary of [Text, Text]. Specify keepExisting to if you want existing entries to be kept.
Parameters / Return Value
toDict
Dictionary[Text,Text]
Dictionary of [Text, Text]
keepExisting
Boolean
Boolean
Returns
Boolean
Boolean
ToDictionary
procedure ToDictionary(var toDict: Dictionary of [Text, Text]): Boolean
Convert this Dictionary to a BC Dictionary of [Text, Text].
Parameters / Return Value
toDict
Dictionary[Text,Text]
Dictionary of [Text, Text]
Returns
Boolean
Boolean
Edit
procedure Edit(placeOnName: Text): Boolean
Edit this Json Dictionary. The Record pointer is placed on placeOnName.
Parameters / Return Value
placeOnName
Text[]
Text
Returns
Boolean
Boolean
Edit
procedure Edit(): Boolean
Edit this Json Dictionary.
Parameters / Return Value
Returns
Boolean
Boolean
Show
procedure Show(placeOnName: Text): Boolean
Show this Json Dictionary. The Record pointer is placed on placeOnName.
Parameters / Return Value
placeOnName
Text[]
Text
Returns
Boolean
Boolean
Show
procedure Show(): Boolean
Show this Json Dictionary.
Parameters / Return Value
Returns
Boolean
Boolean
Dump
procedure Dump(template: Text): Text
Dump the contained dictionary keys and values to text in the format provided by template. %1 = dictionary key, %2 = dictionary value.
Parameters / Return Value
template
Text[]
Text
Returns
Text[]
Text
Dump
procedure Dump(): Text
Dump the contained dictionary keys and values to text in the format dictKey = ‘dictValue’ (dataType).
Parameters / Return Value
Returns
Text[]
Text
Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.