Skip to content

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. Your program code should not rely on specific values for serialized RowIds. The single exception to this is null serialized RowId values; they always serialize to an empty string.