Vai alla guida
ErinTech Labs

GUIDE ALLA CONFIGURAZIONE / ERINTECH CONNECT

Porta dati pubblici in Framer.

Controlla le modifiche, importa bozze e pubblica quando sei pronto. Oppure collega una console di richieste in sola lettura a un feed pubblico compatibile.

Beta pubblica 0.2.4 · Gratuito sul Marketplace Framer. Non servono un account ErinTech o una chiave API. Tracefield è un template separato.

Scegli il risultato che ti serve.

Il plugin funziona nell’editor Framer. Gli import CMS copiano i campi selezionati nel progetto. Request Console è un componente separato che può leggere dati pubblici anche dopo la chiusura del plugin.

  1. Apri ErinTech Connect sul Marketplace Framer, scegli Open Plugin e seleziona il tuo progetto. Per imparare il flusso usa una copia non pubblicata.
  2. Per articoli e contenuti strutturati, parti da Included example o ErinTech demo API — CMS content, poi scegli CMS import.
  3. Per il visualizzatore interattivo di richieste, scegli ErinTech demo API — requests, poi Request console. Apri il plugin dal canvas per inserire componenti.
  4. Per dati tuoi, scegli Public API e inserisci un URL HTTPS con accesso CORS dal browser. Non includere credenziali, chiavi API o dati privati.

La sincronizzazione è manuale. Il plugin non ospita API, interroga database privati, pianifica import o gestisce autenticazione. Il template funziona con dati di esempio anche senza plugin.

Importa i primi tre elementi in bozza.

Usa l’esempio incluso per imparare il flusso prima di collegare un feed tuo.

  1. Seleziona Included example → Load source → CMS import. Mantieni Records path /items, Stable ID path /id e le mappature suggerite. Assegna un nome alla raccolta.
  2. Scegli Review import. Apri Preview mapped values e controlla le azioni per ciascun ID. Questo passaggio non scrive contenuti.
  3. Scegli Apply 3 changes. Apri il CMS Framer e controlla i tre record in bozza. Collega la raccolta al layout desiderato e rivedilo prima di pubblicare.
  4. Per la sincronizzazione successiva ricarica la stessa sorgente, scegli Find existing connections e seleziona la raccolta. Ripeti la revisione: dati identici dovrebbero proporre zero modifiche.

Crea una nuova raccolta per cambiare URL sorgente o mappatura di una connessione. Sono supportati fino a otto campi testo, numero o booleano, 100 record sorgente per import e 500 elementi nella destinazione.

Mantieni visibili le modifiche manuali.

L’import associa i record tramite ID esterno stabile. Le modifiche manuali ai campi mappati diventano conflitti e vengono saltate. Gli altri campi sono preservati; gli elementi assenti dalla sorgente non vengono cancellati automaticamente.

  1. Mantieni External ID invariato. Non rimuovere campi mappati e non cambiarne il tipo. Puoi rinominare le etichette perché le mappature seguono l’identità del campo.
  2. Se appare un conflitto, confronta sorgente e destinazione e decidi dove deve stare il valore definitivo. Non esiste un comando di sovrascrittura forzata.
  3. Se un import si interrompe, conserva i record completati, ricarica la stessa sorgente e rivedi la destinazione prima di riprovare. Un errore non implica l’annullamento dell’intero import.

Collega il visualizzatore di richieste.

Carica ErinTech demo API — requests e scegli Request console. La demo ospitata contiene sei richieste simulate attraverso una vera connessione HTTPS: è una fotografia fissa, non attività reale di clienti.

  1. Scegli Insert console e posiziona il componente in uno stack responsive. Apri Preview e controlla ricerca, filtri di stato, ordinamento e dettagli.
  2. Per aggiornare una console compatibile esistente, selezionala sul canvas, scegli Inspect selected console e controllane il nome. Configure selected console cambia solo sorgente e URL; mantiene le impostazioni visive.
  3. Usa Included example per una console con richieste di esempio locali. Per un feed reale seleziona Public API e carica una risposta nel formato versione 1 collegato sotto.
  4. Prova Preview e il dominio finale pubblicato. L’accesso dall’editor non dimostra che il dominio pubblico abbia i permessi CORS necessari.

