MicrosoftDocs / azure-docs

Open source documentation of Microsoft Azure
https://docs.microsoft.com/azure
Creative Commons Attribution 4.0 International
10.29k stars 21.48k forks source link

Incomplete description of "Item"-Element for "LocalizedCollections" #37608

Closed AH4 closed 5 years ago

AH4 commented 5 years ago

The documentation of the "Item"-Element currently lists two attributes: "Text" and "Value". However, when adding translations for enumerations in a "Restriction"-element of a "ClaimType", the value of the "SelectByDefault"-value will be lost. According to the schema-definition, the "Enumeration"-Element of the ClaimType and the "Item"-element of the LocalizedCollection are of type "EnumerationItem", which defines the attribute "SelectByDefault". Only when this attribute is set also for the "Item"-elements in the LocalizedCollection the selected default will be shown on the form.

Example: The following excerpt shows a "country"-claim with "germany" as the selected default value: <ClaimType Id="country"> <DisplayName>Country</DisplayName> <DataType>string</DataType> <UserInputType>DropdownSingleSelect</UserInputType> <Restriction> <Enumeration Text="Germany" Value="germany" SelectByDefault="true"/> <Enumeration Text="Switzerland" Value="switzerland" SelectByDefault="false"/> </Restriction> </ClaimType> </ClaimsSchema>

A corresponding LocalizedCollection might look like this: <LocalizedCollection ElementType="ClaimType" ElementId="country" TargetCollection="Restriction"> <Item Text="Deutschland" Value="germany" SelectByDefault="true"/> <Item Text="Schweiz" Value="switzerland" SelectByDefault="false"/> </LocalizedCollection>

Please add the missing attribute to the documentation of the "Item"-element.


Document Details

Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

frankhu-2021 commented 5 years ago

@AH4 Thanks for your feedback! We will investigate and update as appropriate.