Grouping custom actions into submenus

You can group custom action XML adapters (scripts) into display submenus by using the optional <groupName> tag.

If you add the <groupName> tag with a group name value in the declarations section of a custom action, the custom action then belongs to the named group.

Note

In typical situations, you should use a hard-coded value to define the <groupName> tag and should not need to define the <groupName> tag with keys. Keys are used for out-of-the-box adapters that need to be localized.

Example:

  • Add Actions Menu:
    • Span Actions
    • Endpoint Actions
    • Notifications
    • Custom Actions
      • Action 1, is in Group A
      • Action 2, is in Group A
      • Action 3
      • Action 4, is in Group B
Example: Group names referenced to custom actions
<?xml version="1.0" encoding="UTF-8" ?>
<deviceTypeMap xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <customDeviceCommandDeclaration>
    <name>Action 1</name>
    <guid>C9FDC1C8-A2DF-4E18-AE2B-849CF66221AA</guid>
    <groupName>Group A</groupName>
    <browserExecutable>true</browserExecutable>
    <approvable>true</approvable>
    <inspectionOnly>true</inspectionOnly>
  </customDeviceCommandDeclaration>

  <customDeviceCommandDeclaration>
    <name>Action 2</name>
    <guid>171A3D80-9201-4BB7-AAD0-A4C744192671</guid>
    <groupName>Group A</groupName>
    <browserExecutable>true</browserExecutable>
    <approvable>true</approvable>
  <inspectionOnly>true</inspectionOnly>
  </customDeviceCommandDeclaration>


  <customDeviceCommandDeclaration>
    <name>Action 3</name>
    <guid>B95115A0-4ED0-4D97-A847-DB21862EF3D0</guid>
    <browserExecutable>true</browserExecutable>
    <approvable>true</approvable>
    <inspectionOnly>true</inspectionOnly>
  </customDeviceCommandDeclaration>


  <customDeviceCommandDeclaration>
    <name>Action 4</name>
    <guid>DD288EE4-7B97-4916-80EB-5E13BDAB9130</guid>
    <groupName>Group B</groupName>
    <browserExecutable>true</browserExecutable>
    <approvable>true</approvable>
    <inspectionOnly>true</inspectionOnly>
  </customDeviceCommandDeclaration>
</deviceTypeMap> 

Related topics

About-network-spans
Managing-static-groups

 

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