Il feed accetta fino a 100 richieste con ID univoci. Ogni record richiede id, workflow, model, status, durationMs, costUsd, tokens, startedAt e summary. Status può essere completed, retried o error; le metriche sono numeri finiti non negativi e le date sono ISO UTC. Un array requests vuoto è valido. Il limite è 200.000 caratteri per risposta, con timeout di dieci secondi e Refresh manuale.

Trova il prossimo passo utile.

Fai questi controlli prima di chiedere supporto. Non inserire credenziali o record privati nelle schermate e nelle segnalazioni.

La sorgente non si carica

Controlla HTTPS, risposta JSON valida e permessi CORS del browser. Credenziali, host locali o privati, redirect e parametri URL simili a token vengono rifiutati intenzionalmente. Per un’API privata serve un backend tuo che esponga solo dati approvati per la pubblicazione.

La sorgente si carica ma non è compatibile con la console

Request Console richiede il formato descritto sopra. Per JSON diversi usa CMS import con mappature esplicite. Importare contenuti non li trasforma in un feed di richieste.

La revisione segnala un percorso mancante o un tipo errato

Usa percorsi JSON Pointer, ad esempio /items e /title. Fai corrispondere il tipo di campo al valore sorgente e mantieni un ID stabile. Le connessioni esistenti conservano lo schema; per cambiarlo crea una nuova raccolta.

Il componente selezionato non è configurabile

Seleziona un solo ErinTech Request Console supportato e ripeti l’ispezione. L’inserimento è disponibile dal canvas. Il plugin non sovrascrive componenti arbitrari e non aggiorna di nascosto il codice già installato.

Il CMS è aggiornato ma la pagina no

Verifica che la pagina sia collegata alla raccolta importata e che l’elemento non sia ancora in bozza. Importare una raccolta non sostituisce i collegamenti Field Notes già presenti nel template.

Sapere dove vanno i dati.

Il plugin richiede i feed direttamente dal browser all’endpoint scelto senza credenziali. Non contiene analytics, pubblicità o un endpoint ErinTech per caricare i tuoi dati.

  1. I valori CMS mappati vengono scritti nel progetto Framer. I metadati di connessione conservano URL sorgente, mappatura e impronte SHA-256 per i confronti. Queste impronte non sono un sistema di cifratura o segretezza.
  2. La console pubblica conserva l’URL del feed nel progetto e lo legge dal browser dei visitatori. Chiunque può ispezionare la risposta. Usa solo dati destinati alla pubblicazione.
  3. Il gestore del feed e Framer elaborano le richieste necessarie al servizio. Caricare i feed demo ErinTech contatta il nostro hosting; i normali log di accesso possono contenere metadati delle richieste. Questa guida e il plugin non aggiungono analytics o cookie di tracciamento.
  4. Per disconnettere, interrompi gli import e rimuovi o riconfigura la console. Elementi importati e metadati restano in Framer finché non rimuovi la raccolta interessata con i controlli di Framer.

La checklist di questa guida non salva dati: le spunte restano solo nella sessione corrente e si azzerano ricaricando la pagina. Il supporto passa dal sito aziendale separato e dalla sua informativa privacy.

CHECK / 06

La tua checklist di lancio

Segna i controlli completati. Le spunte restano solo in questa pagina e si azzerano al ricaricamento. Puoi stampare la guida dal browser.

La tua checklist di lancio

0 / 6 verificati

Serve una mano?

Per domande sul template o sul plugin, indica la versione e come riprodurre il problema con dati di esempio. Configurazioni su misura e integrazioni si preventivano separatamente.

info@erintechlabs.com