Progettare nel generatore

Inizia con un modello

Crea un modello da Modelli nel tuo account o aprine uno esistente nel generatore. Usa Risorse per aggiungere testo, titoli, tabelle, immagini o grafici. Selezionando un elemento nell'area di lavoro ne vedi le impostazioni nell'Inspector.

Layout e spazio disponibile

Usa Layout per posizione, dimensioni e allineamento e Stile per tipografia e spaziature interne. Il posizionamento a flusso segue l'ordine del documento; quello assoluto serve per posizioni precise. Preferisci flow per report che crescono e controlla le interruzioni con dati lunghi.

Dimensioni, margini e spaziature interne

Una larghezza del 100% riempie l'area contenitrice, non tutto il foglio. I margini riducono l'area utile del documento e la spaziatura interna riduce lo spazio nell'elemento. Tabelle e grafici nelle colonne sono vincolati anche alla larghezza della colonna.

Esegui la stessa operazione tramite API

L'editor scrive la definizione del modello tramite lo stesso endpoint che puoi chiamare direttamente. Leggi la definizione attuale, modificala e riscrivila con la versione letta, così non sovrascrivi per errore modifiche pubblicate nel frattempo da altri.

# 1 - Scarica la definizione su cui lavora l'editor
curl -s https://api.pdfgine.com/api/v1/templates/invoice \
  -H "X-PDFgine-Key: $PDFGINE_KEY" > invoice.json

# 2 - Modifica l'oggetto "definition" in invoice.json

# 3 - Riscrivilo con lo stesso numero di versione
curl -X POST https://api.pdfgine.com/api/v1/templates \
  -H "X-PDFgine-Key: $PDFGINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "code": "invoice",
        "name": "Invoice",
        "saveMode": "manual",
        "expectedVersion": 1,
        "changeReason": "Logo spostato al margine destro.",
        "definition": { "page": { "size": "A4", "orientation": "portrait" }, "elements": [] }
      }'

È expectedVersion a rendere sicura l'operazione. Se il modello è cambiato, la scrittura viene rifiutata con 409 e la risposta contiene la versione attuale; rileggi, riapplica la modifica e scrivi di nuovo.

Salvare e controllare gli output

Salva le modifiche, poi controlla Anteprima e l'output PDF o Word necessario. Un esempio che entra nell'area di lavoro può creare più pagine con dati reali più lunghi. Controlla insieme titoli, tabelle, etichette dei grafici e interruzioni di pagina prima di pubblicare.

Gli errori più comuni

• Quello che vedi nell'editor è la bozza. Finché non pubblichi, ogni generazione di produzione continua a usare la versione pubblicata precedente.
• I dati di esempio sono più brevi di quelli reali. Un layout che entra nell'area di lavoro può occupare una seconda pagina quando arrivano un vero nome cliente, un indirizzo e trenta righe.
• 100% indica l'area contenitrice, non il foglio. Margini e spaziature interne vengono sottratti prima di assegnare la larghezza all'elemento.
• Il posizionamento assoluto non si sposta per fare spazio. Un elemento a coordinate fisse resta lì mentre il contenuto a flusso cresce oltre di esso; usa flow per tutto ciò che può occupare più pagine.
• Due persone nello stesso modello producono un 409, non un'unione. La scrittura contiene la versione di partenza e viene rifiutata se è cambiata.