Create A New Product Media File with Akeneo API on New Time Entry Started from McTime API

Pipedream makes it easy to connect APIs for Akeneo, McTime and 2,900+ other apps remarkably fast.

Trigger workflow on

New Time Entry Started from the McTime API

Next, do this

Create A New Product Media File with the Akeneo 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 McTime trigger and Akeneo action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Time Entry Started trigger
1. Connect your McTime account
2. Configure timer
Configure the Create A New Product Media File action
1. Connect your Akeneo account
2. Optional- Select a Product Identifier
3. Optional- Select a Product Model Code
4. Select a Attribute Code
5. Configure File Path or URL
6. Optional- Configure syncDir
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#

New Time Entry Started on McTime

Description:Emit new event each time a new time entry is started

Version:0.0.1

Key:mctime-new-time-entry-started

View on GitHub

McTime Overview#

The McTime API provides functionality for tracking and managing time-related data. With McTime integrated into Pipedream, you can automate processes involving employee scheduling, time tracking, and payroll. Leverage Pipedream's ability to connect with hundreds of apps to link time data with project management tools, accounting software, and communication platforms, streamlining workflow efficiencies and reducing manual timekeeping errors.

Trigger Code#

import { DEFAULT_POLLING_SOURCE_TIMER_INTERVAL } from "@pipedream/platform";
import mctime from "../../mctime.app.mjs";

export default {
  key: "mctime-new-time-entry-started",
  name: "New Time Entry Started",
  description: "Emit new event each time a new time entry is started",
  version: "0.0.1",
  type: "source",
  dedupe: "unique",
  props: {
    mctime,
    db: "$.service.db",
    timer: {
      type: "$.interface.timer",
      default: {
        intervalSeconds: DEFAULT_POLLING_SOURCE_TIMER_INTERVAL,
      },
    },
  },
  methods: {
    _getLastStarted() {
      return this.db.get("lastStarted");
    },
    _setLastStarted(lastStarted) {
      this.db.set("lastStarted", lastStarted);
    },
    generateMeta(data) {
      const {
        id, from,
      } = data;
      return {
        id,
        summary: `New Time Entry: ${id}`,
        ts: Date.parse(from),
      };
    },
    getDateTimeWithOffset(date) {
      date = new Date(date);
      const offsetMinutes = date.getTimezoneOffset();
      const offsetHours = Math.abs(Math.floor(offsetMinutes / 60));
      const offsetMinutesRemainder = Math.abs(offsetMinutes % 60);
      const offsetSign = offsetMinutes > 0
        ? "-"
        : "+";
      const offsetFormatted = offsetSign + (offsetHours < 10
        ? "0"
        : "") + offsetHours + ":" + (offsetMinutesRemainder < 10
        ? "0"
        : "") + offsetMinutesRemainder;
      const isoString = date.toISOString().split(".")[0];
      return isoString + offsetFormatted;
    },
  },
  async run() {
    const currentDate = new Date();
    const to = this.getDateTimeWithOffset(currentDate);
    let lastStarted = this._getLastStarted()
      || this.getDateTimeWithOffset(currentDate.setDate(currentDate.getDate() - 7)); // if no lastStarted get date from one week ago
    const params = {
      to,
      from: lastStarted,
      page: 1,
    };
    let total;
    do {
      const { items } = await this.mctime.getTimeEntries({
        params,
      });
      const timeEntries = items[0].data.timeEntries;
      for (const timeEntry of timeEntries) {
        for (const time of timeEntry.times) {
          if (Date.parse(time.from) > Date.parse(lastStarted)) {
            lastStarted = time.from;
          }
          const meta = this.generateMeta(time);
          this.$emit(time, meta);
        }
      }
      total = timeEntries?.length;
      params.page++;
    } while (total);
    this._setLastStarted(lastStarted);
  },
};

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
McTime	`mctime`	`app`	This component uses the McTime app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
	`timer`	`$.interface.timer`

Trigger Authentication#

