Unsupported content

 

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments. Click here to view the documentation for the current version.

Adding assets

BMC MyIT provides an intuitive experience for users to search for locations and assets such as conference rooms, offices, printers, and other resources that they need. BMC MyIT is context- and location-aware, enabling users to find nearby resources, "follow" resource status updates, and "update" resource status to help other users.

Before you begin

Assets are located on floor maps. You must first add a location to BMC MyIT, and then add floor maps to the location, as described in Setting up locations.

locations-actions implementation

Creating actions

Actions are associated with asset types and appear as buttons in the asset's profile based on the associated type.

Adding actions to the Asset Actions Library

create asset action

Type options for asset actions

TypeDescription
Client-side URLThe user’s device executes the URL.
Server-side URL

The server executes the URL and returns a response to the user’s device.

You can place files in the MyITinstallDirectory\Smart_IT_MyIT\Smart_IT_MyIT\IPA\download directory or a subdirectory. The URL to the file uses the syntax http://myitserver.mycompany.com/download/filename.extension .

The file and subdirectory names must not use spaces. Use underscores or hyphens to replace spaces; for example (non-working links):

http://myit-vm-nyc.calbro.com/download/downloads.pdf

http://myit-vm-nyc.calbro.com/download/hr/2015holidays.p df

Default requestThe service request definition (SRD) assigned as the Default Service Request. See Setting the default service request definitions for BMC MyIT.
RequestSelect a request that you want to open for the user when the action is executed. See Setting up service requests through BMC Service Request Management and Setting up service requests through BMC MyIT Service Broker .

Use Tag to specify the action for specific assets only. If the action has a tag such as a model number, then only assets with the same tag have the action.

To localize actions, see Localizing titles and messages.

Associating actions to asset types

When adding or editing an asset type, you can add actions to that asset type.

link action to asset type

Adding assets

When you create floor maps, you can add assets that users can act on. For example, you might add a Printer/Copier asset so that a user can tap the icon and submit a request for toner.

Adding assets manually  

You can add individual assets to a floor map when you create or edit it. Changes to assets on maps are automatically saved.

When you save a new asset, its icon appears on the floor map, and it is visible in the BMC MyIT clients.

Key asset parameters

ParameterDescription
TypeFrom asset types, each asset inherits actions, status values, and the asset's icon on the map. This icon appears in the asset's profile.
StatusSet the initial status for the asset. This status appears in the asset's profile.
EmailEnter a valid email address assigned to an asset. To enable reservations, you must provide a Microsoft Exchange email address.
QR Code Data

If an asset has a QR code, users can scan the asset to find its profile in BMC MyIT. With asset actions, create buttons on the profile that link to self-help resources or to enable users to report that the asset has a problem.

BMC MyIT can use any type of code that mobile devices recognize. For example, iOS  devices can detect the following codes: UPC-A, UPC-E, Code 39, Code 39 mod 43, Code 93, Code 128, EAN-8, EAN-13, Aztec, PDF417, QR.

Tags

Additional metadata for an asset. Using tags, you can select specific assets that have particular actions. For example, if an action has the tag 5635 and is associated with the Printer/Copier type, only assets with the 5638 tag have that action.

Source

Select official if the asset is created by the Administrator by using the BMC MyIT Admin console.

Select user-created if the asset is added by a business user in BMC MyIT console. Business users can create assets if Crowd source assets feature is enabled in BMC MyIT Admin console.

OwnerSelect a user to assign asset ownership to this user.
Parent AssetSelect the asset to which a new asset is related or subordinated. For example, a conference room can be a parent asset of a specific printer or video device.
Profile ImageAn image to use in the asset's profile. Images must be 320x200 pixels, 640x400 pixels, or another size with the same aspect ratio. The profile image supports .gif, .jpg, .png, and .bmp file types.

If an asset is associated with a URL through an action, add parameters to the URL with New Property.

Adding URL parameters

Adding multiple assets by importing CSV files  

Import assets into MyIT by using a comma-separated values (CSV) file in the following format:

CSV asset file example
#ExternalId,name,xPos,yPos,assetTypeId,assetStatus,desc,desc2,desc3,phone,tag,metaData,qrCodeData,locationDesc,metaDataJson
A1,A1,110,577,Office room (compact icon),1,,,,,,,,,,
A1,A1,110,577,Office room (compact icon),1,,,,,,,,,
A2,A2,201,583,Office room (compact icon),1,,,,,,,,,
A3,A3,252,583,Office room (compact icon),1,,,,,,,,,

Example: Assets CSV file in Microsoft Excel

The assets CSV file must meet the following requirements:

  • The file must be in MS-DOS, comma-delimited format.
  • Fields with asterisks (for example, ExternalId* and name*) must contain an entry. (The ExternalId field is used for API integration updates.)
  • The field names in the file must match the field names in BMC MyIT.
  • If an entry in a field contains spaces, the entry must be enclosed in quotation marks.
  •  The assetTypeId value must match a corresponding asset type in BMC MyIT.

