Deze handleiding gebruikt een eenvoudig gegevensmodel als basis om uit te leggen hoe je de REST API kunt gebruiken. Stel dat we bestellingen volgen bij een pizzeria die pizza's bezorgt. Een klant kan een willekeurig aantal bestellingen hebben, en elke bestelling kan een willekeurig aantal pizza's bevatten. De keuze aan pizza's is echter afkomstig van een menu dat hetzelfde is voor alle klanten.
Dit wordt uitgedrukt in het gegevensmodel dat wordt weergegeven in Illustratie 1.
De afgebeelde klant heeft in de loop van de tijd drie bestellingen geplaatst. De eerste twee bestellingen bevatten elk drie verschillende soorten pizza, en de derde bestelling bevat er slechts één. De bestelde pizza's verwijzen naar een lijst met informatie over de pizza's zelf. In het schema worden deze verwijzingen alleen weergegeven voor de eerste bestelling.
Elke klant in de Deployteq CRM heeft een record met bestellingen, maar deze verwijzen allemaal naar dezelfde lijst met pizza's. Het ontwerp dat hierboven is beschreven, wordt weergegeven in het model in Illustratie 2.
Illustratie 2: Data model van de pizzabestellingen
Het model heeft de volgende eigenschappen:
De klantentabel is altijd gedefinieerd en heeft geen kolommen, aangezien de klantgegevens worden opgeslagen in de Deployteq CRM.
Een klant bevat één of meer bestellingen. In dit eenvoudige model heeft een bestelling een afleveradres, een tekstveld voor opmerkingen en een statusvlag die aangeeft of de bestelling is bezorgd of niet.
Een bestelling bevat één of meer bestelde pizza's. Een bestelde pizza slaat het type pizza op, het aantal bestelde pizza's van dit type en een ander tekstveld voor opmerkingen.
Een bestelde pizza zoekt aanvullende informatie over de pizza op via de kolom 'pizza', die eigenlijk een verwijzing naar de pizzatabel bevat.