---
title: "Ylläpitäjän opas"
description: "Ota Quire-organisaatio käyttöön: henkilöt, roolit, kirjautuminen, brändi-ilme, kielet, sähköposti ja tietueet."
image: "https://docs.quirelms.com/og.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.quirelms.com/fi/llms.txt
> Use this file to discover all available pages before exploring further.

# Ylläpitäjän opas

<span id="administrator-guide"></span>

Kirjaudu ennen aloittamista organisaatioosi ja tarkista, että roolisi sallii tarvitsemiesi asetusten hallinnan. Käytettävissä olevat sivut ja toiminnot määräytyvät sinulle annettujen käyttöoikeuksien mukaan.

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/admin-overview.webp" alt="Site administration overview: the settings grouped into cards for users, courses and appearance, each link with a one line description." width="944" height="700" loading="lazy" decoding="async"><figcaption>Site administration at /admin groups every setting and links to it.</figcaption></figure>

Ylläpidät Quiressa organisaatiota: sen käyttäjiä, kirjautumistapoja, näytettäviä asioita ja säilytettäviä tietoja. Kaikki tämän oppaan sivut löytyvät osoitteesta `/admin`. Kaikki niillä tekemäsi muutokset kirjataan auditointilokiin nimelläsi ja kellonaikoineen.

## Ensimmäiset vaiheet <!--quire:first-steps-->

1. Kirjaudu organisaatiota perustettaessa luodulla ylläpitotilillä ja vaihda sen salasana osoitteessa `/account/security`. Ota samalla käyttöön kaksivaiheinen vahvistus.
2. Määritä organisaation logo, korostusväri, otsikkofontti ja sivustokuvake osoitteessa `/admin/appearance/branding`. Määritä nimi, osoitteet, oletuskieli ja kytkimet osoitteessa `/admin/settings` (katso [organisaation asetukset](/fi/admin/organisation/)). Quire tarkistaa korostusvärin suhteessa sivun taustaan ja säätää sitä, jos tekstistä tulisi vaikealukuista. Voit ladata oman, enintään 200 kt:n WOFF2-otsikkofontin, joka sisältää latinalaiset kirjaimet. Fonttia käytetään vain otsikoissa.
3. Päätä, miten käyttäjät kirjautuvat sisään osoitteessa `/admin/security/auth` (alla).
4. Lisää käyttäjiä osoitteessa `/admin/users` yksitellen tai taulukosta osoitteessa `/admin/users/upload`.
5. Luo ensimmäinen kurssikategoria osoitteessa `/admin/categories` ja lisää sen jälkeen kurssi.

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/admin-branding.webp" alt="The Branding page with an accent colour field, a live preview and a table of contrast checks." width="944" height="760" loading="lazy" decoding="async"><figcaption>Branding previews your colours and checks their contrast before you save.</figcaption></figure>

## Henkilöt ja roolit <!--quire:people-and-roles-->

