# Per iniziare

Come aggiungere un’azione PDF Blocks a un flusso Power Automate e collegarla al proprio account con una chiave API.

PDF Blocks è un connettore per Power Automate, Power Apps e Azure Logic Apps.
Questa guida si concentra su Power Automate, ma gran parte dei suoi contenuti
vale anche per Azure Logic Apps.

## Requisiti

Per iniziare a usare PDF Blocks occorre:

- Un piano Power Automate a pagamento, per utente oppure per flusso.
- Un account PDF Blocks. Se non se ne ha uno, [creare un account
  gratuito](https://accounts.pdfblocks.com/signup): il piano Free non richiede
  alcuna carta di credito.

## La chiave API

La chiave API si ottiene dalla propria
[dashboard](https://accounts.pdfblocks.com).

Questa chiave API dà al suo titolare (ad esempio l’account Power Automate)
accesso soltanto al servizio PDF Blocks. Chi possiede la chiave API non può
accedere ai documenti né ai dati di input privati, perché non memorizziamo i
documenti né i dati. In ogni caso, conservarla al sicuro e non pubblicarla.

È possibile revocare una chiave e generarne una nuova in qualsiasi momento dalla
dashboard.

## Passaggio 1: scegliere PDF Blocks

In un flusso Power Automate, aggiungere una nuova azione. Nel riquadro **Add an
action**, cercare PDF Blocks.

<Frame caption="Ricerca di PDF Blocks nel riquadro Add an action.">
  <img src="/images/power-automate/getting-started/search-for-pdf-blocks.png" alt="Ricerca di PDF Blocks nel riquadro Add an action di Power Automate" />
</Frame>

La ricerca non mette sempre PDF Blocks al primo posto: scorrere i risultati fino
al gruppo **PDF Blocks**. Se l’azione desiderata non compare, selezionare
**Vedi altre** (*See more*) in quel gruppo per elencare tutte le azioni PDF
Blocks, poi scegliere quella che serve.

## Passaggio 2: creare una connessione

La prima volta che si aggiunge un’azione PDF Blocks a un flusso, Power Automate
chiede alcuni parametri per creare una connessione:

<Frame caption="Creazione di una connessione in Power Automate.">
  <img src="/images/power-automate/getting-started/create-a-connection-global.png" alt="Il riquadro di creazione della connessione in Power Automate, con il server predefinito" />
</Frame>

Parametri della connessione:

- In **Connection name**, scrivere il testo che si vuole usare come nome della
  connessione. Nell’esempio qui sopra abbiamo usato «PDF Blocks Default».
- In **API Key**, scrivere la propria chiave API PDF Blocks. Mentre la si
  digita, viene mascherata da puntini come qualsiasi altra password.
- In **Server Hostname**, lasciare il campo vuoto per usare il server
  predefinito (`api.pdfblocks.com`).

Premere **Crea nuovo** (*Create new*) per creare la connessione. Una volta
creata la connessione, si può iniziare a usare PDF Blocks in qualsiasi flusso.

### Elaborare i documenti in una regione specifica

Lasciando **Server Hostname** vuoto, PDF Blocks instrada ogni richiesta verso
l’infrastruttura più vicina, per la latenza più bassa. Per mantenere
l’elaborazione in una giurisdizione specifica, inserire invece il nome host di
quella regione. Ad esempio, per elaborare esclusivamente su server europei,
scrivere `eu.api.pdfblocks.com` nella casella **Server Hostname** prima di
creare la connessione:

<Frame caption="Usare eu.api.pdfblocks.com per elaborare i documenti nell’UE.">
  <img src="/images/power-automate/getting-started/create-a-connection-eu.png" alt="Il riquadro di creazione della connessione in Power Automate, con il nome host del server dell’UE" />
</Frame>

Le regioni disponibili, e il nome host da inserire per ciascuna, dipendono dal
piano:

| Regione               | Server Hostname           | Disponibile con                    |
| --------------------- | ------------------------- | ---------------------------------- |
| Globale (predefinita) | _Lasciare vuoto_          | Tutti i piani                      |
| Stati Uniti           | `us.api.pdfblocks.com`    | Starter e Business                 |
| Unione europea        | `eu.api.pdfblocks.com`    | Starter e Business                 |
| Regno Unito           | `uk.api.pdfblocks.com`    | Business                           |
| Canada                | `ca.api.pdfblocks.com`    | Business                           |
| Australia             | `au.api.pdfblocks.com`    | Business                           |
| Giappone              | `jp.api.pdfblocks.com`    | Business                           |
| India                 | `in.api.pdfblocks.com`    | Business                           |
| Brasile               | `br.api.pdfblocks.com`    | Business                           |
| HIPAA Stati Uniti     | `hipaa.api.pdfblocks.com` | Business (richiede un BAA firmato) |

Vedere [Regioni e residenza dei dati](/docs/api/regions-and-data-residency) per
tutti i dettagli su ciascun endpoint.

## Ottenere assistenza

Serve una mano? Aprire un ticket di supporto da **Support** nella propria
[dashboard](https://accounts.pdfblocks.com). Descrivere il problema (è possibile
allegare file) e risponderemo nello stesso thread, con notifiche via e-mail man
mano che la conversazione prosegue.

Se non si riesce ad accedere alla dashboard, scriverci all’indirizzo
[support@pdfblocks.com](mailto:support@pdfblocks.com).