Where do I define the classification rules?

Classification rules: class names and their regex or JavaScript expressions: are created and stored in your PDF4me account at dev.pdf4me.com under Classify Document. The Make module reads those rules at runtime. You must set up at least one class before the module can return a result.

What does the module return?

The module returns two fields: Class Name (the matched class label, e.g. pdf4me_invoice or Contract) and Trace Id (a unique identifier for debugging). It does NOT return the PDF file. To pass the PDF to downstream modules, use the Document output from the prior download or trigger step.

What expression types can I use to define a class?

Two types are supported: Regular Expression and JavaScript. Regular expressions match text patterns found anywhere in the document content: for example, invoice(.*) matches any PDF containing the word invoice. JavaScript expressions let you write more complex matching logic for multi-condition or scored classification.

What happens if the PDF does not match any class?

If no class expression matches the document content, the module returns an empty or unmatched Class Name. Handle this case in your Router by adding a fallback branch for documents that could not be classified: for example, routing them to a manual review folder.

Classifica il documento in Make

Q: Does each classification run use a credit?

Yes. Each Classify Document module run consumes one PDF4me credit regardless of whether a match is found. For high-volume scenarios processing hundreds of PDFs daily, plan your credit allocation accordingly.

Cosa fa questo modulo

PDF4meClassifica il documento legge un PDF e restituisce un Nome della classe che identifica il tipo di documento, fattura, contratto, ricevuta o qualsiasi classe personalizzata definita. Regole di classificazione (regex o JavaScript le espressioni) vengono impostate una volta nel tuo PDF4me account su dev.pdf4me.com. Quando un PDF passa attraverso il modulo in Make, viene confrontato con quelle regole e viene restituita l'etichetta della classe vincente. Inserisci quell'etichetta in un Make Il router invia il documento alla cartella corretta, seleziona il modello di analisi sintattica appropriato o attiva un'azione successiva specifica per il tipo, il tutto senza alcun ordinamento manuale.

Autenticazione del tuo API Richiesta

Ogni PDF4me modulo in Make richiede un valido Connessione. Crea o selezionane uno che contenga il tuo PDF4me API chiave affinché lo scenario possa autenticare in modo sicuro le richieste di classificazione.

Get your API Key

Informazioni importanti da non perdere

Definisci prima le classi nel tuo account, non in Make

Le regole di classificazione vivono nel tuo PDF4me cruscotto a dev.pdf4me.com → Classifica documento. Aggiungi un nome di classe (ad esempio fattura_pdf4me) e un'espressione regolare o JavaScript espressione (ad esempio fattura(.*)), quindi fai clic su Salva modifiche. Make Il modulo non dispone di campi per la definizione delle regole, si limita ad applicare le regole salvate nel tuo account.

Il modulo restituisce solo il nome della classe, non il PDF

Classifica documento produce due campi: Nome della classe (l'etichetta corrispondente) e Traccia ID (per il debug). Non restituisce né modifica il PDF file. Se devi passare il PDF a un modulo a valle, caricarlo, analizzarlo o inviarlo via e-mail, mappare l'output del documento dal precedente Scaricare o attivare il passaggio, non da questo modulo.

Un credito consumato per ogni esecuzione della classificazione.

Ogni esecuzione del modulo Classifica documento utilizza un PDF4me credito, indipendentemente dal fatto che venga trovata o meno una corrispondenza di classe. Per scenari che elaborano grandi volumi di documenti (centinaia o migliaia di PDFs quotidianamente), pianifica la tua allocazione del credito nel PDF4me dashboard prima di abilitare lo scenario su larga scala. Aggiungere un ramo di fallback del router per i documenti non corrispondenti per evitare errori silenziosi.

Crea il modulo PDF4me Classify Document mostrando la connessione impostata su My PDF4me connection, il nome del file mappato dal nome del file del passaggio 1 e il documento mappato dai dati del passaggio 1. — Il modulo necessita solo del nome del file e del documento da una fase di download precedente. Le regole di classificazione vengono lette dal tuo PDF4me account automaticamente, nessuna configurazione di regole all'interno Make.

Parametri

Prerequisito: Crea almeno una classe di documenti a dev.pdf4me.com → Classifica documento prima di utilizzare questo modulo. Vedere Configura il documento di classificazione per la guida completa.

Parametro	Necessario	Cosa fa	Esempio
Connection	Yes	PDF4me API connection. Click Add and paste your API key if connecting for the first time.	`My PDF4me connection`
File Name	Yes	Filename of the PDF to classify including .pdf extension. Map from the prior module's file name output.	`document.pdf`
Document	Yes	Binary content of the PDF to classify. Map from the prior module's data output: Dropbox, Google Drive, HTTP, or email attachment.	`1. Data`

Campi di output

Campo	Descrizione
Nome della classe	L'etichetta di classe corrispondente (ad esempio `pdf4me_invoice`, `Contract`). Usalo nel tuo Router o rinomina il passaggio.
Traccia ID	Identificativo univoco per questa esecuzione di classificazione, utile per il debug o la registrazione delle attività di controllo.

Configurazione rapida

Vai a dev.pdf4me.com → Classifica documento, clicca Modificare, aggiungi un nome di classe (ad esempio pdf4me_invoice) con un'espressione regolare (ad esempio invoice(.*)), e clicca Salva le modifiche.
Nel tuo Make scenario, aggiungere PDF4me → Classifica il documento dopo una fase di download del file.
Seleziona Connessione (oppure fai clic) Aggiungere per crearne uno con il tuo PDF4me API chiave).
Mappa Nome del file E Documento dal precedente modulo di download o di attivazione.
Fare clic Salva e avviare lo scenario. Nome della classe l'output contiene il tipo di documento corrispondente: collegalo a un Router per ramificare in base al tipo, un modulo di caricamento per salvare in una cartella specifica per tipo, oppure una fase di rinomina per anteporre la classe al nome del file.

Esempi di flusso di lavoro

Esempi di flusso di lavoroCommon Make scenario patterns using Classify Document.

Indirizzare fatture, contratti e ricevute in cartelle separate.

La cartella di monitoraggio di Dropbox si attiva quando viene creato un nuovo PDF finisce nella cartella "In arrivo".
Dropbox Scarica un file recupera il PDF binario
Classifica il documento restituisce il nome della classe, ad esempio fattura_pdf4me, pdf4me_contract, O pdf4me_receipt.
Ramificazioni del router sulla classe Nome: invoice → /Contabilità/Fatture/, contratto → /Contratti/Legali/, ricevuta → /Finanza/Incassi/.
Ogni ramo carica il PDF (dalla fase di download, non da Classify) alla cartella di destinazione. Slack notifica il team competente.

Classifica e poi analizza con il modello corretto

Email Watch si attiva quando un PDF L'allegato arriva nella casella di posta in arrivo dell'account.
La funzione "Classifica documento" identifica se si tratta di una fattura, un ordine di acquisto o una bolla di consegna.
Il router si dirama in base al nome della classe ed esegue il modulo di analisi del documento corrispondente, il modello di fattura per le fatture e il modello di ordine di acquisto per gli ordini di acquisto.
I dati estratti (totale, fornitore, data) vengono scritti in una riga di un Foglio Google per ogni tipo di documento.
Un unico scenario gestisce qualsiasi tipo di documento, senza necessità di smistamento manuale prima dell'elaborazione.

Rinominare automaticamente i file in base al tipo di documento all'arrivo.

Google Drive Watch Files si attiva quando un nuovo file viene caricato PDF viene caricato in una cartella condivisa "Documenti".
Google Drive "Ottieni un file" scarica il file binario.
Classifica documento restituisce il nome della classe, ad esempio pdf4me_contract.
Google Drive Carica un file salva nuovamente il file PDF con un nome file con prefisso: Nome della classe + trattino basso + nome originale (ad esempio pdf4me_contratto_NDA_2025.pdf).
Il file originale senza nome viene spostato in una sottocartella di archivio per riferimento.

Domande frequenti

Where do I create and manage classification rules?+

Rules are created at dev.pdf4me.com under the Classify Document section: not inside Make. Click Edit, add a Class Name and an expression (Regular Expression or JavaScript), then click Save Changes. The Make module automatically reads all saved classes from your account each time it runs. See the Set Up Classify Document guide for screenshots and full walkthrough.

What expression types are supported for defining a class?+

Two types: Regular Expression and JavaScript. Regex expressions match text patterns found anywhere in the PDF text content: for example, invoice(.*) matches any document containing the word "invoice". JavaScript expressions let you write more complex logic: multiple conditions, scored matching, or length-based rules, for documents where a single regex is insufficient.

What does the module output: does it return the PDF?+

No. The module outputs two text fields: Class Name (the matched class label, e.g. pdf4me_invoice) and Trace Id (a unique run identifier for debugging). The PDF itself is not returned. To pass the document to a downstream upload, email, or parse module, map the Document field from the prior download or trigger step: not from Classify Document.

What happens when no class expression matches the document?+

When no expression matches, the Class Name output is empty or contains an unmatched indicator. Add a fallback branch to your Router that handles empty Class Names: for example, route unclassified documents to a "Manual Review" folder and send a Slack alert. This prevents unmatched PDFs from being silently dropped or misrouted.

How many credits does each classification use?+

One credit per module execution, regardless of whether a match is found. For high-volume scenarios: processing hundreds of PDFs daily, estimate your monthly credit consumption before enabling at scale. Use the PDF4me dashboard to monitor usage and set up credit alerts if needed.