Utveckling & teknik

Vad vi skall titta på

• Var hittar man info
• Att skapa användare
• Att radera användare
• Exempel på användning hos KB

Var hittar man info

• API-dokumentation hittas på https://dev.folio.org som är uppdelad efter FOLIO-modulerna.
• I FOLIO-wikin https://wiki.folio.org kan man hitta mer info om apierna och mer dokumentation om apierna.
• I FOLIO-slacken så kan man givetvis fråga om allt men även om apier.
• WEB-GUIet för FOLIO är fin källa till att se hur saker och ting går till via utvecklarverktygen i browsern.
• FOLIO-FSE har diverse repos att förkovra sig i. FOLIO-FSE
• Javascript biblioteket för att prata med FOLIO. @indexdata/foliojs

Att skapa användare

Vilken information är obligatorisk

• Efternamn
• Låntagargrupp (id)
• Status
• E-mejl
• Föredragen kontaktväg

Att skapa användare

Bra att ha information

• användarnamn
• externt användarnamn
• streckkod

Vilka steg behövs för att skapa användare.

1. Skaffa api-token med användare som har korrekta rättigheter
2. Patrongroup
3. Skapa en user
4. Skapa Permissions (Enbart i OKAPI-system)
5. Skapa RequestPreference
6. ID-block?
7. Sätt pinkod/lösenord

Skaffa api-token

Posta till /authn/login-with-expiry
där headern innehåller vilken tenant som avses i X-OKAPI-TENANT som

{
    "username":"användarnamn",
    "password":"lösenord"
}

Två cookies med token returneras.

set-cookie: folioAccessToken=xxx; Max-Age=600; Expires=Mon, 18 May 2026 16:07:35 GMT;
Path=/; Secure; HTTPOnly; SameSite=None
set-cookie: folioRefreshToken=yyy; Max-Age=604800; Expires=Mon, 25 May 2026 15:57:35 GMT;
Path=/authn; Secure; HTTPOnly; SameSite=None

och bodyn består av json med expire-tiderna upprepad.

{
    "accessTokenExpiration":"2026-05-18T16:07:35Z",
    "refreshTokenExpiration":"2026-05-25T15:57:35Z"
}

Hitta låntagargrupp

GET /groups

{
  "usergroups": [
    {
      "group": "faculty",
      "desc": "Faculty Member",
      "id": "503a81cd-6c26-400f-b620-14c08943697c",
      "expirationOffsetInDays": 365,
      "metadata": {
        "createdDate": "2026-05-19T01:51:33.022+00:00",
        "updatedDate": "2026-05-19T01:51:33.022+00:00"
      }
    },
    ......

Skapa användaren

POST /users

{
    "username": "string",
    "externalSystemId": "string",
    "active": true,
    "personal": {
        "firstName": "string",
        "lastName": "string",
        "email": "string",
        "preferredContactTypeId": "002"
    },
    "barcode":"string",
    "patronGroup":"GUID"
}

Skapa rättighegter för användaren

Post till /perms/users

{
    "userId": "GUID",
    "permissions": []
}

Skapa beställarpreferens

Post till /request-preference-storage/request-preference

{
    "userId": "GUID",
    "holdShelf": true,
    "delivery": false
}

Skapa ID-block

Post till /manualblocks

{
    "userId": "GUID",
    "type": "Manual",
    "desc": "Nyskapat konto. ID-koll!!",
    "staffInformation": "Info som personal behöver.",
    "patronMessage": "Eventuell info till användaren. Visa ID.",
    "borrowing": true,
    "renewals": false,
    "requests": false
}

Skapa pin/lösenord

Post till /patron-pin med header Accept: text/plain

{
    "id": "GUID",
    "pin": "pin/lösenord"
}

Radera användare

• Kolla om användare har några öppna transaktioner
• Radera användaren

Öppna transaktioner

GET /bl-users/by-id/{Användar id}/open-transactions

{
  "userId": "Användar id",
  "hasOpenTransactions": false,
  "loans": 0,
  "requests": 0,
  "feesFines": 0,
  "proxies": 0,
  "blocks": 0
}

Radera användare

DELETE /bl-users/by-id/{användar id}

Returnerar Status 204 om den lyckades.

Chalmers: Låntagarregistrering

Chalmers: Radering av användare

• 2 gånger per år
• Allmänheten
  • konton äldre än 2 år utan transaktioner inaktiveras
  • Markeras med körningsdatum inför radering
• Studenter och anställda
  • Koll mot Chalmers Persondatabas om de är aktiva
  • Transaktionkoll i FOLIO
  • Inaktiva utan transaktioner raderas
  • Med transaktioner undersöks
  • Görs om till allmänhet med eventuell ny emejl.

KB: Inloggningsflöde

KB: "Ny låntagare"-tjänsten

KB: Migrering från Aleph

Slides och repo

Slides	Repo
https://folio-sweden.github.io/utv-preso-2026/	https://github.com/Folio-Sweden/utv-preso-2026