# Usare un connettore personalizzato

Come importare da GitHub il connettore PDF Blocks come connettore personalizzato, per usare le azioni prima che arrivino in quello pubblicato.

Il connettore **PDF Blocks** pubblicato in Power Automate è certificato da
Microsoft: le nuove azioni e i nuovi parametri vi arrivano quindi con i tempi di
revisione di Microsoft, non con i nostri. Quando serve una funzionalità già
presente nella definizione del connettore ma non ancora distribuita nel
connettore pubblicato (le azioni di divisione e di riordino, la [selezione delle
pagine](/docs/power-automate/extract-pages-from-pdf) o le opzioni di
crittografia), è possibile installare da soli la definizione più recente come
**connettore personalizzato**, importandola da GitHub.

La definizione del connettore è open source e si trova nel repository
[PowerPlatformConnectors](https://github.com/microsoft/PowerPlatformConnectors)
di Microsoft. Power Automate può costruire un connettore personalizzato
direttamente da lì, quindi non occorre mai copiare file a mano.

<Note>
  Un connettore personalizzato vive in un solo ambiente Power Platform e non è
  certificato. Funziona esattamente come il connettore pubblicato (stesse
  azioni, stessa chiave API), ma la manutenzione è a proprio carico:
  reimportarlo per recuperare gli aggiornamenti successivi. Quando il connettore
  pubblicato avrà recuperato il ritardo, è possibile riportarvi i propri flussi.
</Note>

## Prima di iniziare

- Un piano Power Automate a pagamento (per utente o per flusso), lo stesso
  requisito del connettore pubblicato.
- L’autorizzazione a creare connettori personalizzati nel proprio ambiente. Se
  **Connettori personalizzati** (*Custom connectors*) non compare, rivolgersi
  all’amministratore Power Platform.
- La chiave API PDF Blocks, pronta per il momento in cui si crea la connessione.
  Vedere [Per iniziare](/docs/power-automate/getting-started) se non se ne ha
  una.

## Importare il connettore

<Steps>

<Step title="Aprire Connettori personalizzati">
  In [Power Automate](https://make.powerautomate.com), espandere il menu di
  sinistra, scegliere **Altro** (*More*) e aprire **Connettori personalizzati**.
  (Si può raggiungere la stessa pagina anche dal portale di creazione di Power
  Apps, sotto **Scopri tutto → Connettori personalizzati**.)
</Step>

<Step title="Avviare un nuovo connettore da GitHub">
  Selezionare **+ Nuovo connettore personalizzato** (*+ New custom connector*),
  poi scegliere **Importa da GitHub** (*Import from GitHub*).

  <Frame caption="Nuovo connettore personalizzato → Importa da GitHub.">
    <img
      src="/images/power-automate/use-a-custom-connector/01-new-custom-connector-menu.png"
      alt="Il menu Nuovo connettore personalizzato con l’opzione Importa da GitHub"
    />
  </Frame>
</Step>

<Step title="Selezionare il connettore PDF Blocks">
  Nella finestra di dialogo **Importa da GitHub**:

  - Impostare **Tipo di connettore** (*Connector Type*) su **Certified**: in
    questo modo la lettura avviene dalla cartella dei connettori certificati del
    repository open source, dove si trova PDF Blocks.
  - Scegliere un **Ramo** (*Branch*). Prendere il ramo che porta l’aggiornamento
    che serve (ad esempio `dev` per il più recente, oppure un ramo di rilascio
    per una versione fissata).
  - Impostare **Connettore** (*Connector*) su **PDF Blocks**.

  Selezionare **Continua** (*Continue*).

  <Frame caption="Scegliere Certified, prendere un ramo e selezionare il connettore PDF Blocks.">
    <img
      src="/images/power-automate/use-a-custom-connector/02-import-from-github-dialog.png"
      alt="La finestra di dialogo Importa da GitHub con Certified selezionato, il ramo dev e il connettore PDF Blocks"
    />
  </Frame>

  <Tip>
    Usare il collegamento **Click here to explore the open source repository**
    nella finestra di dialogo per sfogliare la definizione esatta prima di
    importarla.
  </Tip>
</Step>

<Step title="Creare il connettore">
  Power Automate carica la definizione del connettore nell’editor. Non occorre
  modificare nulla. Se si vuole, scorrere le schede **Generale** (*General*),
  **Sicurezza** (*Security*) e **Definizione** (*Definition*) per esaminarla,
  poi selezionare **Crea connettore** (*Create connector*) in alto a destra.
  Assegnargli un nome riconoscibile (ad esempio *PDF Blocks Next*) per
  distinguerlo dal connettore pubblicato.
</Step>

<Step title="Creare una connessione">
  La prima volta che si aggiunge a un flusso un’azione del proprio connettore
  personalizzato, Power Automate chiede gli stessi parametri di connessione del
  connettore pubblicato: un **Connection Name**, la propria **API Key** e un
  **Server Hostname** facoltativo. Vedere [Per
  iniziare](/docs/power-automate/getting-started#passaggio-2-creare-una-connessione)
  per il significato di ciascuno.
</Step>

<Step title="Usare le nuove azioni">
  In un flusso, aggiungere un’azione e cercare il nome dato al proprio
  connettore personalizzato. Le sue azioni (comprese quelle non ancora presenti
  nel connettore pubblicato, come [Dividere un PDF per numero di
  pagine](/docs/power-automate/split-pdf-by-page-count) e [Riordinare le pagine
  di un PDF](/docs/power-automate/reorder-pages-of-pdf)) compaiono accanto a
  tutte le altre, pronte da configurare.
</Step>

</Steps>

## Mantenerlo aggiornato

Un connettore personalizzato è un’istantanea della definizione al momento
dell’importazione. Quando pubblichiamo altri aggiornamenti, ripetere
**Importa da GitHub** sullo stesso connettore (oppure reimportare e ricreare) per
aggiornarlo. Poiché il connettore personalizzato e quello pubblicato sono
indipendenti, si possono tenere installati entrambi e spostare ogni flusso
quando si è pronti.

## Vedi anche

<CardGroup cols={2}>

<Card title="Per iniziare" href="/docs/power-automate/getting-started">
  Configurare la prima connessione PDF Blocks e la chiave API.
</Card>

<Card title="Unire documenti PDF" href="/docs/power-automate/merge-pdf-documents">
  Iniziare da un’azione fondamentale una volta installato il connettore.
</Card>

</CardGroup>