Change Order Status with AmeriCommerce API on New Records Returned by CloudWatch Logs Insights Query from AWS API

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

Trigger workflow on

New Records Returned by CloudWatch Logs Insights Query from the AWS API

Next, do this

Change Order Status with the AmeriCommerce 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 AWS trigger and AmeriCommerce action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Records Returned by CloudWatch Logs Insights Query trigger
1. Connect your AWS account
2. Select a AWS Region
3. Select one or more CloudWatch Log Groups
4. Configure Logs Insights Query
5. Optional- Configure Emit query results as a single event
6. Configure Polling schedule
Configure the Change Order Status action
1. Connect your AmeriCommerce account
2. Select a Order Status ID
3. Optional- Configure Name
4. Optional- Configure Is Open
5. Optional- Configure Is Declined
6. Optional- Configure Is Cancelled
7. Optional- Configure Is Shipped
8. Optional- Configure Color
9. Optional- Select a Email Template ID
10. Optional- Configure Is Fully Refunded
11. Optional- Configure Is Partially Refunded
12. Optional- Configure Is Quote Status
13. Optional- Configure Is Partially Shipped
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 Records Returned by CloudWatch Logs Insights Query on AWS

Description:Executes a CloudWatch Logs Insights query on a schedule, and emits the records as invidual events (default) or in batch

Version:0.2.2

Key:aws-new-records-returned-by-cloudwatch-logs-insights-query

View on GitHub

AWS Overview#

The AWS API unlocks endless possibilities for automation with Pipedream. With this powerful combo, you can manage your AWS services and resources, automate deployment workflows, process data, and react to events across your AWS infrastructure. Pipedream offers a serverless platform for creating workflows triggered by various events that can execute AWS SDK functions, making it an efficient tool to integrate, automate, and orchestrate tasks across AWS services and other apps.

Trigger Code#

import common from "../../common/common-cloudwatch-logs.mjs";
import { DEFAULT_POLLING_SOURCE_TIMER_INTERVAL } from "@pipedream/platform";

export default {
  ...common,
  key: "aws-new-records-returned-by-cloudwatch-logs-insights-query",
  name: "New Records Returned by CloudWatch Logs Insights Query",
  // eslint-disable-next-line pipedream/source-description
  description: "Executes a CloudWatch Logs Insights query on a schedule, and emits the records as invidual events (default) or in batch",
  version: "0.2.2",
  type: "source",
  props: {
    aws: common.props.aws,
    region: common.props.region,
    db: "$.service.db",
    // eslint-disable-next-line pipedream/props-label
    logGroupNames: {
      ...common.props.logGroupName,
      type: "string[]",
      description: "The log groups you'd like to query",
    },
    queryString: {
      label: "Logs Insights Query",
      description: "The query you'd like to run. See [this AWS doc](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html) for help with query syntax",
      type: "string",
    },
    emitResultsInBatch: {
      type: "boolean",
      label: "Emit query results as a single event",
      description: "If `true`, all events are emitted as an array, within a single Pipedream event. If `false`, each row of results is emitted as its own event. Defaults to `true`",
      optional: true,
      default: true,
    },
    timer: {
      label: "Polling schedule",
      description: "How often you want to query CloudWatch Logs Insights for results",
      type: "$.interface.timer",
      default: {
        intervalSeconds: DEFAULT_POLLING_SOURCE_TIMER_INTERVAL,
      },
    },
  },
  async run() {
    const now = +new Date();
    const startTime = this.db.get("startTime") || now - 1000 * 60 * 60;

    // First, start the query
    const params = {
      queryString: this.queryString,
      startTime,
      endTime: now,
      logGroupNames: this.logGroupNames,
    };

    const { queryId } = await this.startQuery(params);

    // Then poll for its status, emitting each record as its own event when completed
    async function sleep(ms) {
      return new Promise((r) => setTimeout(r, ms));
    }

    let result, res;
    do {
      await sleep(1000);
      res = await this.getQueryResults({
        queryId,
      });
      result = res.status;
    } while (result === "Running" || result === "Scheduled");

    if (result !== "Complete") {
      throw new Error(`Query ${queryId} failed with status ${result}`);
    }

    console.log(JSON.stringify(res, null, 2));
    const { results } = res;

    if (!results || !results.length) {
      console.log("No results, exiting");
      this.db.set("startTime", now);
      return;
    }

    if (this.emitResultsInBatch === true) {
      this.$emit(results, {
        summary: JSON.stringify(results),
      });
    } else {
      for (const item of results) {
        this.$emit(item, {
          summary: JSON.stringify(item),
        });
      }
    }

    // The next time this source runs, query for data starting now
    this.db.set("startTime", now);
  },
};

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
AWS	`aws`	`app`	This component uses the AWS app.
AWS Region	`region`	`string`	Select a value from the drop down menu.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
CloudWatch Log Groups	`logGroupNames`	`string[]`	Select a value from the drop down menu.
Logs Insights Query	`queryString`	`string`	The query you'd like to run. See this AWS doc for help with query syntax
Emit query results as a single event	`emitResultsInBatch`	`boolean`	If `true`, all events are emitted as an array, within a single Pipedream event. If `false`, each row of results is emitted as its own event. Defaults to `true`
Polling schedule	`timer`	`$.interface.timer`	How often you want to query CloudWatch Logs Insights for results

Trigger Authentication#

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

Follow the AWS Instructions for creating an IAM user with an associated access and secret key.

