Search Products 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

Search Products 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 Search Products action
1. Connect your Akeneo account
2. Optional- Configure Search
3. Optional- Select a Scope
4. Optional- Select a Locale
5. Optional- Select a Attributes
6. Optional- Configure Convert Measurements
7. Optional- Configure With Count
8. Optional- Configure With Attribute Options
9. Optional- Configure With Asset Share Links
10. Optional- Configure With Quality Scores
11. Optional- Configure With Completeness
12. Optional- Configure Page
13. Optional- Configure Limit
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#

Search Products on Akeneo

Description:Search products from Akeneo. [See the documentation](https://api.akeneo.com/api-reference.html#get_products)

Version:0.0.2

Key:akeneo-search-products

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 akeneo from "../../akeneo.app.mjs";
import { ConfigurationError } from "@pipedream/platform";

export default {
  key: "akeneo-search-products",
  name: "Search Products",
  description: "Search products from Akeneo. [See the documentation](https://api.akeneo.com/api-reference.html#get_products)",
  version: "0.0.2",
  annotations: {
    destructiveHint: false,
    openWorldHint: true,
    readOnlyHint: true,
  },
  type: "action",
  props: {
    akeneo,
    search: {
      type: "string",
      label: "Search",
      description: "Filter products, for more details see the [Filters](https://api.akeneo.com/documentation/filter.html) section",
      optional: true,
    },
    scope: {
      propDefinition: [
        akeneo,
        "channelCode",
      ],
      label: "Scope",
      description: "Filter product values to return scopable attributes for the given channel as well as the non localizable/non scopable attributes, for more details see the [Filter product values via channel](https://api.akeneo.com/documentation/filter.html#via-channel) section",
      optional: true,
    },
    locales: {
      propDefinition: [
        akeneo,
        "locale",
      ],
      description: "Filter product values to return localizable attributes for the given locales as well as the non localizable/non scopable attributes, for more details see the [Filter product values via locale](https://api.akeneo.com/documentation/filter.html#via-locale) section",
      optional: true,
    },
    attributes: {
      propDefinition: [
        akeneo,
        "attribute",
      ],
      label: "Attributes",
      description: "Filter product values to only return those concerning the given attributes, for more details see the [Filter on product values](https://api.akeneo.com/documentation/filter.html#filter-product-values) section",
      optional: true,
    },
    convertMeasurements: {
      type: "boolean",
      label: "Convert Measurements",
      description: "Convert values of measurement attributes to the unit configured in the channel provided by the parameter \"scope\". Therefore, this parameter requires the \"scope\" parameter to be provided.",
      optional: true,
    },
    withCount: {
      type: "boolean",
      label: "With Count",
      description: "Return the count of items in the response. Be careful: on large catalogs, enabling counts can significantly impact performance.",
      optional: true,
    },
    withAttributeOptions: {
      propDefinition: [
        akeneo,
        "withAttributeOptions",
      ],
    },
    withAssetShareLinks: {
      propDefinition: [
        akeneo,
        "withAssetShareLinks",
      ],
    },
    withQualityScores: {
      propDefinition: [
        akeneo,
        "withQualityScores",
      ],
    },
    withCompletenesses: {
      propDefinition: [
        akeneo,
        "withCompletenesses",
      ],
    },
    page: {
      type: "integer",
      label: "Page",
      description: "The page number to return",
      optional: true,
    },
    limit: {
      type: "integer",
      label: "Limit",
      description: "The number of items to return per page",
      optional: true,
    },
  },
  async run({ $ }) {
    if (this.convertMeasurements && !this.scope) {
      throw new ConfigurationError("The `convertMeasurements` parameter requires the `scope` parameter to be provided");
    }

    const response = await this.akeneo.getProducts({
      $,
      params: {
        search: this.search,
        scope: this.scope,
        locales: this.locales,
        attributes: this.attributes,
        convert_measurements: this.convertMeasurements,
        with_count: this.withCount,
        with_attribute_options: this.withAttributeOptions,
        with_asset_share_links: this.withAssetShareLinks,
        with_quality_scores: this.withQualityScores,
        with_completenesses: this.withCompletenesses,
        page: this.page,
        limit: this.limit,
      },
    });

    $.export("$summary", `Found ${response._embedded.items.length} products`);
    return response;
  },
};

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	`akeneo`	`app`	This component uses the Akeneo app.
Search	`search`	`string`	Filter products, for more details see the Filters section
Scope	`scope`	`string`	Select a value from the drop down menu.
Locale	`locales`	`string`	Select a value from the drop down menu.
Attributes	`attributes`	`string`	Select a value from the drop down menu.
Convert Measurements	`convertMeasurements`	`boolean`	Convert values of measurement attributes to the unit configured in the channel provided by the parameter "scope". Therefore, this parameter requires the "scope" parameter to be provided.
With Count	`withCount`	`boolean`	Return the count of items in the response. Be careful: on large catalogs, enabling counts can significantly impact performance.
With Attribute Options	`withAttributeOptions`	`boolean`	Return labels of attribute options in the response. See the`linked_data` format section for more details.
With Asset Share Links	`withAssetShareLinks`	`boolean`	Return asset collection share link urls in the response. See the `linked_data` format section for more details.
With Quality Scores	`withQualityScores`	`boolean`	Return product quality scores in the response
With Completeness	`withCompletenesses`	`boolean`	Return product completenesses in the response
Page	`page`	`integer`	The page number to return
Limit	`limit`	`integer`	The number of items to return per page

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: