Home › PAC Software › PAC Taxonomy Bridge for WooCommerce › Documentazione
DOCUMENTAZIONE PAC SOFTWARE
PAC Taxonomy Bridge for WooCommerce
Documentazione tecnica per le notifiche in tempo reale delle tassonomie dei prodotti WooCommerce verso Claris FileMaker tramite FileMaker Data API.
Versione gratuita 1.0.4 • Impostazioni Professional verificate sulla 1.0.1 • Documentazione aggiornata ottobre 2026
Evento della tassonomia WooCommerce
Cambia una categoria, un attributo o un valore di attributo
PAC Taxonomy Bridge
Identifica l'oggetto e l'ambito
FileMaker Data API
Esegue l'autenticazione ed esegue lo script
Script FileMaker
Applica la tua logica di sincronizzazione
1. Panoramica
PAC Taxonomy Bridge for WooCommerce notifica Claris FileMaker quando gli oggetti tassonomici WooCommerce supportati vengono creati, aggiornati o eliminati. Sono incluse le categorie dei prodotti, gli attributi globali dei prodotti e i termini utilizzati come valori degli attributi globali.
La versione gratuita utilizza un database, un layout e uno script FileMaker per tutti e tre gli ambiti. Lo script riceve un JSON compatto contenente l'ID dell'oggetto WooCommerce e l'ambito tassonomico, ad esempio {"id":37,"ambito":"categoria"}.
Professional utilizza una connessione, un database e un layout condivisi, quindi seleziona automaticamente uno script dedicato per Categoria, Attributo o Valore dell'attributo. Aggiunge inoltre controlli di invio con licenza, nuovi tentativi, verifica personalizzata dei certificati e diagnostica.
WordPress si collega direttamente al FileMaker Server configurato. FileMaker non deve eseguire polling su WooCommerce. La tua soluzione FileMaker resta responsabile del recupero dei dati aggiuntivi e della decisione su come gestire record e flussi di lavoro.
Modifiche alle tassonomie. Invio diretto. La tua logica di business.
Reagisci alle modifiche supportate delle tassonomie WooCommerce senza polling del catalogo o middleware esterni di sincronizzazione.
2. Vantaggi principali
Notifiche in tempo reale
Invia le modifiche supportate a categorie, attributi globali e valori degli attributi nel momento in cui si verificano.
Parametro compatto della versione gratuita
Ricevi l'ID dell'oggetto e l'ambito, quindi recupera solo i dati necessari al tuo flusso di lavoro.
Script specifici per ambito
Con Professional, indirizza i tre ambiti a script FileMaker dedicati.
Integrazione diretta
Collega WordPress a FileMaker Data API senza middleware.
3. Come funziona
PAC Taxonomy Bridge utilizza gli hook di WooCommerce e WordPress per rilevare gli eventi tassonomici supportati e chiama FileMaker Data API per eseguire lo script appropriato.
WooCommerce
Evento della tassonomia
PAC Taxonomy Bridge
Identifica l'ambito e seleziona la destinazione
FileMaker Data API
Esegue lo script configurato
Script FileMaker
Esegue la tua logica di business
Flusso tipico:
1
In WooCommerce si verifica un evento supportato relativo a una categoria, a un attributo globale o a un valore di attributo.
2
PAC Taxonomy Bridge identifica l'ID dell'oggetto e l'ambito tassonomico.
3
La versione gratuita prepara un JSON compatto con id e ambito; Professional seleziona il database, il layout e lo script configurati per quell'ambito.
4
Il plugin apre una sessione FileMaker Data API ed esegue lo script selezionato nel contesto del relativo layout.
5
Lo script FileMaker legge Get ( ScriptParameter ), esegue la logica di integrazione e restituisce il risultato registrato dal bridge.
Il controllo resta nelle tue mani.
La logica lato FileMaker è interamente sotto il tuo controllo. PAC Taxonomy Bridge consegna la notifica; non crea tabelle, non associa campi e non impone una struttura dei record.
4. Requisiti
Per utilizzare PAC Taxonomy Bridge for WooCommerce, sono necessari i seguenti componenti:
WordPress 6.4 o versione successiva e PHP 7.4 o versione successiva
WooCommerce installato e attivo
Supporto PHP Sodium o OpenSSL AES-256-GCM per la crittografia delle password salvate
FileMaker Server con Data API abilitata e raggiungibile tramite HTTPS
Un account FileMaker con fmrest e accesso al file, ai layout e agli script necessari
Un layout di destinazione e uno script ricevente configurati per il contratto dei parametri dell'edizione installata
Un esecutore funzionante di WooCommerce Action Scheduler per l'invio in background e i nuovi tentativi Professional
5. Installazione
Installa PAC Taxonomy Bridge in WordPress, attivalo con WooCommerce disponibile, quindi configura e testa la connessione FileMaker prima di abilitare l'invio automatico.
1
Scarica
il plugin
2
Carica in
WordPress
3
Attiva
il plugin
4
Configura
le destinazioni FileMaker
5
Testa
ogni ambito tassonomico
6. Configurazione
Apri WooCommerce > Impostazioni > Integrazioni > PAC Taxonomy Bridge for WooCommerce.
6.1 Impostazioni della connessione
Queste sono le impostazioni condivise utilizzate da PAC Taxonomy Bridge per collegare direttamente WordPress a FileMaker Data API.
Importante: i valori mostrati di seguito sono esempi. Sostituiscili con i dati di connessione del tuo ambiente FileMaker.
Abilita controlla le notifiche tassonomiche automatiche. FileMaker Server è l'URL di base HTTPS senza /fmi/data/ né slash finale. Versione Data API offre v1, v2 e vLatest e ha come valore predefinito v1.
Utilizza un nome utente FileMaker e una password FileMaker dedicati. Lascia vuota la password per mantenere il valore crittografato salvato. Il timeout HTTP si applica a ogni richiesta, accetta da 5 a 120 secondi e ha come valore predefinito 30 secondi; la versione gratuita limita la richiesta di logout a 10 secondi.
Impostazioni
Abilita
✓
Abilita PAC Taxonomy Bridge
Attivo per impostazione predefinita nella versione gratuita. I test restano disponibili anche quando l'invio automatico è disattivato.
FileMaker Server
https://fm.example.com
URL di base HTTPS senza /fmi/data/ né slash finale.
Versione Data API
v1
⌄
Valori disponibili: v1, v2 e vLatest. Valore predefinito: v1.
Nome utente FileMaker
taxonomy_api
Utilizza un account dedicato con fmrest e solo i privilegi necessari.
Password FileMaker
••••••••••••
Memorizzata in forma crittografata. Lascia vuoto il campo per mantenere la password salvata.
Timeout HTTP
30
⌃
⌄
Intervallo consentito: 5–120 secondi. La versione gratuita limita il logout a 10 secondi.
Costanti di configurazione della versione gratuita
Nella versione gratuita, queste costanti di wp-config.php sovrascrivono i corrispondenti valori di connessione salvati.
Costante
Sovrascrive
PAC_TAXONOMY_BRIDGE_FM_HOST
Server
PAC_TAXONOMY_BRIDGE_FM_API_VERSION
Versione Data API
PAC_TAXONOMY_BRIDGE_FM_USERNAME
Nome utente
PAC_TAXONOMY_BRIDGE_FM_PASSWORD
Password
PAC_TAXONOMY_BRIDGE_FM_TIMEOUT
Timeout
6.2 Destinazioni FileMaker
Dalla versione 1.0.2, Professional può assegnare un database, un layout e uno script FileMaker indipendenti a ciascun ambito tassonomico, mentre tutte le destinazioni utilizzano le stesse credenziali di connessione Data API.
Configura una destinazione completa per Categoria prodotto, Attributo globale e Valore dell'attributo. Ogni destinazione contiene i propri valori Database, Layout e Script. PAC Taxonomy Bridge seleziona automaticamente il gruppo corretto in base all'ambito tassonomico prima di effettuare la richiesta FileMaker Data API.
Se tutti gli ambiti appartengono alla stessa soluzione FileMaker, ripeti gli stessi valori Database e Layout e utilizza lo script di ingresso appropriato in ogni gruppo.
Esempio di destinazione FileMaker
Professional
Database
Catalog
Nome esatto del database FileMaker ospitato per questo ambito. Ripeti il valore negli altri gruppi quando condividono lo stesso file.
Layout
Taxonomy_API
Contesto del layout per lo script FileMaker di questo ambito. Può essere diverso dai layout utilizzati dagli altri ambiti.
Script della categoria
taxonomy_category
Riceve le notifiche relative alle categorie dei prodotti.
Script dell'attributo
taxonomy_attribute
Riceve le notifiche relative agli attributi globali dei prodotti.
Script del valore dell'attributo
taxonomy_attribute_value
Riceve le notifiche relative ai valori degli attributi globali.
Instradamento automatico per ambito
L'ambito tassonomico seleziona la destinazione completa prima dell'esecuzione della richiesta Data API: Database, Layout e Script. I tre percorsi possono puntare alla stessa soluzione FileMaker o a soluzioni indipendenti.
Ambito
Campo selezionato
Valore predefinito mostrato
categoria
Script della categoria
taxonomy_category
attributo
Script dell'attributo
taxonomy_attribute
Script del valore dell'attributo
Script del valore dell'attributo
taxonomy_attribute_value
Edizione gratuita
La versione gratuita utilizza un Database, un Layout e uno Script per ogni ambito supportato. Lo script condiviso riceve un JSON compatto contenente id e ambito. Le costanti di destinazione della versione gratuita sono PAC_TAXONOMY_BRIDGE_FM_DATABASE, PAC_TAXONOMY_BRIDGE_FM_LAYOUT e PAC_TAXONOMY_BRIDGE_FM_SCRIPT.
6.3 Eventi supportati e script.param
L'impostazione principale Abilita controlla tutte le notifiche automatiche. PAC Taxonomy Bridge ascolta le operazioni di creazione, aggiornamento ed eliminazione sui tre ambiti tassonomici WooCommerce supportati e instrada ogni notifica in base al relativo ambito.
Ambito
Creazione
Aggiornamento
Eliminazione
ambito
Categoria del prodotto
created_product_cat
edited_product_cat
delete_product_cat
categoria
Attributo globale
woocommerce_attribute_added
woocommerce_attribute_updated
woocommerce_attribute_deleted
attributo
Valore dell'attributo globale
created_term on pa_
edited_term on pa_
delete_term on pa_
valore_attributo
Gli attributi locali memorizzati solo su un singolo prodotto non rientrano in questo insieme di eventi.
script.param della versione gratuita
La versione gratuita invia un JSON compatto contenente solo l'ID dell'oggetto WooCommerce e il relativo ambito tassonomico.
Categoria
{"id":37,"ambito":"categoria"}
Attributo
{"id":4,"ambito":"attributo"}
Valore dell'attributo
{"id":91,"ambito":"valore_attributo"}
Il parametro non include l'operazione né l'oggetto completo. Un oggetto eliminato potrebbe non essere più recuperabile, quindi il flusso di lavoro FileMaker ricevente deve conservare un'identità sufficiente per riconciliare le eliminazioni utilizzando id e ambito.
6.4 Invio e nuovi tentativi Professional
Professional può inviare le notifiche tassonomiche durante la richiesta corrente oppure accodarle tramite WooCommerce Action Scheduler. I nuovi tentativi automatici aiutano a recuperare dagli errori temporanei di FileMaker o della rete.
Invio
Modalità di invio
Immediato ▾
In background con Action Scheduler
Seleziona se la richiesta Data API deve essere eseguita immediatamente o elaborata dalla coda in background.
Tentativi automatici
3
Numero massimo di tentativi automatici dopo un errore temporaneo di invio.
Immediato
Il plugin chiama FileMaker nell'ambito della richiesta WooCommerce. L'ultimo risultato è disponibile immediatamente nello stato di comunicazione salvato.
In background con Action Scheduler
La notifica viene inserita nella coda WooCommerce ed elaborata separatamente. Action Scheduler deve essere in esecuzione normale affinché gli invii accodati e i nuovi tentativi vengano completati.
Gli script FileMaker devono poter essere eseguiti più di una volta senza problemi. Un nuovo tentativo può ripetere un invio la cui prima risposta è stata interrotta dopo che FileMaker lo aveva già elaborato.
6.5 Verifica dei certificati
La verifica dei certificati controlla il modo in cui WordPress valida l'identità HTTPS di FileMaker Server. Mantieni la verifica abilitata in produzione e utilizza una CA personalizzata solo quando la catena dei certificati del server lo richiede.
Verifica HTTPS
Verifica del certificato
Abilitata — verifica con bundle CA pubblico ▾
Professional offre modalità con CA pubblica, CA personalizzata e sola crittografia. La versione gratuita verifica utilizzando un bundle CA pubblico disponibile.
Certificato CA personalizzato
Testo del certificato PEM o percorso leggibile a un file PEM. Utilizzato solo quando è selezionata la verifica personalizzata.
Mode
Behavior
Abilitata — bundle CA pubblico
Verifies the certificate chain and hostname against the public CA bundle. This is the verified default.
Personalizzata — CA personalizzata
Uses the PEM certificate or readable PEM path supplied in the Custom CA certificate field.
Disabilitata — sola crittografia HTTPS
Keeps HTTPS encryption but disables certificate identity verification. Reserve this mode for controlled troubleshooting.
Never publish private certificate material. The custom field must contain only the CA certificate needed to verify FileMaker Server, not a server private key.
6.6 Diagnostics and testing
Use the built-in controls to verify the Data API connection, exercise the complete taxonomy path and inspect the exact FileMaker response. Tests use the values currently shown in the settings form.
Test and diagnostics
Last communication
No communication recorded yet.
Clear status
Connection test
Test connection
WooCommerce test ID
Enter the ID of an existing category, global attribute or attribute value.
Test scope
Category ▾
End-to-end taxonomy test
Send taxonomy test
Diagnostics
Plugin version
Licensed runtime features
WordPress · WooCommerce · PHP versions
Encryption backend
FileMaker destination selected for the scope
Database · Layout · Script · Sent parameter
Response code · scriptError · scriptResult
Delivery mode · Last status · Last object ID
Copy this block when support needs the runtime configuration and the latest FileMaker test result. Review it before sharing because it can identify internal destinations.
Cleanup on uninstall
Remove plugin settings and runtime data when the plugin is deleted
Connection test
Authenticates with FileMaker Server and verifies that the configured database can be reached. It does not run a taxonomy script.
End-to-end taxonomy test
Select Category, Attribute or Attribute Value and enter a known WooCommerce ID. Professional routes the request to that scope’s configured database, layout and script.
Recommended order: save the destination settings; test the connection; send one known ID for each configured scope; inspect response code, scriptError and scriptResult; verify the resulting FileMaker data; then enable controlled live changes.
7. Free vs Professional
Scegli l'edizione più adatta al flusso di lavoro. Entrambe le edizioni si collegano direttamente a FileMaker e lasciano la convalida, l'associazione dei record e la logica di business nella tua soluzione FileMaker. Professional aggiunge l'instradamento specifico per ambito e i controlli di invio necessari per flussi di lavoro di produzione più impegnativi.
Funzionalità
Gratuita
Professional
Three supported taxonomy scopes
✓
✓
Create, update and delete hooks
✓
✓
Connessione diretta a FileMaker Data API
✓
✓
FileMaker authentication and session handling
✓
✓
One shared database and layout
✓
✓
Enable or disable automatic notifications
✓
✓
Configurable HTTP timeout
✓
✓
Immediate delivery
✓
✓
Public certificate verification
✓
✓
Encrypted FileMaker password storage
✓
✓
Connection test
✓
✓
End-to-end taxonomy test
✓
✓
Stato dell'ultima comunicazione
✓
✓
Cleanup on uninstall
✓
✓
Compact id + ambito JSON parameter
✓
—
One shared receiving script for all scopes
✓
—
Dedicated script for each scope
—
✓
Instradamento automatico dello script in base all'ambito
—
✓
Configurable delivery mode
—
✓
Nuovi tentativi automatici
—
✓
Configurable retry attempts
—
✓
Verifica personalizzata / CA personalizzata
—
✓
Freemius license status
—
✓
Professional event_json payload mode
—
✓
Diagnostica avanzata
—
✓
Le edizioni differiscono principalmente per l'instradamento degli script, i controlli di invio, i nuovi tentativi, le opzioni dei certificati e la diagnostica. Il contratto dei parametri della versione gratuita è documentato nella sezione 6.3. Professional segnala event_json come modalità del payload, ma i campi non confermati dalla build verificata non vengono dichiarati intenzionalmente.
8. Funzionalità Professional
L'edizione Professional di PAC Taxonomy Bridge aggiunge controlli con licenza per l'instradamento specifico per ambito, il recupero degli invii, la gestione dei certificati e la diagnostica.
Professional include le funzionalità della versione gratuita.
Mantiene una connessione, un database e un layout FileMaker condivisi, aggiungendo script separati per Categoria, Attributo e Valore dell'attributo. I controlli di invio, i nuovi tentativi automatici, la verifica personalizzata dei certificati e il supporto diagnostico sono pensati per l'uso in produzione.
Queste opzioni non definiscono lo schema FileMaker e non sincronizzano le modifiche verso WooCommerce. Gli script FileMaker configurati restano responsabili dell'interpretazione del parametro e dell'applicazione della logica di business.
Script specifici per ambito
Seleziona automaticamente lo script Categoria, Attributo o Valore dell'attributo per l'ambito tassonomico corrispondente.
Modalità di invio
Utilizza i controlli di invio con licenza disponibili nella build Professional installata; nelle impostazioni verificate è mostrato Immediato.
Nuovi tentativi automatici
Ripete i tentativi per gli errori temporanei idonei di FileMaker o della rete utilizzando i controlli configurati per i tentativi.
Gestione personalizzata dei certificati
Scegli la policy di verifica disponibile e fornisci un certificato CA personalizzato quando necessario.
Stato della licenza
Freemius autorizza le funzionalità runtime Professional per l'installazione corrente.
Diagnostica avanzata
Analizza le informazioni sul plugin, sul runtime, sulla connessione, sulla destinazione e sull'ultimo invio.
9. Implementazione lato FileMaker
Sul tuo FileMaker Server, prepara gli script riceventi che PAC Taxonomy Bridge eseguirà per le notifiche relative a categorie, attributi globali e valori degli attributi.
I passaggi seguenti descrivono un modello tipico di implementazione, non un'architettura FileMaker obbligatoria.
PAC Taxonomy Bridge non crea record FileMaker, non associa campi e non impone uno schema del database. Esegue l'autenticazione tramite FileMaker Data API, esegue lo script configurato nel contesto del layout selezionato e passa il JSON tramite script.param.
La versione gratuita invia un contratto compatto a un singolo script: id identifica l'oggetto WooCommerce e ambito identifica categoria, attributo o valore_attributo. Professional utilizza automaticamente lo script configurato per l'ambito corrispondente. La tua soluzione FileMaker convalida il parametro, recupera gli eventuali dati WooCommerce ancora disponibili e applica la propria logica di business sicura rispetto alle ripetizioni.
1
Crea un account di integrazione dedicato
Utilizza fmrest e concedi solo i privilegi sul file, sul layout e sugli script necessari all'integrazione tassonomica.
2
Abilita Data API
Abilita l'accesso Data API per il file ospitato e rendi FileMaker Server raggiungibile da WordPress tramite HTTPS.
3
Prepara il layout e gli script di destinazione
Fornisci un contesto di layout stabile e configura lo script unico della versione gratuita oppure i tre script specifici per ambito di Professional.
4
Leggi e convalida script.param
Utilizza Get ( ScriptParameter ) e analizza i valori JSON id e ambito.
5
Risolvi l'ambito tassonomico
Accetta solo categoria, attributo o valore_attributo e instrada il flusso di lavoro corrispondente.
6
Applica una logica di business sicura rispetto alle ripetizioni
Associa i record in base all'ID WooCommerce stabile e all'ambito, quindi crea, aggiorna o archivia secondo le regole FileMaker.
Flusso di script FileMaker di esempio (pseudocodice)
# Ricevi il parametro JSON inviato da PAC Taxonomy Bridge
Set Variable [ $parameter ; Value: Get ( ScriptParameter ) ]
Set Variable [ $id ; Value: JSONGetElement ( $parameter ; "id" ) ]
Set Variable [ $scope ; Value: JSONGetElement ( $parameter ; "ambito" ) ]
# Richiedi un ID intero positivo
# Accetta solo categoria, attributo o valore_attributo
# Instrada al flusso di lavoro tassonomico appropriato
# Recupera i dati WooCommerce correnti quando disponibili
# Non dedurre creazione/aggiornamento/eliminazione dal parametro della versione gratuita
# Associa i record in base all'ID e all'ambito stabili
# Applica regole di business sicure rispetto alle ripetizioni
Il bridge considera un valore scriptError FileMaker diverso da zero come un invio non riuscito.
RESPONSABILITÀ LATO FILEMAKER
La tua soluzione FileMaker definisce il modello dati e il risultato.
PAC Taxonomy Bridge fornisce la notifica ed esegue lo script configurato. FileMaker resta responsabile della convalida dell'identità e dell'ambito, della conservazione di un'identità sufficiente per riconciliare gli eventi di eliminazione, del recupero dei dati aggiuntivi quando disponibili e della decisione se creare, aggiornare, archiviare o avviare flussi di lavoro successivi.
10. Esempio reale
Ecco un flusso di lavoro tipico da una modifica tassonomica supportata in WooCommerce a un record aggiornato del catalogo in FileMaker.
Questo esempio mostra un possibile flusso di lavoro end-to-end. PAC Taxonomy Bridge esegue esclusivamente la notifica e lo script FileMaker configurato.
Dopo l'avvio dello script, convalida, recupero dei dati, associazione dei record ed elaborazione successiva appartengono alla tua soluzione FileMaker. La versione gratuita fornisce l'ID dell'oggetto e l'ambito allo script condiviso; Professional instrada l'ambito corrispondente allo script configurato.
Sono validi anche altri flussi di lavoro: il plugin non richiede uno schema FileMaker o un'associazione dei campi specifici.
Modifica della tassonomia
In WooCommerce cambia una categoria, un attributo globale o un valore di attributo globale.
Notifica del bridge
Il bridge invia un JSON compatto con ID e ambito oppure instrada l'ambito allo script Professional.
Convalida dell'identità e dell'ambito
FileMaker convalida l'ID positivo e il valore ambito supportato.
Recupero dei dati necessari
Il flusso di lavoro recupera i campi WooCommerce correnti quando l'oggetto è ancora disponibile.
Aggiornamento del catalogo
FileMaker associa gli ID stabili e applica la propria logica dei record, sicura rispetto alle ripetizioni.
Questa è un'architettura di esempio, non un'associazione automatica dei campi fornita dal plugin.
11. Sicurezza e affidabilità
PAC Taxonomy Bridge è progettato pensando alla sicurezza e all'affidabilità, utilizzando FileMaker Data API per una comunicazione diretta e crittografata.
PAC Taxonomy Bridge comunica direttamente tra il tuo server WordPress/WooCommerce e il FileMaker Server configurato dall'amministratore. PAC Age non fa da proxy per la connessione FileMaker e non è richiesto alcun middleware di terze parti.
La versione gratuita include la verifica dei certificati HTTPS, la memorizzazione crittografata della password FileMaker, la convalida delle risposte e un blocco di breve durata contro l'invio simultaneo dello stesso ID e ambito. Professional aggiunge controlli orientati alla produzione come invio in background, nuovi tentativi automatici, verifica personalizzata dei certificati, supporto per CA personalizzate e diagnostica.
Le scritture FileMaker devono rimanere idempotenti, perché gli eventi successivi e i nuovi tentativi Professional possono elaborare legittimamente più volte lo stesso oggetto tassonomico.
HTTPS
Utilizza HTTPS e un certificato considerato attendibile dalla policy di verifica selezionata.
Privilegio minimo
Limita l'account FileMaker Data API al file, al layout e agli script tassonomici necessari.
Password crittografata
La versione gratuita crittografa la password salvata con libsodium o OpenSSL AES-256-GCM, utilizzando una chiave derivata dal salt di autenticazione di WordPress.
Convalida della risposta
La versione gratuita convalida lo stato HTTP, i codici FileMaker Data API e scriptError e tenta di chiudere la sessione.
Sicurezza rispetto alle ripetizioni
Il blocco della versione gratuita previene solo gli invii simultanei. Rendi idempotenti le scritture FileMaker per gli eventi successivi e i nuovi tentativi Professional.
Percorso diretto
L'invio è diretto al FileMaker Server configurato; PAC Age non riceve né fa da proxy per i dati tassonomici.
Connessione diretta. Nessun middleware.
PAC Taxonomy Bridge chiama direttamente FileMaker Data API dal tuo server WordPress. Non sono coinvolti server PAC Age, piattaforme esterne di sincronizzazione o servizi di polling del catalogo.
12. Risoluzione dei problemi
Trova le soluzioni ai problemi comuni di connessione, invio e integrazione lato FileMaker.
Impossibile connettersi a FileMaker
Esegui innanzitutto il Test della connessione dalla pagina delle impostazioni di PAC Taxonomy Bridge.
Verifica che l'URL di FileMaker Server sia corretto e raggiungibile dal server WordPress tramite HTTPS, che FileMaker Data API sia abilitata e che il database configurato sia aperto.
Controlla anche il nome del database, l'account FileMaker e la password. L'account deve avere il privilegio esteso fmrest e un accesso sufficiente al file, al layout e agli script configurati.
Se la connessione funziona da un altro computer ma non dal server WordPress, controlla anche le regole del firewall, la risoluzione DNS e la raggiungibilità di FileMaker Server dal web server stesso.
Errore HTTPS o del certificato
PAC Taxonomy Bridge si connette a FileMaker Server tramite HTTPS e verifica il certificato del server.
Assicurati che il certificato sia valido, non sia scaduto e corrisponda al nome host configurato per FileMaker Server.
Se FileMaker Server utilizza un certificato emesso da una CA privata o interna, Professional può utilizzare il certificato CA personalizzato configurato. Verifica sia la modalità di verifica del certificato selezionata sia il certificato CA salvato rispetto alla build Taxonomy installata.
Se il certificato funziona da un altro computer ma non dal server WordPress, verifica anche che la catena completa di attendibilità sia disponibile per il web server.
Errore di autenticazione o della password
Un errore di autenticazione significa che FileMaker Server è stato raggiunto ma ha rifiutato le credenziali fornite.
Verifica il nome utente e la password FileMaker, il privilegio esteso fmrest e l'accesso al database, al layout e allo script o agli script configurati.
Se le credenziali sono definite da una costante di configurazione sovrascrivente, conferma che il suo valore sia aggiornato. Dopo aver modificato la password FileMaker o i salt di sicurezza di WordPress, inserisci e salva nuovamente la password prima di ripetere il test.
Script non trovato o scriptError diverso da zero
Verifica che i nomi del database, del layout e dello script corrispondano esattamente a quelli in FileMaker. I nomi degli script distinguono tra maiuscole e minuscole e devono appartenere al database configurato.
Verifica che l'account FileMaker possa accedere al layout selezionato ed eseguire lo script necessario. La versione gratuita utilizza l'unico script configurato; Professional seleziona lo script Categoria, Attributo o Valore dell'attributo in base all'ambito tassonomico.
Se uno script è stato rinominato, aggiorna e salva le impostazioni del bridge, quindi esegui nuovamente il test dello script. Un valore scriptError diverso da zero deve essere analizzato nello script FileMaker corrispondente.
Un oggetto tassonomico non viene inviato
Controlla innanzitutto che PAC Taxonomy Bridge sia abilitato e che tutte le impostazioni della connessione e degli script siano state salvate. Esamina Ultima comunicazione, quindi esegui i test della connessione e tassonomico end-to-end.
Conferma che la modifica sia avvenuta tramite un'azione tassonomica WooCommerce supportata. Sono supportate categorie, attributi globali e valori degli attributi globali; un valore di attributo deve essere un termine di una tassonomia globale il cui nome inizi con pa_.
Il codice che scrive direttamente nel database o che ignora in altro modo gli hook supportati di WordPress e WooCommerce potrebbe non notificare il bridge.
Un oggetto eliminato non può essere recuperato
Dopo l'eliminazione di una categoria, di un attributo o di un valore di attributo, WooCommerce potrebbe non essere più in grado di restituire i dati originali dell'oggetto.
La notifica fornisce comunque l'ID WooCommerce stabile e l'ambito tassonomico. Utilizza questi valori in FileMaker per trovare e archiviare, disattivare o riconciliare il record corrispondente senza richiedere una ricerca riuscita dell'oggetto WooCommerce eliminato.
FileMaker dovrebbe quindi memorizzare sia l'ID WooCommerce sia l'ambito per ogni record tassonomico sincronizzato.
Un ID di test non correlato ha esito positivo
Il test tassonomico end-to-end convalida che l'ID inserito sia positivo e che l'ambito selezionato sia supportato. Non conferma che l'ID appartenga a una categoria, a un attributo globale o a un valore di attributo esistente.
Utilizza l'ID di un oggetto tassonomico WooCommerce noto, seleziona l'ambito corrispondente e verifica quindi il risultato in FileMaker. Una richiesta riuscita con un ID non correlato dimostra soltanto che il percorso di invio e l'esecuzione dello script sono stati completati.
Una notifica viene elaborata due volte
La versione gratuita utilizza un blocco di breve durata per impedire l'invio simultaneo dello stesso ID WooCommerce e ambito tassonomico. Questo blocco non rappresenta una cronologia permanente delle notifiche elaborate.
Gli eventi successivi per lo stesso oggetto possono essere inviati nuovamente e i nuovi tentativi Professional possono ripetere un invio dopo un errore temporaneo. L'elaborazione FileMaker dovrebbe quindi essere idempotente: utilizza l'ID WooCommerce insieme all'ambito tassonomico per aggiornare il record esistente in sicurezza invece di creare un duplicato indesiderato.
13. FAQ
Risposte alle domande più frequenti su PAC Taxonomy Bridge for WooCommerce.
Quali oggetti sono supportati?
PAC Taxonomy Bridge supporta le categorie dei prodotti, gli attributi globali dei prodotti e i termini utilizzati come valori nelle tassonomie degli attributi globali.
Per i valori degli attributi, il termine deve appartenere a una tassonomia globale degli attributi WooCommerce il cui nome inizi con pa_. Il bridge invia l'ambito tassonomico appropriato, così FileMaker può elaborare ogni tipo tramite il flusso configurato.
Gli attributi locali dei prodotti sono supportati?
Non è documentato alcun evento dedicato per gli attributi memorizzati solo su un singolo prodotto.
PAC Taxonomy Bridge monitora gli attributi globali WooCommerce e i termini appartenenti alle relative tassonomie pa_. Un attributo locale esiste solo all'interno di un prodotto e non viene gestito come oggetto tassonomico globale indipendente.
I dati specifici del prodotto devono essere gestiti dal flusso di lavoro appropriato per i prodotti, non trattati come un evento Taxonomy Bridge.
Cosa invia la versione gratuita?
La versione gratuita passa un oggetto JSON compatto tramite script.param. Contiene l'ID dell'oggetto WooCommerce e il relativo ambito tassonomico, ad esempio:
{"id":55,"ambito":"categoria"}
I valori di ambito supportati sono categoria, attributo e valore_attributo. La versione gratuita non invia l'oggetto tassonomico completo; lo script FileMaker decide come utilizzare ID e ambito.
La versione gratuita identifica l'operazione?
No. Nella versione gratuita, gli hook di creazione, aggiornamento ed eliminazione utilizzano lo stesso contratto compatto contenente solo id e ambito.
Il flusso di lavoro FileMaker deve decidere come riconciliare l'oggetto ricevuto. Per un oggetto eliminato, WooCommerce potrebbe non restituire più i dati originali, quindi FileMaker dovrebbe utilizzare ID e ambito salvati per archiviare, disattivare o riconciliare il record corrispondente.
Ogni ambito può utilizzare un file FileMaker diverso?
Le impostazioni Professional verificate utilizzano una connessione FileMaker Server, un database e un layout condivisi per tutti gli ambiti tassonomici.
Professional fornisce impostazioni di script separate per Categoria, Attributo e Valore dell'attributo e seleziona automaticamente lo script corretto per l'oggetto inviato. Le impostazioni correnti non forniscono un database o un layout separato per ogni ambito.
Richiede middleware o polling?
No.
PAC Taxonomy Bridge invia le richieste direttamente dal server WordPress/WooCommerce al FileMaker Server configurato dall'amministratore tramite la FileMaker Data API standard.
Non sono necessari Zapier, n8n, servizi di polling del catalogo o server intermediario PAC Age. L'invio immediato reagisce alle modifiche tassonomiche supportate; l'invio in background Professional richiede comunque il corretto funzionamento delle azioni pianificate di WordPress.
È una sincronizzazione bidirezionale?
No. La direzione documentata è da WooCommerce a FileMaker: quando si verifica una modifica tassonomica supportata, il bridge esegue lo script FileMaker configurato e passa la notifica tramite script.param.
L'invio di categorie, attributi o valori degli attributi da FileMaker a WooCommerce è un flusso di integrazione separato e non viene eseguito automaticamente da PAC Taxonomy Bridge.
Richiede un plugin FileMaker?
No.
PAC Taxonomy Bridge utilizza la FileMaker Data API standard per autenticarsi con FileMaker Server ed eseguire lo script configurato. Non è richiesto alcun plugin FileMaker.
FileMaker Data API deve essere abilitata e l'account FileMaker configurato deve avere il privilegio esteso fmrest e un accesso sufficiente al database, al layout e agli script selezionati.
14. Registro delle modifiche
Versione 1.0.4
Aggiornamenti della gestione delle traduzioni e della documentazione su WordPress.org; nessuna modifica funzionale all'invio tassonomico.
Versione 1.0.3
Diagnostica dettagliata dei test FileMaker e miglioramento dei test end-to-end della versione gratuita.
Riferimento impostazioni Professional 1.0.1
Connessione condivisa, tre script, modalità di invio, nuovi tentativi, controlli dei certificati, test e diagnostica.
Versione 1.0.1
Tooltip di aiuto, correzione dei selettori, dimensionamento allineato dei campi e descrizioni italiane migliorate nell'amministrazione.
Versione 1.0.0
Versione iniziale.
15. Prodotti correlati
Crea un flusso di lavoro WooCommerce–FileMaker più ampio con gli altri bridge PAC. Aggiungi notifiche di prodotti e ordini agli eventi tassonomici oppure esplora la famiglia completa PAC Software per scegliere l'integrazione più adatta alla tua soluzione.
PAC Product Bridge for WooCommerce
Notifica FileMaker quando i prodotti e le variazioni vengono creati, aggiornati o eliminati, mantenendo il controllo nei tuoi flussi di lavoro FileMaker esistenti.
Esplora PAC Product Bridge →
PAC Order Bridge for WooCommerce
Collega direttamente a FileMaker gli eventi supportati degli ordini WooCommerce e attiva la logica di business già presente nella tua soluzione.
Esplora PAC Order Bridge →
PAC WooCommerce Bridge Suite
Riunisci le integrazioni di tassonomie, prodotti e ordini in una connessione coordinata tra WooCommerce e FileMaker.
Esplora la famiglia PAC Software →
Serve aiuto?
Utilizza prima diagnostica e test. Per un flusso FileMaker personalizzato, contatta PAC Age.
Contatta PAC AgePAC Taxonomy Bridge for WooCommerce · Documentazione tecnica
PAC Taxonomy Bridge Professional
Utilizza script FileMaker separati per categorie, attributi e valori degli attributi, con invio in background, nuovi tentativi e diagnostica.
Visualizza Professional → Plugin gratuito →Ambito della documentazione
Questa guida tratta il plugin gratuito corrente e le impostazioni Professional verificate nell'interfaccia Taxonomy Bridge installata. Controlla la nota sulla versione nella parte superiore della pagina quando confronti una release successiva.
Prodotti PAC correlati
PAC Order Bridge
per WooCommerce
PAC Product Bridge
per WooCommerce
PAC Software
Famiglia di prodotti
