Skip to content

SerializeRowId

See Also: RowId, RowId Helper Functions

Purpose

Serializes a RowId so it can be represented as a String.

Return Type

String

Syntax

SerializeRowId({RowId})

Parameters

  • {RowId}: A value of type RowId.

Example

Procedure StoreSerializedId
    String sRowId
    RowId riCustomer
    Move (GetRowId(Customer.File_Number)) to riCustomer
    Move (SerializeRowId(riCustomer)) to sRowId
    Send StoreIDInMyWebPage sRowId
End_Procedure

Notes

  • SerializeRowId converts data of type RowId to a serialized string. This was created primarily to allow RowId to be represented over HTTP in web pages and web services.

  • A serialized RowId string can be moved back into a RowId variable using the DeserializeRowId function.

  • RowId variables cannot be cast into any other variable type. This serialization/deserialization process represents the only way RowId data can be moved to another type.

  • The rules for serialization and deserialization are private. Therefore, a serialized RowId has no meaningful value. Your program code should not rely on specific values for serialized RowIds. The single exception to this is null serialized RowId values, which always serialize to an empty string.