Importing assets from a CSV file

importing assets csv

After the import, your assets are available in the Assets > View All window.

add assets to floor map

Adding assets from BMC Atrium CMDB 

Import assets from the BMC.ASSET dataset by using a query shared in BMC Atrium Core.

Note

Changing asset details in BMC MyIT will not automatically update the asset records in BMC Atrium CMDB. 

Verify that the configuration settings in BMC Remedy AR System specify the application service password, host name, and port number.

CMDB provider config

To ensure that the assets are imported successfully, the mapped attributes must be populated in BMC Atrium CMDB. If you use attributes other than the defaults, you must change the mappings.

cmdb asset mappings

In BMC Atrium Core, create a shared query that includes the attributes used in the BMC MyIT mappings.  Your query must include ReconciliationIdentity.
See Building queries in BMC Atrium Explorer and How queries work in the BMC Atrium Core online documentation.

Next, select the query to import the assets from BMC Atrium CMDB into BMC MyIT.

cmdb import assets

Enabling crowd-sourced assets  

BMC MyIT administrators can allow user-created assets based on asset type:

  • From Configuration > Enable Features, enable User-Created Assets in Configuration > Enable Features.
  • From Location Management > Assets > Types Library, enable User can create.

BMC MyIT administrators can allow users to update asset status:

  • From Configuration > Enable Features, enable User-Created Assets in Configuration > Enable Features.
  • From Location Management > Assets > Types Library, modify the asset type:
    • Enable User can update status, and specify the status labels that users can select.
    • Create the Report equipment outage action, and add the action to the asset type.

Adding asset types

Note

Before entering the name and status labels for any locale, enter them for the (default) option. This default text is shown on the user’s device if no name and status labels are defined for the locale specified on the user’s device or if no specific locale is selected on the user’s device.

adding asset types

Key asset type parameters

FieldDescription
Good status label

Enter text that indicates that the asset is ready to be used.

Example: Working for a printer or Available for a conference room.

Bad status label

Enter text that indicates that the asset is not ready to be used.

Example: Closed for a cafeteria or Occupied for a workplace.

Users can update statusAllow users to update the status for this asset type; available only when User-Created Assets is enabled in the Configuration tab.
Users can create

Allow users to create assets for this type; available only when User-Created Assets is enabled in the Configuration tab.

Icon

All assets of this type use the selected icon. See the Asset type icons table below.

Available Actions and Selected ActionsTo associate an asset type with one or more actions, add actions. Unless tags are used to specify assets, assets of the associated type have the selected actions.

Asset type icons

Icon
Asset type
Alias number
Briefing center14
Cafeteria9
Conference room10
Conference room (compact icon)23
Elevator1
Entry0
Exit5
Fax3
Game room16
Hot desk19
Hot desk (compact icon)20
Hoteling desk18
Hoteling desk (compact icon)21
Lobby12
Mailroom/shipping6
Office room11
Office room (compact icon)22
Other17

Other (compact icon)

24

Printer / Copier

2

Reception area

13

Security

4

Service Desk appointment location

7

Training room

15

Video equipment

8
Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Brijesh Patel

    In the: "Adding multiple assets by importing CSV files" section, are the columns correct? I am getting an error when trying to import assets by a CSV file:

    "No assets were imported from your file.

    There was a server error during import: "CSV file has invalid column count: 14""

     

    Tried deleting different rows but still comes up with an error.

    Apr 05, 2016 06:16
    1. Michele Marques

      I will check and get back to you. This section has not needed an updated for some time. Did you ask Support to look at your CSV?

      Apr 06, 2016 12:27
  2. Anton Polovynka

    There is one more column need to be added - metaDataJson(also one coma for the values)

    There is the correct format:

    #ExternalId,name,xPos,yPos,assetTypeId,assetStatus,desc,desc2,desc3,phone,tag,metaData,qrCodeData,locationDesc,metaDataJson
    A1,A1,110,577,Office room (compact icon),1,,,,,,,,,

     

    Apr 08, 2016 10:57
    1. Brijesh Patel

      Thanks

      Apr 10, 2016 06:05
      1. Michele Marques

        I updated the doc

        Apr 12, 2016 10:51
  3. Naji Abdallahi

    In the section about URL parameters it says "For an asset of the Conference Room type, the URL is http://serverName/buildingNumber/roomNumber where buildingNumber and roomNumber are defined as Extra Properties." but is that correct? Should the parameters be surrounded by any special characters? It is  [ ] in SmartIT, but that does not seem to work.

    Oct 25, 2016 10:53
    1. Bhakti Paranjpe

      Hello Naji,

      Thank you for your question. The parameters should be surrounded by curly brackets "{" and "}". I have updated the example in the above topic.

      Thanks,
      Bhakti

      Nov 09, 2016 03:53