Docs
General - Assets
Created: 2022-01-09 11:12:39 || Updated: 2022-04-28 16:48:18Manage your client's laptops, servers and networking gear with the assets module.
Asset Information
The following information can be recorded for each asset:
- Name
- Type (Desktop/Laptop/Server/Mobile, etc)
- Make/Manufacturer
- Model
- Serial Number
- OS
- IP & MAC addresses
- Vendor
- Purchase, install, and warranty dates
- Notes
Assets can also be associated with other data in ITFlow, such as:
- Clients
- Locations
- Networks
- Logins
- Referenced in tickets
- Services
Asset Export to CSV
- You can easily export assets for a client using the Export button when viewing assets for a particular client
- Assets are exported in a CSV in the format:
- Name, Type, Make, Model, Serial Number, OS, Purchase Date, Warranty Expire, Install Date, Assigned To, Location, Notes
- Name, Type, Make, Model, Serial Number, OS, Purchase Date, Warranty Expire, Install Date, Assigned To, Location, Notes
Asset Import via CSV
- You can import a list of assets for a client using the Import button and uploading a CSV
- The CSV must be in the following format (with headings):
- Name, Type, Make, Model, Serial Number, OS
API
/api/v1/assets
Read - Retrieve asset information (/read.php)
- Default / No params - Returns all assets
- asset_id - Specific asset ID from the ITFlow database
- asset_name - Asset Name
- asset_type - Type of asset (e.g. Laptop, Desktop, Server, etc)
- asset_serial - Asset Serial Number
- client_id - Returns all assets for a specific client
Invoke-RestMethod -Uri "http://127.0.0.1/itflow/api/v1/assets/read.php?api_key=XetQjoZiti5Opg7y&asset_id=7" | ConvertTo-Json { [...] |
Create - Create a new asset (/create.php)
Specify parameters as below. The new asset ID will be returned.
$uri = "http://127.0.0.1/itflow/api/v1/assets/create.php" success count data |
Update - Update attributes of an existing asset (/update.php)
Only parameters specified are changed, remove parameters you don't want to modify. Client ID is required if the API key has access to all clients. True/False is returned.
$uri = "http://127.0.0.1/itflow/api/v1/assets/update.php" success count |
Deprecated - Asset Add via API
- Assets can also be added/imported via the API
- The API query to /api.php must include the following information
- api_key - You can find this at /settings-general.php
- client_id - Client to relate the asset with
- add_asset - Name of the asset
- type - Asset type. Accepted values are: Laptop, Desktop, Server, Phone, Mobile Phone, Tablet, Firewall/Router, Switch, Access Point, Printer, Camera, TV, Virtual Machine, Other
- make - Manufacturer of the asset
- model - Model of the asset
- serial - S/N of the asset
- os - Operating System
- Example:
- > Invoke-RestMethod -Uri "http://127.0.0.1/itflow/api.php?api_key=IhgiLuryNAdwZs7&client_id=1&add_asset=MyAssetName&type=Desktop&make=Dell&model=XPS&serial=XXYYY&os=Win10"
- Response: Asset added!
- Response: Asset added!
- > Invoke-RestMethod -Uri "http://127.0.0.1/itflow/api.php?api_key=IhgiLuryNAdwZs7&client_id=1&add_asset=MyAssetName&type=Desktop&make=Dell&model=XPS&serial=XXYYY&os=Win10"