User Tools

Site Tools


sanctuaria:advanced_features

This is an old revision of the document!


Advanced features (Authenticated users)

Keycloak Keycloak Keycloak

Data export

Authenticated users can export search results using the Export button available in the upper control bar of the Search Results page. (Figure 15)

The system allows the download of filtered data in the following formats:

  • CSV
  • JSON

Export procedure

  • Click on the Export button (top-right area, next to *+ Add resource*).
  • In the modal window, select the fields to be included in the export file

(e.g. *Source Date*, *Sanctuary Name*, *Region*, *City*, *Type*, *Description*).

  • Choose the desired output format:
    • CSV → suitable for spreadsheets and tabular analysis.
    • JSON → recommended for structured analysis or system integration.
  • Confirm by clicking the Export button.

The file is automatically generated and downloaded, containing data consistent with the current search filters.

Creating a new resource

The + Add resource button allows authenticated users to insert new records into the SANCTUARIA database. (Figure 17)

Resource type selection

The initial field *Resource type* allows users to choose between the following options:

  • Ex-Voto
  • Foundation Legend

Ex-Voto form

When *Ex-Voto* is selected as the resource type, the system displays a dedicated form with the following main fields:

  • Image URL
  • Region
  • Location
  • Province
  • Sanctuary Name
  • Date
  • Depicted Subject
  • Inscription
  • Description / Text
  • Keywords (1–5)
  • Photographer

At the bottom of the form, the following action buttons are available:

  • Cancel
  • Save draft

Foundation Legend form

When *Foundation Legend* is selected, a specific form is displayed, including the following main fields:

  • Region
  • Location
  • Province
  • Sanctuary Name
  • Venerated Object
  • Technique and Material
  • Document Type
  • Language
  • Miracle Date
  • Bibliographical Reference
  • Text
  • Digital Version of the Book

The form also includes the Cancel and Save draft action buttons.

In both resource forms, a final confirmation checkbox is required to authorize the publication of the resource on the SANCTUARIA platform. (Figure 20)

Dashboard

The Dashboard area lists all resources created or saved as drafts under the *Contributions* section.

If no requests or materials are available, the following message is displayed:

*No requests*

Technical notes

  • Advanced features are restricted to authenticated users and authorized via access tokens.
  • Dedicated APIs are used for resource creation, update, and draft saving.
  • Field validation is performed both on the client side and on the server side.
  • Multi-format support is provided for data export.
sanctuaria/advanced_features.1768473446.txt.gz · Last modified: by fincons