How Tos¶

// Get the samples from https://www.adobe.com/go/dcservicessdk_java_samples
 package com.adobe.platform.operation.samples.combine;

 import java.io.IOException;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import com.adobe.platform.operation.ExecutionContext;
 import com.adobe.platform.operation.auth.Credentials;
 import com.adobe.platform.operation.exception.SdkException;
 import com.adobe.platform.operation.exception.ServiceApiException;
 import com.adobe.platform.operation.exception.ServiceUsageException;
 import com.adobe.platform.operation.io.FileRef;
 import com.adobe.platform.operation.pdfops.CombineFilesOperation;
 import com.adobe.platform.operation.pdfops.options.PageRanges;

 public class CombinePDFWithPageRanges {

   // Initialize the logger.
   private static final Logger LOGGER = LoggerFactory.getLogger(CombinePDFWithPageRanges.class);

   public static void main(String[] args) {

     try {

       // Initial setup, create credentials instance.
       Credentials credentials = Credentials.serviceAccountCredentialsBuilder()
           .fromFile("dc-services-sdk-credentials.json")
           .build();

       //Create an ExecutionContext using credentials and create a new operation instance.
       ExecutionContext executionContext = ExecutionContext.create(credentials);
       CombineFilesOperation combineFilesOperation = CombineFilesOperation.createNew();

       // Create a FileRef instance from a local file.
       FileRef firstFileToCombine = FileRef.createFromLocalFile("src/main/resources/combineFileWithPageRangeInput1.pdf");
       PageRanges pageRangesForFirstFile = getPageRangeForFirstFile();
       // Add the first file as input to the operation, along with its page range.
       combineFilesOperation.addInput(firstFileToCombine, pageRangesForFirstFile);

       // Create a second FileRef instance using a local file.
       FileRef secondFileToCombine = FileRef.createFromLocalFile("src/main/resources/combineFileWithPageRangeInput2.pdf");
       PageRanges pageRangesForSecondFile = getPageRangeForSecondFile();
       // Add the second file as input to the operation, along with its page range.
       combineFilesOperation.addInput(secondFileToCombine, pageRangesForSecondFile);

       // Execute the operation.
       FileRef result = combineFilesOperation.execute(executionContext);

       // Save the result to the specified location.
       result.saveAs("output/combineFilesWithPageOptionsOutput.pdf");

     } catch (ServiceApiException | IOException | SdkException | ServiceUsageException ex) {
       LOGGER.error("Exception encountered while executing operation", ex);
     }
   }

   private static PageRanges getPageRangeForSecondFile() {
     // Specify which pages of the second file are to be included in the combined file.
     PageRanges pageRangesForSecondFile = new PageRanges();
     // Add all pages including and after page 3.
     pageRangesForSecondFile.addAllFrom(3);
     return pageRangesForSecondFile;
   }

   private static PageRanges getPageRangeForFirstFile() {
     // Specify which pages of the first file are to be included in the combined file.
     PageRanges pageRangesForFirstFile = new PageRanges();
     // Add page 1.
     pageRangesForFirstFile.addSinglePage(1);
     // Add page 2.
     pageRangesForFirstFile.addSinglePage(2);
     // Add pages 3 to 4.
     pageRangesForFirstFile.addRange(3, 4);
     return pageRangesForFirstFile;
   }
 }
     

// Get the samples from https://www.adobe.com/go/dcservicessdk_net_samples
 using System;
 using System.IO;
 using log4net.Repository;
 using log4net;
 using log4net.Config;
 using System.Reflection;
 using Adobe.DocumentCloud.Services;
 using Adobe.DocumentCloud.Services.auth;
 using Adobe.DocumentCloud.Services.pdfops;
 using Adobe.DocumentCloud.Services.io;
 using Adobe.DocumentCloud.Services.options;
 using Adobe.DocumentCloud.Services.exception;

 namespace CombinePDFWithPageRanges
 {
   class Program
   {
     private static readonly ILog log = LogManager.GetLogger(typeof(Program));
     static void Main()
     {
       //Configure the logging
       ConfigureLogging();
       try
       {

         // Initial setup, create credentials instance.
         Credentials credentials = Credentials.ServiceAccountCredentialsBuilder()
                 .FromFile(Directory.GetCurrentDirectory() + "/dc-services-sdk-credentials.json")
                 .Build();

         //Create an ExecutionContext using credentials and create a new operation instance.
         ExecutionContext executionContext = ExecutionContext.Create(credentials);
         CombineFilesOperation combineFilesOperation = CombineFilesOperation.CreateNew();

         // Create a FileRef instance from a local file.
         FileRef firstFileToCombine = FileRef.CreateFromLocalFile(@"combineFileWithPageRangeInput1.pdf");
         PageRanges pageRangesForFirstFile = GetPageRangeForFirstFile();
         // Add the first file as input to the operation, along with its page range.
         combineFilesOperation.AddInput(firstFileToCombine, pageRangesForFirstFile);

         // Create a second FileRef instance using a local file.
         FileRef secondFileToCombine = FileRef.CreateFromLocalFile(@"combineFileWithPageRangeInput2.pdf");
         PageRanges pageRangesForSecondFile = GetPageRangeForSecondFile();
         // Add the second file as input to the operation, along with its page range.
         combineFilesOperation.AddInput(secondFileToCombine, pageRangesForSecondFile);

         // Execute the operation.
         FileRef result = combineFilesOperation.Execute(executionContext);

         // Save the result to the specified location.
         result.SaveAs(Directory.GetCurrentDirectory() + "/output/combineFilesOutput.pdf");

       }
       catch (ServiceUsageException ex)
       {
         log.Error("Exception encountered while executing operation", ex);
       }
       // Catch more errors here. . .
     }

     private static PageRanges GetPageRangeForSecondFile()
     {
       // Specify which pages of the second file are to be included in the combined file.
       PageRanges pageRangesForSecondFile = new PageRanges();
       // Add all pages including and after page 5.
       pageRangesForSecondFile.AddAllFrom(5);
       return pageRangesForSecondFile;
     }

     private static PageRanges GetPageRangeForFirstFile()
     {
       // Specify which pages of the first file are to be included in the combined file.
       PageRanges pageRangesForFirstFile = new PageRanges();
       // Add page 2.
       pageRangesForFirstFile.AddSinglePage(2);
       // Add page 3.
       pageRangesForFirstFile.AddSinglePage(3);
       // Add pages 5 to 7.
       pageRangesForFirstFile.AddRange(5, 7);
       return pageRangesForFirstFile;
     }

     static void ConfigureLogging()
     {
       ILoggerRepository logRepository = LogManager.GetRepository(Assembly.GetEntryAssembly());
       XmlConfigurator.Configure(logRepository, new FileInfo("log4net.config"));
     }
   }
 }
    

 const DCServicesSdk = require('@dcloud/dc-services-node-sdk');

 const getPageRangesForFirstFile = () => {
   // Specify which pages of the first file are to be included in the combined file.
   const pageRangesForFirstFile = new DCServicesSdk.PageRanges();
   // Add page 1.
   pageRangesForFirstFile.addSinglePage(1);
   // Add page 2.
   pageRangesForFirstFile.addSinglePage(2);
   // Add pages 3 to 4.
   pageRangesForFirstFile.addPageRange(3, 4);
   return pageRangesForFirstFile;
 };

 const getPageRangesForSecondFile = () => {
   // Specify which pages of the second file are to be included in the combined file.
   const pageRangesForSecondFile = new DCServicesSdk.PageRanges();
   // Add all pages including and after page 3.
   pageRangesForSecondFile.addAllFrom(3);
   return pageRangesForSecondFile;
 };

 try {
   // Initial setup, create credentials instance.
   const credentials =  DCServicesSdk.Credentials
     .serviceAccountCredentialsBuilder()
     .fromFile("dc-services-sdk-credentials.json")
     .build();

   // Create an ExecutionContext using credentials and create a new operation instance.
   const executionContext = DCServicesSdk.ExecutionContext.create(credentials),
     combineFilesOperation = DCServicesSdk.CombineFiles.Operation.createNew();

   // Create a FileRef instance from a local file.
   const combineSource1 = DCServicesSdk.FileRef.createFromLocalFile('resources/combineFilesInput1.pdf'),
     pageRangesForFirstFile = getPageRangesForFirstFile();
   // Add the first file as input to the operation, along with its page range.
   combineFilesOperation.addInput(combineSource1, pageRangesForFirstFile);

   // Create a second FileRef instance using a local file.
   const combineSource2 = DCServicesSdk.FileRef.createFromLocalFile('resources/combineFilesInput2.pdf'),
     pageRangesForSecondFile = getPageRangesForSecondFile();
   // Add the second file as input to the operation, along with its page range.
   combineFilesOperation.addInput(combineSource2, pageRangesForSecondFile);

   // Execute the operation and Save the result to the specified location.
   combineFilesOperation.execute(executionContext)
     .then(result => result.saveAsFile('output/combineFilesWithPageRangesOutput.pdf'))
     .catch(err => {
       if(err instanceof DCServicesSdk.Error.ServiceApiError
         || err instanceof DCServicesSdk.Error.ServiceUsageError) {
         console.log('Exception encountered while executing operation', err);
       } else {
         console.log('Exception encountered while executing operation', err);
       }
     });
 } catch (err) {
   console.log('Exception encountered while executing operation', err);
 }