Claris Connect – Nuovi Connettori Personalizzati
Claris Connect è una piattaforma per l’automazione dei flussi di lavoro tra app e servizi diversi.
Il ruolo di Claris Connect è quello di orchestrare una sequenza di Azioni (Actions), previste da dei Connettori (Connectors) in quelli che vengono definiti Flussi (Flows). Le Azioni possono essere eseguite manualmente, su richiesta dell’utente, oppure al verificarsi di un Evento (Trigger).
Con Claris Connect è possibile programmare dei flussi di lavoro tramite un’interfaccia guidata, senza necessità di dover scrivere del codice o di creare un’infrastruttura di backend complessa. Per esempio, è possibile creare un Flusso che, al caricamento di un file su una cartella OneDrive o Dropbox, invii una notifica su Slack, oppure crei un record di log in un database FileMaker. In un Flusso è possibile combinare quanti Connettori ed Azioni si desidera, consentendo un controllo di eventuali errori e prevedendo la possibilità di lasciare ad un utente la decisione sugli step successivi di un Flusso (IF / Else).
Claris Connect mette a disposizione centinaia di connettori per le applicazioni e i servizi più popolari su internet. Ciò significa che molto probabilmente troverete già quello che fa al caso vostro.
Se però il connettore dedicato al nostro servizio non fosse ancora disponibile, o se dovessimo integrare un’applicazione aziendale gestita internamente, ci verranno in aiuto i nuovi Connettori Personalizzati (Claris Connect Custom Connectors)
Connettori Personalizzati (Custom Connectors)
Oggi Claris ha rilasciato uno strumento di creazione di connettori personalizzati. Per poter creare il nostro primo connettore dovremo avere già familiarità con tutto ciò che segue:
- Formato di interscambio JSON e sua sintassi;
- Funzionamento e architettura delle API (Application Programming Interfaces);
- Capacità di leggere e comprendere la documentazione delle API;
- Conoscenza di base dei diversi sistemi di autenticazione per API.
E’ possibile partire da zero, oppure da una lista di template pronti e funzionanti, che potranno essere adattati per le nostre esigenze.
Dalla pagina iniziale di Claris Connect (connect.claris.com)
- Cliccare sul tab Custom Connectors
- Cliccare su Create a new connector.
- Compilare il JSON del vostro connettore personalizzato, e poi fare click su Create.
L’editor dispone di un controllo di struttura e sintassi, pertanto non sarà possibile salvare il proprio connettore personalizzato finché non verranno corretti tutti gli eventuali errori ed omissioni.
Ogni connettore descritto tramite JSON deve contenere tutte queste sezioni:
- Proprietà e meta dati
- Auth Components
- requiredSettings e authFields
- Auth Request
- Endpoints
- testConnection
- Actions
Ecco un esempio di connettore personalizzato che può essere utilizzato per interrogare le API di OpenAI, in particolare il servizio “Completions”
{
"schema": "1.0",
"name": "OpenAI - workshop",
"link": "https://www.openai.com",
"description": "My awesome OpenAI connector",
"auth_components": {
"type": "none"
},
"requiredSettings": {
"authFields": [
{
"label": "API key",
"key": "api_key",
"description": "API key",
"masked": true
}
]
},
"auth_request": {
"type": "bearer",
"token": "{{authFields.api_key}}"
},
"endpoints": {
"GET": {
"/models": {
"url": "https://api.openai.com/v1/"
}
},
"POST": {
"/completions": {
"url": "https://api.openai.com/v1/"
}
}
},
"testConnection": {
"endpoint": "/models",
"method": "GET"
},
"actions": [
{
"modelId": "create",
"actionId": "completion",
"endpoint": "/completions",
"method": "POST",
"label": "Create completion",
"helpText": "Creates a completion for a prompt",
"actionFields": [
{
"key": "model",
"label": "Model",
"description": "Model to use",
"type": "string",
"required": true
},
{
"key": "prompt",
"label": "Prompt",
"description": "Prompt for the completion",
"type": "string",
"required": true
},
{
"key": "max_tokens",
"label": "Max tokens",
"description": "Maximum number of tokens to return",
"type": "number",
"required": false
}
]
}
]
}
Funzionalità non supportate al momento del rilascio
I connettori personalizzati, alla data di scrittura (Agosto 2023), hanno alcune limitazioni:
- Un connettore personalizzato è in grado di gestire solo delle Azioni (i Trigger non sono supportati)
- Supporto limitato per l’autenticazione verso API (per es. Oauth 2.0 non è al momento supportato)
- Una volta confermati e pubblicati, i connettori personalizzati non possono essere aggiornati o modificati. E’ necessario quindi salvare una copia del JSON del proprio connettore ed utilizzarla come base per svilupparne uno nuovo.
Prossimi passi
Ci auguriamo che questa breve introduzione ai Connettori Personalizzati in Claris Connect vi sia stata utile.
Visitate la pagina del sito Claris relativa a Claris Connect e la sezione della guida in linea dei Connettori Personalizzati a questo indirizzo: https://help.claris.com/en/connect-help/content/creating-custom-connectors.html
E per un’eventuale consulenza su Claris Connect e sui nuovi Connettori Personalizzati, contattateci