How Tos¶

// Get the samples from https://www.adobe.com/go/dcservicessdk_java_samples
import java.io.IOException;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import com.adobe.platform.operation.ClientContext;
import com.adobe.platform.operation.exception.SdkException;
import com.adobe.platform.operation.exception.ServiceApiException;
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 a ClientContext using a config file, and a new operation instance.
           ClientContext clientContext = ClientContext.createFromFile("dc-services-sdk-config.json");
           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(clientContext);

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

       } catch (ServiceApiException | IOException | SdkException 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.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 a ClientContext and a new operation instance.
    ClientContext clientContext = ClientContext.CreateFromFile(Directory.GetCurrentDirectory() + "/dc-services-sdk-config.json");
    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(clientContext);

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

   }
   catch (ServiceApiException ex)
   {
    log.Error("Exception encountered while executing operation", ex);
   }
   catch(SDKException ex)
   {
    log.Error("Exception encountered while executing operation", ex);
   }
   catch(IOException ex)
   {
    log.Error("Exception encountered while executing operation", ex);
   }
   catch(Exception ex)
   {
    log.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 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('@adobe/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 a ClientContext using a config file, and a new operation instance.
   const clientContext = DCServicesSdk.ClientContext.createFromFile('dc-services-sdk-config.json'),
     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(clientContext)
     .then(result => result.saveAsFile('output/combineFilesWithPageRangesOutput.pdf'))
     .catch(err => console.log('Exception encountered while executing operation', err));
 } catch (err) {
   console.log('Exception encountered while executing operation', err);
 }