DeSerializeRowId

See Also: RowId, RowId Helper Functions

Purpose

To deserialize a serialized RowId string back into a RowId data type

Return Type

RowId

Syntax

DeserializeRowId( {sRowId} )

Where:

• {sRowId} is a value of type String

Example

Procedure RefindFromWebPage

    String  sRowId

    RowId   riCustomer

    Boolean bFound

    Get SerializedRowIdFromPage to sRowid

    Move (DeserializeRowId(sRowId)) to riCustomer

    Move (FindByRowId(Customer.File_Number, riCustomer)) to bFound

End_Procedure

Notes

• DeserializeRowId converts a previously serialized RowId string back to its native RowId data type. The RowId serialization / deserialization process was created primarily to allow RowId to be represented over HTTP in web pages and web services.

• A serialized RowId string is created by using the SerializeRowId 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.