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} )

Where:

• {RowId} is 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. You program code should not rely on specific values for serialized RowIds.  The single exception to this are null serialized RowId values. They always serialize to an empty string.