As a best practice, attach the minimum set of IAM permissions necessary to perform the specific task in Pipedream. If your workflow only needs to perform a single API call, you should create a user and associate an IAM group / policy with permission to do only that task. You can create as many linked AWS accounts in Pipedream as you'd like.

Enter your access and secret key below.

About AWS#

Amazon Web Services (AWS) offers reliable, scalable, and inexpensive cloud computing services.

Action#

Change Order Status on AmeriCommerce

Description:Changes the status of an existing order. [See the documentation](https://developers.cart.com/docs/rest-api/6898d9f254dfb-update-an-order-status).

Version:0.0.1

Key:americommerce-change-order-status

View on GitHub

Action Code#

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

export default {
  key: "americommerce-change-order-status",
  name: "Change Order Status",
  description: "Changes the status of an existing order. [See the documentation](https://developers.cart.com/docs/rest-api/6898d9f254dfb-update-an-order-status).",
  version: "0.0.1",
  type: "action",
  props: {
    app,
    orderStatusId: {
      optional: false,
      propDefinition: [
        app,
        "orderStatusId",
      ],
    },
    name: {
      type: "string",
      label: "Name",
      description: "The name of the order status.",
      optional: true,
    },
    isOpen: {
      type: "boolean",
      label: "Is Open",
      description: "Indicates whether the order status is open.",
      optional: true,
    },
    isDeclined: {
      type: "boolean",
      label: "Is Declined",
      description: "Indicates whether the order status is declined.",
      optional: true,
    },
    isCancelled: {
      type: "boolean",
      label: "Is Cancelled",
      description: "Indicates whether the order status is cancelled.",
      optional: true,
    },
    isShipped: {
      type: "boolean",
      label: "Is Shipped",
      description: "Indicates whether the order status is shipped.",
      optional: true,
    },
    color: {
      type: "string",
      label: "Color",
      description: "The color of the order status.",
      optional: true,
    },
    emailTemplateId: {
      propDefinition: [
        app,
        "emailTemplateId",
      ],
    },
    isFullyRefunded: {
      type: "boolean",
      label: "Is Fully Refunded",
      description: "Indicates whether the order status is fully refunded.",
      optional: true,
    },
    isPartiallyRefunded: {
      type: "boolean",
      label: "Is Partially Refunded",
      description: "Indicates whether the order status is partially refunded.",
      optional: true,
    },
    isQuoteStatus: {
      type: "boolean",
      label: "Is Quote Status",
      description: "Indicates whether the order status is a quote status.",
      optional: true,
    },
    isPartiallyShipped: {
      type: "boolean",
      label: "Is Partially Shipped",
      description: "Indicates whether the order status is partially shipped.",
      optional: true,
    },
  },
  methods: {
    changeOrderStatus({
      orderStatusId, ...args
    } = {}) {
      return this.app.put({
        path: `/order_statuses/${orderStatusId}`,
        ...args,
      });
    },
  },
  async run({ $ }) {
    const {
      changeOrderStatus,
      orderStatusId,
      name,
      isOpen,
      isDeclined,
      isCancelled,
      isShipped,
      color,
      emailTemplateId,
      isFullyRefunded,
      isPartiallyRefunded,
      isQuoteStatus,
      isPartiallyShipped,
    } = this;

    const response = await changeOrderStatus({
      $,
      orderStatusId,
      data: {
        name,
        is_open: isOpen,
        is_declined: isDeclined,
        is_cancelled: isCancelled,
        is_shipped: isShipped,
        color,
        email_template_id: emailTemplateId,
        is_fully_refunded: isFullyRefunded,
        is_partially_refunded: isPartiallyRefunded,
        is_quote_status: isQuoteStatus,
        is_partially_shipped: isPartiallyShipped,
      },
    });
    $.export("$summary", `Successfully changed the order status with ID \`${response.id}\`.`);
    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
AmeriCommerce	`app`	`app`	This component uses the AmeriCommerce app.
Order Status ID	`orderStatusId`	`string`	Select a value from the drop down menu.
Name	`name`	`string`	The name of the order status.
Is Open	`isOpen`	`boolean`	Indicates whether the order status is open.
Is Declined	`isDeclined`	`boolean`	Indicates whether the order status is declined.
Is Cancelled	`isCancelled`	`boolean`	Indicates whether the order status is cancelled.
Is Shipped	`isShipped`	`boolean`	Indicates whether the order status is shipped.
Color	`color`	`string`	The color of the order status.
Email Template ID	`emailTemplateId`	`string`	Select a value from the drop down menu.
Is Fully Refunded	`isFullyRefunded`	`boolean`	Indicates whether the order status is fully refunded.
Is Partially Refunded	`isPartiallyRefunded`	`boolean`	Indicates whether the order status is partially refunded.
Is Quote Status	`isQuoteStatus`	`boolean`	Indicates whether the order status is a quote status.
Is Partially Shipped	`isPartiallyShipped`	`boolean`	Indicates whether the order status is partially shipped.

Action Authentication#

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

About AmeriCommerce#

The B2B Commerce Platform for Digital Transformations.

More Ways to Connect AmeriCommerce + AWS#

Other Popular Integrations#

Change Order Status with AmeriCommerce API on New DynamoDB Stream Event from AWS API

AWS + AmeriCommerce

Change Order Status with AmeriCommerce API on New Records Returned by CloudWatch Logs Insights Query from AWS API

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

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

Developers ♥ Pipedream

1-24of2,400+apps by most popular

1
-
24
of
2,400+
apps by most popular