Airtable

Esempi di configurazione della connessione

Questa sezione elenca i valori di esempio per i vari campi che configuri durante la creazione della connessione.

Tipo di connessione con token di accesso personale

Entità, operazioni e azioni

Tutti i connettori di integrazione forniscono un livello di astrazione per gli oggetti dell'applicazione connessa. Puoi accedere agli oggetti di un'applicazione solo tramite questa astrazione. L'astrazione ti viene mostrata come entità, operazioni e azioni.

• Entità : un'entità può essere considerata un oggetto o una raccolta di proprietà nell'applicazione o nel servizio connesso. La definizione di un'entità varia da un connettore all'altro. Ad esempio, in un connettore di database, le tabelle sono le entità, in un connettore del file server, le cartelle sono le entità e in un connettore del sistema di messaggistica, le code sono le entità.

  Tuttavia, è possibile che un connettore non supporti o non abbia entità, nel qual caso l'elenco Entities sarà vuoto.

• Operazione : un'operazione è l'attività che puoi eseguire su un'entità. Puoi eseguire una delle seguenti operazioni su un'entità:
  • Elenca
  • Scarica
  • Crea
  • Aggiorna
  • Elimina

  Selezionando un'entità dall'elenco disponibile, viene generato un elenco di operazioni disponibili per l'entità. Per una descrizione dettagliata delle operazioni, consulta le operazioni sulle entità dell'attività Connettori. Tuttavia, se un connettore non supporta alcuna delle operazioni sulle entità, queste operazioni non supportate non sono elencate nell'elenco Operations.

• Azione: un'azione è una funzione di prima classe resa disponibile per l'integrazione tramite l'interfaccia del connettore. Un'azione ti consente di apportare modifiche a una o più entità e varia da connettore a connettore. In genere, un'azione ha alcuni parametri di input e un parametro di output. Tuttavia, è possibile che un connettore non supporti alcuna azione, nel qual caso l'elenco Actions sarà vuoto.

Esempi di operazioni sulle entità

Questa sezione mostra come eseguire alcune delle operazioni sulle entità in questo connettore.

Esempio: operazione di elenco per l'entità Dati di contatto (record)

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Contact Data dall'elenco Entity.
3. Seleziona l'operazione List, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, puoi impostare la filterClause in base ai requisiti del cliente.

