Μετάβαση στο κύριο περιεχόμενο

Ανέβασμα Αρχείου ως Πρότυπο

Αυτός ο οδηγός σας καθοδηγεί σε όλη τη διαδικασία δημιουργίας ενός προτύπου και ανέβασμα ενός αρχείου PDF, εικόνας ή Word για χρήση ως πρότυπο εγγράφου στο Legalesign.

Τι Θα Μάθετε​

Μέχρι το τέλος αυτού του οδηγού, θα γνωρίζετε πώς να:

  1. Δημιουργήσετε ένα νέο πρότυπο στην ομάδα σας στο Legalesign
  2. Λάβετε το ID προτύπου και το URL ανέβασματος από την απόκριση της μετάλλαξης
  3. Ανέβασμα του αρχείου πηγής στο πρότυπο
  4. Επαληθεύσετε ότι το ανέβασμα ήταν επιτυχές

Προαπαιτούμενα​

Πριν ξεκινήσετε, βεβαιωθείτε ότι έχετε:

  • Λογαριασμό Legalesign με πρόσβαση API
  • Τις διαπιστευτήριες αυθεντικοποίησής σας (δείτε τον οδηγό αυθεντικοποίησης)
  • Ένα αρχείο PDF, εικόνας ή Word έτοιμο για ανέβασμα (μέγιστο 50MB)
  • Το ID της ομάδας σας (τον χώρο εργασίας όπου θέλετε να δημιουργήσετε το πρότυπο)

Η Πλήρης Διαδικασία​

Βήμα 1: Δημιουργία Προτύπου​

Πρώτα, δημιουργήστε ένα κενό πρότυπο στο Legalesign. Αυτό επιστρέφει τόσο το ID του προτύπου όσο και ένα προ-υπογεγραμμένο URL ανέβασματος για το ανέβασμα του PDF. Για να το κάνετε αυτό, θα χρειαστεί να εκτελέσετε μια GraphQL μετάλλαξη. Εάν δεν το έχετε ξανακάνει, δείτε το Εισαγωγή στο GraphQL.

Τι είναι το Πρότυπο;​

Ένα πρότυπο είναι μια επαναχρησιμοποιήσιμη δομή εγγράφου στο Legalesign. Μόλις ανεβάσετε ένα PDF σε ένα πρότυπο, μπορείτε να:

  • Προσθέσετε πεδία υπογραφής και πεδία φόρμας
  • Το στείλετε σε πολλούς παραλήπτες
  • Το επαναχρησιμοποιήσετε για διαφορετικούς υπογράφοντες

GraphQL Μετάλλαξη​

mutation CreateTemplate($input: templateCreateInput!) {
createTemplate(input: $input) {
id
uploadUrl
}
}

Είσοδοι Μεταβλητών​

{
"input": {
"groupId": "grpYourGroupAPIId",
"title": "Employment Contract Template"
}
}

Επεξήγηση Παραμέτρων​

  • groupId: Το αναγνωριστικό σε base 64 της ομάδας/χώρου εργασίας σας (μπορείτε να το πάρετε από το URL στο Console https://console.legalesign.com/)
  • title: Ένα περιγραφικό όνομα για το πρότυπό σας (μπορείτε να το αλλάξετε αργότερα)
  • uploadOptions (προαιρετικό): Επιλογές επεξεργασίας που εφαρμόζονται όταν ανεβαίνει το PDF:
    • pdfFieldsImport: true — εισαγωγή ενσωματωμένων πεδίων φόρμας PDF ως πεδία προτύπου
    • processTags: true — επεξεργασία ετικετών κειμένου Legalesign στο έγγραφο κατά το ανέβασμα

Βήμα 2: Εξαγωγή του ID Προτύπου και του URL Ανέβασματος​

Η μετάλλαξη επιστρέφει ένα αντικείμενο templateCreateOutput. Αποθηκεύστε το πεδίο id και το string uploadUrl.

Παράδειγμα απόκρισης:

{
"data": {
"createTemplate": {
"id": "dHBsYjQ5YTg5NWQtYWRhMy0xMWYwLWIxZGMtMDY5NzZlZmU0MzIx",
"uploadUrl": "https://s3.amazonaws.com/bucket/path?signature=..."
}
}
}
Συμβουλή

Το ID προτύπου είναι ένα string κωδικοποιημένο σε Base64. Αποθηκεύστε και τις δύο τιμές της απόκρισης. Το uploadUrl έχει σύντομη διάρκεια ζωής και πρέπει να χρησιμοποιείται άμεσα.

Βήμα 3: Ανέβασμα του PDF σας​

Χρησιμοποιήστε το επιστρεφόμενο uploadUrl για να ανεβάσετε απευθείας το PDF σας στο S3. Αυτό θα διαφέρει ανάλογα με το αναπτυξιακό περιβάλλον σας. Στο παράδειγμα με JavaScript χρησιμοποιήσαμε τη μέθοδο fetch, αλλά μπορείτε να χρησιμοποιήσετε και άλλες βιβλιοθήκες όπως το aws-amplify.

Πλήρη Παραδείγματα Εργασίας​

import fs from 'fs';

const AUTH_TOKEN = '<token-from-authentication-guide>';

const uploadPdfTemplate = async (groupId, title, pdfFilePath) => {
const graphqlEndpoint = 'https://graphql.uk.legalesign.com/graphql';

// Step 1: Create the template
console.log('Creating template...');
const createResponse = await fetch(graphqlEndpoint, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': `Bearer ${AUTH_TOKEN}`
},
body: JSON.stringify({
query: `
mutation CreateTemplate($input: templateCreateInput!) {
createTemplate(input: $input) {
id
uploadUrl
}
}
`,
variables: {
input: {
groupId: groupId,
title: title
}
}
})
});

