# Arrangementer 2 av 4 støttet Kilde: https://plasapi.com/no/funksjoner/library-and-content/events/ La lånerne finne bibliotekets arrangementer og se når og hvor de foregår, og hvordan man kommer med. ## 3.2.1 Se arrangement — Støttet Vis et arrangement med tid, sted, adgang og relatert materiale. ### Dette kan du bygge En arrangementsside som forteller låneren om arrangementet er noe for dem: når og hvor det er, hva det koster, og hvordan man kommer med. Krever det billett eller påmelding, har arrangementet en lenke, en e-post, et telefonnummer eller en veiledning. Siden kan også vise de andre datoene i en serie og verkene som hører til arrangementet. ### Typisk flyt 1. Klienten henter arrangementet med `GetContentEvents` og id-en i `event_ids`. 2. Siden viser tittelen, tiden fra `scheduling`, stedet fra `branch` og `location`, og adgangen fra `admission`. 3. Hører arrangementet til en serie, henter klienten de andre arrangementene med `GetContentEventsInSeries` og `series.seriesId`. 4. Relaterte verk kommer fra `GetWorks` når `relevantWorks` har `workIds`, eller fra `SearchWorks` når det angir en `query`. 5. Låneren åpner et verk (1.2.1) eller et annet arrangement i serien. ### Dette leverer API-et - `state` er `scheduled`, `cancelled` eller `finished`. - `scheduling` er `all_day` med `startDate` og `endDate`, eller `time_span` med `startTime` og `endTime`. - `location` er `at_branch`, et sted inne på filialen, eller `external` med et `name` og en valgfri `address`. - `admission` er `open`, `ticket` eller `registration`. Billett og påmelding har `contactInfo` med minst ett av `url`, `email`, `phone` eller `info`, og en `state`: `ticket_sale_not_open`, `ticket_sale_open`, `almost_sold_out` eller `sold_out`. - En billett har `pricing`: `simple` med en tekst, eller `price_categories` med et `amount` i minste myntenhet og en `currency` i ISO 4217. Et `amount` på 0 betyr at arrangementet er gratis, men billetten kreves fortsatt. - Bare `description` kan ha formatering, og bare med HTML-taggene `b`, `i`, `p`, `a`, `ul`, `ol` og `li`. ### Kall i API-et Slås på i konfigurasjonen: `GetContentConfiguration` Kallene bak visningen - [GET /content/event](https://plasapi.com/no/provider/v0.6.7/content-event/#GetContentEvents) — Get content events - [GET /content/event/series/{seriesId}](https://plasapi.com/no/provider/v0.6.7/content-event/#GetContentEventsInSeries) — Get content events in series - [GET /work](https://plasapi.com/no/provider/v0.6.7/work/#GetWorks) — Get Works - [GET /work/search](https://plasapi.com/no/provider/v0.6.7/work/#SearchWorks) — Search Works ## 3.2.2 Meld på eller få billett — Ikke ennå La låneren melde seg på et arrangement eller få en billett. > Ikke i PLAS ennå. Funksjonen er ikke støttet i dag. Beskrivelsen viser hva den gjør, så du kan se sammenhengen med resten. ## 3.2.5 Bla gjennom arrangementer — Støttet Vis bibliotekets kommende arrangementer for en periode, så lånerne kan finne de som interesserer dem. ### Dette kan du bygge En arrangementskalender som viser bibliotekets arrangementer dag for dag, hvert med tittel, tid, filial og pris. Filtre for filial, kategori og målgruppe bygges av arrangementene selv. ### Typisk flyt 1. Klienten henter arrangementene i en periode med `GetContentEvents`, `from_date` og `to_date`. 2. Klienten blar gjennom resultatet med `page` og `size` til `endOfResults` er sann. 3. Klienten grupperer arrangementene per dag og lar låneren filtrere på `branch`, `categories` og `audiences`. 4. Låneren åpner et arrangement (3.2.1). ### Dette leverer API-et - En forespørsel må ha enten `to_date` eller `event_ids`. Uten `from_date` starter provideren fra i dag i sin egen tidssone. - `size` er høyst 50. `total` er antallet arrangementer i hele perioden. - `GetContentEvents` har ingen parametre for filial, kategori eller målgruppe. Klienten filtrerer på feltene i hvert arrangement. - `promoted` markerer et arrangement som fremhevet, eventuelt mellom en `startTime` og en `endTime`. - Uten `ui_language` returneres hvert arrangement på alle språkene det finnes på. Samme `id` på flere språk er ett arrangement. `GetContentConfiguration` viser hvilke språk provideren støtter. ### Kall i API-et Slås på i konfigurasjonen: `GetContentConfiguration` - [GET /content/event](https://plasapi.com/no/provider/v0.6.7/content-event/#GetContentEvents) — Get content events ## 3.2.6 Interesse for arrangement — Ikke ennå La låneren markere et arrangement de er interessert i. > Ikke i PLAS ennå. Funksjonen er ikke støttet i dag. Beskrivelsen viser hva den gjør, så du kan se sammenhengen med resten.