Specifica sempre il valore della clausola di filtro tra virgolette singole (').

Puoi eseguire operazioni di elenco anche sulle seguenti entità:
Contacts Data.Main View, Contacts Data.Calendar, Contacts Data.Kanban, Contacts Data.Gallery, Contacts Data.List e Contacts Data_Collaborators

Esempio: recupera il record per l'entità Dati di contatto (record)

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Contact Data dall'elenco Entity.
3. Seleziona l'operazione GET, quindi fai clic su Fine.
4. Imposta l'ID entità su "recg7qjPRMa7DBwIb", ovvero la chiave da trasferire. Per impostare l'ID entità, nella sezione Data Mapper di Data Mapping, fai clic su Open Data Mapping Editor, quindi inserisci "recg7qjPRMa7DBwIb" nel campo Input Value e scegli EntityId come variabile locale.

   In questo caso, Entity Id: "recg7qjPRMa7DBwIb" è il valore univoco della chiave primaria e deve essere trasmesso direttamente.

Se l'entità ha una chiave primaria composita, puoi specificare una clausola di filtro.

Puoi eseguire l'operazione get anche sulle seguenti entità: Contacts Data.Main View, Contacts Data.Calendar, Contacts Data.Kanban, Contacts Data.Gallery, Contacts Data.List e Contacts Data_Collaborators.

Esempio: elimina un record dell'entità Dati di contatto (record)

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Contact Data dall'elenco Entity.
3. Seleziona l'operazione Delete, quindi fai clic su Fine.
4. Imposta l'ID entità su "recg7qjPRMa7DBwIb", che è la chiave da trasferire.Per impostare l'ID entità, nella sezione Data Mapper di Mappatura dei dati, fai clic su Apri editor di mappatura dei dati, inserisci "recg7qjPRMa7DBwIb" nel campo Valore di input e scegli EntityId come variabile locale.

Se l'entità ha una chiave primaria composita, puoi specificare una clausola di filtro.

Esempio: crea operazione per l'entità Dati di contatto (record)

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Contact Data dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

   {
   "First Name": "Demo4",
   "Last Name": "Alex",
   "Email": "cloudysanfrancisco@gmail.com",
   "DOB": "2000-04-14",
   "Office": "Denver",
   "Phone Number": "1-175-432-1437",
   "Current Brand": "Mercedes"
   }
   

   Se l'integrazione ha esito positivo, il parametro connectorOutputPayload response dell'attività del connettore avrà un valore simile al seguente:

   {
   "Internal_Id": "recg7qjPRMa7DBwIb"
   }
     
   <pre>
     function helloWorld() {
       alert('Hello, world! This sentence is so long that it wraps onto a second
         line.');
     }
     
     /n
     <h3>Example title</h3>
     </pre>
   

Esempio: operazione di aggiornamento per l'entità Dati di contatto (record)

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona ContactData dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   {
   "Phone Number": "1-175-432-4312",
   "Current Brand": "Honda"
   }
   

   Anziché specificare entityId, puoi anche impostare filterClause su Internal_Id='reckqGnFusjDlnmvs'.

Se l'integrazione va a buon fine, la variabile di output connectorOutputPayload dell'attività del connettore:

{
"Internal_Id": "reckqGnFusjDlnmvs"
}

Esempio: operazione di aggiornamento per l'entità Dati di contatto (allegato)

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Contact Data dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   {
   "Attachment": "[{\"url\":\"https://media.istockphoto.com/id/2086323995/photo/global-communication-east-asia.jpg?s=2048x2048&w=is&k=20&c=Z50lesspQQzxWug0m11QrPZMOUzMeTufgnLHh_3COy4=\",\"filename\":\"BMW\"}]"
   }
   

   Anziché specificare entityId, puoi anche impostare filterClause su Internal_Id='reckqGnFusjDlnmvs'.

   Se l'integrazione va a buon fine, la variabile di output connectorOutputPayload dell'attività del connettore:

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

Esempio: operazione di aggiornamento per l'entità Dati di contatto (casella di controllo)

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Contact Data dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   {
   "Checkbox": true
   }
   

   Anziché specificare entityId, puoi anche impostare filterClause su Internal_Id='reckqGnFusjDlnmvs'.

   Se l'integrazione va a buon fine, la variabile di output connectorOutputPayload dell'attività del connettore:

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

Esempio: operazione di aggiornamento per l'entità Dati di contatto (numero)

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona ContactData dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   {
   "Number": 1001.0
   } 
   

   Anziché specificare entityId, puoi anche impostare filterClause su Internal_Id='reckqGnFusjDlnmvs'.

   Se l'integrazione va a buon fine, la variabile di output connectorOutputPayload dell'attività del connettore:

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   } 
   

Esempio: operazione di aggiornamento per l'entità Contact Data (DateField)

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona ContactData dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   {
   "DOB": "2000-04-14"
   } 
   

   Anziché specificare entityId, puoi anche impostare filterClause su Internal_Id='reckqGnFusjDlnmvs'.

   Se l'integrazione va a buon fine, la variabile di output connectorOutputPayload dell'attività del connettore:

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

Esempio: operazione di aggiornamento per l'entità Dati di contatto (testo)

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona ContactData dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   {
   "Singlelinetext": "Airtable Application",
   "Long text": "Airtable is a cloud-based collaboration platform that combines the features of a spreadsheet with the capabilities of a database. "
   }
   

   Anziché specificare entityId, puoi anche impostare filterClause su Internal_Id='reckqGnFusjDlnmvs'.

   Se l'integrazione va a buon fine, la variabile di output connectorOutputPayload dell'attività del connettore:

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }