Process Files with iLovePDF API on Weekly schedule from Schedule API

Pipedream makes it easy to connect APIs for iLovePDF, Schedule and 2,400+ other apps remarkably fast.

Trigger workflow on

Weekly schedule from the Schedule API

Next, do this

Process Files with the iLovePDF API

No credit card required

▶

Watch us build a workflow

8 min

Watch now ➜

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

Getting Started#

This integration creates a workflow with a Schedule trigger and iLovePDF action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the Weekly schedule trigger
1. Connect your Schedule account
2. Configure Cron Schedule
Configure the Process Files action
1. Connect your iLovePDF account
2. Optional- Configure File URLs
3. Optional- Configure File Paths
4. Select a Tool
5. Optional- Configure Extra Parameters
6. Optional- Configure Output Filename
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Details#

This integration uses pre-built, source-available components from Pipedream's GitHub repo. These components are developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

Trigger#

Weekly schedule on Schedule

Description:Trigger your workflow on one or more days each week at a specific time (with timezone support).

Version:0.0.1

Key:schedule-weekly

View on GitHub

Schedule Overview#

The Schedule app in Pipedream is a powerful tool that allows you to trigger workflows at regular intervals, ranging from every minute to once a year. This enables the automation of repetitive tasks and the scheduling of actions to occur without manual intervention. By leveraging this API, you can execute code, run integrations, and process data on a reliable schedule, all within Pipedream's serverless environment.

Trigger Code#

import schedule from "../../schedule.app.mjs";

export default {
  name: "Weekly schedule",
  version: "0.0.1",
  key: "schedule-weekly",
  type: "source",
  description: "Trigger your workflow on one or more days each week at a specific time (with timezone support).",
  props: {
    schedule,
    cron: {
      propDefinition: [
        schedule,
        "cron",
      ],
      default: {
        cron: "0 10 * * 1",
      },
    },
  },
};

Trigger Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.

Label	Prop	Type	Description
Schedule	`schedule`	`app`	This component uses the Schedule app.
Cron Schedule	`cron`	`$.interface.timer`	Enter a cron expression

Trigger Authentication#

The Schedule API does not require authentication.

About Schedule#

Trigger workflows on an interval or cron schedule.

Action#

Process Files on iLovePDF

Description:Process one or more files with the desired tool. [See the documentation](https://developer.ilovepdf.com/docs/api-reference)

Version:0.0.1

Key:ilovepdf-process-files

View on GitHub

iLovePDF Overview#

The iLovePDF API lets you automate PDF processing tasks like merging, splitting, compressing, and converting PDFs to other formats. iLovePDF's robust functionality can be harnessed in Pipedream workflows, which may include handling PDFs generated from various triggers, processing them as needed, and connecting to other services for storage, data extraction, or further actions based on the transformed PDFs.

Action Code#

import ilovepdf from "../../ilovepdf.app.mjs";
import FormData from "form-data";
import fs from "fs";
import { ConfigurationError } from "@pipedream/platform";

export default {
  key: "ilovepdf-process-files",
  name: "Process Files",
  description: "Process one or more files with the desired tool. [See the documentation](https://developer.ilovepdf.com/docs/api-reference)",
  version: "0.0.1",
  type: "action",
  props: {
    ilovepdf,
    fileUrls: {
      propDefinition: [
        ilovepdf,
        "fileUrls",
      ],
    },
    filePaths: {
      propDefinition: [
        ilovepdf,
        "filePaths",
      ],
    },
    tool: {
      propDefinition: [
        ilovepdf,
        "tool",
      ],
    },
    extraParameters: {
      type: "object",
      label: "Extra Parameters",
      description: "Any extra parameters to be passed. Values will be parsed as JSON when applicable. [Refer to the documentation for the extra parameters of each tool](https://developer.ilovepdf.com/docs/api-reference#Process).",
      optional: true,
    },
    outputFilename: {
      type: "string",
      label: "Output Filename",
      description: "If specified, the name of the file that will be written to the `/tmp` folder. Defaults to the download filename returned by the API.",
      optional: true,
    },
  },
  async run({ $ }) {
    const {
      fileUrls, filePaths, tool, extraParameters, outputFilename,
    } = this;

    const { token } = await this.ilovepdf.getAuthToken({
      $,
    });

    // Start a new task
    const {
      server, task,
    } = await this.ilovepdf.startTask({
      $,
      token,
      tool,
    });

    if (!filePaths?.length && !fileUrls.length) {
      throw new ConfigurationError("You must provide either a File Path or File URL");
    }

    const fileNames = [
      ...filePaths ?? [],
      ...fileUrls ?? [],
    ].map((f) => f.split("/").pop());

    // Upload the files
    const pathUploads = (filePaths ?? []).map(async (filePath) => {
      const formData = new FormData();
      formData.append("task", task);

      const content = fs.createReadStream(filePath.includes("tmp/")
        ? filePath
        : `/tmp/${filePath}`);
      formData.append("file", content);
      const headers = {
        "Content-Type": `multipart/form-data; boundary=${formData._boundary}`,
      };
      return this.ilovepdf.uploadFile({
        $,
        token,
        server,
        data: formData,
        headers,
      });
    });

    const urlUploads = (fileUrls ?? []).map(async (fileUrl) => {
      return this.ilovepdf.uploadFile({
        $,
        token,
        server,
        data: {
          task,
          cloud_file: fileUrl,
        },
        headers: {
          "Content-Type": "application/json",
        },
      });
    });

    const uploadResponses = await Promise.all([
      ...pathUploads,
      ...urlUploads,
    ]);

    const serverFilenames = uploadResponses.map((response) => response?.server_filename);

    // Process the files
    const processResponse = await this.ilovepdf.processFiles({
      $,
      server,
      token,
      data: {
        task,
        tool,
        files: serverFilenames.map((value, index) => (
          {
            server_filename: value,
            filename: fileNames[index],
          }
        )),
        ...Object.fromEntries(Object.entries(extraParameters ?? {}).map(([
          key,
          value,
        ]) => {
          try {
            return [
              key,
              JSON.parse(value),
            ];
          } catch (e) {
            return [
              key,
              value,
            ];
          }
        })),
      },
    });

    // Download the processed file
    const downloadResponse = await this.ilovepdf.downloadFiles({
      $,
      token,
      server,
      task,
      responseType: "arraybuffer",
    });

    const filePath = outputFilename?.includes?.("tmp/")
      ? outputFilename
      : `/tmp/${outputFilename ?? processResponse.download_filename}`;

    await fs.promises.writeFile(filePath, Buffer.from(downloadResponse));

    $.export("$summary", `Successfully processed ${processResponse.output_filenumber} files`);
    return {
      processResponse,
      downloadResponse,
      filePath,
    };
  },
};

Action Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI.

Label	Prop	Type	Description
iLovePDF	`ilovepdf`	`app`	This component uses the iLovePDF app.
File URLs	`fileUrls`	`string[]`	The URL(s) of the file(s) to be processed.
File Paths	`filePaths`	`string[]`	The path(s) to file(s) in the `/tmp` directory. See the documentation on working with files.
Tool	`tool`	`string`	Select a value from the drop down menu:`compressmergesplitpdfjpgimagepdfunlockpagenumberwatermarkofficepdfrepairrotateprotectpdfavalidatepdfahtmlpdfextract`
Extra Parameters	`extraParameters`	`object`	Any extra parameters to be passed. Values will be parsed as JSON when applicable. Refer to the documentation for the extra parameters of each tool.
Output Filename	`outputFilename`	`string`	If specified, the name of the file that will be written to the `/tmp` folder. Defaults to the download filename returned by the API.