# Mine lister

6 af 6 understøttet
Kilde: https://plasapi.com/da/funktioner/patron/my-lists/

Lad lånerne gemme materiale til senere i deres egne lister uden at reservere det.

## 2.6.1 Se mine lister — Understøttet

Vis lånerens lister og det materiale der er gemt i hver af dem.

### Det kan du bygge

En liste gemmer materiale til senere uden at reservere det, så låneren kan reservere eller låne det når det passer. Listerne ligger i bibliotekssystemet, så lister låneren har oprettet andre steder, kommer også med.

### Typisk flow

1. Klienten henter lånerens lister med `GetPatronLists`.
2. Låneren åbner en liste. Klienten henter dens elementer med `GetPatronListAndItems`.
3. Hvert element peger på et værk og den udgave låneren gemte. Klienten henter det der skal vises, med `GetWorks`.
4. Åbner låneren et element, vises værket med den gemte udgave (1.2.1).

### Det leverer API'et

- `default` er id'et på standardlisten. Bruger en klient kun én liste, anbefaler specifikationen den, og klienten kan oprette den hvis den ikke findes.
- Et element har `type` `workAndPublication` med et `workId` og et `publicationId`.

### Kald i API'et

Forudsætter: 2.2.1

I denne rækkefølge

1. [GET /patron/{patronId}/list](https://plasapi.com/da/provider/v0.6.7/patron-list/#GetPatronLists) — Get all patron lists
2. [GET /patron/{patronId}/list/{listId}](https://plasapi.com/da/provider/v0.6.7/patron-list/#GetPatronListAndItems) — Get patron list and items
3. [GET /work](https://plasapi.com/da/provider/v0.6.7/work/#GetWorks) — Get Works

## 2.6.2 Fjern fra mine lister — Understøttet

Fjern materiale låneren ikke længere vil gemme, fra en liste.

### Typisk flow

1. Låneren vælger et eller flere elementer i en liste.
2. Klienten kalder `DeletePatronListItem` for hvert element.

### Det leverer API'et

- Kaldet fjerner ét element, angivet ved listens `listId` og elementets `itemId`.

### Kald i API'et

Forudsætter: 2.2.1

- [DELETE /patron/{patronId}/list/{listId}/item/{itemId}](https://plasapi.com/da/provider/v0.6.7/patron-list/#DeletePatronListItem) — Delete item from a patron list

## 2.6.3 Flyt mellem lister — Understøttet

Flyt materiale fra en af lånerens lister til en anden.

### Det kan du bygge

Låneren omorganiserer det gemte materiale og kan oprette mållisten undervejs (2.6.4).

### Typisk flow

1. Låneren vælger et eller flere elementer og en målliste.
2. Klienten tilføjer hvert element til mållisten med `InsertItemToPatronList`.
3. Lykkes det, fjerner klienten elementet fra den oprindelige liste med `DeletePatronListItem`.

### Det leverer API'et

- Specifikationen har ingen operation der flytter et element mellem lister. `MovePatronListItem` ændrer kun et elements plads i én liste.
- Hvert element kræver to kald. Mislykkes fjernelsen, står elementet i begge lister.

### Kald i API'et

Forudsætter: 2.2.1

I denne rækkefølge

1. [POST /patron/{patronId}/list/{listId}](https://plasapi.com/da/provider/v0.6.7/patron-list/#InsertItemToPatronList) — Insert an item to a patron list
2. [DELETE /patron/{patronId}/list/{listId}/item/{itemId}](https://plasapi.com/da/provider/v0.6.7/patron-list/#DeletePatronListItem) — Delete item from a patron list

## 2.6.4 Opret liste — Understøttet

Opret en ny liste, med materiale tilføjet med det samme hvis låneren vil.

### Det kan du bygge

Lånerne sorterer det de gemmer, i deres egne lister, for eksempel fra værksiden mens de gemmer en titel.

### Typisk flow

1. Låneren giver den nye liste et navn.
2. Klienten opretter den med `CreatePatronList`.
3. Oprettes listen fra et værk, tilføjer klienten materialet med `InsertItemToPatronList`.

### Det leverer API'et

- Klienten sætter listens `id` i forespørgslen. Både `id` og `name` er påkrævet.

### Kald i API'et

Forudsætter: 2.2.1

I denne rækkefølge

1. [POST /patron/{patronId}/list](https://plasapi.com/da/provider/v0.6.7/patron-list/#CreatePatronList) — Create a new patron list
2. [POST /patron/{patronId}/list/{listId}](https://plasapi.com/da/provider/v0.6.7/patron-list/#InsertItemToPatronList) — Insert an item to a patron list

## 2.6.5 Slet liste — Understøttet

Slet en liste låneren ikke længere vil beholde.

### Typisk flow

1. Låneren vælger listen og bekræfter.
2. Klienten kalder `DeletePatronList`.

### Kald i API'et

Forudsætter: 2.2.1

- [DELETE /patron/{patronId}/list/{listId}](https://plasapi.com/da/provider/v0.6.7/patron-list/#DeletePatronList) — Delete patron list

## 2.6.6 Tilføj til mine lister — Understøttet

Gem materiale i en af lånerens lister.

### Det kan du bygge

En gem-knap på værksiden: låneren tilføjer materialet til en eksisterende liste eller en ny (2.6.4) og kan reservere eller låne det senere.

### Typisk flow

1. Klienten henter lånerens lister med `GetPatronLists`.
2. Låneren vælger en liste.
3. Klienten tilføjer elementet med `InsertItemToPatronList`, med det værk og den udgave låneren valgte.

### Det leverer API'et

- Klienten sætter elementets `id` sammen med `workId` og `publicationId`.
- `position` afgør hvor elementet placeres, talt fra 0. Standard er 0, forrest i listen; en position efter slutningen placerer elementet sidst.

### Kald i API'et

Forudsætter: 2.2.1

I denne rækkefølge

1. [GET /patron/{patronId}/list](https://plasapi.com/da/provider/v0.6.7/patron-list/#GetPatronLists) — Get all patron lists
2. [POST /patron/{patronId}/list/{listId}](https://plasapi.com/da/provider/v0.6.7/patron-list/#InsertItemToPatronList) — Insert an item to a patron list