const createResult = await createResponse.json();
const templateId = createResult.data.createTemplate.id;
const uploadUrl = createResult.data.createTemplate.uploadUrl;
console.log('Template created with ID:', templateId);

// Step 2: Upload the PDF
console.log('Uploading PDF...');
const fileData = fs.readFileSync(pdfFilePath);

const uploadResponse = await fetch(uploadUrl, {
method: 'PUT',
body: fileData,
headers: {
'Content-Type': 'application/pdf'
}
});

if (!uploadResponse.ok) {
throw new Error(`Upload failed: ${uploadResponse.statusText}`);
}

console.log('PDF uploaded successfully!');

return {
success: true,
templateId: templateId,
title: title
};
};

// Usage example
uploadPdfTemplate(
'grpYourGroupId',
'Employment Contract',
'./contract.pdf'
).then(result => {
console.log('Complete!', result);
}).catch(error => {
console.error('Error:', error);
});

Δεν απαιτούνται επιπλέον εξαρτήσεις — το Node.js 18+ περιλαμβάνει το fetch εγγενώς.

Τι Συμβαίνει Μετά το Ανέβασμα;​

Μόλις ανεβεί το PDF σας, το Legalesign αυτόματα:

  1. Σαρώει για ιούς - Εξασφαλίζει ότι το αρχείο είναι ασφαλές
  2. Επικυρώνει ή μετατρέπει το αρχείο - Ελέγχει αν τα PDFs είναι έγκυρα ή μετατρέπει υποστηριζόμενα αρχεία όπως έγγραφα Word και εικόνες σε PDF
  3. Εξάγει πληροφορίες σελίδων - Λαμβάνει αριθμό σελίδων και διαστάσεις
  4. Επεξεργάζεται το αρχείο - Βελτιστοποιεί για προβολή και υπογραφή
  5. Το αποθηκεύει με ασφάλεια - Μεταφέρει το σε μόνιμη αποθήκευση

Αυτή η διαδικασία συνήθως διαρκεί λίγα δευτερόλεπτα. Μόλις ολοκληρωθεί, το πρότυπό σας είναι έτοιμο για χρήση!

Παρακολούθηση Προόδου Ανέβασματος​

Για να λάβετε ανατροφοδότηση σε πραγματικό χρόνο σχετικά με την επεξεργασία ανέβασματος (σαρωτικά, επικύρωση, ολοκλήρωση), χρησιμοποιήστε συνδρομές. Δείτε Παρακολούθηση Προόδου Ανέβασματος με Συνδρομές.

Εναλλακτικά, κάντε επανάληψη στο πεδίο fileUploaded του προτύπου μέχρι να επιστρέψει true:

query CheckUploadStatus($id: ID!) {
template(id: $id) {
id
fileUploaded
}
}

Προσθήκη Υπογραφών και Πεδίων​

Αν θέλετε να αυτοματοποιήσετε συμμετέχοντες και τοποθέτηση πεδίων, μπορείτε να προετοιμάσετε το αρχείο πηγής πριν το ανέβασμα με μερικούς διαφορετικούς τρόπους:

  • Ετικέτες κειμένου — Προσθέστε ετικέτες κειμένου Legalesign στο αρχικό έγγραφο ώστε να δημιουργούνται αυτόματα συμμετέχοντες, πεδία υπογραφής και πεδία φόρμας κατά την επεξεργασία. Περνάτε uploadOptions: { processTags: true } στη μετάλλαξη createTemplate για να το ενεργοποιήσετε. Δείτε την εξήγηση στο REST API στον οδηγό αρχικής εκκίνησης και την αναφορά στο endpoint Μετατροπή Ετικετών Κειμένου.
  • Ενσωματωμένα πεδία PDF — Εάν το PDF σας περιέχει ήδη ενσωματωμένα πεδία φόρμας, περάστε uploadOptions: { pdfFieldsImport: true } στη μετάλλαξη createTemplate για να τα εισαγάγετε αυτόματα ως πεδία προτύπου.

Επόμενα Βήματα​

Τώρα που έχετε πρότυπο με PDF, μπορείτε να:

  1. Προσθέσετε πεδία υπογραφής - Χρησιμοποιήστε τη μετάλλαξη createTemplateElement για να προσθέσετε πεδία
  2. Δημιουργήσετε ρόλους - Ορίστε ποιος θα υπογράψει το έγγραφο
  3. Στείλετε για υπογραφή - Χρησιμοποιήστε τη μετάλλαξη send για να το στείλετε στους παραλήπτες

Συνήθη Προβλήματα και Λύσεις​

Σφάλμα "No permission"​

Επαληθεύστε ότι το ID της ομάδας σας είναι σωστό και είστε αυθεντικοποιημένοι με τον σωστό λογαριασμό.

Σφάλμα "File too large"​

Συμπιέστε το PDF σας — το μέγιστο μέγεθος είναι 50MB.

Λήξη του URL Ανέβασματος​

Χρησιμοποιήστε το uploadUrl που επιστράφηκε από τη createTemplate έγκαιρα. Εάν λήξει πριν το ανεβάσετε, ζητήστε νέο URL με το ερώτημα upload χρησιμοποιώντας το αποθηκευμένο ID προτύπου.

Σφάλμα "Invalid PDF"​

Ανοίξτε το PDF σε πρόγραμμα ανάγνωσης PDF για να βεβαιωθείτε ότι είναι έγκυρο και στη συνέχεια экспорт ή αποθηκεύστε το εκ νέου.