Knowledge Base

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
===== Advanced features (Authenticated users) =====

==== Data export ====

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

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. 


{{sanctuaria:sanctuaria_export_button.png?100|Export Button}}
{{sanctuaria:sanctuaria_export.png?650|Export}}
----
==== Creating a new resource ====

The **+ Add resource** button allows authenticated users to insert new records into the SANCTUARIA database. 

{{sanctuaria:sanctuaria_add_resource.png?650|Add Resource}}

----
==== Resource type selection ====

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

  * **Ex-Voto**
  * **Foundation Legend**

{{sanctuaria:sanctuaria_resource_type.png?650|Resource Type}}
----
==== 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**

{{sanctuaria:sanctuaria_ex_voto_module.png?650|Ex-voto Module}}
----
==== 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. 

{{sanctuaria:sanctuaria_foundation_module.png?650|Foundation Module}}
----
==== 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.