# Vragensets

## Overzichtstabel termen

|                           |                                                                                                                                                                                                                                            |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| code                      | De code van de vragenset                                                                                                                                                                                                                   |
| description               | Omschrijving van de vragenset                                                                                                                                                                                                              |
| name                      | Naam van de vragenset                                                                                                                                                                                                                      |
| questions                 | Een lijst met vragen die aan de vragensets gekoppeld zijn                                                                                                                                                                                  |
| status                    | De huidige status van de vragenset. ongoing = actief, draft = concept                                                                                                                                                                      |
| lockedBy                  | De huidige vragenset is **gelocked** door de aangegeven gebruiker. Het is dan niet meer mogelijk om de vragenset te bewerken door andere gebruikers.                                                                                       |
| organisationObject        | De organisatie die de eigenaar is van de vragenset                                                                                                                                                                                         |
| evaluationCount           | Het totaal aantal evaluaties wat gekoppeld is aan de vragenset, ongeacht de huidige organisatie/opleiding                                                                                                                                  |
| evaluationCountCurrentOrg | Het totaal aantal evaluaties wat gekoppeld is aan de vragenset binnen de huidige organisatie/opleiding                                                                                                                                     |
| createdByObject           | De gebruiker die de vragenset heeft aangemaakt                                                                                                                                                                                             |
| questionCount             | Het totaal aantal vragen binnen een vragenset                                                                                                                                                                                              |
| routing                   | Het is mogelijk om routering toe te passen voor een vragenset. Bij een bepaald antwoord op een vraag kan je dan extra vragen stellen of vragen overslaan. Als een vragenset routering gebruikt staat hierbinnen de routering gedefinieerd. |

## Vragensets ophalen (lijst)

<mark style="color:blue;">`GET`</mark> `https://api-portal.evalytics.nl/questionSet`

#### Query Parameters

| Name                   | Type    | Description                                                                                   |
| ---------------------- | ------- | --------------------------------------------------------------------------------------------- |
| q                      | string  | Zoek op vragensets (naam, omschrijving, code)                                                 |
| questionTypes          | array   | Filter op vraag type (1=cursus, 2=docent, 7=toets)                                            |
| countLinkedEvaluations | boolean | Voegt aan alle vragensets het totaal aantal evaluaties toe die gebruik maken van de vragenset |
| countQuestions         | boolean | Voegt aan alle vragensets het totaal aantal vragen toe                                        |
| hasRouting             | boolean | Filter op vragensets met vraag routering                                                      |

{% tabs %}
{% tab title="200 " %}

```
{
  "metadata": {
    "timestamp": "2021-06-22T11:21:11.409Z",
    "resultSet": {
      "count": 1
    }
  },
  "results": [
    {
      "deleted": 0,
      "createdBy": "bootstrap",
      "modifiedBy": null,
      "archived": 0,
      "status": "ongoing",
      "code": "XAMHUBXF",
      "name": "Verdieping 'Toets'",
      "description": "Deze verdiepende toetsvragen kunnen aanvullende context bieden op de toetsvragen gesteld in de standaard vragenset.",
      "isPreselection": 0,
      "routing": null,
      "lockedBy": null,
      "organisation": 418,
      "topOrganisation": 418,
      "id": 376,
      "createdAt": "2020-04-12T19:12:43.000Z",
      "updatedAt": "2020-04-12T19:12:43.000Z",
      "createdByObject": {
        "id": "3",
        "name": "Evalytics"
      },
      "organisationObject": {
        "id": 123,
        "name": "Example school"
      },
      "questionCount": 2,
      "evaluationCount": 0,
      "evaluationCountCurrentOrg": 0
    }
  ]
}
```

{% endtab %}
{% endtabs %}

## Vragenset ophalen (item)

<mark style="color:blue;">`GET`</mark> `https://api-portal.evalytics.nl/questionSet/:id`

#### Path Parameters

| Name | Type   | Description                 |
| ---- | ------ | --------------------------- |
| id   | string | Interne id van de vragenset |

#### Query Parameters

| Name                     | Type    | Description                               |
| ------------------------ | ------- | ----------------------------------------- |
| populateWithLockedByUser | boolean | Voegt toe wie de vragenset gelocked heeft |

{% tabs %}
{% tab title="200 " %}

```
{
  "lockedBy": null,
  "organisation": 418,
  "topOrganisation": 418,
  "deleted": false,
  "createdBy": "bootstrap",
  "modifiedBy": null,
  "archived": false,
  "status": "ongoing",
  "code": "XAMHUBXF",
  "name": "Verdieping 'Toets'",
  "description": "Deze verdiepende toetsvragen kunnen aanvullende context bieden op de toetsvragen gesteld in de standaard vragenset.",
  "isPreselection": false,
  "routing": null,
  "id": 376,
  "createdAt": "2020-04-12T19:12:43.000Z",
  "updatedAt": "2020-04-12T19:12:43.000Z",
  "questions": []
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.evalytics.nl/onderdelen/vragensets.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.