Spire

Assetspire is a cloud-native platform dedicated to managing the entire lifecycle of your physical assets from data-centre hardware and furniture to facilities infrastructure, property, and vehicles. It acts as a single, secure source of truth with automatic versioning, intelligent tagging, and support for unlimited assets and locations, so your team always sees the same up-to-date inventory across your organisation.

The Assetspire App for Make brings Assetspire’s asset management experience straight into your scenarios. Once connected, you can work with your asset database directly inside the Make builder . Everything is seamlessly integrated, so you never have to leave your flow.

What Spire modules are available in the Make platform

  • Asset – Search for Assets, Watch Assets, Create an Asset, Update an Asset, List Assets, Get an Asset, Get Asset Attributes, List Associated Assets
  • Product – Search Products, Create a Product, Update a Product, List Products, Get a Product, Get Product Attributes, Watch Products
  • Location – List Locations, Get a Location, Create a Location, Get a Location Mapping, Create a Location Mapping
  • Connection – List Connections, Get a Connection
  • Other – Make API Call

Connecting Spire to Make

How do I request a BPT App License Key.

After purchasing your app either as part of a bundle or separately, you should have received an email containing the BPT App License Key. If you have not received an email or if you are yet to purchase the app please use the BPT License Key link that will guide you through the process.

How to Create a connection for your Make module

  1. Login to Make > Select ‘Scenarios’ > Select ‘Create a new scenario’

  2. Search for “Spire” > Any module you intend to user

  3. Under Connection, click ‘Create a connection’

  4. The Create a Connection dialog appears.

  5. Enter all fields as stated below:

    Spire_Make_Connection.png
    Create a connection

    Connection Name : Name of a connection that make will use. Can use the default make naming convention.

    BPT App License Key: This is a key provide by BPT to authorise access to the Make Apps

    🔗 For more information on how to acquire an App License Key, refer to the License Activation page.

    Username : This is the same as your credentials used for signing into your Assetspire instance

    Password: This is the same as your credentials used for signing into your Assetspire instance.

    Assetspire Domain: This is the assetspire instance that the account is under. This is displayed as https://{{Domain Name}}.assetspire.cloud/en-gb/ For example the url https://blueprecision.assetspire.cloud/en-gb/ the Assertpire Domain would be blueprecision.

    Spire_URL_example.png
    Assetspire URL

  6. Click Save

Location

List Locations

Returns a list or all Locations

This module contains the following fields

Field Usage
Connection Establish a connection to your Spire account.
Limit Define the number of results to return. Defaults to 50 if left unspecified.
Location ID Dropdown of all location within a location. This can be mapped with the location id supplied by a previous module

Get a Locations

Retrieves a specific location by its ID.

This module contains the following fields

Field Usage
Connection Establish a connection to your Spire account.
Location ID Input the Location ID to return data for.

Create a Location

Create an new Location entry, featuring multiple fields including the Location Code, Location Name, Parent Location, Type of Location, and other relevant information about the location.

This module contains the following fields

Field Usage
Connection Establish a connection to your Spire account.
Name * Name of Location to be created. This must be unique
Code * Code Name of Location to be created. This must be unique value.
Parent Location Location Parent that that the new location would be the child of. Not a mandatory field
Type Selection * Dropdown menu with the following options:- Dynamic Mapping: Allows for user to input the Location Type ID mapped from a previous module- Select From Type List: A drop-down list of the location types which is NOT mapped
Type ID * Location Type ID of the new location. This can either be a set dropdown or can be supplied by module. Its value determines if the nested fields return either Geographical Parameters and/or Positional Parameters If Type ID was supplied by a previous module or hard coded then by default both Geographical Parameters and Positional Parameters would be returned.
Geographical Parameter Contains following fields:- Street Address- Post Code- City- Country
Positional Parameter Contains the following fields:- Set Units of measurement- Overall Length- Overall Depth- Default Rotation Degrees- Horizontal Offset- Vertical Offset
Set Units of measurement A Positional Parameter which contains Units of measurement used for calculation area. Used in the following fields:- Overall Length- Overall Depth- Horizontal Offset- Vertical OffsetThis field is a dropdown that is also mappable.
Please be aware what unit of measurement is used and adjust the measurement accordingly

Get a Location Mapping

Retrieves a specific location mapping by its ID

This module contains the following fields

Field Usage
Connection Establish a connection to your Spire account.
Mapping ID Input the Mapping ID to return data for.

Create a Location Mapping

Create an new Location Mapping entry for a connected Location,

This module contains the following fields

Field Usage
Connection Establish a connection to your Spire account.
Name * Name of Location to be created. This must be unique
Type Dropdown of the Type of the Location Mapping
Offset X Cell Offset in the X-axis
Offset Y Cell Offset in the X-axis
Origin Point Determine Origin point to be either:- Top Left- Top Right- Bottom Right- Bottom Left
Cell Separator Texted used to separate the values for each cell
Cell Depth Cell size in depth
Cell Length Cell size in length
Manual Cell Configuration Boolean
Location * Location ID for Location
Cell Namer * Cell Naming convention for cells being created.

