Home › PAC Software › PAC Product Bridge for WooCommerce › Documentazione
DOCUMENTAZIONE PAC SOFTWARE
PAC Products Bridge per WooCommerce
Documentazione tecnica per le notifiche in tempo reale di prodotti e variazioni WooCommerce verso Claris FileMaker tramite FileMaker Data API.
Versione 1.0.0 • Aggiornato settembre 2026
Evento prodotto WooCommerce
Un prodotto o una variazione cambia
PAC Products Bridge
Identifica l'oggetto e l'evento
FileMaker Data API
Esegue l'autenticazione ed esegue lo script
Script FileMaker
Applica la logica di sincronizzazione del tuo catalogo
1. Panoramica
Collega in tempo reale le modifiche ai prodotti e alle variazioni WooCommerce a FileMaker. PAC Products Bridge per WooCommerce è un plugin WordPress che collega gli eventi dei prodotti e delle variazioni WooCommerce a Claris FileMaker Server tramite FileMaker Data API.
Quando si verifica un evento supportato relativo a un prodotto o a una variazione in WooCommerce, il plugin richiama in tempo reale uno script FileMaker e passa le informazioni sull'oggetto WooCommerce interessato. La creazione, l'aggiornamento e l'eliminazione dei prodotti, così come la creazione, l'aggiornamento e l'eliminazione delle variazioni, sono supportati nell'edizione gratuita.
L'integrazione è basata sugli eventi: WooCommerce notifica FileMaker quando cambia un prodotto o una variazione. Non sono necessari polling programmati, middleware o piattaforme esterne di sincronizzazione. La tua soluzione FileMaker resta responsabile dell'interpretazione del parametro ricevuto, del recupero dei dati aggiuntivi necessari al flusso di lavoro e dell'applicazione della tua logica di sincronizzazione o di business.
Professional aggiunge opzioni orientate all'uso in produzione, come eventi relativi a scorte e prezzi, invio in background, nuovi tentativi automatici, strumenti per il reinvio manuale, modalità di payload personalizzate, JSON completo di WooCommerce disponibile localmente, opzioni per i certificati e diagnostica avanzata.
Modifiche ai prodotti in tempo reale, sotto il tuo controllo.
PAC Products Bridge comunica a FileMaker cosa è cambiato non appena WooCommerce genera un evento supportato relativo a un prodotto o a una variazione, mentre tutta la logica di elaborazione resta nella tua soluzione FileMaker.
2. Vantaggi principali
Notifiche in tempo reale
FileMaker riceve una notifica immediata quando cambiano in WooCommerce i dati di un prodotto o di una variazione supportati.
Prodotti e variazioni
Gestisci i prodotti principali e le singole variazioni come oggetti WooCommerce separati, ciascuno con il proprio ID.
La tua logica di business
Utilizza i tuoi script FileMaker per recuperare dati, aggiornare record, archiviare gli elementi eliminati e avviare flussi di lavoro successivi.
Integrazione diretta
Collega WooCommerce direttamente a FileMaker Data API senza polling o middleware di terze parti.
3. Come funziona
PAC Products Bridge ascolta gli eventi supportati dei prodotti WooCommerce ed esegue lo script FileMaker configurato.
WooCommerce
Si verifica un evento supportato relativo a un prodotto o a una variazione
PAC Products Bridge
Costruisce il parametro dello script per la modalità di payload configurata
FileMaker Data API
Apre una sessione ed esegue lo script
Script FileMaker
Applica la logica di sincronizzazione del tuo catalogo o la logica di business
Flusso tipico:
1
Un prodotto o una variazione WooCommerce viene creato, aggiornato o eliminato.
2
PAC Products Bridge identifica l'oggetto interessato e il tipo di evento.
3
Il plugin apre una sessione FileMaker Data API ed esegue lo script configurato.
4
Nell'edizione gratuita, lo script riceve tramite script.param un valore compatto nel formato event|ID. In Professional, lo script può ricevere un parametro evento compatto oppure un payload più ricco, come il JSON del prodotto o della variazione WooCommerce disponibile localmente, in base alla configurazione. Lo script FileMaker interpreta il parametro, recupera o analizza gli eventuali dati aggiuntivi richiesti dal flusso di lavoro e aggiorna la tua soluzione.
5
Il plugin registra il risultato e chiude la sessione FileMaker Data API.
Il controllo resta nelle tue mani.
PAC Products Bridge notifica FileMaker e avvia il tuo script. Non impone uno schema FileMaker e non modifica direttamente i record FileMaker.
4. Requisiti
Per utilizzare PAC Products Bridge per WooCommerce, sono necessari i seguenti componenti:
WordPress (supportato e aggiornato) e PHP 7.4 o versione successiva
WooCommerce (supportato e aggiornato)
Data API abilitata sul tuo FileMaker Server
Sito web con HTTPS abilitato
Claris FileMaker Server o un endpoint FileMaker Data API compatibile
Host raggiungibile e credenziali valide (ad esempio, un account dedicato)
Uno script di destinazione e un layout configurati lato FileMaker
5. Installazione
Installa PAC Products Bridge da WordPress, quindi configura e testa la connessione FileMaker. Prima di andare in produzione, esegui test end-to-end in un ambiente di staging per assicurarti che tutto funzioni come previsto.
1
Scarica
il plugin
2
Carica in
WordPress
3
Attiva
il plugin
4
Configura
le impostazioni della connessione
5
Testa
end-to-end in staging
6. Configurazione
PAC Products Bridge è configurato direttamente da WooCommerce.
Dove trovare le impostazioni
WooCommerce > Impostazioni > Integrazioni > PAC Products Bridge per WooCommerce.
Da questa pagina puoi configurare la connessione condivisa a FileMaker Data API, definire la destinazione FileMaker utilizzata dal bridge, scegliere come vengono elaborati gli invii Professional, selezionare la strategia del payload ed eseguire test della connessione e test end-to-end.
L'edizione gratuita utilizza un database, un layout e uno script FileMaker per tutti gli eventi supportati del ciclo di vita di prodotti e variazioni. Lo script FileMaker configurato riceve tramite script.param un valore compatto event|ID. Professional mantiene lo stesso modello diretto con FileMaker Data API e aggiunge eventi relativi a scorte e prezzi, invio in background, nuovi tentativi automatici, strumenti per il reinvio manuale, modalità di payload personalizzate, JSON completo di WooCommerce disponibile localmente, opzioni per i certificati e diagnostica avanzata.
6.1 Impostazioni della connessione
L'edizione gratuita invia immediatamente gli eventi del ciclo di vita dei prodotti come event|ID allo script FileMaker configurato.
Configura la connessione FileMaker utilizzata da PAC Products Bridge. Il server deve essere un URL HTTPS completo senza slash finale. Database, layout e script identificano la destinazione FileMaker, mentre l'account deve avere accesso alla Data API. La password viene memorizzata in forma crittografata; lascia vuoto il campo per mantenere il valore salvato.
Connessione FileMaker
Abilita
✓
Abilita PAC Products Bridge
Server FileMaker
https://fm.example.com
URL completo di FileMaker Server con HTTPS, senza slash finale.
Versione Data API
v1
⌄
Database
Layout
Layout FileMaker utilizzato come contesto dello script.
Script
L'edizione gratuita passa event|ID come script.param, ad esempio product.updated|123.
Nome utente FileMaker
Password FileMaker
Memorizzata in forma crittografata utilizzando i salt di sicurezza di WordPress. Lascia vuoto per mantenere la password salvata.
Timeout HTTP
30
⌃
⌄
6.2 Eventi supportati e script.param
L'edizione gratuita invia gli eventi del ciclo di vita di prodotti e variazioni come event|ID. Professional aggiunge eventi relativi a scorte e prezzi e ulteriori opzioni per i payload.
Edizione gratuita: invia gli eventi del ciclo di vita di prodotti e variazioni come script.param nel formato event|ID.
Modifiche alle scorte: abilita questa opzione quando FileMaker deve ricevere notifiche sulle scorte di prodotti o variazioni.
Modifiche ai prezzi: abilita questa opzione quando FileMaker deve ricevere notifiche sui prezzi normali, in saldo o attivi.
Modalità di invio: Immediato invia ogni evento supportato non appena si verifica la modifica in WooCommerce.
JSON completo di WooCommerce: passa in script.param la rappresentazione completa del prodotto o della variazione disponibile localmente. La rappresentazione include pac_bridge_event; i file immagine non sono incorporati e FileMaker non deve chiamare l'API WooCommerce.
Parametro dello script: scegli Evento + ID WooCommerce, JSON base del prodotto o Modello personalizzato. Questa selezione viene ignorata quando è abilitato il JSON completo di WooCommerce.
Modello del parametro: utilizza le parentesi graffe, ad esempio {event}|{id}; i segnaposto supportati sono elencati di seguito.
Eventi e payload Professional
Professional
Modifiche alle scorte
✓
Notifica FileMaker quando cambiano le scorte di un prodotto o di una variazione
Modifiche ai prezzi
✓
Notifica FileMaker quando cambiano il prezzo normale, il prezzo in saldo o il prezzo attivo
Modalità di invio
Immediato
L'invio immediato trasmette ogni evento supportato non appena si verifica la modifica in WooCommerce.
JSON completo di WooCommerce
✓
Passa a FileMaker il JSON REST completo del prodotto o della variazione WooCommerce
Quando abilitato, script.param contiene la rappresentazione REST completa di WooCommerce disponibile localmente, oltre a pac_bridge_event. FileMaker non deve effettuare chiamate all'API WooCommerce. I file immagine non vengono incorporati.
Parametro dello script
Evento + ID WooCommerce
Ignorato quando è abilitato il JSON completo di WooCommerce. Opzioni: Evento + ID WooCommerce, JSON base del prodotto o Modello personalizzato.
Modello del parametro
{event}|{id}
Segnaposto: {event}, {id}, {parent_id}, {sku}, {name}, {type}, {status}, {regular_price}, {sale_price}, {price}, {stock_quantity}, {stock_status}.
Eventi del ciclo di vita gratuiti
product.created
product.updated
product.deleted
variation.created
variation.updated
variation.deleted
script.param = event|ID
Esempi
product.updated|123
variation.created|456
6.3 Opzioni di affidabilità — Professional
Controlli per l'invio in background, i nuovi tentativi e il recupero manuale.
Nuovo tentativo automatico: ripete i tentativi per gli errori transitori idonei di FileMaker o della rete senza intervento manuale.
Numero massimo di tentativi: imposta il numero totale dei tentativi di invio, incluso il tentativo iniziale.
Intervallo tra i tentativi (minuti): imposta il tempo di attesa prima del tentativo successivo dopo un errore idoneo.
Reinvio manuale: aggiunge “Invia a FileMaker” alle azioni delle righe dei prodotti WooCommerce, così è possibile inviare nuovamente un singolo prodotto o una variazione.
Invio e recupero Professional
Nuovo tentativo automatico
✓
Ripete automaticamente i tentativi per gli errori transitori di FileMaker o della rete
Ripete i tentativi per gli errori temporanei idonei di FileMaker o della rete senza intervento manuale.
Numero massimo di tentativi
3
Numero totale dei tentativi di invio, incluso il tentativo iniziale.
Intervallo tra i tentativi (minuti)
5
Minuti di attesa prima del tentativo successivo dopo un errore transitorio idoneo.
Reinvio manuale
Aggiungi “Invia a FileMaker” alle azioni delle righe dei prodotti WooCommerce
Aggiunge un'azione manuale Invia a FileMaker a ogni riga di prodotto WooCommerce, così è possibile inviare nuovamente un singolo prodotto o una variazione.
6.4 Diagnostica e test
Utilizza questi strumenti per verificare la connessione FileMaker e l'esecuzione dello script. I test utilizzano il server, il database, il layout e lo script configurati; non sostituiscono un vero evento prodotto WooCommerce.
Ultima comunicazione: mostra il risultato di invio registrato più di recente, inclusi timestamp ed event|ID.
Cancella stato: rimuove il risultato di comunicazione salvato; non invia una richiesta.
Test della connessione: verifica la raggiungibilità e l'autenticazione di FileMaker Server senza eseguire lo script di destinazione.
Parametro del test dello script: è il valore event|ID passato allo script FileMaker configurato come script.param.
Test dello script: esegue lo script configurato con quel valore, separatamente da un evento WooCommerce reale.
Diagnostica e test
Ultima comunicazione
Evento del prodotto inviato correttamente a FileMaker
Ultimo risultato registrato: 2026-10-12 10:42:03 — product.updated|123.
Cancella stato
Cancella stato
Cancella il risultato di comunicazione salvato mostrato sopra; non invia una richiesta.
Test della connessione
Testa connessione
Verifica la raggiungibilità e l'autenticazione di FileMaker Server senza eseguire lo script di destinazione.
Parametro del test dello script
product.updated|123
Inserisci il valore event|ID che il test dello script riceverà come script.param.
Test dello script
Esegui test dello script
Esegue lo script FileMaker configurato utilizzando il valore sopra indicato; è separato da un evento WooCommerce reale.
7. Versione gratuita vs Professional
Confronta le funzionalità del prodotto disponibili nelle edizioni gratuita e Professional.
Funzionalità
Gratuita
Professional
Connessione diretta a FileMaker Data API
√
√
Eventi di creazione, aggiornamento ed eliminazione dei prodotti
√
√
Eventi di creazione, aggiornamento ed eliminazione delle variazioni
√
√
Parametro event|ID
√
√
Invio immediato
√
√
Test della connessione e dello script
√
√
Eventi relativi alle modifiche delle scorte
—
√
Eventi relativi alle modifiche dei prezzi
—
√
Invio in background
—
√**
Nuovi tentativi automatici
—
√***
Invio/reinvio manuale del prodotto
—
√
JSON base del prodotto
—
√
Modello personalizzato del parametro
—
√
JSON completo di WooCommerce disponibile localmente
—
√*
Opzioni personalizzate per CA / certificati
—
√
Diagnostica avanzata
—
√****
* Il JSON completo di WooCommerce disponibile localmente è disponibile in Professional quando abilitato; i file immagine non vengono incorporati.
** L'invio in background è disponibile in Professional.
*** I nuovi tentativi automatici si applicano solo agli errori idonei dopo il tentativo iniziale.
**** La diagnostica avanzata è inclusa solo quando viene esposta dalla versione corrente del prodotto.
8. Funzionalità Professional
Estendi le notifiche del ciclo di vita con maggiori dettagli sugli eventi e controllo dell'invio.
Professional include il flusso di lavoro dell'edizione gratuita basato sugli eventi del ciclo di vita e sul parametro compatto. Le opzioni aggiuntive modificano quali eventi vengono inviati, come viene costruito il parametro e come viene gestito l'invio. Non sostituiscono la tua logica di business FileMaker.
Eventi relativi a scorte e prezzi
Ricevi eventi dedicati e notifiche sulle impostazioni delle scorte di prodotti e variazioni, oltre alle notifiche derivanti dalle modifiche ai metadati dei prezzi.
JSON base e modelli personalizzati
Invia un insieme definito di campi del prodotto o componi un parametro testuale a partire dai segnaposto supportati.
JSON completo di WooCommerce
Passa la rappresentazione dell'oggetto preparata localmente con pac_bridge_event, inclusi i metadati delle immagini quando disponibili.
Invio in background
Accoda il parametro preparato tramite Action Scheduler, con un fallback agli eventi pianificati di WordPress.
Nuovi tentativi automatici
Ripeti i tentativi per gli errori idonei con un limite totale e un intervallo configurabili, anche dopo un primo tentativo immediato.
Invio manuale del prodotto
Invia il prodotto corrente dall'azione della riga nell'elenco Prodotti utilizzando la configurazione salvata.
Gestione personalizzata dei certificati
Utilizza la verifica con CA pubblica, una CA personalizzata in formato PEM o una modalità selezionata esplicitamente con sola crittografia.
Codice di supporto diagnostico
Il pacchetto include un collector diagnostico; la versione 1.0.0 non lo espone come strumento nella pagina delle impostazioni. Consulta la sezione 6.6.
9. Implementazione lato FileMaker
Sul tuo FileMaker Server, prepara uno script che riceva gli eventi relativi a prodotti e variazioni ed esegua la tua logica di business.
I passaggi seguenti descrivono una tipica architettura di integrazione. PAC Product Bridge consegna un parametro tramite FileMaker Data API ed esegue lo script configurato. La tua soluzione FileMaker implementa la convalida del parametro, il recupero dei dati, l'associazione dei record e l'elaborazione successiva. Il bridge non impone una struttura di tabelle FileMaker e non crea uno script di importazione per te.
Nell'edizione gratuita, lo script riceve event|ID, ad esempio product.updated|123 o variation.updated|456. Professional può utilizzare lo stesso formato compatto, JSON base del prodotto, un Modello personalizzato o il JSON completo di WooCommerce. Interpreta l'input in base alla modalità configurata; consulta le sezioni 6.3 e 6.4 per formati, campi e comportamento di fallback.
Utilizza uno script di ingresso per la destinazione configurata, quindi indirizza gli eventi relativi a prodotti, variazioni, scorte e prezzi alla logica FileMaker appropriata. Recupera ulteriori dati WooCommerce solo quando il parametro ricevuto non contiene tutto ciò che il flusso di lavoro richiede.
1
Crea un account di integrazione dedicato
Concedi il privilegio esteso fmrest e il livello minimo di accesso necessario per il file ospitato, il layout e lo script.
2
Abilita la Data API
Abilita FileMaker Data API sul server e rendi il suo endpoint HTTPS raggiungibile dall'host WordPress.
3
Prepara il layout e lo script di destinazione
Utilizza esattamente i nomi di Database, Layout e Script configurati nella sezione 6.2.
4
Leggi script.param
Leggi Get ( ScriptParameter ) all'inizio dello script FileMaker.
5
Interpreta o recupera i dati
Analizza il formato compatto, JSON o modello personalizzato configurato. Convalida l'evento e l'ID dell'oggetto, quindi recupera i dati mancanti necessari al flusso di lavoro.
6
Implementa la tua logica di business
Crea, aggiorna o archivia i record corrispondenti, conserva le relazioni tra le variazioni ed esegui i processi successivi necessari.
Flusso di script FileMaker di esempio (pseudocodice)
Set Variable [ $param ; Value: Get ( ScriptParameter ) ]
# Edizione gratuita:
# $param contiene event|ID, ad esempio product.updated|123.
# Professional:
# Formato compatto: separa l'evento e l'ID dell'oggetto al separatore pipe.
# JSON base del prodotto: leggi evento, id e i campi disponibili del prodotto.
# Modello personalizzato: analizza il formato concordato con lo script FileMaker.
# JSON completo di WooCommerce: leggi pac_bridge_event, id e i campi disponibili.
# Considera i fallback del JSON completo descritti nella sezione 6.4.
# Convalida il formato, l'evento supportato e l'ID positivo dell'oggetto WooCommerce.
# Rifiuta gli input non validi prima di interrogare o modificare i record.
# Per product.deleted o variation.deleted:
# Applica la tua policy di archiviazione utilizzando l'evento esplicito e l'ID dell'oggetto.
# Non richiedere che l'oggetto non sia più presente in WooCommerce.
# Per gli altri eventi supportati:
# Leggi i campi forniti e recupera gli eventuali dati aggiuntivi necessari.
# Associa il record FileMaker utilizzando l'ID del prodotto o della variazione WooCommerce.
# Crea o aggiorna i record e conserva la relazione con il prodotto principale della variazione.
# Gestisci in sicurezza le notifiche ripetute e i payload dei tentativi più vecchi.
# Esegui le azioni successive solo quando appropriate per l'evento.
# Registra il risultato dell'elaborazione nella tua soluzione FileMaker.
Questa traccia mostra la sequenza di elaborazione. Implementa l'analisi e i passaggi di business nella tua soluzione; non è uno script completo da incollare in FileMaker.
Considerazioni sull'implementazione
ID di prodotti e variazioni: un evento relativo a una variazione identifica la variazione stessa, non il prodotto principale. Il JSON base include parent_id; il formato compatto no. Leggi i campi della relazione quando disponibili oppure recuperali quando necessario. Non presumere che ogni rappresentazione REST completa o ogni fallback includa gli stessi campi.
Gestione delle eliminazioni: sia il cestino sia la rimozione permanente generano .deleted prima del completamento della rimozione. Applica la tua policy di archiviazione in base all'evento esplicito e gestisci in sicurezza le notifiche di eliminazione ripetute.
Eventi ripetuti e ritardati: rendi l'elaborazione idempotente, in modo che la ricezione ripetuta di un evento mantenga coerenti i record e non ripeta inutilmente azioni irreversibili. I job in background e i nuovi tentativi possono consegnare un parametro più vecchio dopo un aggiornamento più recente; scegli come la tua soluzione rileva o evita i dati obsoleti.
Convalida ed errori: aggiungi convalida degli input, blocco dei record, gestione delle transazioni e segnalazione degli errori adeguati alla tua soluzione. Un messaggio di errore personalizzato restituito dal solo scriptResult non fa sì che il bridge consideri fallito l'invio: il plugin verifica la risposta della Data API e scriptError. Verifica e registra il risultato di business in FileMaker.
Serve un flusso di lavoro personalizzato per i prodotti?
IMPLEMENTAZIONE LATO FILEMAKER
PAC Age può aiutarti a collegare gli eventi dei prodotti WooCommerce al tuo modello dati FileMaker, agli script e ai processi di business.
Parla della tua integrazione FileMaker →
10. Esempio reale
Un aggiornamento di un prodotto in WooCommerce avvia un flusso di lavoro del catalogo in FileMaker.
Questo esempio illustra una possibile integrazione. Il bridge rileva gli eventi e li consegna; i passaggi FileMaker richiedono l'implementazione del tuo script.
Un amministratore del negozio aggiorna il prodotto 123. Con il formato compatto, FileMaker riceve product.updated|123. Lo script di ingresso convalida l'evento, recupera le informazioni necessarie sul prodotto e aggiorna il record corrispondente del catalogo FileMaker.
Con il JSON completo di WooCommerce di Professional, lo script riceve invece i dati del prodotto preparati localmente e legge pac_bridge_event. Se il payload contiene tutto ciò che il flusso di lavoro richiede, FileMaker può elaborarlo senza una seconda richiesta a WooCommerce.
Modifiche ai prodotti in WooCommerce
Un aggiornamento supportato del prodotto attiva il bridge.
PAC Product Bridge esegue lo script
Il parametro preparato viene consegnato immediatamente o tramite la modalità in background selezionata.
FileMaker interpreta o recupera i dati
Il tuo script convalida l'evento e l'ID e legge o recupera i campi necessari.
I record vengono aggiornati
La tua logica FileMaker aggiorna il prodotto corrispondente e tutti i record correlati inclusi nel flusso di lavoro.
I processi di business continuano
I tuoi script possono aggiornare le viste interne del catalogo, generare esportazioni o avviare ulteriori elaborazioni di business.
Un successivo evento product.deleted può archiviare il record FileMaker corrispondente. Un evento variation.updated identifica la singola variazione. Nessuna delle due operazioni richiede che il bridge imponga una struttura specifica delle tabelle FileMaker.
11. Sicurezza e affidabilità
Funzionalità di sicurezza e affidabilità incluse in entrambe le edizioni, oltre ai controlli Professional per invio, recupero, certificati e diagnostica.
I parametri dei prodotti viaggiano direttamente dal tuo server WordPress al FileMaker Server configurato. PAC Age non fa da proxy per questa connessione. Il pacchetto include anche Freemius per le licenze e l'opt-in facoltativo all'utilizzo; questo è separato dal percorso di invio dei prodotti.
Entrambe le edizioni offrono comunicazione HTTPS, memorizzazione crittografata della password, gestione delle sessioni Data API, test della connessione e dell'invio, stato dell'ultima comunicazione e protezione contro invii sovrapposti dello stesso evento.
Professional estende questa base condivisa con sei funzionalità operative documentate per l'edizione a pagamento: invio in background, nuovi tentativi automatici, reinvio manuale del prodotto, policy configurabile per i certificati HTTPS, supporto per certificati CA personalizzati e diagnostica avanzata. La versione 1.0.0 fornita espone le prime cinque nell'interfaccia del plugin; il collector della diagnostica avanzata è presente nel codice ma non è collegato a un pannello diagnostico visibile. La distinzione è documentata nel gruppo Professional qui sotto.
Disponibile in Gratuita e Professional
HTTPS e verifica dei certificati
Le richieste utilizzano l'endpoint HTTPS FileMaker configurato. La versione gratuita verifica il certificato del server; Professional utilizza la verifica per impostazione predefinita e aggiunge i controlli elencati di seguito.
Password salvata crittografata
La password FileMaker viene memorizzata utilizzando la crittografia autenticata e una chiave derivata dalle chiavi e dai salt di sicurezza di WordPress.
Gestione della sessione Data API
Il client apre una sessione per l'invio e tenta di chiuderla dopo la richiesta dello script. Le credenziali della sessione sono gestite dal bridge.
Blocco degli invii in corso
Un blocco per evento e oggetto riduce gli invii sovrapposti. Non sopprime permanentemente gli aggiornamenti successivi, i nuovi tentativi o gli eventi diversi per lo stesso oggetto.
Test e stato dell'ultimo invio
I test della connessione, dello script e del prodotto end-to-end aiutano a verificare l'integrazione. Ultima comunicazione registra lo stato dell'ultimo invio del prodotto; non rappresenta una cronologia completa.
Accesso FileMaker controllato
Le richieste utilizzano l'account FileMaker configurato e i relativi permessi. Configura un account dedicato con i privilegi necessari e convalida i parametri ricevuti nel tuo script.
Controlli e diagnostica Professional aggiuntivi
Invio in background
Accoda l'invio tramite WooCommerce Action Scheduler, utilizzando come fallback gli eventi pianificati di WordPress. In questo modo la richiesta FileMaker viene spostata al di fuori della richiesta WooCommerce interattiva; l'elaborazione dipende dal corretto funzionamento dello scheduler.
Nuovi tentativi automatici
Pianifica un ulteriore tentativo dopo un errore temporaneo di rete o HTTP idoneo. Configura il numero totale dei tentativi e l'intervallo tra i tentativi. I nuovi tentativi possono seguire sia un invio Immediato sia un invio in background; non tutti gli errori possono essere ritentati.
Reinvio manuale del prodotto
Utilizza Invia a FileMaker nell'elenco Prodotti di WooCommerce per inviare nuovamente lo stato corrente del prodotto. Sono necessari i permessi di modifica dei prodotti e vengono utilizzate le impostazioni salvate del payload e dell'invio; non si tratta della riproduzione di una notifica storica.
Policy dei certificati HTTPS
Seleziona la verifica del certificato pubblico, la verifica con certificato personalizzato oppure la crittografia senza verifica del certificato. L'ultima opzione mantiene la crittografia HTTPS ma non autentica il server remoto. La versione gratuita non espone questo selettore.
Certificati CA personalizzati
Fornisci un certificato o una catena CA in formato PEM, oppure un percorso leggibile a un file PEM, per la verifica personalizzata. Questo supporta configurazioni di attendibilità che richiedono una CA propria invece del bundle CA pubblico predefinito.
Diagnostica avanzata — limitazione Professional della versione 1.0.0
Indicata come funzionalità Professional su WordPress.org. Il pacchetto fornito include un collector per informazioni sull'ambiente, sullo scheduler, sulla destinazione e sullo stato più recente, ma non espone un pannello diagnostico né un pulsante Copia diagnostica. Consulta la sezione 6.6 per gli strumenti effettivamente disponibili.
Considerazioni operative
Consulta la sezione 6.1 per le impostazioni dei certificati e la sezione 6.5 per l'invio, l'idoneità ai nuovi tentativi e il reinvio manuale. Gli eventi relativi a scorte e prezzi, le modalità di payload personalizzate e il JSON completo di WooCommerce sono ulteriori funzionalità Professional trattate nelle sezioni 6.3–6.4 e 8; il confronto completo tra le edizioni si trova nella sezione 7.
La password FileMaker salvata è crittografata con Sodium secretbox quando disponibile, altrimenti con OpenSSL AES-256-GCM. La modifica delle chiavi o dei salt di sicurezza di WordPress, oppure la perdita del backend di crittografia richiesto da una password già salvata, può rendere necessario inserire nuovamente la password.
Il client non mantiene una cache riutilizzabile dei token di sessione. Una risposta positiva dello script non conferma autonomamente che il tentativo di logout sia riuscito. Inoltre non dimostra che il flusso di lavoro di business FileMaker abbia prodotto il risultato previsto; verifica il risultato in FileMaker.
L'invio in background e i nuovi tentativi non garantiscono un'elaborazione esattamente una volta o in ordine cronologico. I nuovi tentativi riutilizzano il parametro originale e un tentativo più vecchio può arrivare dopo un aggiornamento più recente. Lo script FileMaker deve gestire in sicurezza notifiche ripetute e dati obsoleti. Uno stato accodato conferma la pianificazione, non l'avvenuto invio.
Nella versione 1.0.0 fornita, il Test della connessione e il Test dello script non inviano i campi dei certificati Professional. Salva la configurazione ed esegui un test di prodotto end-to-end controllato per verificare la policy dei certificati selezionata; consulta la sezione 6.6. I test di base e Ultima comunicazione sono disponibili in entrambe le edizioni e non devono essere descritti come diagnostica esclusiva Professional.
Per la pianificazione della distribuzione, ricorda che nella versione 1.0.0 il parametro viene inserito nell'URL della richiesta dello script. Verifica la gestione dei log di accesso del server e del proxy, oltre ai limiti di dimensione delle richieste, quando utilizzi il JSON completo. Non presumere che i payload siano esclusi dai log dell'infrastruttura solo perché il plugin non dispone di un logger di debug dedicato.
Connessione diretta. Nessun middleware di sincronizzazione.
PAC Product Bridge chiama direttamente FileMaker Data API. La tua soluzione FileMaker controlla come vengono elaborati i dati dei prodotti ricevuti.
12. Risoluzione dei problemi
Individua se un problema deriva dalle impostazioni della connessione, dal rilevamento degli eventi, dall'invio o dall'elaborazione FileMaker.
Impossibile connettersi a FileMaker
Verifica l'URL del server HTTPS, la risoluzione DNS e la raggiungibilità dall'host WordPress. Conferma che Data API sia abilitata e che il database sia ospitato. Esamina la risposta specifica del test prima di testare un evento prodotto. I reindirizzamenti sono disabilitati nel client, quindi configura l'endpoint HTTPS effettivo invece di un indirizzo che reindirizza altrove.
Errore HTTPS o del certificato
Verifica il nome host del certificato, la catena di attendibilità e la configurazione del server. In Professional, utilizza la verifica personalizzata con il certificato CA PEM appropriato o con un percorso leggibile al file quando necessario. Tieni conto della limitazione del test dei certificati nella versione 1.0.0 descritta nella sezione 6.6: il Test della connessione e il Test dello script non inviano la configurazione del certificato personalizzato selezionata. Utilizza un test di prodotto end-to-end salvato e controllato per convalidare la policy.
Errore di autenticazione o della password salvata
Verifica il nome utente, la password, il database ospitato e il privilegio fmrest. Una costante di configurazione può sovrascrivere il valore salvato durante l'invio. Se i salt di WordPress sono cambiati o il backend di crittografia richiesto non è disponibile, risolvi la condizione e inserisci nuovamente la password salvata. Gli errori di autenticazione non si risolvono aumentando il numero di tentativi.
Script non trovato o scriptError diverso da zero
Verifica i nomi esatti del database, del layout e dello script, oltre all'accesso dell'account. Esegui il Test dello script generico con un parametro valido noto. Correggi l'errore FileMaker prima di inviare nuovamente. Una stringa di errore personalizzata restituita dal tuo script non viene automaticamente considerata un errore di invio del bridge.
La modifica di un prodotto o di una variazione non viene inviata
Verifica Abilita, la destinazione salvata e, in Professional, l'abilitazione runtime. Verifica che l'operazione attivi gli hook elencati nella sezione 6.3. Le scritture dirette nel database o le importazioni personalizzate che ignorano questi hook non garantiscono una notifica al bridge. Per l'invio in background, controlla anche lo scheduler.
Le notifiche sulle scorte o sui prezzi non corrispondono alle aspettative
Conferma che l'opzione Professional Modifiche alle scorte o Modifiche ai prezzi sia abilitata. Gli eventi dedicati alle scorte utilizzano gli hook delle impostazioni delle scorte, non gli hook autonomi dello stato delle scorte. Gli eventi relativi ai prezzi utilizzano aggiunte o aggiornamenti di tre chiavi di metadati dei prezzi e sopprimono per tre secondi le notifiche ripetute per lo stesso oggetto. Un aggiornamento del ciclo di vita e un evento dedicato a prezzo o scorte possono essere entrambi validi per una singola operazione.
Lo script FileMaker non riesce ad analizzare il parametro
Conferma la modalità del parametro salvata e se il JSON completo di WooCommerce è abilitato. L'input compatto è composto dall'evento e dall'ID dell'oggetto, separati da una pipe. Il JSON base utilizza event; il JSON completo utilizza pac_bridge_event. I modelli personalizzati non applicano l'escape ai valori inseriti per il JSON. Gestisci anche i fallback del JSON completo descritti nella sezione 6.4.
Il JSON completo non funziona mentre il parametro compatto sì
Il parametro dello script codificato viene inviato in un URL di richiesta GET. Verifica lo stato HTTP, i limiti di lunghezza dell'URL e i limiti del proxy/server utilizzando un prodotto rappresentativo. Descrizioni e metadati di grandi dimensioni possono rendere l'URL molto più lungo del JSON leggibile. Utilizza un parametro evento compatto e recupera i dati aggiuntivi in FileMaker quando l'invio completo è troppo grande per l'ambiente.
Un oggetto eliminato esiste ancora o non può essere recuperato
Entrambe le situazioni sono possibili. Le notifiche di eliminazione vengono generate prima del completamento dello spostamento nel cestino o dell'eliminazione permanente, quindi una ricerca immediata può ancora avere esito positivo. Una ricerca successiva potrebbe non trovare alcun oggetto. Gestisci l'evento .deleted e applica la tua policy di archiviazione; non dedurre l'evento esclusivamente dall'esito positivo o negativo della ricerca.
Notifiche duplicate o fuori sequenza
Il blocco dell'invio è temporaneo e non esiste un flag permanente di invio effettuato. Tipi di evento diversi, aggiornamenti successivi, invii manuali e nuovi tentativi possono tutti raggiungere FileMaker. Un nuovo tentativo più vecchio può essere eseguito dopo un aggiornamento più recente. Rendi l'elaborazione idempotente e definisci una strategia per i dati obsoleti, ad esempio recuperando lo stato corrente quando appropriato.
L'invio in background è in ritardo o i nuovi tentativi non vengono eseguiti
Quando Action Scheduler è disponibile, controlla WooCommerce > Stato > Azioni pianificate per il gruppo pac-products-bridge e gli hook pac_products_bridge_async_send o pac_products_bridge_retry_send. In caso contrario, controlla l'esecutore degli eventi pianificati di WordPress. Verifica Nuovo tentativo automatico, Numero massimo di tentativi e la categoria dell'errore. Uno stato accodato non conferma l'invio a FileMaker e i test dei prodotti ignorano intenzionalmente coda e nuovi tentativi.
I test funzionano ma l'invio automatico no
I test della connessione e dello script generico utilizzano i valori correnti del modulo; l'invio automatico e il test del prodotto utilizzano le impostazioni salvate e le sovrascritture supportate. Salva la configurazione e verifica Abilita e l'abilitazione runtime Professional. Il test del prodotto ignora il controllo dell'abilitazione e viene eseguito immediatamente, quindi non dimostra che l'invio runtime con licenza o l'elaborazione in background funzionino.
L'ultima comunicazione non cambia o la diagnostica non è disponibile
I test generici della connessione e dello script restituiscono i risultati accanto ai pulsanti senza aggiornare Ultima comunicazione. Alcuni errori iniziali lasciano invariato anche lo stato memorizzato. Aggiorna la pagina dopo un invio del prodotto ed esamina la risposta effettiva del test. Il pacchetto 1.0.0 fornito include un collector diagnostico, ma non un pannello diagnostico collegato né un'impostazione dedicata del log di debug.
L'invio riesce ma mancano i dati FileMaker attesi
Verifica l'esatto parametro ricevuto e il risultato di business dello script FileMaker. Il bridge non crea record, non associa campi, non scarica immagini e non considera ogni risultato di uno script personalizzato come un errore. Controlla l'associazione dei record, la convalida, i permessi e la tua logica di importazione in FileMaker.
13. FAQ
Risposte alle domande frequenti su PAC Product Bridge per WooCommerce.
PAC Product Bridge richiede middleware?
No. L'invio dei prodotti avviene direttamente da WordPress all'endpoint FileMaker Data API configurato.
Funziona in tempo reale?
L'invio immediato avviene durante la richiesta che genera l'evento WooCommerce supportato. Professional può invece accodare l'invio in background, la cui esecuzione dipende dallo scheduler.
Richiede polling o job cron?
FileMaker non deve eseguire polling su WooCommerce per rilevare le modifiche supportate. L'invio immediato non dipende da un job di polling pianificato. L'invio in background e i nuovi tentativi automatici di Professional richiedono invece uno scheduler o un esecutore cron funzionante.
Cosa invia la versione gratuita a FileMaker?
Una stringa compatta event|ID per gli eventi di creazione, aggiornamento ed eliminazione di prodotti e variazioni. Ad esempio, variation.updated|456 identifica la variazione 456; non include tutti i campi di quella variazione.
Cosa aggiunge Professional?
Eventi dedicati a scorte e prezzi, invio in background, nuovi tentativi configurabili, un'azione manuale sulla riga del prodotto, JSON base, modelli personalizzati, JSON completo di WooCommerce preparato localmente e opzioni per i certificati. Consulta il confronto completo e la limitazione della diagnostica specifica della versione nelle sezioni 7 e 6.6.
Il JSON completo evita sempre una seconda richiesta a WooCommerce?
Può evitarla quando la rappresentazione ricevuta contiene tutti i campi necessari al tuo flusso di lavoro FileMaker. Per i dati aggiuntivi potrebbe comunque essere necessario un recupero separato. I dati di fallback del controller REST possono avere una struttura diversa e, se un oggetto non è disponibile, viene utilizzata la modalità di parametro standard selezionata.
Il plugin chiama l'API REST di WooCommerce per creare il JSON completo?
Utilizza localmente i controller REST di WooCommerce per preparare la rappresentazione; non effettua una richiesta HTTP in uscita all'API REST del negozio per quel payload.
I file immagine vengono inviati a FileMaker?
No. La rappresentazione REST completa può includere metadati e URL delle immagini. FileMaker deve scaricare gli eventuali file immagine necessari come parte del tuo flusso di lavoro. Il JSON base non include immagini.
Il payload di un prodotto variabile include tutte le variazioni complete?
Non darlo per scontato. Un payload completo del prodotto è la rappresentazione di quel prodotto, mentre gli eventi delle variazioni trasportano la rappresentazione della variazione interessata. Recupera o elabora le singole variazioni quando il flusso di lavoro richiede i loro dati completi.
Il plugin modifica direttamente i record FileMaker?
No. Esegue lo script configurato e passa il parametro. La creazione, l'aggiornamento e l'archiviazione dei record, così come gli eventuali processi di business correlati, vengono implementati da te in FileMaker.
È un sistema bidirezionale di sincronizzazione dei prodotti?
La direzione dell'invio degli eventi implementata è da WooCommerce a FileMaker. La scrittura delle modifiche ai prodotti da FileMaker a WooCommerce richiede un flusso di lavoro separato; non viene eseguita da questo bridge.
Posso inviare manualmente un prodotto?
Sì, in Professional. Abilita Reinvio manuale e utilizza Invia a FileMaker in una riga di prodotto. Invia il prodotto corrente come evento di aggiornamento utilizzando la configurazione salvata. L'interfaccia fornita non aggiunge un'azione equivalente sulla riga per le singole variazioni.
I nuovi tentativi sono disponibili con l'invio immediato?
Sì. Un errore idoneo può pianificare un nuovo tentativo dopo un invio Immediato o in background. Numero massimo di tentativi conta il tentativo iniziale; un valore pari a 3 consente fino a due nuovi tentativi. Il test del prodotto non pianifica nuovi tentativi.
L'eliminazione indica solo la rimozione permanente?
No. Lo stesso evento .deleted viene utilizzato per gli hook del cestino e dell'eliminazione permanente, prima del completamento dell'operazione. La tua logica FileMaker deve riconoscere l'evento, gestire le notifiche ripetute e applicare la policy di archiviazione prevista. Nella versione 1.0.0 non esiste un evento di ripristino dedicato.
Disabilitare Abilita annulla il lavoro in sospeso?
No. Interrompe la cattura automatica degli eventi tramite gli event handler protetti. I job già accodati, i test e l'azione manuale Professional sono separati. Controlla e gestisci esplicitamente il lavoro in sospeso quando metti in pausa un'integrazione.
L'integrazione richiede un plugin FileMaker?
No. Utilizza FileMaker Data API e i tuoi script FileMaker.
PAC Age riceve i miei payload dei prodotti?
Il bridge invia i parametri dei prodotti direttamente al FileMaker Server configurato; PAC Age non fa da proxy per questa connessione. Le licenze Freemius e l'opt-in facoltativo all'utilizzo sono separati dal percorso di invio dei prodotti.
Questo sostituisce Order Bridge o Taxonomy Bridge?
No. PAC Product Bridge gestisce gli eventi di prodotti e variazioni. Le integrazioni degli ordini e delle tassonomie sono prodotti PAC separati, con documentazione e configurazione proprie. I campi del prodotto in un payload non costituiscono un sistema dedicato di notifiche per le modifiche alle tassonomie.
PAC Age può aiutarmi con la parte FileMaker?
Sì. PAC Age può aiutarti a progettare gli script FileMaker e il flusso di integrazione personalizzato necessari per il tuo modello dati e i tuoi processi di business.
14. Registro delle modifiche
Informazioni sulla release dal pacchetto del plugin fornito.
Versione 1.0.0
-
Versione iniziale.
-
Eventi in tempo reale del ciclo di vita di prodotti e variazioni.
-
Eventi Professional relativi a scorte e prezzi, invio in background, nuovi tentativi e opzione JSON completo di WooCommerce.
15. Prodotti correlati
Esplora le altre aree di integrazione PAC o parla di un flusso di lavoro FileMaker personalizzato.
PAC Order Bridge for WooCommerce
Esplora il bridge PAC separato per gli eventi degli ordini WooCommerce e i flussi di lavoro FileMaker.
Esplora PAC Order Bridge →
PAC Taxonomy Bridge for WooCommerce
Esplora l'integrazione PAC separata per le tassonomie e la relativa configurazione e documentazione dedicate.
Esplora PAC Taxonomy Bridge →
PAC WooCommerce Bridge Suite
Esplora la famiglia di bridge PAC e individua i componenti pertinenti alla tua integrazione WooCommerce e FileMaker.
Esplora la famiglia di bridge PAC →
Integrazioni personalizzate WooCommerce e FileMaker
Collega gli eventi dei prodotti al tuo modello dati FileMaker e ai processi di business con un'implementazione su misura.
Parla della tua integrazione →
Serve aiuto?
Utilizza prima diagnostica e test. Per un flusso FileMaker personalizzato, contatta PAC Age.
Contatta PAC AgePAC Taxonomy Bridge per WooCommerce · Documentazione tecnica
PAC Product Bridge Professional
Professional aggiunge eventi relativi a scorte e prezzi, invio in background, nuovi tentativi e JSON completo di WooCommerce generato localmente con il contesto dell'evento.
Visualizza Professional → Plugin gratuito →Ambito della documentazione
Questa guida tratta il plugin gratuito corrente e le impostazioni Professional verificate nell'interfaccia Product Bridge installata. Controlla la nota sulla versione nella parte superiore della pagina quando confronti una release successiva.
