# General Translation Integrations: Registrazione di tour guidati
URL: https://generaltranslation.com/it/docs/integrations/rrweb/guides/recording-walkthroughs.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Come catturare un flusso di prodotto con gt-rrweb, revisionare la sessione e salvarne il bundle di registrazione.

Registra una sola volta un flusso di prodotto ripetibile, poi salvalo come bundle da revisionare, pubblicare e riprodurre.

Questa guida si concentra su come condurre una sessione di cattura efficace. Completa prima la [Quickstart](/docs/integrations/rrweb/quickstart).

## Prima di iniziare [#before-start]

Prima di registrare:

* [Configura il registratore](/docs/integrations/rrweb/guides/configuring-recordings) per la region del prodotto e il riquadro di riproduzione che ti servono.
* Apri il flusso nell'impostazione regionale sorgente e riportalo a uno stato iniziale prevedibile.
* Decidi quali impostazioni regionali pubblicate includere. (Vedi [Configurare il replay localizzato](/docs/integrations/rrweb/guides/configuring-recordings#localized-replay)).

## Avviare e interrompere la cattura [#capture]

Chiama [`start()`](/docs/integrations/rrweb/reference/recorder#use-recorder) prima con l'impostazione regionale sorgente, poi con ogni impostazione regionale di destinazione da raccogliere. Il registratore mantiene la sessione nello stato del modulo, quindi un cambio di route che rimonta i componenti non interrompe una registrazione attiva.

```tsx title="src/RecordButton.tsx"
const { start, stop, status } = useRecorder();

await start({ locales: ['en', 'de', 'ja'] });
const bundle = await stop();
```

`status` passa da `preparing` a `recording`, torna a `preparing` mentre le traduzioni vengono raccolte e termina con `idle`. Un errore del loader del catalog interessa solo quell'impostazione regionale; un errore più ampio nella raccolta non è fatale e `stop()` si risolve comunque con un bundle contenente solo contenuti sorgente.

Abbandonare la pagina interrompe una sessione attiva senza raccogliere le traduzioni né chiamare `onComplete`. Interrompi la registrazione prima di una navigazione che scarica l'applicazione.

## Registra il flusso del prodotto [#product-flow]

Dopo che `start()` si è risolta, completa il tour guidato nello stesso ordine in cui uno spettatore dovrebbe vederlo. Clic, navigazione, modifiche al DOM, posizione di scorrimento e contenuto visibile della pagina entrano a far parte del flusso di eventi.

Mantieni la sessione mirata:

* Parti da una pagina e da uno stato dell'applicazione stabili.
* Attendi il tempo necessario perché il contenuto async venga renderizzato prima di interagirci.
* Termina quando lo spettatore ha raggiunto un chiaro stato di successo.
* Evita di esporre stati sensibili dell'applicazione.

I valori inseriti nei form vengono mascherati e la telemetria dei movimenti del mouse viene omessa. Rivedi la registrazione completata prima della pubblicazione, perché il resto del testo e dello stato visibili rimane nel flusso di eventi.

Aggiungi la classe `rr-block` di rrweb ai controlli dell'operatore o ad altri elementi che non devono comparire nella registrazione:

```tsx
<div className="rr-block">
  <RecordingControls />
</div>
```

## Pilotare le registrazioni tramite automazione [#automation]

Per controllare una registrazione via script da un test end-to-end, configura l&#39;opzione `expose` del registratore. L&#39;handle `window[name]` risultante fornisce le stesse funzioni `start` e `stop`.

```tsx title="src/RecordingTools.tsx"
<GTRecorder expose="gtRecorder" />
```

```js title="record.spec.js"
await page.evaluate(() => window.gtRecorder.start({ locales: ['en', 'es'] }));
// ... esegui il flusso
const bundle = await page.evaluate(() => window.gtRecorder.stop());
```

## Archiviare il bundle [#store-bundle]

Serializza il [`RecorderBundle`](/docs/integrations/rrweb/reference/recorder#recorder-bundle) restituito in formato JSON e conservalo insieme alle risorse della tua applicazione o in un archivio di tua proprietà. Il package non carica le registrazioni da nessuna parte.

Puoi archiviare l&#39;intero bundle oppure soltanto `bundle.events`. I metadati di impostazione regionale e di overlay sono incorporati nel flusso di eventi, quindi il replayer è in grado di ripristinare la riproduzione localizzata quando un&#39;esportazione dei soli eventi viene successivamente racchiusa come `{ events }`.

<Callout type="warn">
  Esamina una registrazione prima di pubblicarla. I valori di input sono mascherati, ma il flusso di eventi contiene comunque il testo visibile della pagina e lo stato dell&#39;applicazione durante la sessione.
</Callout>

## Next steps

- /docs/integrations/rrweb/guides/configuring-recordings
- /docs/integrations/rrweb/guides/replaying-recordings

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.