Assets

List Assets

List assets within a given location

This module contains the following fields

Field Usage
Connection Establish a connection to your Spire account.
Limit Define the number of results to return. Defaults to 50 if left unspecified.
Location ID Dropdown of all location within a location. This can be mapped with the location id supplied by a previous module

List Associated Assets

List all associated assets from a selected product

This module contains the following fields

Field Usage
Connection Establish a connection to your Spire account.
Limit Define the number of results to return. Defaults to 50 if left unspecified.
Product ID Product ID of the Asset intend to be returned by the module.

Get an Asset

Retrieves a specific location by its ID.

This module contains the following fields

Field Usage
Connection Establish a connection to your Spire account.
Asset ID Input the Asset ID to return data for.

Get Asset Attributes

Retrieves attributes for an asset by ID

This module contains the following fields

Field Usage
Connection Establish a connection to your Spire account.
Asset ID Input the Asset ID to return data for.

Search for Assets

Searches for assets

This module contains the following fields

Field Usage
Connection Establish a connection to your Spire account.
Search Type Dropdown for how the module will search for assets:- General- Advanced
General Fields that allow for user to search for the assets via free-form text search field
Advanced Allow for searching on individual fields:- Asset Name- Location- Product Model- Asset ID- Serial Number- Asset Type
Limit Limit the amount of data returned by the module. Set to 50 by default.

Create an Assets

Create an Asset

This module contains the following fields

Field Usage
Connection Establish a connection to your Spire account.
Asset Name * Given name for the Asset. Maximum Character for name is 120
Product Model The product that the asset will be used. Search used to find a product use either:- General - Free Text field to search the payload- Advanced - A search more tailored to find the exact module. This is used on the following fields: - Product Name - Manufacturer - Family - Product Code - Category - Asset ClassThis can also be mapped with previous Module data or a hardcoded Product ID
Placement Type Placement Type of the asset. These are the following.- Floor Mounted- Asset Mounted- Rack/Cabinet Mounted- Basic Placement
Main Location For Floor Mounted Devices this will need to be set to a location that the device will be placed
Parent Asset The ID of the parent asset that the asset would be placed in such a rack mounted or an asset mounted device
Rack Mount Location For Rack Mounted Device this is a drop-down for how the device would be mounted in the rack.

Update an Assets

Update an Asset

This module contains the following fields

Field Usage
Connection Establish a connection to your Spire account.
Asset System Id * Asset ID of the given Product
Name Given name for the Asset. Maximum Character for name is 120
Product Model The product that the asset will be used. Search used to find a product use either:- General - Free Text field to search the payload- Advanced - A search more tailored to find the exact module. This is used on the following fields: - Product Name - Manufacturer - Family - Product Code - Category - Asset ClassThis can also be mapped with previous Module data or a hardcoded Product ID
Placement Type Placement Type of the asset. These are the following.- Floor Mounted- Asset Mounted- Rack/Cabinet Mounted- Basic Placement
Custom Fields This will list all custom attributes for a asset depending on your Assetspire instance.

Watch Assets

Watch Assets

This module contains the following fields

Field Usage
Connection Establish a connection to your Spire account.
Limit * Number of result returned by the module Default is 10
Watch Event * Drop-down value for determining the type of records are returned on a poll. These event can occured on when an asset has been added or modified

Product

List Products

List Products within a given location

This module contains the following fields

Field Usage
Connection Establish a connection to your Spire account.
Limit Define the number of results to return. Defaults to 50 if left unspecified.
Location ID Dropdown of all location within a location. This can be mapped with the location id supplied by a previous module

Get an Product

Retrieves a specific location by its ID.

This module contains the following fields

Field Usage
Connection Establish a connection to your Spire account.
Product ID Input the Asset ID to return data for.

Get Product Attributes

Retrieves attributes for a product by ID

This module contains the following fields

Field Usage
Connection Establish a connection to your Spire account.
Product ID Input the Asset ID to return data for.

Search for Product

Searches for Products

This module contains the following fields

Field Usage
Connection Establish a connection to your Spire account.
Search Type Dropdown for how the module will search for products:- General- Advanced
General Fields that allow for user to search for the assets via free-form text search field
Advanced Allow for searching on individual fields:- Asset Name- Location- Product Model- Asset ID- Serial Number- Asset Type
Limit Limit the amount of data returned by the module. Set to 50 by default.

Create an Products [Pending]

Create an Product

This module contains the following fields

Field Usage
Connection Establish a connection to your Spire account.
Asset Name * Given name for the Asset. Maximum Character for name is 120

Watch Products

Watch Products

This module contains the following fields

Field Usage
Connection Establish a connection to your Spire account.
Limit * Number of result returned by the module Default is 10
Watch Event * Drop-down value for determining the type of records are returned on a poll. These event can occured on when a Product has been added or modified