This documentation supports the 19.05 version of BMC Digital Workplace Advanced.

To view an earlier version, select the version from the Product Version menu.

Managing assets on floor maps

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.


Before you begin

Creating actions for assets

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

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.

 https://youtu.be/eGAsuX5zaz8

To add an action to the Asset Actions Library

  1. In the BMC Digital Workplace Admin console, click Location Management.
  2. Click Actions Library.
  3. Click Add.
  4. From the Type list, select one of the following types:

    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 DigitalWorkplaceHome\DWP\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 as shown in the following (non-working) links:

    http://digital-workplace-nyc.calbro.com/download/downloads.pdf

    http://digital_workplace_nyc.calbro.com/download/hr/2015_holidays.pdf

    Default requestThe service request definition (SRD) assigned as the Default Service Request. See Setting the default service request definitions for BMC Digital Workplace.
    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 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.

  5. Complete the other fields, which change depending on the type you selected in step 4.
    To specify the action for specific assets only, enter a tag in the Tag field. If the action has a tag such as a model number, then only assets with the same tag have the action.

  6. Click Create Action.

To localize actions, see Localizing titles and messages.

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.  

You can add assets individually 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 end user console.

You can also add multiple assets by using a CSV file or by performing a CMDB import. See these procedures below.

 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.

 https://youtu.be/Ik0sFtUHhvg

To add assets from a floor map

  1. In the BMC Digital Workplace Admin console, click Location Management.
  2. Click Floor Maps.
  3. Select a floor map, and click Edit Floor Map.
  4. Click Edit Floor Map Info, and scroll down to view the Assets table.
  5. Click Add Asset.
  6. Scroll down the page, and complete the fields:

    FieldDescription
    NameName of the asset.
    TypeAsset 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. Asset types are defined in the Types Library. For more information, see Managing asset types.
    StatusThe initial status for the asset. This status appears in the asset's profile. Status labels are defined with the type in the Types Library. For more information, see Managing asset types.
    EmailA valid email address that is assigned to an asset. To enable reservations, enter a Microsoft Exchange email address.
    QR Code Data

    The asset's QR code. 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.

     https://youtu.be/LvE9uZN_gZc

    Tag

    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.

    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.

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

     https://youtu.be/jinu3cVt3Rs

    Parent AssetThe 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.
    Source

    The source for the asset. The options are:

    • Official if an administrator creates the asset by using theBMC Digital WorkplaceAdmin console.
    • User-created if a business user adds the asset in BMC Digital Workplace. Business users can create assets if Crowd source assets feature is enabled in theBMC Digital WorkplaceAdmin console. For more information, see To enable crowd-sourced assets below.
    OwnerThe user who owns the asset.
    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.
  7. Click Save Asset.
  8. If you want to add extra properties to an asset:
    1. Select the asset from the Assets table.
    2. Under Extra Properties in the Edit asset "Asset Name" area, click New Property, and complete the fields.

      For example, you might want to add extra properties if an asset is associated with a URL through an action. Then, you can add parameters to the URL with extra properties. In the example below, an asset of the Printer/Copier type has an action associated with a URL of http://files.support.epson.com/pdf/{model}/{language}.pdf, and model and language are defined as Extra Properties.

      Adding URL parameters
  9. Click Save Asset.

To add multiple assets by importing CSV files

  1. Prepare 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,,,,,,,,,

    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.
      Here is an example of a CSV file in Microsoft Excel:

  2. In the BMC Digital Workplace Admin console, click Location Management.
  3. Under Assets, click CSV Import.
  4. Select a location into which to import the assets.
  5. Click Choose File, and select the CSV file.
  6. Click Import.
    After the import, your assets are available in the Assets > View All window.

To add BMC.ASSET dataset assets from BMC Atrium CMDB

Note

Changing asset details in BMC Digital Workplace does not automatically update the asset records in BMC Atrium CMDB. 
  1. Make sure that the person who imports the assets must meet the following conditions:
    • Has the Asset User permission in Remedy ITSM
    • Is a member of the same company as the assets being imported
  2. Configure the CMDB pluggable provider settings:
    1. In the BMC Digital Workplace Admin console, click Configuration.
    2. From the Providers table (at the bottom of the window), select the CMDB pluggable provider check box.

    3. Click in the CMDB pluggable provider row, and scroll down to view the fields.

    4. Complete the fields.

      The cmdb.url, cmdb.port, and cmdb.auth.pswd fields are connection settings to the BMC Atrium CMDB server.

      The cmdb.query.dataset field is the production (or master) dataset with asset data that has been normalized and reconciled. By default, this should be BMC.ASSET.

      For more information about the fields, see List of providers.

      To ensure that the assets are imported successfully, verify that BMC Digital Workplace asset fields are mapped to Atrium CMDB attributes. If you use attributes other than the defaults, you must change the mappings.
  3. If you modify the provider settings, click the Reload providers button.

  4. In BMC Remedy AR System, verify that the configuration settings specify the application service password, host name, and port number.

  5. In BMC Atrium Core, create a shared query that includes the attributes used in the BMC Digital Workplace mappings. (Your query must include ReconciliationIdentity.)

    For more information, see  Building queries in BMC Atrium Explorer  and  How queries work  in the Atrium Core online documentation.

  6.  Select the query to import the assets from Atrium CMDB into BMC Digital Workplace:

    1. In the BMC Digital Workplace Admin console, click Location Management.
    2. Under Assets, click CMDB Import.
    3. From the Query Name field, select the query in BMC Atrium CMDB.
    4. In the External ID field, enter the ID.
    5. (Optional) Modify the Name value to restrict or broaden the query results.

      For example, Allen Allbrook created a query with the % wildcard for a default Name value. To import all the Bell computer equipment, Allen would enter Bell% in the Name field.

To enable crowd-sourced assets

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

  1. From Configuration > Application Features, select Crowd Sourced Assets.
  2. From Location Management > Assets > Types Library, select the asset type and select User can create.

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

  1. From Configuration > Application Features, select Crowd Sourced Assets.
  2. From Location Management > Assets > Types Library, select the asset type and select User can update status. Then, specify the status labels that users can select.
  3. Create the Report equipment outage action, and add the action to the asset type.

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.


Video URLDescription

https://youtu.be/eGAsuX5zaz8

This video (4:43) provides an overview and demonstrates create asset actions, associate actions to asset types, use tags for assets, and add new asset types.

https://youtu.be/KRqch7fhYko

This video (3:29) provides an overview and demonstrates how you can manually add assets or import them from a CSV file.

Where to go from here

To enable room reservations, see Enabling room reservations.

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

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

Comments

  1. Tamara Ehmoser

    Hi! In the Asset Action-Type-Menu there is also an entry "Provider" existing, but it is not described here what you can do with this Action-Type. Can you please add that?

    Apr 15, 2019 02:49
    1. Lisa Greene

      Hello Tamara,

      The Provider type option is legacy functionality, but I added the following description:

      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.

      Thank you,

      Lisa Greene

      May 06, 2019 12:44