Page History

...

Sijoita lomakkeiden asetukset tiedostoon /local/config/vufind/FeedbackForms.yaml. Voit katsoa mallia Finnan Finnan esimerkkitiedosta.

Lomakkeet sijaitsevat päätason 'forms' -listan sisällä.

...

...

emailFrom:
  name: Tilaukset
  email: kirjasto@joku

recipient
  name:

recipient
  name: nimi
  email: osoite

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

help:
  pre: feedback_help_pre
  post: feedback_help_post

...

settings:
  - [class, "css-luokka1 css-luokka2"]

options:
  - valinta-1
  - valinta-2
  - valinta-3

options:
  - value: valinta-1
    label: Valinta 1
  - value: valinta-2
    label: Valinta 2
  - value: valinta-3
    label: Valinta 3

options:
  - valinta-1
  - valinta-2
  - valinta-3

optionGroups:
  - label: otsikko-1
    options:
     - valinta-1a
     - valinta-1b
  - label: otsikko-2
    options:
     - valinta 2a
     - valinta 2b

recipient: true
options:
  - value: [email protected]
    label: Vastaanottaja 1
  - value: [email protected]
    label: Vastaanottaja 2

recipient: true
optionGroups:
  - label: otsikko-1
    options:
     - value: [email protected]
       label: Vastaanottaja 1
     - value: [email protected]
       label: Vastaanottaja 2
  - label: otsikko-2
    options:
     - value: [email protected]
       label: Vastaanottaja 3
     - value: [email protected]
       label: Vastaanottaja 4

type: select
required: true
placeholder: Valitse toimipiste
options:
  - toimipiste-1
  - toimipiste-2

...

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

...

Esimerkki: Lisätään Varastokirjastotilaus-lomake

Tämä toiminnallisuus on käytettävissä v2.71.0 eli 21.9.2021 lähtien.

Image Added

Warning
Huom! Lomakkeen nimen täytyy olla RepositoryLibraryRequest.

Tilausnappula näytetään automaattisesti "Tämän aineiston tarjoaa" -palkissa:

Image Removed

Warning

Varastokirjatotilaus-lomakkeessa pitää käyttäjälle selkeästi kertoa henkilötietojen käsittelystä. Käytettäessä parametria includePatronID : true tulee lomakkeen loppuun automaattisesti seuraava huomatus: Käyttäjän yksilöivä tunniste lähetetään lomakkeen mukana. Muut tiedot henkiötietojen käsittelystä voi lisätä lomakkeelle kohtaan pre: feedback_help_pre (lomakkeen alkuun) tai post: feedback_help_post (lomakkeen loppuun). Mainitse ainakin, lähetetäänkö tiedot sähköpostitse vai käsitelläänkö niitä muulla tavoin. Voit myös linkittää organisaation tai yhteenliittymän tietosuojaselosteeseen.

Tilausnappula

Tilausnappula näytetään automaattisesti "Tämän aineiston tarjoaa" -palkissa:

Image Added

Finnan versiosta 2.74.0 (14.12.2021) lähtien on mahdollista määritellä, missä tilausnappula näytetään. Tähän on käytettävissä seuraavat näkymän /local/config/vufind/config.ini-tiedoston asetukset, joilla nappulan voi lisätä myös hakutuloksiin ja saatavuustietoihin tai poistaa "Tämän aineiston tarjoaa" -palkista:

[Record]
; Whether to display repository library request in search results:
;repository_library_request_in_results = true
; Whether to display repository library request in holdings:
;repository_library_request_in_holdings = true
; Whether to display repository library request in organisation info box:
repository_library_request_in_organisation_info = true

Saatavuustiedoissa:

Image Added

Hakutuloksissa:

Image Added

Esimerkki lomakkeen asetuksista

forms:

  RepositoryLibraryRequest:
    enabled: true
    title: repository_library_request
    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]

Esimerkki: Lisätään Arkistoaineiston tilauslomake

Image Added

Tilauslomakkeen lisäämiseksi omaan näkymään, muokataan alla mainittuja tiedostoja tiedostosijainnissa: /local/config/vufind/

Varausnappula

Varausnappula näytetään automaattisesti Saatavuustiedot-välilehdellä, jos se on asetuksista määritelty päälle ja/jos varattavien aineistojen tiedot sopivat asetuksista määriteltäviin lisäehtoihin.

