Limited support This version of the product is in limited support. 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 Digital Workplace 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 Digital Workplace is context- and location-aware, enabling users to find nearby resources, "follow" resource status updates, and "update" resource status to help other users.

Related topic

Setting-up-the-My-Stuff-page

BMC Asset Management user permissions in the BMC Asset Management 9.1 documentation

Before you begin

Read the use case for finding places and assets.

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

locations-actions implementation.png

To create actions

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

To add actions to the Asset Actions Library

create asset action.png

Type options for asset actions

Type

Description

Client-side URL

The 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 installDirectory\Smart_IT_MyIT\Smart_IT_MyIT\IPA\download directory or a subdirectory. The URL to the file uses the syntax http://digitalworkplaceserver.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://digital-workplace-nyc.calbro.com/download/downloads.pdf

http://digital-workplace-nyc.calbro.com/download/hr/2015holidays.pdf

Default request

The service request definition (SRD) assigned as the Default Service Request. See Setting-up-service-requests-through-BMC-Service-Request-Management.

Request

Select 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 Enabling-and-configuring-the-enhanced-catalog-for-BMC-Digital-Workplace .

Provider

If the Incident Management provider is configured, the My-It_Action form is updated each time a user runs an action.

If you would like to implement this legacy functionality, contact BMC Professional Services.

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.

The following video (4:44) describes how you can create asset types and actions.

Note

The following video shows an older version of BMC Digital Workplace. The previous product name was MyIT. Although there might be minor changes in the user interface, the overall functionality remains the same.

icon_play.png https://youtu.be/eGAsuX5zaz8

To localize actions, see Localizing-titles-and-messages.

To associate actions to asset types

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

create asset action.png

To add 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.

To add 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 Digital Workplace clients.

 The following video (2:49) describes how to manually create assets on floor maps.

Note

The following video shows an older version of BMC Digital Workplace. The previous product name was MyIT. Although there might be minor changes in the user interface, the overall functionality remains the same.

icon_play.png https://youtu.be/Ik0sFtUHhvg

Key asset parameters

Parameter

Description

Type

From asset types, each asset inherits actions, status values, and the asset's icon on the map. This icon appears in the asset's profile.

Status

Set the initial status for the asset. This status appears in the asset's profile.

Email

Enter 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 Digital Workplace. 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 Digital Workplace 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.

The following video (4:42) includes demonstrates:

  • How administrators configure locations and assets by using BMC Digital Workplace
  • How self-service users can scan an asset having a QR code, find its profile in BMC Digital Workplace, and report an issue.

    Note

    The following video shows an older version of BMC Digital Workplace. The previous product name was MyIT. Although there might be minor changes in the user interface, the overall functionality remains the same.

 

icon-play.png https://youtu.be/LvE9uZN_gZc

 

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.

The following video (2:25) demonstrates how to use tags to assign an action to a specific asset.

 

Note

The following video shows an older version of BMC Digital Workplace. The previous product name was MyIT. Although there might be minor changes in the user interface, the overall functionality remains the same.

icon-play.png https://youtu.be/jinu3cVt3Rs

Source

Select official if the asset is created by the Administrator by using theBMC Digital WorkplaceAdmin console.

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

Owner

Select a user to assign asset ownership to this user.

Parent Asset

Select 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 Image

An 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.

For an asset of the Printer/Copier type, the URL is http://files.support.epson.com/pdf/{model}/{language}.pdf where model and language are defined as Extra Properties.

Adding URL parameters.png

To add multiple assets by importing CSV files

Import assets into BMC Digital Workplace 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

asset example.PNG

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 Digital Workplace.
  • 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 Digital Workplace.

To import assets from a CSV file

importing assets csv.png

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

add assets to floor map.png

To 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 Digital Workplace

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

The person who imports the assets must meet the following conditions:

  • Have the Asset User permission in Remedy ITSM.
  • Be a member of the same company as the assets being imported.

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

CMDB provider config.png

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

cmdb asset mappings.png

If you modify the provider settings, click Reload providers.

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

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

cmdb import assets.png

To enable crowd-sourced assets

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

  • From Configuration > Enable Features, enable Crowd Sourced Assets.
  • From Location Management > Assets > Types Library, enable User can create.

BMC Digital Workplace administrators can allow users to update asset status:

  • From Configuration > Enable Features, enable Crowd Sourced Assets.
  • 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.

To add 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.png

Key asset type parameters

Field

Description

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 status

Allow 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 Actions

To 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 center.png

Briefing center

14

cafeteria.png

Cafeteria

9

conference room.png

Conference room

10

conference room (compact icon).png

Conference room (compact icon)

23

elevator.png

Elevator

1

entry.png

Entry

0

exit.png

Exit

5

fax.png

Fax

3

Game room.png

Game room

16

Hot desk.png

Hot desk

19

Hot desk (compact icon).png

Hot desk (compact icon)

20

Hoteling desk.png

Hoteling desk

18

Hoteling desk (compact icon).png

Hoteling desk (compact icon)

21

lobby.png

Lobby

12

MailroomShipping.png

Mailroom/shipping

6

Office room.png

Office room

11

Office room (compact icon).png

Office room (compact icon)

22

other.png

Other

17

Other (compact icon).png

Other (compact icon)

24

printercopier.png

Printer / Copier

2

Reception area.png

Reception area

13

security.png

Security

4

Service Desk appointment location.png

Service Desk appointment location

7

Training room.png

Training room

15

Video equipment.png

Video equipment

8

Related videos

The following videos created by BMC contributors demonstrate various procedures described in this topic.

Note

The videos show an older version of BMC Digital Workplace. The previous product name was MyIT. Although there might be minor changes in the user interface, the overall functionality remains the same.


Where to go from here

To enable rooms reservation, see Enabling-room-reservations.

To set up rooms for appointment calendars, see Setting-up-help-desk-appointments

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*