SAP Developer Challenge - Full-Stack - Project Set-up and Database Modeling (Week 1)

[dinah]

If you have not checked out the initial blog post for this challenge, please do so and get your development environment set up as outlined in the post. 

Task Description 

We are working on creating test(s) for a particular course/subject. We need to have a pool of questions (related to the course/subject) that we can pick from to make up a test. A single test can be associated with several questions, but each question belongs to only one test. Through the relationship between tests and questions, one should be able to access all questions related to a specific test and easily access the specific test to which a question belongs (hint: backlink). 

Additionally, we need to have a right answer for every question and a question can only have one right answer. An answer cannot exist without a question. If a question is deleted, so should the linked answer be deleted. 

We will get started with database modeling using SAP CAP. We delve into the architecture, carefully defining two core entities and an aspect respectively: "Tests," "Questions," and "Answers".  

Tests Entity – serves as a container for organizing different test cycles. Each entry within the Tests entity represents a unique object with attributes such as test ID, title, description, createdAt, createdBy, modifiedAt, modifiedBy and any other vital information relating to tests. A single test can have many questions. This entity allows us to categorize and manage tests efficiently, facilitating easy retrieval and presentation of tests data. 

Questions Entity – serves as a repository for individual questions comprising the intellectual content of our tests. Each entry in the Questions entity comprises attributes such as ID, text, and any other vital information relating to questions. Many questions can be associated with a single test, but each question belongs to only one test (that is, two different tests cannot have the same question). Centralizing questions in this entity allows us to create a cohesive reservoir of knowledge that can be easily linked to a Test instance. 

Answers Aspect– records the correct answer to a particular question. Each record in this aspect corresponds to a correct answer linked to a specific question. Each entry in the Answers aspect comprises attributes such as ID, and text. The separation of answers from questions reinforces data integrity. 

Why an Aspect instead of Entity for the Answers? 

Aspects are well suited for representing data that does not have a distinct identity of their own. In our schema design, the answers cannot exist without a question. For example, if a question record is deleted, we would want an answer associated with it to be deleted as well. Using an aspect in this case allows us to associate answers data directly with questions without creating a separate entity.  

 

Task outline 

Our goal is to perform entity-relationship modeling based on the above entities' description and then populate initial data in csv files to be used in the next tasks. Below is a visual representation providing details (entity properties and data types) to help with the modeling. 

Steps 

1. Model the entities in the db/data-model.cds file. 
2. Declare the remaining entities in srv/cat-service.cds file (The Tests entity has already been declared). 
3. Generate an empty set of initial csv files and then manually populate them with about two or more records of data each. Note: remember the relationships that exist between entities when populating the records. 

 

Resources 

Here are some resources to guide you through this task: 

CDS Command line Interface tools 

Domain modeling 

Compositions vs. Associations 

Modeling to many associations 

Modeling services in CDS 

Providing Initial Data 

 

Task checklist 

Run the application (cds watch). Note that the initial errors displayed in the terminal after our development environment setup should have disappeared.   

Click on the URL that the server is listening on to access the page displayed below: 

Under Service Endpoints, click on $metadata and post a screenshot into this discussion thread. Collapse other sections and focus on the <EntityType Name=”...”> tags as shown below.  

[vladimirs_semikins]

[dinah]

Check your Tests entity, there is a tiny piece missing in your model (The attribute Partner in your <NavigationProperty Name="questions">). Hint: backlink

[vladimirs_semikins]

Thanks! fixed 🙂 

btw used ChatGTP to generate some dummy data 

[harsh_itaverma]

[nicoschoenteich]

 

[qmacro]

[SandipAgarwalla]

[thomas_jung]

[ravishgarg]

[abdullahgunes]

[yasmeenhs]

[EvandroFerreira]

[dinah]

Some pieces are not accurately represented in your model. Check on the relationships between the entities and note that Answers in not an independent entity but an Aspect that exists in the context of a Questions entity.

[nex]

[Ruthiel]

[dinah]

There's a tiny piece missing in your model in the Tests entity - (The attribute Partner in your <NavigationProperty Name="questions">). Hint: backlink

[Ruthiel]

Thanks for the tip @dinah :

[Erdaleser]

[swanandl]

