Versions Compared

Old Version 19

changes.mady.by.user Ere Maijala

Saved on

compared with

New Version 20

changes.mady.by.user Ere Maijala

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Poistettu useCaptcha-asetus, lisätty dokumentaatiota

...

AsetusSelitysMahdolliset arvot
enabledOnko lomake käytössä
  • true
  • false
useCaptchaKäytetäänkö lomakkeella captcha-tarkistusta. Finnassa captcha-tarkistus on korvattu toisella, käyttäjälle näkymättömällä mekanismilla. Tämä asetus kannattaa jättää pois omista lomakemäärityksistä.
  • true
  • false (älä käytä)
titleLomakkeen otsikkoKäännösavain
onlyForLoggedUsersNäytetäänkö lomake ainoastaan kirjautuneille käyttäjille
  • true
  • false
emailFrom

(käytettävissä v2.71.0 eli 21.9.2021 alkaen)

Lomakkeen lähettäjän nimi ja sähköpostiosoite (vain, kun sendMethod on 'email')

Huom! Yleensä email-asetus kannattaa jättää pois, koska viestin lähettäjän osoitteen vaihtaminen voi aiheuttaa sen, etteivät viestit mene perille tai ne päätyvät roskapostiin.


Code Block
emailFrom:
  name: Tilaukset
  email: kirjasto@joku


emailSubject

Lomakkeen tallennuksen yhteydessä lähetettävän sähköpostiviestin otsikko. api-lähetyksessä tieto siirtyy emailSubject-kentässä.

Voit lisätä otsikkoon lomakekentän arvon. Esimerkiksi jos lomakkeella on alasvetovalikko (nimellä "toimipiste"), voit lisätä valikon arvon viestin otsikkoon näin:

emailSubject: Hankintaehdotus - %%toimipiste%%

Tietuekohtaisilla lomakkeilla (FeedbackRecord, RepositoryLibraryRequest) voi käyttää myös seuraavia paikanpitäjiä:

  • %%record%% (nimeke)
  • %%record_id%% (tietueen ID)
  • Käännösavain
  • Teksti, joka voi sisältää lomakekenttien arvoja, esim. 'Tilaus: %%record%% - %%toimipiste%%'


recipient

Lomakkeen vastaanottajan nimi ja sähköpostiosoite (vain, kun sendMethod on 'email').

Code Block
recipient
  name: nimi
  email: osoite

Mikäli 'recipient' ei ole määritely, käytetään näkymän yleistä palauteosoitetta (Yleiset asetukset > Näkymän ylläpidon sähköpostiosoite).

Voit määritellä lomakkeelle useamman vastaaanottajan asettamalla recipientin listaksi:

Code Block
recipient:
  - name: nimi-1
    email: osoite-1
  - name: nimi-2
    email: osoite-2


ks. esimerkit
sendMethod

Lähetetäänkö lomakkeen vastaukset sähköpostilla (email) vai tallennetaanko vastaukset tietokantaan (database)?

Oletuksena lomakkeen kautta kerätyt palautteet lähetetään määriteltyyn sähköpostiosoitteeseen (ks. 'recipient'). Mikäli palautteita ei tietoturvasyistä johtuen voida lähettää sähköpostin välityksellä, voidaan palautteet tallentaa tietokantaan tai lähettää organisaation itse ylläpitämään erilliseen järjestelmään JSON-muotoisena pakettina. Tämän rajapintatoiminnallisuuden käyttämisestä on erillinen ohjesivu.

Tallennettujen palautteiden käsittely tapahtuu hallintaliittymän Lomakkeet-osiossa. Osiossa listataan tuotantonäkymien kautta lähetetyt palautteet. Tietokantaan tallennusta ei  voi kokeilla testipalvelimella.

  • email
  • database
  • api (v2.71.0 eli 21.9.2021 alkaen)
reminderEmailJos lomakkeen vastaukset tallennetaan tietokantaan (ks. 'sendMethod'), lähetetään käsittelemättömistä palautteista muistutus tähän sähköpostiosoitteeseen. Jos osoitetta ei ole määritelty, lähetetään muistutukset näkymän yleiseen palauteosoiteeseen (Yleiset asetukset > Näkymän ylläpidon sähköpostiosoite).Sähköpostiosoite
hideSenderInfoKysytäänkö lomakkeella lähettäjän yhteystietoja (nimi ja sähköposti)? Oletuksena kysytään.
  • true
  • false
senderInfoRequiredEdellytetäänkö lomakkeen lähettäjän syöttävän yhteystietonsa?
  • true
  • false
senderInfoHelpLähettäjän yhteystietojen ohjeteksti.Käännösavain
reportReferrerSisällytetäänkö palautesivulle viitannut sivu palautteeseen
  • true
  • false
reportUserAgent

(käytettävissä v2.71.0 eli 21.9.2021 alkaen)


Sisällytetäänkö käyttäjän selaimen tunniste palautteeseen

  • true
  • false
responseLomakkeen lähetyksen jälkeen näytettävä viesti.Käännösavain
help

Lomakkeen ohjetekstit, näytetään lomakkeen alussa ('pre') ja/tai lopussa ('post). Käännös voi sisältää HTML-muotoiluja.

Code Block
help:
  pre: feedback_help_pre
  post: feedback_help_post


Käännösavain
fieldsLomakkeen kentätLista

...

Code Block
forms:

  AcquisitionRequest:
    title: Acquisition request
    enabled: true
    useCaptcha: false
    recipient:
      name: Your Library
      email: [email protected]

    onlyForLoggedUsers: false
    emailSubject: Hankintaehdotus (%%library%%)
    response: Thank you for your feedback.
    senderInfoRequired: false 
    #senderInfoHelp: feedback_info
    #help:
    #  pre: feedback_help_pre
    #  post: feedback_help_post

    fields:
      - name: library
        type: select
        options:
          - 1/Vaski/1/
          - 1/Vaski/5/
          - 1/Vaski/6/
        label: feedback_choose_library
      - name: author
        type: text
        label: Author
        required: true
      - name: title
        type: text
        label: Title
        required: true
      - name: format
        type: select
        options:
          - 0/Book/
          - 0/Journal/
          - 1/Sound/CD/
          - 1/Video/DVD/
          - 1/Other/Other/
        label: Format
      - name: info
        type: textarea
        label: Additional Information
        required: false

...

Code Block
forms:

  RepositoryLibraryRequest:
    enabled: true
    title: repository_library_request
    useCaptcha: false
    sendMethod: database
    includeBarcode: true
    includePatronId: true
    onlyForLoggedUsers: true
    recipient:
      name: Tilaukset
      email: tilaukset@joku
    reminderEmail: [email protected]
    emailSubject: "Varastokirjastotilaus (%%noutopaikka%%): %%record_id%% - %%record%%"
    response: repository_library_request_response
    senderInfoRequired: true
    hideSenderInfo: true
    hideRecipientInfo: true
    help:
      pre: repository_library_request_info_html
    fields:
      - name: noutopaikka
        type: select
        options:
          - 1/Vaski/1/
          - 1/Vaski/5/
          - 1/Vaski/6/
        label: preferred_pickup_location
      - name: lastdate
        type: date
        label: hold_required_by
        minValue: now
        required: false
      - name: name
        type: text
        label: feedback_name
        required: true
      - name: email
        type: email
        label: feedback_email
        required: true
      - name: message
        type: textarea
        label: feedback_message
        settings:
          - [placeholder, repository_library_request_message]
          - [rows, 3]

...