> For the complete documentation index, see [llms.txt](https://docs.wiclax.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wiclax.com/it/utilizza-wiclax/acquisizione-di-dati-di-cronometraggio/il-principio-delle-acquisizioni.md).

# Il principio delle acquisizioni

L’espressione *acquisizione dei tempi* indica il recupero dei “tempi” da parte di Wiclax provenienti da un dispositivo esterno. Un’acquisizione si distingue da una semplice importazione effettuata manualmente a partire da un file.

I diversi tipi di acquisizione sono i seguenti:

* Da un cronometro esterno o da una fotocellula
* Da un sistema di rilevamento elettronico (RFID) (versione Pro)
* Da un file locale o remoto (rete/web) (versione Pro)
* Da un servizio online di archiviazione dei passaggi (versione Pro)

## Creazione e configurazione

La finestra delle acquisizioni si apre da questa sezione della **barra multifunzione**, oppure tramite la scorciatoia `F9`.

<figure><img src="https://2309109415-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMmAbOjoyl6NhBeeNtxJy%2Fuploads%2Fi90SSmCESZYyjxJHa1Bz%2Fimage.png?alt=media&amp;token=57933bda-7be3-4928-9e1e-1db875ee2a4e" alt="" width="231"><figcaption></figcaption></figure>

La creazione di una nuova acquisizione avviene cliccando uno dei pulsanti presenti nella barra multifunzione, che raccoglie tutti i tipi disponibili. In genere si seleziona il produttore dell’apparecchiatura, oppure un’acquisizione basata su file o su cloud:

<figure><img src="https://2309109415-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMmAbOjoyl6NhBeeNtxJy%2Fuploads%2FN6ZOvqnb4HGfBXfVvZaU%2Fimage.png?alt=media&amp;token=a90cedab-9410-49ee-a084-fb6e4c038047" alt=""><figcaption></figcaption></figure>

#### Da sapere

* Il numero di acquisizioni attive in un dato momento non è limitato.
* Le acquisizioni vengono salvate sulla postazione locale e non sulla gara. La logica è di poter passare rapidamente a una nuova gara mantenendo la configurazione abituale del proprio dispositivo.
* Per scenari complessi, ad esempio una configurazione di gara preparata su una postazione diversa da quella utilizzata il giorno dell’evento, è possibile esportare/importare un’intera configurazione di acquisizioni tramite i pulsanti situati in alto a destra della barra multifunzione.
* Il pulsante <img src="https://2309109415-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMmAbOjoyl6NhBeeNtxJy%2Fuploads%2Ff6t1hGNEco0Oz46pc8yK%2Fimage.png?alt=media&amp;token=7568334c-acca-4eeb-be35-61d4527318b3" alt="" data-size="line">in alto a destra della barra multifunzione consente di semplificare l’interfaccia mostrando solo le apparecchiature che si prevede di utilizzare.
* È inoltre possibile cercare un produttore o un modello di cronometro tramite il campo di ricerca nella barra del titolo della barra multifunzione.

## Attivazione

L’attivazione corrisponde generalmente alla connessione con l’apparecchiatura.

Nel caso di un’acquisizione basata su file, ciò significa l’avvio delle importazioni automatiche.

L’attivazione avviene tramite il pulsante a destra di ogni riga di acquisizione:

<figure><img src="https://2309109415-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMmAbOjoyl6NhBeeNtxJy%2Fuploads%2FUpF9DfF3MqP7rhOVmkpP%2Fimage.png?alt=media&amp;token=a576e7e7-9975-4c12-b7b6-31fb6caa6fd8" alt=""><figcaption></figcaption></figure>

## Parametri di un’acquisizione

La configurazione di un dispositivo come un lettore RFID richiede in genere di specificare:

* **il modello dell’apparecchiatura** – se non è necessario selezionarlo, significa che l’acquisizione funzionerà allo stesso modo con i diversi modelli dello stesso produttore
* **l’indirizzo di connessione** – porta COM per una connessione seriale/USB, indirizzo IP per una connessione Ethernet. Da notare che l’indicazione della porta TCP è solitamente facoltativa, a meno che la porta predefinita del dispositivo non sia stata modificata.

### Ritardo di ripassaggio

Inizializzato di default a 10 s, impedisce che una stessa lettura di transponder venga registrata troppo frequentemente. Una lettura della stessa chip prima della scadenza dell’intervallo sarà ignorata da Wiclax.

Se una destinazione è configurata per considerare **l’ultimo passaggio**, questo ritardo viene ignorato.

In generale questo ritardo è utile e sufficiente per evitare che un punto di rilevamento venga validato troppo rapidamente dopo il precedente, o per limitare gli effetti di un atleta che rimane fermo sulla linea. Per un controllo più fine dei rilevamenti e dei tempi minimi tra due passaggi, consultare le **condizioni di passaggio**.

### Scostamento (Offset)

Lo scostamento, o offset, permette di gestire casi non standard, come ad esempio una mancata sincronizzazione dell’orologio di un lettore. È possibile aggiungere o sottrarre un valore temporale ai passaggi ricevuti.

## Destinazione

Il parametro più importante di un’acquisizione è la **destinazione**, che può essere un singolo punto di rilevamento oppure una serie di punti.

Ecco alcuni casi tipici per comprenderne la logica:

{% tabs %}
{% tab title="Un solo punto di rilevamento" %}
Questa è la configurazione più semplice.

<figure><img src="https://2309109415-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMmAbOjoyl6NhBeeNtxJy%2Fuploads%2F2UZHzTsINJLcQOi55ngc%2Fimage.png?alt=media&amp;token=99bce999-90f8-4b28-a28f-0878319931db" alt="" width="226"><figcaption></figcaption></figure>

Tutti i passaggi dell’acquisizione saranno inviati al punto intermedio **10 km**, e solo il primo passaggio sarà considerato per ogni concorrente (l’opzione per considerare i ripassaggi non è attivata).
{% endtab %}

{% tab title="Arrivo semplice" %}

<figure><img src="https://2309109415-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMmAbOjoyl6NhBeeNtxJy%2Fuploads%2FeLCRwA5GRljxr9gyjfPw%2Fimage.png?alt=media&amp;token=a7e00324-bdd3-4caf-9463-d0c9801ffaa0" alt="" width="225"><figcaption></figcaption></figure>

Solo l’arrivo è selezionato.

Verrà registrato un solo passaggio sulla linea; i successivi saranno considerati come ripassaggi.

Si tratta della configurazione classica per una gara a giri, in cui ogni passaggio sulla linea d’arrivo incrementa il numero di giri di un concorrente.
{% endtab %}

{% tab title="Partenza e arrivo" %}

<figure><img src="https://2309109415-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMmAbOjoyl6NhBeeNtxJy%2Fuploads%2FWjFDpFsYTBax2tTFd3EA%2Fimage.png?alt=media&amp;token=e192d5fd-05a3-435f-a649-f24e8907e4fd" alt="" width="226"><figcaption></figcaption></figure>

Per impostazione predefinita, per una partenza l’opzione di considerare l’ultimo passaggio – in arancione nella schermata – è attivata.

Se un chip viene letto più volte sulla linea, verrà quindi conservato il valore di tempo più recente.

Il ritardo dopo lo sparo è qui impostato a 10 minuti. Ciò significa che un nuovo passaggio sulla linea oltre 10 minuti dopo l’ora di partenza della gara di un corridore sarà considerato come una nuova rilevazione, in questo caso come un arrivo.
{% endtab %}

{% tab title="Intermedi e arrivo" %}

<figure><img src="https://2309109415-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMmAbOjoyl6NhBeeNtxJy%2Fuploads%2FLAdCjvv3Xod8A2Kwt7qk%2Fimage.png?alt=media&amp;token=7ed739f0-bfb5-4b04-92f3-fbf2b0366a1b" alt="" width="227"><figcaption></figcaption></figure>

Il principio di base delle destinazioni multiple è che i passaggi vengono registrati in modo sequenziale.

In questo esempio, la stessa linea viene utilizzata per i rilevamenti intermedi ai 20 km e ai 48 km, e successivamente per l’arrivo. Ciò significa che, se arriva un passaggio per un concorrente che ha già un tempo registrato al rilevamento dei 48 km, quel passaggio verrà considerato come l’arrivo.

Importante: l’algoritmo tiene conto dell’assegnazione dei rilevamenti alle diverse gare. Ad esempio, un concorrente iscritto al percorso da 30 km non è interessato dal rilevamento dei 48 km. Il suo secondo passaggio sulla linea sarà quindi considerato come il suo arrivo.
{% endtab %}
{% endtabs %}

{% hint style="info" %}
Se nessuna destinazione è valida per un passaggio, verrà visualizzato il messaggio: **“Nessuna destinazione valida per il passaggio”.**

Ciò accade, ad esempio, se il passaggio arriva con un indirizzo sorgente che non corrisponde a nessuna delle sorgenti configurate nelle destinazioni.
{% endhint %}

### **Indirizzo sorgente**

Il campo **@ sorgente** presente su ogni riga di destinazione permette di collegare la destinazione a una selezione specifica dei dati provenienti dall’acquisizione.

<figure><img src="https://2309109415-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMmAbOjoyl6NhBeeNtxJy%2Fuploads%2Fx0n5pxq6vIOQU6HbK0Xy%2Fimage.png?alt=media&amp;token=4d973560-2c34-42b0-a60b-2bbca736a31f" alt="" width="375"><figcaption></figcaption></figure>

A seconda del tipo di acquisizione, può trattarsi:

* dell’identificativo del rilevamento quando si utilizza un software intermedio tra Wiclax e i lettori
* di un canale nel caso di un cronometro
* di un numero di antenna o di lettore, a seconda dell’hardware utilizzato

{% hint style="info" %}
**Da sapere:** il menu a tendina del campo di inserimento mostra, quando disponibili, i valori predefiniti oppure i valori ricevuti. Questo può aiutare a individuarli o a effettuare verifiche.
{% endhint %}

### **Linea di backup**&#x20;

La proprietà *linea di backup*, valida esclusivamente per la linea d’arrivo, ha i seguenti effetti:

* limita le notifiche sonore e visive delle letture su questa linea
* visualizza un indicatore “linea backup” nella riga dei risultati nel caso in cui il concorrente non sia stato rilevato sulla linea principale

Nel caso in cui, per un motivo tecnico, la lettura della linea principale arrivi dopo quella della linea di backup, il tempo di passaggio viene immediatamente sovrascritto dal primo tempo ricevuto.

### **Rilevamento partenza**

La selezione di `Ril. partenza` come destinazione permette di impostare un semplice rilevamento, ad esempio l’ingresso in una griglia di partenza.

Per *semplice rilevamento* si intende che verrà memorizzata un’informazione sì/no, invece di un tempo di passaggio. Nella griglia degli iscritti questa informazione appare sotto forma di una colonna denominata `Rilevamento partenza`.

## **Monitoring**&#x20;

Per le apparecchiature che inviano queste informazioni, la riga di un’acquisizione nell’elenco può mostrare il livello di carica della batteria, lo stato di ricarica, lo stato della connessione alla rete GPRS, le antenne attive e il loro livello di potenza…

Il log di un’acquisizione viene visualizzato sotto l’elenco. Contiene eventi come errori o indicazioni riguardanti i passaggi scartati.

I passaggi ricevuti vengono mostrati nella finestra principale sotto forma di vignette, che indicano in particolare il pettorale, il rilevamento e la gara.

{% hint style="info" %}
Se le vignette diventano troppo numerose e non sono utili per il monitoraggio, è possibile rendere l’acquisizione “silenziosa” cliccando su questa icona.
{% endhint %}

{% hint style="info" %}
Cliccando su una vignetta è possibile spostare l’impilamento dall’altro lato della finestra principale.
{% endhint %}

## **Rilletura**

L’operazione di *rilletura* consiste nel richiedere all’hardware o a un servizio cloud di reinviare i propri dati di passaggio, per un intervallo di date scelto dall’utente.

<figure><img src="https://2309109415-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMmAbOjoyl6NhBeeNtxJy%2Fuploads%2Fe4kn2GuZ8AO7yKxDasLI%2Fimage.png?alt=media&amp;token=ca3f3907-75c7-4783-8702-9a2832cd0500" alt="" width="214"><figcaption></figcaption></figure>

Specificare l’intervallo di date, quindi cliccare sul pulsante di *rilletura*: si apre una finestra che mostra i dati ottenuti. A questo punto è possibile semplicemente visualizzarli, ad esempio per conoscere il numero di passaggi “nuovi”, cioè quelli che non erano stati integrati nella gara.

<figure><img src="https://2309109415-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMmAbOjoyl6NhBeeNtxJy%2Fuploads%2FG5MmgShkcP7wvF1KUGCl%2Fimage.png?alt=media&amp;token=3a0636cf-69e9-485f-b6ff-4d7e727b9baa" alt="" width="375"><figcaption></figcaption></figure>

E naturalmente è possibile decidere di avviare l’importazione dei dati, sia nella loro totalità sia solo per una selezione.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.wiclax.com/it/utilizza-wiclax/acquisizione-di-dati-di-cronometraggio/il-principio-delle-acquisizioni.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