<EntityType Name="Tests">
<Key>
<PropertyRef Name="ID"/>
<PropertyRef Name="IsActiveEntity"/>
</Key>
<Property Name="ID" Type="Edm.Guid" Nullable="false"/>
<Property Name="createdAt" Type="Edm.DateTimeOffset"/>
<Property Name="createdBy" Type="Edm.String" MaxLength="256"/>
<Property Name="modifiedAt" Type="Edm.DateTimeOffset"/>
<Property Name="modifiedBy" Type="Edm.String" MaxLength="256"/>
<Property Name="title" Type="Edm.String" MaxLength="255"/>
<Property Name="description" Type="Edm.String" MaxLength="100"/>
<NavigationProperty Name="questions" Type="Collection(DevChallengeService.Questions)" Partner="test"/>
<Property Name="IsActiveEntity" Type="Edm.Boolean" Nullable="false" DefaultValue="true"/>
<Property Name="HasActiveEntity" Type="Edm.Boolean" Nullable="false" DefaultValue="false"/>
<Property Name="HasDraftEntity" Type="Edm.Boolean" Nullable="false" DefaultValue="false"/>
<NavigationProperty Name="DraftAdministrativeData" Type="DevChallengeService.DraftAdministrativeData" ContainsTarget="true"/>
<NavigationProperty Name="SiblingEntity" Type="DevChallengeService.Tests"/>
</EntityType>
<EntityType Name="Questions">
<Key>
<PropertyRef Name="ID"/>
</Key>
<Property Name="ID" Type="Edm.Guid" Nullable="false"/>
<Property Name="text" Type="Edm.String" MaxLength="255" Nullable="false"/>
<NavigationProperty Name="answer" Type="DevChallengeService.Questions_answer" Partner="up_">
<OnDelete Action="Cascade"/>
<ReferentialConstraint Property="ID" ReferencedProperty="up__ID"/>
</NavigationProperty>
<NavigationProperty Name="test" Type="DevChallengeService.Tests" Partner="questions">
<ReferentialConstraint Property="test_ID" ReferencedProperty="ID"/>
</NavigationProperty>
<Property Name="test_ID" Type="Edm.Guid"/>
</EntityType>
<EntityType Name="DraftAdministrativeData">
<Key>
<PropertyRef Name="DraftUUID"/>
</Key>
<Property Name="DraftUUID" Type="Edm.Guid" Nullable="false"/>
<Property Name="CreationDateTime" Type="Edm.DateTimeOffset" Precision="7"/>
<Property Name="CreatedByUser" Type="Edm.String" MaxLength="256"/>
<Property Name="DraftIsCreatedByMe" Type="Edm.Boolean"/>
<Property Name="LastChangeDateTime" Type="Edm.DateTimeOffset" Precision="7"/>
<Property Name="LastChangedByUser" Type="Edm.String" MaxLength="256"/>
<Property Name="InProcessByUser" Type="Edm.String" MaxLength="256"/>
<Property Name="DraftIsProcessedByMe" Type="Edm.Boolean"/>
</EntityType>
<EntityType Name="Questions_answer">
<Key>
<PropertyRef Name="up__ID"/>
<PropertyRef Name="ID"/>
</Key>
<NavigationProperty Name="up_" Type="DevChallengeService.Questions" Nullable="false" Partner="answer">
...
</NavigationProperty>
<Property Name="up__ID" Type="Edm.Guid" Nullable="false"/>
<Property Name="ID" Type="Edm.Guid" Nullable="false"/>
<Property Name="text" Type="Edm.String" MaxLength="255"/>
</EntityType>

[stickman_0x00]

[dinah]

There is a tiny piece missing in your model in the Tests entity - (The attribute Partner in your <NavigationProperty Name="questions">). Hint: backlink

[stickman_0x00]

So thats why the expand was not working! Thanks for the correction.

[narendran_nv]

[choujiacheng]

[kedarT]

[dinah]

In the Tests entity, there is a tiny piece missing in your model (The attribute Partner in your <NavigationProperty Name="questions">). Hint: backlink

[kedarT]

Hi Dinah,

It is fixed, thanks for the inputs

[Trulov]

[Bharathi_S]

[KathrynK]

[AjayDeshetty]

[kasch-code]

[Nicolas]

[geek]

[BrijeshGandhi]

[NilsJanßen]

[dinah]

A tiny piece missing in your model in the Tests entity - (The attribute Partner in your <NavigationProperty Name="questions">). Hint: backlink

[NilsJanßen]

Thank you for pointing this out:

[ruben_alvarez]