Contents

Method

Get

ModuleStorage
LibraryCore
Action

Indicate whether a persistent storage table of the specified name is present and return its contents if present.

Parameters

Name (string): The name of the persistent storage table. Maximum length of 128 characters. The first character must be alphanumeric, and the remainder can be alphanumeric, '.' or '_'. Case is not significant.

Return valuesValue (table): Contents of the persistent storage table, which may be empty, either because the table is empty in persistent storage or because the table does not exist.
Example
@found = Storage.Check(Name: "2018.Sept.AdobeUsers");
IF NOT (@found)
    SELECT "Table not found" AS Status;
ELSE
    @table = Storage.Get(Name: "2018.Sept.AdobeUsers");
    IF NOT (@table)
        SELECT "Table is empty" AS Status;
    ELSE
        SELECT "Table retrieved and has content" AS Status;
    ENDIF;
ENDIF;
Platforms
  • Windows
  • Linux
  • MacOS
  • Solaris Intel
  • Solaris Sparc
  • Android
Notes

This method can be used with the SCALE evaluate statement to abandon processing if the persistent storage table is not present.

See User Defined Persistent Storage page for guidance using persistent storage tables.

The following methods existing in the Agent Storage module:

  • Page:
    Storage.Check — Tests the existence of a user defined persistent storage table.
  • Page:
    Storage.Delete — Removes an existing user defined persistent storage table.
  • Page:
    Storage.Get — Indicate whether a persistent storage table of the specified name is present and return its contents if present.
  • Page:
    Storage.GetRemote — Retrieve the requested datum directly from the Platform central repository.
  • Page:
    Storage.List — Enumerates all user-defined persistent storage tables.
  • Page:
    Storage.Set — Set or change the value of the named persistent storage table.