Merge pull request #95511 from tfitzmac/1111tagsui

add tagsbyresource ui element

Author: TedA-M

articles/managed-applications/create-uidefinition-elements.md

@@ -1,20 +1,16 @@
 ---
 title: Azure create UI definition element | Microsoft Docs
 description: Describes the elements to use when constructing UI definitions for Azure portal.
-services: managed-applications
-documentationcenter: na
 author: tfitzmac
 
 ms.service: managed-applications
-ms.devlang: na
 ms.topic: reference
-ms.tgt_pltfrm: na
-ms.workload: na
-ms.date: 09/19/2018
+ms.date: 11/11/2019
 ms.author: tomfitz
 
 ---
 # CreateUiDefinition elements
+
 This article describes the schema and properties for all supported elements of a CreateUiDefinition. 
 
 ## Schema
@@ -55,6 +51,7 @@ The documentation for each element contains a UI sample, schema, remarks on the
 - [Microsoft.Common.OptionsGroup](microsoft-common-optionsgroup.md)
 - [Microsoft.Common.PasswordBox](microsoft-common-passwordbox.md)
 - [Microsoft.Common.Section](microsoft-common-section.md)
+- [Microsoft.Common.TagsByResource](microsoft-common-tagsbyresource.md)
 - [Microsoft.Common.TextBlock](microsoft-common-textblock.md)
 - [Microsoft.Common.TextBox](microsoft-common-textbox.md)
 - [Microsoft.Compute.CredentialsCombo](microsoft-compute-credentialscombo.md)
@@ -66,4 +63,5 @@ The documentation for each element contains a UI sample, schema, remarks on the
 - [Microsoft.Storage.StorageAccountSelector](microsoft-storage-storageaccountselector.md)
 
 ## Next steps
+
 For an introduction to creating UI definitions, see [Getting started with CreateUiDefinition](create-uidefinition-overview.md).

articles/managed-applications/media/managed-application-elements/microsoft.common.tagsbyresource.png

@@ -0,0 +1,75 @@
+---
+title: Azure TagsByResource UI element
+description: Describes the Microsoft.Common.TagsByResource UI element for Azure portal. Use to apply tags to a resource during deployment.
+author: tfitzmac
+
+ms.service: managed-applications
+ms.topic: reference
+ms.date: 11/11/2019
+ms.author: tomfitz
+
+---
+
+# Microsoft.Common.TagsByResource UI element
+
+A control for associating [tags](../azure-resource-manager/resource-group-using-tags.md) with the resources in a deployment.
+
+## UI sample
+
+![Microsoft.Common.DropDown](./media/managed-application-elements/microsoft.common.tagsbyresource.png)
+
+## Schema
+
+```json
+{
+  "name": "element1",
+  "type": "Microsoft.Common.TagsByResource",
+  "resources": [
+    "Microsoft.Storage/storageAccounts",
+    "Microsoft.Compute/virtualMachines"
+  ]
+}
+```
+
+## Sample output
+
+```json
+{
+  "Microsoft.Storage/storageAccounts": {
+    "Dept": "Finance",
+    "Environment": "Production"
+  },
+  "Microsoft.Compute/virtualMachines": {
+    "Dept": "Finance"
+  }
+}
+```
+
+## Remarks
+
+- At least one item in the `resources` array must be specified.
+- Each element in `resources` must be a fully qualified resource type. These elements appear in the **Resource** dropdown, and are taggable by the user.
+- The output of the control is formatted for easy assignment of tag values in an Azure Resource Manager template. To receive the control's output in a template, include a parameter in your template as shown in the following example:
+
+  ```json
+  "parameters": {
+    "tagsByResource": { "type": "object", "defaultValue": {} }
+  }
+  ```
+
+  For each resource that can be tagged, assign the tags property to the parameter value for that resource type:
+
+  ```json
+  {
+    "name": "saName1",
+    "type": "Microsoft.Storage/storageAccounts",
+    "tags": "[ if(contains(parameters('tagsByResource'), 'Microsoft.Storage/storageAccounts'), parameters('tagsByResource')['Microsoft.Storage/storageAccounts'], json('{}')) ]",
+    ...
+  ```
+
+- Use the [if](../azure-resource-manager/resource-group-template-functions-logical.md#if) function when accessing the tagsByResource parameter. It enables you to assign an empty object when no tags are assigned to the given resource type.
+
+## Next steps
+
+- For an introduction to creating UI definitions, see [Getting started with CreateUiDefinition](create-uidefinition-overview.md).
+- For a description of common properties in UI elements, see [CreateUiDefinition elements](create-uidefinition-elements.md).

articles/managed-applications/microsoft-common-tagsbyresource.md

@@ -124,6 +124,8 @@
         href: microsoft-common-passwordbox.md
       - name: Section
         href: microsoft-common-section.md
+      - name: TagsByResource
+        href: microsoft-common-tagsbyresource.md
       - name: TextBlock
         href: microsoft-common-textblock.md
       - name: TextBox