Πήγαινε στο κύριο περιεχόμενο

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

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

συμβουλή

Χρειάζεστε άμεση ενημέρωση για την πρόοδο του ανέβασματος; Δείτε το Παρακολούθηση Προόδου Ανέβασματος με Συνδρομές.

Τι θα Μάθετε​

Στο τέλος αυτού του οδηγού, θα ξέρετε πώς να:

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

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

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

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

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

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

Πρώτα, δημιουργήστε ένα κενό πρότυπο στο Legalesign. Αυτό επιστρέφει τόσο το αναγνωριστικό προτύπου (template 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: Το ID της ομάδας/χώρου εργασίας σας σε μορφή base64 (μπορείτε να το βρείτε από το URL στο Console https://console.legalesign.com/)
  • title: Ένα περιγραφικό όνομα για το πρότυπό σας (μπορείτε να το αλλάξετε αργότερα)

Βήμα 2: Εξαγωγή του Template ID και της Διεύθυνσης Upload URL​

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

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

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

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

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

Χρησιμοποιήστε την επιστρεφόμενη uploadUrl για να ανεβάσετε το αρχείο PDF σας απευθείας στο S3. Αυτό θα διαφέρει ανάλογα με το stack ανάπτυξής σας. Στο παράδειγμά μας με 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. Ελέγχει ή μετατρέπει το αρχείο - Ελέγχει ότι τα PDF είναι έγκυρα ή μετατρέπει υποστηριζόμενα αρχεία όπως έγγραφα Word και εικόνες σε PDF
  3. Εξάγει πληροφορίες σελίδας - Λαμβάνει πλήθος σελίδων και διαστάσεις
  4. Επεξεργάζεται το αρχείο - Το βελτιστοποιεί για προβολή και υπογραφή
  5. Αποθηκεύει με ασφάλεια - Το μετακινεί σε μόνιμη αποθήκευση

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

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

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

  • Ετικέτες κειμένου - Προσθέστε ετικέτες κειμένου Legalesign στο αρχείο πηγής ώστε να δημιουργούνται αυτόματα συμμετέχοντες, πεδία υπογραφής και πεδία φόρμας κατά τη διάρκεια της επεξεργασίας. Δείτε την εξήγηση του REST API στο γρήγορο εκπαιδευτικό και την αναφορά του endpoint Convert text tags.
  • Ενσωματωμένα πεδία PDF - Αν το PDF σας περιέχει ήδη ενσωματωμένα πεδία φόρμας, το Legalesign μπορεί να τα χρησιμοποιήσει ως μέρος της ροής εργασίας ανέβασματος και προετοιμασίας προτύπου.

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

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

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

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

Σφάλμα "Χωρίς άδεια"​

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

Σφάλμα "Το αρχείο είναι πολύ μεγάλο"​

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

Η Διεύθυνση Upload URL Έχει Λήξει​

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

Σφάλμα "Μη έγκυρο PDF"​

Ανοίξτε το PDF σε ένα πρόγραμμα ανάγνωσης PDF για να βεβαιωθείτε ότι είναι έγκυρο και στη συνέχεια κάντε επανεξαγωγή ή αποθήκευση.

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

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

Export This Article

Save a copy of this page as PDF or plain text.