- **Käyttäjät** (`/admin/users`): hae, suodata tilan mukaan sekä aseta käyttökieltoon ja palauta käyttöön. Käyttökieltoon asettaminen päättää kaikki istunnot heti, mutta henkilön työt ja arvosanat säilyvät.
- **Roolit** (`/admin/roles`): rooli on joukko toiminto-oikeuksia. Aloita sisäänrakennetuista rooleista (organisaation ylläpitäjä, päällikkö, kurssien luoja, opettaja, apuopettaja, oppija ja vieras) ja kopioi rooli muokkausta varten, jotta alkuperäinen säilyy vertailukohtana. Jokaisella sisäänkirjautuneella henkilöllä on myös kaikille kirjautuneille kuuluva rooli. Se sisältää yhteiset oikeudet, kuten haun ja oman oppimissuunnitelman hallinnan. Yksittäisen toiminnon oikeus voi olla määrittämätön, sallittu, estetty tai kielletty. Kieltoa ei voi ohittaa toisella roolilla. Erillinen [organisaation asetus](/fi/admin/organisation/#graded-roles) määrittää, mitkä roolit lasketaan arviointikirjassa oppijoiksi.
- **Kohortit** (`/admin/cohorts`): useita kursseja yhdistäviä ryhmiä, esimerkiksi osasto tai sisäänotto. Kohortin jäsenyys voidaan pitää ajan tasalla profiilikenttiin perustuvalla säännöllä. Kurssi voi ottaa kohortin jäsenet automaattisesti ilmoittautuneiksi, jolloin jäsenet lisätään ja poistetaan ryhmästä heidän tilanteensa muuttuessa.
- **Organisaatiorakenne** (`/admin/org`): osastot ja tehtävänimikkeet, joita käytetään esihenkilöille, raporteissa ja hyväksynnöissä.
- **Profiilikentät** (`/admin/profile-fields`): käyttäjiin lisättäviä tietoja, kuten työntekijänumero. Kenttä voi olla lyhyt tai pitkä teksti, muotoiltu teksti, valikko, kyllä/ei, päivämäärä, numero, verkkosivu tai sosiaalisen median profiili. Kenttä näkyy uuden käyttäjän lomakkeessa, kohorteissa ja CSV-tuonnissa. Valikkokentän arvo kohdistetaan määritettyyn vaihtoehtoon kirjainkoosta riippumatta. Muotoiltu teksti puhdistetaan ennen tallentamista.

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/admin-users.webp" alt="The Users page with filters and a table of people, their email, status and last access." width="944" height="700" loading="lazy" decoding="async"><figcaption>Users: search, filter, suspend and reinstate.</figcaption></figure>

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/admin-roles.webp" alt="The Roles and permissions page listing each built-in role and how many people hold it." width="944" height="700" loading="lazy" decoding="async"><figcaption>Roles: the built-in roles and how many people hold each.</figcaption></figure>

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/admin-cohorts.webp" alt="The Cohorts page listing two cohorts with their members, and a form to add a new one." width="944" height="700" loading="lazy" decoding="async"><figcaption>Cohorts group people across courses, by hand or by rule.</figcaption></figure>

## Kirjautuminen ja tietoturva <!--quire:sign-in-and-security-->

`/admin/security/auth` hallitsee seuraavia: 

- **Kirjautumistavat**: sähköposti ja salasana, sähköpostiin lähetettävä kirjautumislinkki, pääsyavaimet, sosiaalisen median tilit, kertakirjautuminen (OpenID Connect tai SAML) ja LDAP-hakemisto. Katso [kertakirjautumisen opas](/fi/integrations/sso/) identiteetintarjoajan yhdistämisestä ja SCIM-käyttäjähallinnasta.
- **Salasanasäännöt** ja **kaksivaiheinen vahvistus**: tunnistussovellus, sähköpostikoodi ja varakoodit. Kaksivaiheinen vahvistus voi olla poissa käytöstä, valinnainen, kaikilta vaadittu tai valittujen roolien vaatima.
- **Istunnot**: istunnon kesto ja käyttämättömänäolon sallittu pituus.
- **Vieraat ja omatoiminen rekisteröityminen**: saavatko käyttäjät luoda tilejä itse ja mitkä sähköpostiverkkotunnukset sallitaan.

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/admin-sign-in.webp" alt="The Sign-in and security page with checkboxes for each sign-in method, password rules and two-step verification." width="944" height="760" loading="lazy" decoding="async"><figcaption>Sign-in methods, password rules and two-step verification.</figcaption></figure>

## Kielet ja sanamuodot <!--quire:languages-and-wording-->

- **Kielipaketit** (`/admin/languages`): käyttäjien valittavissa olevat kielet ja organisaation oletuskieli. Jokainen paketti näyttää, kuinka laajasti se kattaa Quiren. Kaksikymmentä kieltä (arabia, heprea, persia, urdu, espanja, ranska, saksa, brasilianportugali, yksinkertaistettu kiina, japani, korea, hindi, venäjä, italia, turkki, hollanti, puola, indonesia, suomi ja ruotsi) kattavat kaikki Quiren viestit. Muut paketit kattavat sovelluksen käyttöliittymän ja näyttävät kääntämättömän sisällön englanniksi. **Konekäännetty**-merkityt paketit on tuotettu automaattisesti, eikä kääntäjä ole tarkistanut niitä. Merkintä näkyy käyttäjälle kielen valinnan yhteydessä. Arabia, heprea, persia ja urdu näytetään kauttaaltaan oikealta vasemmalle.
- **Sanamuodot** (`/admin/strings`): muuta mitä tahansa Quiren tekstiä organisaatiotasi varten millä tahansa kielellä. Hae näkyvän tekstin tai sen tunnisteen avulla, kirjoita oma versio ja tallenna. Oma versiosi korvaa alkuperäisen kaikkialla noin puolessa minuutissa. **Palauta** tuo Quiren alkuperäisen tekstin takaisin. **Vie** lataa kaikki ylikirjoitukset tiedostona, ja **Tuo** lataa tiedoston, jotta voit siirtää tekstit organisaatiosta toiseen tai tarkistettaviksi. Aaltosulkeissa olevat paikkamerkit, kuten `{count}`, on säilytettävä. Quire hylkää ylikirjoituksen, josta paikkamerkki puuttuu tai johon sellainen on lisätty, ja tarkistaa kielen monikkomuodot.

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/admin-languages.webp" alt="The Language packs page, a table of languages with their direction, translation state and override counts." width="944" height="700" loading="lazy" decoding="async"><figcaption>Language packs show how much of Quire each language covers.</figcaption></figure>

## Sähköposti <!--quire:email-->

`/admin/email` määrittää lähetyspalvelun, lähettäjän nimen ja vastausosoitteen, oman lähetysverkkotunnuksen DNS-tietueineen, seurannan sekä sen, voivatko käyttäjät vastata keskustelualueiden julkaisuihin ja viesteihin sähköpostitse. Sen alla ovat mallit, kampanjat, estot ja toimitusloki.

- **Mallit** (`/admin/email/templates`): Quiren tapahtumakohtaiset viestit millä tahansa kielellä. Muuta viesti organisaatiolle, kategorialle, kurssille tai toiminnolle. Muuttamasi viestit säilyttävät Quiren oletuksen ja saavat sen korjaukset jatkossakin. Jokaisen mallin voi esikatsella esimerkkitiedoilla ennen tallennusta, ja siinä näytetään käytettävissä olevat muuttujat.
- **Jokainen järjestelmäviesti on malli**, myös tunnistetietoja sisältävät kirjautumislinkki, vahvistuskoodi, kutsu, salasanan palautus, tervetuloviesti, rekisteröitymisilmoitus, hyväksyntä- ja jo rekisteröitynyt -viestit, huoltajan suostumus ja tietosuojapyynnön vahvistus. Niitä muokataan samassa editorissa. Nämä viestit ovat välttämättömiä, joten ne lähetetään jonottamisen sijasta heti. Jos viestiä ei voida lähettää, siitä ilmoitetaan henkilölle saman tien.
- **Toimitusloki** (`/admin/email/log`): kaikki organisaation lähettämät sähköpostit uusimmasta alkaen sekä niiden tila (jonossa, lähetetty, toimitettu, palautunut ja niin edelleen). Lokiin ei tallenneta viestissä ollutta linkkiä tai koodia.

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/admin-email.webp" alt="The Email delivery page with tabs for delivery, sending domains, templates, campaigns, delivery log and suppressions." width="944" height="700" loading="lazy" decoding="async"><figcaption>Email delivery: the sending service, and tabs for the rest.</figcaption></figure>

## Integraatiot <!--quire:integrations-->

- **Laajennukset** (`/admin/extensions`): ota sisäänrakennettuja toimintotyyppejä, kirjautumistapoja, raportteja ja muita osia käyttöön tai poista niitä organisaatiolta käytöstä. Katso [laajennukset](/fi/admin/extensions/).
- **Live-istunnot ja videot** (`/admin/integrations/meetings`, `/admin/integrations/video`): käytä omaa BigBlueButton-, Zoom-, Teams-, Google Meet- tai Jitsi-tiliäsi sekä Cloudflare Stream-, Mux- tai Bunny Stream -tiliäsi. Katso [live-istuntojen ja videoiden palveluntarjoajat](/fi/admin/providers/).
- **HubSpot** (`/admin/integrations/hubspot`): katso [HubSpot-opas](/fi/integrations/hubspot/).
- **API-avaimet** (`/admin/integrations/api-keys`): komentosarjojen ja integraatioiden avaimet. Avain näytetään vain luotaessa; Quire säilyttää siitä ainoastaan tiivisteen. Anna jokaiselle integraatiolle oma avain ja vain sen tarvitsemat käyttöoikeudet, jotta yhden avaimen voi perua rikkomatta muita.
- **OAuth-asiakkaat** (`/admin/integrations/oauth-clients`): sovelluksille, jotka toimivat sisäänkirjautuneen henkilön puolesta, kuten Zapier tai Make.
- **MCP** (`/admin/integrations/mcp`): mitkä tekoälyavustajat saavat käyttää Quiren MCP-palvelinta ja mitä työkaluja ne voivat käyttää.
- **Webhookit** (`/admin/webhooks`): lähetä tapahtumat toiseen järjestelmään niiden tapahtuessa. Jokaisella tilauksella on toimitusloki, josta epäonnistuneen toimituksen voi lähettää uudelleen. Jos toimitus epäonnistuu 20 kertaa peräkkäin tai virheet jatkuvat 72 tuntia, Quire keskeyttää tilauksen ja lähettää sähköpostin sinulle sekä tilauksen yhteyshenkilöille.

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/admin-extensions.webp" alt="The Extensions page listing each activity type with its version and a Switch off button." width="944" height="760" loading="lazy" decoding="async"><figcaption>Extensions can be switched on or off for the organisation.</figcaption></figure>

## Jakaminen, sisältö ja tekoäly <!--quire:sharing-content-and-ai-->

- **Jaettu tila** (`/admin/sharing`): tarjoa kursseja ja muita kohteita organisaatioille, jotka käyttävät jaettua kurssia omana kopionaan. Katso [organisaatioiden välinen jakaminen](/fi/admin/sharing/).
- **Sisältöpankki** (`/admin/content-bank`): koko organisaation tai kategorian kanssa jaetut tiedostot ja sisältö. Katso [sisältöpankin opas](/fi/teacher/content-bank/).
- **Tekoälyasetukset** (`/admin/ai`): palveluntarjoajat, ominaisuudet, tekoälyn käyttöperiaatteet ja budjetti. Katso [tekoälyominaisuudet](/fi/admin/ai/).
- **Käytännöt** (`/admin/compliance/policies`): käyttäjien hyväksymät käytännöt sekä sisällön kirjoittamista valvova hyväksyttävän käytön käytäntö. Katso [käytännöt ja hyväksyttävä käyttö](/fi/admin/policies/).
- **Palvelupaketti ja laskutus** (`/admin/billing`): paketin sisältö ja käytetyt resurssit. Katso [palvelupaketti ja laskutus](/fi/admin/plans/).

## Tietueet ja raportit <!--quire:records-and-reports-->

- **Auditointiloki** (`/admin/audit`): kuka teki mitä ja milloin. Merkinnät ketjutetaan, joten niiden muuttaminen tai poistaminen paljastuisi ketjusta. Vie tiedot samalla sivulla tietoturvatiimille tai SIEM-järjestelmään.
- **Raportit** (`/admin/reports`): suorittamiset, arvosanat, osallistuminen ja mukautetut raportit. Raportit luetaan erillisestä, vain luku -käyttöön tarkoitetusta yhteydestä, joten suuri raportti ei hidasta oppijoiden sivustoa. Oppijoiden tietueita sisältävät viennit kirjataan tietojen luovutuksiksi.

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/admin-audit.webp" alt="The Audit log with period and search filters." width="944" height="700" loading="lazy" decoding="async"><figcaption>The audit log records who did what, when and with what result.</figcaption></figure>

## Esteettömyys <!--quire:accessibility-->

Quire täyttää WCAG 2.2 AA -vaatimukset. Jokainen voi myös muokata omaa näkymäänsä osoitteessa `/account/preferences`: tekstikokoa, lukivaikeuksia helpottavaa fonttia, vähennettyä liikettä ja suurta kontrastia. Ylläpitäjän asetukset eivät voi poistaa näitä valintoja käytöstä.

Source: https://docs.quirelms.com/fi/admin/index.mdx