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.
Pre-Requisite: This document assumes that you already have a base knowledge of using the Make platform.What Spire modules are available in the Make platform
- Assets – 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, Update a Location, Get a Location Mapping, Create a Location Mapping
- Connection – List Connections, Get a Connection
- Other – Make an API Call, Upload Document to Entity, Upload Image to Entity, Delete a Document, Delete an Image
Connecting Spire to Make
To use Spire in Make, you’ll need both your Registered BPT App License Key and an authorized Assetspire instance with a login credentialsHow 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 Frequently Asked Questions that will guide you through the process.
How to Create a connection for your Make module
Login to Make > Select ‘Scenarios’ > Select ‘Create a new scenario’
Search for “Spire” > Any module you intend to user
Under Connection, click ‘Create a connection’
The Create a Connection dialog appears.s
Enter all fields as stated below:
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 AppsIf you intend to use multiple connections for spire. Naming the connections different names will make choosing the correct connection easier.🔗 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 urlhttps://blueprecision.assetspire.cloud/en-gb/the Assertpire Domain would beblueprecision.
Assetspire URL Click Save
Location
List Location
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 | Drop-down of all location within a location. This can be mapped with the location id supplied by a previous module |
Get a Location
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 * | Drop-down 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 |
Update 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. |
| Location System ID * | Location System ID of the given location. |
| Location Name | Name of Location to be created. |
| Description | Description of Location to be created. |
| Parent Location | Location Parent that that the new location would be the child of. |
| Type Selection * | Drop-down 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 |
| Custom Fields | This will list all custom attributes for a location depending on your Spire instance. |
| Additional Reference | This will list all additional reference attributes for a location depending on your Spire instance. |
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 | Drop-down 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 Asset
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 | Drop-down of all location within a location. This can be mapped with the Location ID supplied by a previous module |
List Associated Asset
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 Attribute
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 Asset
Searches for assets
This module contains the following fields
| Field | Usage |
|---|---|
| Connection | Establish a connection to your Spire account. |
| Search Type | Drop-down 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 Asset
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 Class This 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 Asset
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 Class This 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 an 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 returned in a poll. These events occur 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 | Drop-down of all location within a location. This can be mapped with the location id supplied by a previous module |
Get a 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 Products
Searches for Products
This module contains the following fields
| Field | Usage |
|---|---|
| Connection | Establish a connection to your Spire account. |
| Search Type | Drop-down 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 a Product [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 |
Update a Product
Update a Product
This module contains the following fields
| Field | Usage |
|---|---|
| Connection | Establish a connection to your Spire account. |
| Product ID * | Product ID of the given Product. |
| Name | Name of the Product. |
| Height | Height of the Product. |
| Width | Width of the Product. |
| Depth | Depth of the Product. |
| Power Wattage | Power wattage of the Product. |
| Weight (KG) | Weight of the Product in kilograms. |
| Product Code | Product code for the Product. |
| Manufacturer Id | Manufacturer assigned to the Product. You can search by manufacturer name. |
| Catagory Id | Category assigned to the Product. You can search by category name. |
| Asset Classes | Asset classes assigned to the Product. You can select multiple asset classes. |
| Internal Height | Internal height of the Product. |
| Internal Width | Internal width of the Product. |
| Internal Depth | Internal depth of the Product. |
| Rack Units | Number of rack units used by the Product. |
| Rack Units From Top | Defines whether rack units are counted from the top. |
| Starting Rack Unit | Starting rack unit position for the Product. |
| Custom Fields | Lists all custom attributes for a product, depending on your Assetspire instance. |
Watch Products
Watch Products
This module contains the following fields
| Field | Usage |
|---|---|
| Connection | Establish a connection to your Spire account. |
| Limit * | Number of results returned by the module Default is 10 |
| Watch Event * | Drop-down value for determining the type of records returned in a poll. These events occur when a Product has been added or modified |
Connection
List Connections
Returns a list of available Assetspire connections.
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. |
Get a Connection
Retrieves a specific Assetspire connection by its ID.
This module contains the following fields
| Field | Usage |
|---|---|
| Connection | Establish a connection to your Spire account. |
| Connection ID | Input the Connection ID to return data for. |
Other
Make an API Call
Performs an arbitrary authorized API call.
This module contains the following fields
| Field | Usage |
|---|---|
| Connection | Establish a connection to your Spire account. |
| URL | Enter a path relative to your Assetspire instance. |
| Method | Select the HTTP method you want to use: GET to retrieve information for an entry. POST to create a new entry. PUT to update or replace an existing entry. PATCH to make a partial entry update. DELETE to delete an entry. |
| Headers | Enter the desired request headers. You do not have to add authorization headers; these are already included. |
| Query String | Enter the request query string. |
| Body | Enter the body content for your API call. |
Upload Document to Entity
Uploads a document to an Assetspire entity.
This module contains the following fields
| Field | Usage |
|---|---|
| Connection | Establish a connection to your Spire account. |
| Entity * | Select the type of entity this file belongs to, such as Product, Asset, or Location. |
| Entity ID * | Input the ID of the entity that the document should be uploaded to. |
| File Name | Enter the file name for the document. Supported formats are PDF, DOC, DOCX, XLS, XLSX, CSV, and TXT. |
| Data | Provide the Document data to upload. |
| Description | Provide a description for the document. |
| Set as main * | Select this option to set the Document as the main document for the entity. Defaults to false. |
Upload Image to Entity
Uploads an image to an Assetspire entity.
This module contains the following fields
| Field | Usage |
|---|---|
| Connection | Establish a connection to your Spire account. |
| Entity * | Select the type of entity this file belongs to, such as Product, Asset, or Location. |
| Image Type * | Select the projection type for your image. Choose "Not a Projection" if no projection applies, or pick a direction (Front, Rear, Top, Bottom, Left, Right) based on where the projection originates. Only for Product is selected in Entity. |
| Entity ID * | Input the ID of the entity that the image should be uploaded to. |
| File Name * | Enter the file name for the image. Only JPG, JPEG, PNG, and WEBP formats are supported. |
| Data | Provide the image data to upload. |
| Set as main | Select this option to set the image as the main image for the entity. Defaults to false. |
Delete a Document
Deletes a document from Assetspire.
This module contains the following fields
| Field | Usage |
|---|---|
| Connection | Establish a connection to your Spire account. |
| Entity * | Select the type of entity this file belongs to, such as Product, Asset, or Location. This links the file to the correct record in the system. |
| Entity ID * | Input the ID of the entity that the document should be deleted from. |
| Document ID * | Input the ID of the document to delete. |
Delete an Image
Deletes an image from Assetspire.
This module contains the following fields
| Field | Usage |
|---|---|
| Connection | Establish a connection to your Spire account. |
| Entity * | Select the type of entity this file belongs to, such as Product, Asset, or Location. This links the file to the correct record in the system. |
| Entity ID * | Input the ID of the entity that the image should be deleted from. |
| Image ID * | Input the ID of the image to delete. |