McTime uses API keys for authentication. When you connect your McTime account, Pipedream securely stores the keys so you can easily authenticate to McTime APIs in both code and no-code steps.

About McTime#

McTime's time recording helps small and large teams to record and evaluate project hours or absences. Fully automatic time recording included!

Action#

Create A New Product Media File on Akeneo

Description:Allows you to create a new media file and associate it to an attribute value of a given product or product model. [See the docs](https://api.akeneo.com/api-reference.html#post_media_files)

Version:0.1.4

Key:akeneo-create-a-new-product-media-file

View on GitHub

Akeneo Overview#

The Akeneo API empowers users to streamline product information management by automating data exchange between Akeneo and other systems. By leveraging Pipedream, you can construct workflows that trigger actions based on events in Akeneo, sync product data across platforms, enhance product information with data from external sources, and keep sales channels up-to-date with the latest catalog details.

Action Code#

import app from "../../akeneo.app.mjs";
import {
  ConfigurationError, getFileStreamAndMetadata,
} from "@pipedream/platform";
import FormData from "form-data";

export default {
  type: "action",
  key: "akeneo-create-a-new-product-media-file",
  version: "0.1.4",
  annotations: {
    destructiveHint: false,
    openWorldHint: true,
    readOnlyHint: false,
  },
  name: "Create A New Product Media File",
  description: "Allows you to create a new media file and associate it to an attribute value of a given product or product model. [See the docs](https://api.akeneo.com/api-reference.html#post_media_files)",
  props: {
    app,
    productId: {
      propDefinition: [
        app,
        "productId",
      ],
      optional: true,
    },
    productModelCode: {
      propDefinition: [
        app,
        "productModelCode",
      ],
    },
    mediaFileAttributeCode: {
      propDefinition: [
        app,
        "mediaFileAttributeCode",
      ],
    },
    filename: {
      type: "string",
      label: "File Path or URL",
      description: "The file to be uploaded. Provide either a file URL or a path to a file in the `/tmp` directory (for example, `/tmp/myFile.txt`)",
    },
    syncDir: {
      type: "dir",
      accessMode: "read",
      sync: true,
      optional: true,
    },
  },
  async run ({ $ }) {
    if (!this.productId && !this.productModelCode) {
      throw new ConfigurationError("Either `Product Identifier` or `Product Model Code` should be set!");
    }

    const payload = {
      attribute: this.mediaFileAttributeCode,
      scope: null,
      locale: null,
    };
    const data = new FormData();
    if (this.productId) {
      payload.identifier = this.productId;
      data.append("product", JSON.stringify(payload));
    } else {
      payload.code = this.productModelCode;
      data.append("product_model", JSON.stringify(payload));
    }

    const {
      stream, metadata,
    } = await getFileStreamAndMetadata(this.filename);
    data.append("file", stream, {
      contentType: metadata.contentType,
      knownLength: metadata.size,
      filename: metadata.name,
    });
    const contentLength = data.getLengthSync();
    await this.app.createProductMediaFile({
      $,
      headers: {
        "Content-Length": contentLength,
        ...data.getHeaders(),
      },
      data,
    });
    $.export("$summary", "The product media file has been created.");
    return;
  },
};

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
Akeneo	`app`	`app`	This component uses the Akeneo app.
Product Identifier	`productId`	`string`	Select a value from the drop down menu.
Product Model Code	`productModelCode`	`string`	Select a value from the drop down menu.
Attribute Code	`mediaFileAttributeCode`	`string`	Select a value from the drop down menu.
File Path or URL	`filename`	`string`	The file to be uploaded. Provide either a file URL or a path to a file in the `/tmp` directory (for example, `/tmp/myFile.txt`)
syncDir	`syncDir`	`dir`

Action Authentication#

Akeneo uses OAuth authentication. When you connect your Akeneo account, Pipedream will open a popup window where you can sign into Akeneo and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Akeneo API.

Pipedream requests the following authorization scopes when you connect your account: