Read Form History

After login, the form history can be requested for the authenticated subscriber.

The form history is the list of previously opened form records. The display of the history menu is managed here. This function read the list after every login.

Read App Studio Form History

POST AppStudio/ReadFormHistory

This is a POST method which passes both the API and session keys as headers, and a body. If successful, the history menu items can be displayed.

Headers

Name	Value
Content-Type	application/json
SiteKey	API Key
DataServicesKey	Session Key

Body

Name	Type	Description
UserId	Integer	The logged in user ID in their database. See this API.

Response Format/Sample

200

{
  "Success": true,
  "History": [
    {
      "PageName": "Footballer",
      "DisplayString": "Alessia Russo",
      "RecordId": "6863ef8078badf6500137ef6"
    }
  ]
}

400

{
  "error": "Invalid request"
}

UI Display

This example shows the rendered history menu using the data returned from the API.

Menu Display Algorithm

Combine the history menu list with the list of pages in the navigation bar. This allows you to determine which icon to display in the history menu, and indeed which form and record to open when the user clicks on each history menu item.

Example Response JSON

Here is an example of a full form history:

{
    "History": [
        {
            "PageName": "Nationalities",
            "DisplayString": "Nationalities",
            "RecordId": null
        },
        {
            "PageName": "Footballer",
            "DisplayString": "Alessia Russo",
            "RecordId": "6863ef8078badf6500137ef6"
        },
        {
            "PageName": "Nationality",
            "DisplayString": "Algerian",
            "RecordId": "686e910978badf65001445dc"
        },
        {
            "PageName": "Club",
            "DisplayString": "Arsenal",
            "RecordId": "674d85df050c58540003f7d4"
        },
        {
            "PageName": "Clubs",
            "DisplayString": "Clubs/Teams",
            "RecordId": null
        },
        {
            "PageName": "AANew",
            "DisplayString": "Step 1",
            "RecordId": null
        },
        {
            "PageName": "Footballer",
            "DisplayString": "Jack Grealish",
            "RecordId": "674cb1cb050c58540003e20f"
        },
        {
            "PageName": "AppStudioHome",
            "DisplayString": "App Studio",
            "RecordId": null
        },
        {
            "PageName": "UserOptions",
            "DisplayString": "User Options",
            "RecordId": null
        },
        {
            "PageName": "Footballers",
            "DisplayString": "Footballers",
            "RecordId": null
        },
        {
            "PageName": "FootballersGridPaginationTest",
            "DisplayString": "Footballers Pagination",
            "RecordId": null
        },
        {
            "PageName": "Footballer",
            "DisplayString": "Harry Kane",
            "RecordId": "674cb1cb050c58540003e206"
        },
        {
            "PageName": "Footballer",
            "DisplayString": "Son Heung-min",
            "RecordId": "674cb1cb050c58540003e20e"
        },
        {
            "PageName": "Footballer",
            "DisplayString": "Alisson Becker",
            "RecordId": "674cb1cb050c58540003e217"
        },
        {
            "PageName": "Nationality",
            "DisplayString": "Brazilian",
            "RecordId": "67a601f84779de1b00027afc"
        },
        {
            "PageName": "Club",
            "DisplayString": "Newcastle United",
            "RecordId": "674cb652050c58540003e244"
        },
        {
            "PageName": "Footballer",
            "DisplayString": "Bruno Guimarães",
            "RecordId": "674cb1cb050c58540003e213"
        },
        {
            "PageName": "ContactUs",
            "DisplayString": "Contact Us",
            "RecordId": null
        },
        {
            "PageName": "Club",
            "DisplayString": "Sunderland",
            "RecordId": "67f8e47778badf65000521b7"
        },
        {
            "PageName": "Club",
            "DisplayString": "Bayern Munich",
            "RecordId": "681b3c7878badf65000b29c5"
        },
        {
            "PageName": "Footballer",
            "DisplayString": "Rico Henry",
            "RecordId": "686f8f5f78badf6500145993"
        },
        {
            "PageName": "Footballer",
            "DisplayString": "Joachim Christian Andersen",
            "RecordId": "6863f63578badf6500138016"
        },
        {
            "PageName": "Footballer",
            "DisplayString": "Mathias Jensen",
            "RecordId": "686f8f2478badf6500145986"
        },
        {
            "PageName": "Footballer",
            "DisplayString": "Alexander Iwobi",
            "RecordId": "6863f7fc78badf650013805e"
        },
        {
            "PageName": "Footballer",
            "DisplayString": "Leo Hjelde",
            "RecordId": "686f907d78badf65001459aa"
        },
        {
            "PageName": "Footballer",
            "DisplayString": "Dennis Cirkin",
            "RecordId": "6863ecbf78badf6500137e73"
        },
        {
            "PageName": "Footballer",
            "DisplayString": "Jayden Bogle",
            "RecordId": "686f919878badf65001459cd"
        },
        {
            "PageName": "Footballer",
            "DisplayString": "Pascal Struijk",
            "RecordId": "686f9e5778badf6500145a7f"
        },
        {
            "PageName": "Footballer",
            "DisplayString": "Ethan Ampadu",
            "RecordId": "686f9ea978badf6500145a8c"
        },
        {
            "PageName": "Footballer",
            "DisplayString": "Karl Darlow",
            "RecordId": "686f915878badf65001459c2"
        },
        {
            "PageName": "Footballer",
            "DisplayString": "Patrick Roberts",
            "RecordId": "686f902278badf65001459a0"
        },
        {
            "PageName": "Footballer",
            "DisplayString": "Footballer",
            "RecordId": null
        }
    ],
    "Success": true,
    "ErrorMessage": null
}