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

Αποστολή Αρχείου ως Πρότυπο

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

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

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

Παράδειγμα απάντησης:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Σφάλμα "No permission"​

Επιβεβαιώστε ότι το group ID είναι σωστό και ότι έχετε ταυτοποιηθεί με τον σωστό λογαριασμό.

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

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

Η Διεύθυνση URL Ανέβασματος έχει Λήξει​

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

Σφάλμα "Invalid PDF"​

Ανοίξτε το PDF σε αναγνώστη PDF για να επιβεβαιώσετε ότι είναι έγκυρο, στη συνέχεια επανεξάγετε ή επανα-αποθηκεύστε το.

Export This Article

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