Image Added

Saatavuustiedot-välilehden voi laittaa näkyväksi RecordTabs.ini-tiedoston kautta, jossa se lisätään EAD3-aineiston määrittelyihin. (Eli kuten alla, kohdan "[Finna\RecordDriver\SolrEad3]" alle).

[Finna\RecordDriver\SolrEad3]
tabs[Holdings] = HoldingsILS  

Aineistoihin liittyviä asetuksia voi muokata datasources.ini-tiedostosta. Asetukset lisätään tietolähteen alle. (Eli tiedostossa pitäisi lukea [] sisällä tietolähteen nimi, josta tuleville tietueille halutaan arkistotilauslomake lisätä. Tämän tietolähteen alle alla näkyvät asetukset laitetaan.)

; Archive request form settings
allowArchiveRequest = true
archiveRequestAllowedRecordLevels = 'file:item'
archiveRequestRequireFilingUnit = true

• allowArchiveRequest - Määrittelee yleisesti, onko lomake näkyvissä.
• archiveRequestAllowedRecordLevels - Määrittelee arkistotasot, joilla varausnappula näkyy. (Esimerkissä yllä vain file ja item tason aineistoilla näkyy varauspainike.) Jos arkistotasoja on useita, ne erotetaan ":":llä.
• archiveRequestRequireFilingUnit - Määrittelee vaaditaanko varattavilta aineistoilta säilytyspaikan tieto (jolla tarkoitetaan tietueen container arvoa). Eli jos tietueelta ei kyseistä arvoa löydy ja asetus on "true" → lomake ei näy kyseisellä tietueella.

Jos omassa näkymässä ei ole kyseistä tiedostoa, se pitää tehdä tiedoston lisäyksestä ja nimetä "datasources.ini":ksi. Sen jälkeen asetukset voi lisätä kuten yllä.

Lisätiedot lomakkeelle

Lomakkeelle on mahdollista lisätä ylä- sekä alaosaan lisäinfoa seuraavien käännösavainten avulla:

archive_request_{datasource}_info

archive_request_{datasource}_material_arrival_info_html

Jos käännöksiä ei aseteta, lomake näkyisi ilman tämän osion ylimpänä olevan lomakekuvan havainnollistavia käännösavaimia. Alempi teksti tulee aina näkyville siniseen info-laatikkoon.

Esimerkki lomakkeen asetuksista

forms:

  ArchiveRequest:
      allowLocalOverride

forms:

  RepositoryLibraryRequest:
    enabled: true
    title: repository_library_request
    useCaptcha: false
    sendMethod: database
    includeBarcode: true
    includePatronId: true
    onlyForLoggedUsers: true
    recipient:  title: archive_request_reserve_material
      nameenabled: Tilauksettrue
      emailsendMethod: tilaukset@joku"email"

     reminderEmail onlyForLoggedUsers: [email protected]true
      emailSubject: "Varastokirjastotilaus (%%noutopaikka%%): %%record_id%% -Varauspyyntö: %%record%%"
      response: repository_libraryarchive_request_response
      senderInfoRequired: true
      hideSenderInfo: true
      hideRecipientInfo: truefalse
      help:
        pre: repository_library_request_infoarchive_request_pre_information_html
        post: archive_request_post_information_html

      fields:
        - name: name
          type: noutopaikkatext
          label: feedback_name
 type: select
        optionssettings:
            - 1/Vaski/1/readonly: true
        -  - 1/Vaski/5/name: email
          - 1/Vaski/6/
type: email
          label: preferredfeedback_pickup_location
   email
   - name: lastdate
        typerequired: datetrue
        - labelname: hold_required_byphone
        minValue  type: nowtext
          requiredlabel: falsePhone
        - name: namedesiredDateForOrder
          type: texttextarea
          label: feedback_name
archive_request_request_info
          required: true
      - name: email
        type: email
 settings:
       label: feedback_email
    - [rows, 3]
  required: true
      - name: message
          type: textarea
          label: feedback_message
          settings:
          - [placeholder, repository_library_request_message]
          - [rows, 3]

Lomakkeiden asetuksista enemmän tämän sivun alussa. (Sijoita lomakkeiden asetukset tiedostoon /local/config/vufind/FeedbackForms.yaml.)