Artisan SVG > Object Helpers (object-helpers) (box-3)

Object Helpers
4.1

Object Helpers enable you to create, interact with and manipulate objects

Overview
Copy

The Object Helpers connector allows you to interact with objects more easily and efficiently, depending on your workflow needs.

Think of it as a 'tidier' way of dealing with data from multiple steps, sources and / or databases.

It primarily helps users alter their data into a format which subsequent steps can then work with more proficiently.

See our operation summaries below for more ideas and information on your potential data manipulation options.

USER TIP: A user can also use the Object Helper to create an object from the data gathered throughout the workflow steps, and then send said object to another workflow using the Callable Trigger. See our documentation for more details.

Object Helper Templates
Copy

Below are some relevant templates you may wish to use or learn from. The full range can be found in our Templates Library.

Templates demonstrate pre-configured best practices / common use cases as well as examples of how to use this connector and how best to integrate it with others.

IMPORTANT! Please make sure you read the notes and instructional sections on this page before using any of these templates. A basic understanding of this connector's capabilities will help avoid potential pitfalls during your own build process.

Artisan IMG > Linkedin (linkedin) (98204dc0-c437-44e0-8a18-f9ae125a714f)
Collect LinkedIn lead-gen form responses
Workflow
Marketing
Advanced

Sends lead-gen form answers from LinkedIn to a destination of your choice

Details
Artisan IMG > SalesLoft (salesloft) (4e949938-8c50-47ce-83ea-75d29a2af9ef)
Artisan IMG > HubSpot (hubspot) (e4d5dcb5-2d04-460d-9091-e98e8c18e614)
Sync Salesloft Accounts to HubSpot Companies
Workflow
Marketing
Intermediate

Syncs any updated or new accounts in Salesloft over to HubSpot as companies

Details
Artisan IMG > Slack (slack) (6632c308-2cd1-4f68-8128-e521e552a66b)
Artisan IMG > Salesforce (salesforce) (dd966f42-81e8-4770-a3d8-d095ca41ab45)
Create Salesforce accts / opps with Slack modal
Workflow
Sales
Intermediate

Presents users with a referral form in Slack to create a new account / opportunity in Salesforce

Details

Important notes
Copy

Compatible objects
Copy

Incompatible objects will not always stop your workflow from running.

Please make sure that your 'object types' are compatible i.e. what your Object Helper is expecting to retrieve. Such as an array of objects vs a single object, or that the formatting of the objects themselves are correct.

Operations
Copy

Add Key / Value pairs
Copy

Adds fields to a pre-existing object

Or creates a new object from scratch

Then returns everything in the form of a 'new' single object

USER TIP: If you need to update/ create a new Value based off a pre-existing Key, use the Add Value by Key operation instead.

Add Value by Key
Copy

Updates the value of a particular field

USER TIP: If you need to return a singular object (i.e. create both the Value and the Key in question), use the Add Key/ Value pairs operation instead.

Contains
Copy

Checks if an object contains a particular field.

Returns:

  • True if an object contains your specified field

  • False if otherwise

USER TIP: If you need to return the Value of the data itself, use the Get Value by Key operation instead.

Delete Key / Value pair
Copy

Allows you to delete a particular field from an object

Enforce Object Structure
Copy

Defines a structure that the object MUST adhere to

Once confirmed any additional fields from the input are also included

USER TIP: You may find that our Fallback values feature a more effective and simpler way to deal with inconsistent data - especially when Service APIs do not return anything at all for fields with missing values and can cause errors in subsequent steps trying to pull those fields.

Equals
Copy

Allows you to check if two objects are the same.

Returns:

  • True if the object has exactly the same fields and values as the comparative

  • False if otherwise

USER TIP: If you need to find the difference between two objects, use the Find Difference operation instead.

Find Difference
Copy

Compares two fields or objects.

Returns:

  • The differences if there are any

  • Empty if none found

USER TIP: If you need to return a boolean indicator based off the difference between two objects use the Equals operation instead.

Get Value by Key
Copy

Allows you to retrieve the value of a particular field

USER TIP: If you need to return a boolean result use the Contain operation instead.

Iterative transform
Copy

Goes through the fields available and alters them as requested (capitalize, camelCase etc.)

JSON Parse
Copy

Takes JSON code and returns it as an object

USER TIP: If you need to turn an object into a sting use the JSON Stringify operation instead.

JSON Stringify
Copy

Takes an object and transforms it into a JSON string

USER TIP: If you need to turn an string into an object use the JSON Parse operation instead.

Map Keys
Copy

Allows you to change the field name referenced and replace it with your preferred name

USER TIP: Check out our documentation on the Data Mapper core connector for more potential mapping use cases and operations.

Merge two objects
Copy

Allows you to merge two objects into one

The primary object is the main point of reference

Pick Values by Keys
Copy

Allows you to return a Value by its reference field

Properties Exist
Copy

This operation checks if the fields mentioned exist and returns:

A list of found items

A list of not found items

As well as a True/ False value for the original query

Remove Null Values
Copy

Allows you to Delete any fields with null or empty values