OneDeclarativeConn (anteprima)

Ottenere le fatture uno per uno da GetMyInvoices. Se si esegue questo connettore, è possibile ottenere l'ultima fattura da GetMyInvoices. Ciò significa che se si esegue il connettore una sola volta, si otterrà un dato della fattura e l'ultimo ID fattura verrà aumentato. Successivamente, se si esegue di nuovo questo connettore, si otterranno i dati della fattura successivi in base all'ultimo ID fattura e verrà aumentato anche l'ultimo ID fattura. Se non è più presente alcun ID fattura, il connettore restituirà un valore vuoto.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

OneDeclarativeFlow

Consente le operazioni di base sul software Contract Insight (Add, Insert, Update) e le informazioni sullo schema per un'entità.

Autore: CobbleStone Software

Prerequisiti

Richiede una licenza esistente per CobbleStone Software (Contact Insight).

Operazioni supportate

Get

Elenco di record pull per una determinata entità con criteri specifici, ordine per tag, raggruppamento per tag e numero di record. Nota: non è previsto alcun limite per il numero di record da estrarre, ma l'utente deve considerare che i risultati più grandi saranno più lenti da elaborare.

Aggiungere

Aggiungere un record (limitato a un record per ogni chiamata) all'entità specificata. La risposta sarà l'ID generato dal sistema.

Update

Aggiornare i record per un'entità o un'area specificata con criteri specifici e un triggerWorkflow come flag per l'esecuzione del flusso di lavoro dopo che la richiesta di aggiornamento ha esito positivo o negativo. Il numero massimo di record che è possibile aggiornare è 500 per chiamata.

Schema

Elenca colonne, tipi di dati e eventuali restrizioni o flag (NULL, Lunghezza, Chiave primaria e così via) in una tabella.

Elenco di entità

Restituisce l'elenco di nomi e tre proprietà contrassegnate che indicano se possono essere modificate, aggiornate o visualizzate o sottoposte a query tramite questa interfaccia.

Recupero delle credenziali

Autorizzazione (OAUTH 2.0)

• CobbleStone Software offre due metodi di autorizzazione per l'accesso:
  • Codice di autorizzazione: https://oauth.net/2/grant-types/authorization-code/
  • Concessione implicita: https://oauth.net/2/grant-types/implicit/

Le credenziali possono essere configurate/generate tramite il sistema CobbleStone Software.

Come iniziare

Per creare le credenziali client DELL'API tramite il sistema CobbleStone Software, seguire questa procedura:

All'interno del sistema CobbleStone Software, un amministratore di sistema può passare alla pagina seguente per configurare/configurare le credenziali:

• Per i client SaaS: https://yourCompanyName.cobblestone.software/core/MyAPI.aspx
• Per i client distribuiti (in genere): https://yourCompanyName/core/MyAPI.aspx

(NOTA: si trova sotto la voce di menu "My" in alto e quindi selezionare "My API Clients")

In questo modo un amministratore di sistema può creare credenziali OAuth 2.0 (ID client e segreto client) da usare con il connettore.

Dall'accesso al sistema CobbleStone Software:

Per iniziare, si aprirà CobbleStone Software e si passerà in My > MY API Clients...

Creare una nuova voce client API facendo clic su Aggiungi client API e assegnargli un nome univoco. Il nome è solo interno e può essere qualsiasi elemento significativo per il suo scopo. È consigliabile usare una chiave API diversa per organizzare gli elementi in attività di piccole dimensioni, gestibili e intenzionali.

Verrà generata una chiave e solo il personale amministratore avrà accesso alla pagina. È associato alla persona che ha generato la chiave e sono l'unico che può vederla. È possibile condividere la chiave, ma solo l'utente connesso può visualizzarlo.

A questo punto è stata completata la configurazione della voce client API. Questo ID client e Client Securet vengono usati per il connettore per comunicare con il sistema CobbleStone Software.

Problemi noti e limitazioni

Attualmente il connettore non supporta l'invio o la ricezione di file binari.

L'endpoint "Update" è limitato a un massimo di 500 righe interessate per hit. Se è necessario aggiornare più di 500 record, è necessario elaborarlo in più riscontri.

Limiti per la limitazione delle richieste

Azioni

Ottenere un documento di fattura da GetMyInvoices