Delen via

StringCollection-claimtransformaties

  • Artikel

Dit artikel bevat voorbeelden voor het gebruik van de transformaties van de tekenreeksverzamelingsclaims van het Identity Experience Framework-schema in Azure Active Directory B2C (Azure AD B2C). Zie claimtransformaties voor meer informatie.

AddItemToStringCollection

Voegt een tekenreeksclaim toe aan een nieuwe unieke waarden stringCollection-claim. Bekijk de Livedemo van de claimtransformatie.

Element TransformationClaimType Gegevenstype Notities
InputClaim Element tekenreeks Het ClaimType dat moet worden toegevoegd aan de uitvoerclaim.
InputClaim verzameling StringCollection De tekenreeksverzameling die moet worden toegevoegd aan de uitvoerclaim. Als de verzameling items bevat, kopieert de claimtransformatie de items en voegt het item toe aan het einde van de uitvoerverzamelingsclaim.
OutputClaim verzameling StringCollection Het ClaimType dat wordt geproduceerd nadat deze claimtransformatie is aangeroepen, met de waarde die is opgegeven in de invoerclaim.

Gebruik deze claimtransformatie om een tekenreeks toe te voegen aan een nieuwe of bestaande stringCollection. Het wordt vaak gebruikt in een technisch profiel AAD-UserWriteUsingAlternativeSecurityId . Voordat een nieuw sociaal account wordt gemaakt, leest de claimtransformatie CreateOtherMailsFromEmail het ClaimType en voegt de waarde toe aan het claimtype otherMails .

Voorbeeld van AddItemToStringCollection

Met de volgende claimtransformatie wordt het e-mailbericht ClaimType toegevoegd aan otherMails ClaimType.

<ClaimsTransformation Id="CreateOtherMailsFromEmail" TransformationMethod="AddItemToStringCollection">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="email" TransformationClaimType="item" />
    <InputClaim ClaimTypeReferenceId="otherMails" TransformationClaimType="collection" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="otherMails" TransformationClaimType="collection" />
  </OutputClaims>
</ClaimsTransformation>
  • De invoerclaims:
    • verzameling: ["someone@outlook.com"]
    • item: "admin@contoso.com"
  • De uitvoerclaims:
    • verzameling: ["someone@outlook.com", "admin@contoso.com"]

AddParameterToStringCollection

Voegt een tekenreeksparameter toe aan een nieuwe unieke waarden stringCollection-claim. Bekijk de Livedemo van de claimtransformatie.

Element TransformationClaimType Gegevenstype Notities
InputClaim verzameling StringCollection De tekenreeksverzameling die moet worden toegevoegd aan de uitvoerclaim. Als de verzameling items bevat, kopieert de claimtransformatie de items en voegt het item toe aan het einde van de uitvoerverzamelingsclaim.
InputParameter Element tekenreeks De waarde die moet worden toegevoegd aan de uitvoerclaim.
OutputClaim verzameling StringCollection Het ClaimType dat wordt geproduceerd nadat deze claimtransformatie is aangeroepen, met de waarde die is opgegeven in de invoerparameter.

Voorbeeld van AddParameterToStringCollection

In het volgende voorbeeld wordt een constant e-mailadres (admin@contoso.com) toegevoegd aan de claim otherMails .

<ClaimsTransformation Id="SetCompanyEmail" TransformationMethod="AddParameterToStringCollection">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="otherMails" TransformationClaimType="collection" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="item" DataType="string" Value="admin@contoso.com" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="otherMails" TransformationClaimType="collection" />
  </OutputClaims>
</ClaimsTransformation>
  • De invoerclaims:
    • verzameling: ["someone@outlook.com"]
  • De invoerparameters
    • item: "admin@contoso.com"
  • De uitvoerclaims:
    • verzameling: ["someone@outlook.com", "admin@contoso.com"]

GetSingleItemFromStringCollection

Haalt het eerste item op uit de opgegeven tekenreeksverzameling. Bekijk de Livedemo van de claimtransformatie.

Element TransformationClaimType Gegevenstype Notities
InputClaim verzameling StringCollection De ClaimTypes die worden gebruikt door de claimtransformatie om het item op te halen.
OutputClaim extractedItem tekenreeks De ClaimTypes die worden geproduceerd nadat deze ClaimsTransformation is aangeroepen. Het eerste item in de verzameling.

Voorbeeld van GetSingleItemFromStringCollection

In het volgende voorbeeld wordt de claim otherMails gelezen en wordt het eerste item geretourneerd in de e-mailclaim .

<ClaimsTransformation Id="CreateEmailFromOtherMails" TransformationMethod="GetSingleItemFromStringCollection">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="otherMails" TransformationClaimType="collection" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="email" TransformationClaimType="extractedItem" />
  </OutputClaims>
</ClaimsTransformation>
  • De invoerclaims:
    • verzameling: ["someone@outlook.com", "someone@contoso.com"]
  • De uitvoerclaims:
    • extractedItem: "someone@outlook.com"

StringCollectionContains

Controleert of een StringCollection-claimtype een element bevat. Bekijk de Livedemo van de claimtransformatie.

Element TransformationClaimType Gegevenstype Notities
InputClaim inputClaim StringCollection De claim die moet worden doorzocht.
InputParameter item tekenreeks De te zoeken waarde.
InputParameter ignoreCase tekenreeks Hiermee geeft u op of deze vergelijking het gebruik van hoofdletters of kleine letters moet negeren voor de tekenreeksen die worden vergeleken.
OutputClaim outputClaim booleaans Het ClaimType dat wordt geproduceerd nadat deze ClaimsTransformation is aangeroepen. Een Booleaanse indicator als de verzameling een dergelijke tekenreeks bevat

Voorbeeld van StringCollectionContains

In het volgende voorbeeld wordt gecontroleerd of het roles claimtype stringCollection de waarde admin bevat.

<ClaimsTransformation Id="IsAdmin" TransformationMethod="StringCollectionContains">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="roles" TransformationClaimType="inputClaim"/>
  </InputClaims>
  <InputParameters>
    <InputParameter  Id="item" DataType="string" Value="Admin"/>
    <InputParameter  Id="ignoreCase" DataType="string" Value="true"/>
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="isAdmin" TransformationClaimType="outputClaim"/>
  </OutputClaims>
</ClaimsTransformation>
  • De invoerclaims:
    • inputClaim: ["reader", "author", "admin"]
  • De invoerparameters:
    • item: "Beheer"
    • ignoreCase: "true"
  • De uitvoerclaims:
    • outputClaim: "true"

StringCollectionContainsClaim

Controleert of een StringCollection-claimtype een claimwaarde bevat. Bekijk de Livedemo van de claimtransformatie.

Element TransformationClaimType Gegevenstype Notities
InputClaim verzameling StringCollection De claim die moet worden doorzocht.
InputClaim item tekenreeks Het claimtype dat de waarde bevat waarnaar moet worden gezocht.
InputParameter ignoreCase tekenreeks Hiermee geeft u op of deze vergelijking het gebruik van hoofdletters of kleine letters moet negeren voor de tekenreeksen die worden vergeleken.
OutputClaim outputClaim booleaans Het ClaimType dat wordt geproduceerd nadat deze ClaimsTransformation is aangeroepen. Een Booleaanse indicator als de verzameling een dergelijke tekenreeks bevat

Voorbeeld van StringCollectionContainsClaim

In het volgende voorbeeld wordt gecontroleerd of het roles claimtype stringCollection de waarde van het role claimtype bevat.

<ClaimsTransformation Id="HasRequiredRole" TransformationMethod="StringCollectionContainsClaim">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="roles" TransformationClaimType="collection" />
    <InputClaim ClaimTypeReferenceId="role" TransformationClaimType="item" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="ignoreCase" DataType="string" Value="true" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="hasAccess" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>
  • De invoerclaims:
    • verzameling: ["reader", "author", "admin"]
    • item: "Beheer"
  • De invoerparameters:
    • ignoreCase: "true"
  • De uitvoerclaims:
    • outputClaim: "true"

Volgende stappen