Transformace deklarací identity JSON

Důležité

Od 1. května 2025 už nebude Azure AD B2C k dispozici k nákupu pro nové zákazníky. Další informace najdete v našich nejčastějších dotazech.

Tento článek obsahuje příklady použití transformací deklarací identity schématu Identity Experience Framework v Azure Active Directory B2C (Azure AD B2C). Další informace najdete v tématu Transformace deklarací identity.

Pole CreateJson

Vytvořte jednoúčelové pole JSON z hodnoty deklarace identity. Podívejte se na živou ukázku této transformace deklarací identity.

Element (Prvek) TransformaceClaimType Datový typ Poznámky
Vstupní deklarace Požadavek vstupu řetězec Deklarace identity, která se má přidat do výstupní deklarace identity.
Výstupní deklarace Deklarace výstupu řetězec Řetězec JSON vytvořený po vyvolání této transformace deklarací identity.

Příklad CreateJsonArray

Následující příklad vytvoří jedno pole JSON.

<ClaimsTransformation Id="CreateJsonPayload" TransformationMethod="CreateJsonArray">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="email" TransformationClaimType="inputClaim" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="result" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>
  • Vstupní deklarace identity:
    • inputClaim: someone@example.com
  • Výstupní deklarace identity:
    • outputClaim: [""someone@contoso.com]

GenerateJson

K vygenerování řetězce JSON použijte hodnoty deklarací identity nebo konstanty. Řetězec cesty následující tečkou se používá k označení, kam se mají data vložit do řetězce JSON. Po rozdělení tečkami se všechna celá čísla interpretují jako index pole JSON a ne celá čísla se interpretují jako index objektu JSON.

Podívejte se na živou ukázku této transformace deklarací identity.

Element (Prvek) TransformaceClaimType Datový typ Poznámky
Vstupní deklarace Libovolný řetězec za tečkou řetězec JsonPath JSON, do kterého se hodnota deklarace identity vloží.
VstupníParametr Libovolný řetězec za tečkou řetězec JsonPath json json, do kterého se vloží hodnota konstantního řetězce.
Výstupní deklarace Deklarace výstupu řetězec Vygenerovaný řetězec JSON.

Pole JSON

Pokud chcete přidat objekty JSON do pole JSON, použijte formát názvu pole a index v poli. Pole je založené na nule. Začněte od nuly na N bez vynechání libovolného čísla. Položky v poli mohou obsahovat libovolný objekt. První položka například obsahuje dva objekty, aplikaci a appId. Druhá položka obsahuje jeden objekt, program. Třetí položka obsahuje čtyři objekty, barvu, jazyk, logo a pozadí.

Následující příklad ukazuje, jak nakonfigurovat pole JSON. Pole e-mailů používá InputClaims dynamické hodnoty. Pole hodnot používá InputParameters se statickými hodnotami.

<ClaimsTransformation Id="GenerateJsonPayload" TransformationMethod="GenerateJson">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="mailToName1" TransformationClaimType="emails.0.name" />
    <InputClaim ClaimTypeReferenceId="mailToAddress1" TransformationClaimType="emails.0.address" />
    <InputClaim ClaimTypeReferenceId="mailToName2" TransformationClaimType="emails.1.name" />
    <InputClaim ClaimTypeReferenceId="mailToAddress2" TransformationClaimType="emails.1.address" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="values.0.app" DataType="string" Value="Mobile app" />
    <InputParameter Id="values.0.appId" DataType="string" Value="123" />
    <InputParameter Id="values.1.program" DataType="string" Value="Holidays" />
    <InputParameter Id="values.2.color" DataType="string" Value="Yellow" />
    <InputParameter Id="values.2.language" DataType="string" Value="Spanish" />
    <InputParameter Id="values.2.logo" DataType="string" Value="contoso.png" />
    <InputParameter Id="values.2.background" DataType="string" Value="White" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="result" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>

Výsledek této transformace deklarací identity:

{
  "values": [
    {
      "app": "Mobile app",
      "appId": "123"
    },
    {
      "program": "Holidays"
    },
    {
      "color": "Yellow",
      "language": "Spanish",
      "logo": "contoso.png",
      "background": "White"
    }
  ],
  "emails": [
    {
      "name": "Joni",
      "address": "joni@contoso.com"
    },
    {
      "name": "Emily",
      "address": "emily@contoso.com"
    }
  ]
}

Chcete-li zadat pole JSON v vstupních deklarací identity i vstupních parametrech, je nutné spustit pole v elementu InputClaims nula na N. Potom v elementu InputParameters pokračujte indexem z posledního indexu.

Následující příklad ukazuje pole, které je definováno ve vstupních deklarací identity i vstupních parametrech. První položka pole hodnotvalues.0deklarací identity. Vstupní parametry pokračují z indexu jeden values.1 až dva indexy values.2.

<ClaimsTransformation Id="GenerateJsonPayload" TransformationMethod="GenerateJson">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="app" TransformationClaimType="values.0.app" />
    <InputClaim ClaimTypeReferenceId="appId" TransformationClaimType="values.0.appId"  />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="values.1.program" DataType="string" Value="Holidays" />
    <InputParameter Id="values.2.color" DataType="string" Value="Yellow" />
    <InputParameter Id="values.2.language" DataType="string" Value="Spanish" />
    <InputParameter Id="values.2.logo" DataType="string" Value="contoso.png" />
    <InputParameter Id="values.2.background" DataType="string" Value="White" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="result" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>

Příklad GenerateJson

Následující příklad vygeneruje řetězec JSON na základě hodnoty deklarace identity "email" a "OTP" a konstantních řetězců.

<ClaimsTransformation Id="GenerateRequestBody" TransformationMethod="GenerateJson">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="email" TransformationClaimType="personalizations.0.to.0.email" />
    <InputClaim ClaimTypeReferenceId="otp" TransformationClaimType="personalizations.0.dynamic_template_data.otp" />
    <InputClaim ClaimTypeReferenceId="copiedEmail" TransformationClaimType="personalizations.0.dynamic_template_data.verify-email" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="template_id" DataType="string" Value="d-4c56ffb40fa648b1aa6822283df94f60"/>
    <InputParameter Id="from.email" DataType="string" Value="service@contoso.com"/>
    <InputParameter Id="personalizations.0.subject" DataType="string" Value="Contoso account email verification code"/>
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="requestBody" TransformationClaimType="outputClaim"/>
  </OutputClaims>
</ClaimsTransformation>

Následující transformace deklarací identity vypíše deklaraci řetězce JSON, která bude textem požadavku odeslaného službě SendGrid (poskytovatel e-mailu třetí strany). Struktura objektu JSON je definována ID v tečkované notaci InputParameters a TransformationClaimTypes InputClaimTypes InputClaims. Čísla v zápisu tečky znamenají pole. Hodnoty pocházejí z hodnot InputClaims' a InputParameters' "Value" vlastnosti.

  • Vstupní deklarace identity:
    • e-mail, typ deklarace identity transformace personalizations.0.to.0.email: "someone@example.com"
    • copiedEmail, typ deklarace identity transformace personalizations.0.dynamic_template_data.verify-email: "someone@example.com"
    • typ deklarace identity transformace personalizations.0.dynamic_template_data.otp "346349"
  • Vstupní parametr:
    • template_id: "d-4c56ffb40fa648b1aa6822283df94f60"
    • from.email: "service@contoso.com"
    • personalizations.0.subject "Kód pro ověření e-mailu účtu Contoso"
  • Výstupní deklarace identity:

    • outputClaim:

      {
  "personalizations": [
    {
      "to": [
        {
          "email": "someone@example.com"
        }
      ],
      "dynamic_template_data": {
        "otp": "346349",
        "verify-email" : "someone@example.com"
      },
      "subject": "Contoso account email verification code"
    }
  ],
  "template_id": "d-989077fbba9746e89f3f6411f596fb96",
  "from": {
    "email": "service@contoso.com"
  }
}

Další příklad GenerateJson

Následující příklad vygeneruje řetězec JSON na základě hodnot deklarací identity a konstantních řetězců.

<ClaimsTransformation Id="GenerateRequestBody" TransformationMethod="GenerateJson">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="email" TransformationClaimType="customerEntity.email" />
    <InputClaim ClaimTypeReferenceId="objectId" TransformationClaimType="customerEntity.userObjectId" />
    <InputClaim ClaimTypeReferenceId="givenName" TransformationClaimType="customerEntity.firstName" />
    <InputClaim ClaimTypeReferenceId="surname" TransformationClaimType="customerEntity.lastName" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="customerEntity.role.name" DataType="string" Value="Administrator"/>
    <InputParameter Id="customerEntity.role.id" DataType="long" Value="1"/>
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="requestBody" TransformationClaimType="outputClaim"/>
  </OutputClaims>
</ClaimsTransformation>

Následující transformace deklarací identity vypíše deklaraci řetězce JSON, která bude textem požadavku odeslaného do rozhraní REST API. Struktura objektu JSON je definována ID v tečkované notaci InputParameters a TransformationClaimTypes InputClaimTypes InputClaims. Hodnoty pocházejí z hodnot InputClaims' a InputParameters' "Value" vlastnosti.

  • Vstupní deklarace identity:
    • e-mail, typ deklarace identity transformace customerEntity.email: "john.s@contoso.com"
    • objectId, transformation claim type customerEntity.userObjectId "aaaaaaaaa-0000-1111-2222-bbbbbbbb"
    • givenName, typ deklarace transformace customerEntity.firstName "John"
    • příjmení, transformace typu deklarace identity customerEntity.lastName "Smith"
  • Vstupní parametr:
    • customerEntity.role.name: Správce
    • customerEntity.role.id 1
  • Výstupní deklarace identity:

    • Tělo požadavku:

      {
   "customerEntity":{
      "email":"john.s@contoso.com",
      "userObjectId":"aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "firstName":"John",
      "lastName":"Smith",
      "role":{
         "name":"Administrator",
         "id": 1
      }
   }
}

Transformace deklarací identity GenerateJson přijímá prosté řetězce. Pokud vstupní deklarace identity obsahuje řetězec JSON, bude tento řetězec uchvácený. Pokud v následujícím příkladu použijete výstup e-mailu z CreateJsonArray výše, to je ["someone@contoso.com"], jako vstupní parametr, e-mail bude vypadat jako v následujícím deklarací identity JSON:

  • Výstupní deklarace identity:

    • Tělo požadavku:

      {
   "customerEntity":{
      "email":"[\"someone@contoso.com\"]",
      "userObjectId":"aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "firstName":"John",
      "lastName":"Smith",
      "role":{
         "name":"Administrator",
         "id": 1
      }
   }
}

GetClaimFromJson

Získání zadaného elementu z dat JSON Podívejte se na živou ukázku této transformace deklarací identity.

Element (Prvek) TransformaceClaimType Datový typ Poznámky
Vstupní deklarace inputJson řetězec Deklarace identity používané transformací deklarací identity k získání položky.
VstupníParametr claimToExtract řetězec název elementu JSON, který se má extrahovat.
Výstupní deklarace extrahovaná deklarace řetězec Deklarace identity, která se vytvoří po vyvolání této transformace deklarací identity, hodnota elementu zadaná ve vstupním parametru claimToExtract .

Příklad GetClaimFromJson

V následujícím příkladu transformace deklarací identity extrahovali emailAddress element z dat JSON: {"emailAddress": "someone@example.com", "displayName": "Someone"}

<ClaimsTransformation Id="GetEmailClaimFromJson" TransformationMethod="GetClaimFromJson">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="customUserData" TransformationClaimType="inputJson" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="claimToExtract" DataType="string" Value="emailAddress" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="extractedEmail" TransformationClaimType="extractedClaim" />
  </OutputClaims>
</ClaimsTransformation>
  • Vstupní deklarace identity:
    • inputJson: {"emailAddress": "someone@example.com", "displayName": "Někdo"}
  • Vstupní parametr:
    • claimToExtract: e-mailová adresa
  • Výstupní deklarace identity:
    • extrahované tvrzení:someone@example.com

Další příklad GetClaimFromJson

Transformace deklarací identity GetClaimFromJson získá jeden prvek z dat JSON. V předchozím příkladu je to emailAddress. Pokud chcete získat displayName, vytvořte další transformaci deklarací identity. Příklad:

<ClaimsTransformation Id="GetDisplayNameClaimFromJson" TransformationMethod="GetClaimFromJson">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="customUserData" TransformationClaimType="inputJson" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="claimToExtract" DataType="string" Value="displayName" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="displayName" TransformationClaimType="extractedClaim" />
  </OutputClaims>
</ClaimsTransformation>
  • Vstupní deklarace identity:
    • inputJson: {"emailAddress": "someone@example.com", "displayName": "Někdo"}
  • Vstupní parametr:
    • claimToExtract: displayName
  • Výstupní deklarace identity:
    • extractedClaim: Někdo

GetClaimsFromJsonArray

Získá seznam zadaných prvků z dat JSON. Podívejte se na živou ukázku této transformace deklarací identity.

Element (Prvek) TransformaceClaimType Datový typ Poznámky
Vstupní deklarace jsonSourceClaim řetězec Deklarace identity s datovou částí JSON. Tuto deklaraci identity používá transformace deklarací identity k získání deklarací identity.
VstupníParametr errorOnMissingClaims Boolean Určuje, jestli se má vyvolat chyba, pokud některá z deklarací identity chybí.
VstupníParametr includeEmptyClaims řetězec Určete, jestli se mají zahrnout prázdné deklarace identity.
VstupníParametr jsonSourceNázevKlíče řetězec Název klíče elementu
VstupníParametr jsonSourceValueName řetězec Název hodnoty elementu
Výstupní deklarace Kolekce string, int, boolean a datetime Seznam deklarací identity k extrakci Název deklarace identity by měl být roven názvu zadanému ve vstupní deklaraci jsonSourceClaim .

Příklad GetClaimsFromJsonArray

V následujícím příkladu transformace deklarací identity extrahuje následující deklarace identity: e-mail (řetězec), displayName (string), membershipNum (int), active (boolean) a birthDate (datetime) z dat JSON.

<ClaimsTransformation Id="GetClaimsFromJson" TransformationMethod="GetClaimsFromJsonArray">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="jsonSourceClaim" TransformationClaimType="jsonSource" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="errorOnMissingClaims" DataType="boolean" Value="false" />
    <InputParameter Id="includeEmptyClaims" DataType="boolean" Value="false" />
    <InputParameter Id="jsonSourceKeyName" DataType="string" Value="key" />
    <InputParameter Id="jsonSourceValueName" DataType="string" Value="value" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="email" />
    <OutputClaim ClaimTypeReferenceId="displayName" />
    <OutputClaim ClaimTypeReferenceId="membershipID" />
    <OutputClaim ClaimTypeReferenceId="active" />
    <OutputClaim ClaimTypeReferenceId="birthDate" />
  </OutputClaims>
</ClaimsTransformation>

  • Vstupní deklarace identity:

    • jsonSourceClaim:

      [
  {
    "key": "email",
    "value": "someone@example.com"
  },
  {
    "key": "displayName",
    "value": "Someone"
  },
  {
    "key": "membershipID",
    "value": 6353399
  },
  {
    "key": "active",
    "value": true
  },
  {
    "key": "birthDate",
    "value": "2005-09-23T00:00:00Z"
  }
]

  • Vstupní parametry:

    • errorOnMissingClaims: false
    • includeEmptyClaims: false
    • jsonSourceKeyName: klíč
    • jsonSourceValueName: hodnota

  • Výstupní deklarace identity:

    • e-mail: "someone@example.com"
    • displayName: "Někdo"
    • ID členství: 6353399
    • aktivní: pravda
    • datum narození: 2005-09-23T00:00:00Z

GetClaimsFromJsonArrayV2

Získá seznam zadaných prvků z elementů JSON kolekce řetězců. Podívejte se na živou ukázku této transformace deklarací identity.

Element (Prvek) TransformaceClaimType Datový typ Poznámky
Vstupní deklarace jsonSourceClaim Kolekce řetězců Deklarace identity kolekce řetězců s datovými částmi JSON. Tuto deklaraci identity používá transformace deklarací identity k získání deklarací identity.
VstupníParametr errorOnMissingClaims Boolean Určuje, jestli se má vyvolat chyba, pokud některá z deklarací identity chybí.
VstupníParametr includeEmptyClaims řetězec Určete, jestli se mají zahrnout prázdné deklarace identity.
VstupníParametr jsonSourceNázevKlíče řetězec Název klíče elementu
VstupníParametr jsonSourceValueName řetězec Název hodnoty elementu
Výstupní deklarace Kolekce string, int, boolean a datetime Seznam deklarací identity k extrakci Název deklarace identity by měl být roven názvu zadanému ve vstupní deklaraci jsonSourceClaim .

Příklad GetClaimsFromJsonArrayV2

V následujícím příkladu transformace deklarací identity extrahuje následující deklarace identity: e-mail (řetězec), displayName (string), membershipNum (int), active (boolean) a birthDate (datetime) z dat JSON.

<ClaimsTransformation Id="GetClaimsFromJson" TransformationMethod="GetClaimsFromJsonArrayV2">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="jsonSourceClaim" TransformationClaimType="jsonSource" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="errorOnMissingClaims" DataType="boolean" Value="false" />
    <InputParameter Id="includeEmptyClaims" DataType="boolean" Value="false" />
    <InputParameter Id="jsonSourceKeyName" DataType="string" Value="key" />
    <InputParameter Id="jsonSourceValueName" DataType="string" Value="value" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="email" />
    <OutputClaim ClaimTypeReferenceId="displayName" />
    <OutputClaim ClaimTypeReferenceId="membershipID" />
    <OutputClaim ClaimTypeReferenceId="active" />
    <OutputClaim ClaimTypeReferenceId="birthDate" />
  </OutputClaims>
</ClaimsTransformation>

  • Vstupní deklarace identity:

    • jsonSourceClaim[0] (první prvek kolekce řetězců):

        {
    "key": "email",
    "value": "someone@example.com"
  }

    • jsonSourceClaim[1] (druhý prvek kolekce řetězců):

        {
    "key": "displayName",
    "value": "Someone"
  }

    • jsonSourceClaim[2] (třetí prvek kolekce řetězců):

        {
    "key": "membershipID",
    "value": 6353399
  }

    • jsonSourceClaim[3] (čtvrtý element kolekce řetězců):

        {
    "key": "active",
    "value": true
  }

    • jsonSourceClaim[4] (pátý prvek kolekce řetězců):

        {
    "key": "birthDate",
    "value": "2005-09-23T00:00:00Z"
  }

  • Vstupní parametry:

    • errorOnMissingClaims: false
    • includeEmptyClaims: false
    • jsonSourceKeyName: klíč
    • jsonSourceValueName: hodnota

  • Výstupní deklarace identity:

    • e-mail: "someone@example.com"
    • displayName: "Někdo"
    • ID členství: 6353399
    • aktivní: pravda
    • datum narození: 2005-09-23T00:00:00Z

GetNumericClaimFromJson

Získá zadaný číselný (dlouhý) prvek z dat JSON. Podívejte se na živou ukázku této transformace deklarací identity.

Element (Prvek) TransformaceClaimType Datový typ Poznámky
Vstupní deklarace inputJson řetězec Deklarace identity s datovou částí JSON. Tuto deklaraci identity používá transformace deklarací identity k získání číselné deklarace identity.
VstupníParametr claimToExtract řetězec Název elementu JSON, který se má extrahovat.
Výstupní deklarace extrahovaná deklarace dlouhý Deklarace identity, která se vytvoří po vyvolání této transformace deklarací identity, hodnota elementu zadaná ve vstupních parametrech claimToExtract .

Příklad GetNumericClaimFromJson

V následujícím příkladu transformace deklarací identity extrahuje id element z dat JSON.

<ClaimsTransformation Id="GetIdFromResponse" TransformationMethod="GetNumericClaimFromJson">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="exampleInputClaim" TransformationClaimType="inputJson" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="claimToExtract" DataType="string" Value="id" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="membershipId" TransformationClaimType="extractedClaim" />
  </OutputClaims>
</ClaimsTransformation>

  • Vstupní deklarace identity:

    • inputJson:

      {
  "emailAddress": "someone@example.com",
  "displayName": "Someone",
  "id": 6353399
}

  • Vstupní parametry

    • claimToExtract: ID

  • Výstupní deklarace identity:

    • extrahovaný nárok: 6353399

GetSingleItemFromJson

Získá první prvek z dat JSON. Podívejte se na živou ukázku této transformace deklarací identity.

Element (Prvek) TransformaceClaimType Datový typ Poznámky
Vstupní deklarace inputJson řetězec Deklarace identity s datovou částí JSON. Tuto deklaraci identity používá transformace deklarací identity k získání položky z dat JSON.
Výstupní deklarace klíč řetězec První klíč elementu ve formátu JSON.
Výstupní deklarace hodnota řetězec První hodnota elementu ve formátu JSON.

Příklad GetSingleItemFromJson

V následujícím příkladu transformace deklarací identity extrahuje první prvek (zadaný název) z dat JSON.

<ClaimsTransformation Id="GetGivenNameFromResponse" TransformationMethod="GetSingleItemFromJson">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="json" TransformationClaimType="inputJson" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="givenNameKey" TransformationClaimType="key" />
    <OutputClaim ClaimTypeReferenceId="givenName" TransformationClaimType="value" />
  </OutputClaims>
</ClaimsTransformation>

  • Vstupní deklarace identity:

    • inputJson:

      {
  "givenName": "Emily",
  "lastName": "Smith"
}

  • Výstupní deklarace identity:

    • klíč: givenName
    • hodnota: Emily

GetSingleValueFromJsonArray

Získá první prvek z datového pole JSON. Podívejte se na živou ukázku této transformace deklarací identity.

Element (Prvek) TransformaceClaimType Datový typ Poznámky
Vstupní deklarace inputJsonClaim řetězec Deklarace identity s datovou částí JSON. Tuto deklaraci identity používá transformace deklarací identity k získání hodnoty z pole JSON.
Výstupní deklarace extrahovaná deklarace řetězec Deklarace identity, která se vytvoří po vyvolání této transformace deklarací identity, prvním prvkem v poli JSON.

Příklad GetSingleValueFromJsonArray

V následujícím příkladu transformace deklarací identity extrahuje první prvek (e-mailovou adresu) z pole ["someone@example.com", "Someone", 6353399]JSON .

<ClaimsTransformation Id="GetEmailFromJson" TransformationMethod="GetSingleValueFromJsonArray">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="userData" TransformationClaimType="inputJsonClaim" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="email" TransformationClaimType="extractedClaim" />
  </OutputClaims>
</ClaimsTransformation>
  • Vstupní deklarace identity:
    • inputJsonClaim: [""someone@example.com, "Someone", 6353399]
  • Výstupní deklarace identity:
    • extrahované tvrzení:someone@example.com

XmlStringToJsonString

Převeďte data XML do formátu JSON. Podívejte se na živou ukázku této transformace deklarací identity.

Element (Prvek) TransformaceClaimType Datový typ Poznámky
Vstupní deklarace Soubor XML řetězec Deklarace identity s datovou částí XML. Tuto deklaraci identity používá transformace deklarací identity k převodu dat z XML do formátu JSON.
Výstupní deklarace JSON řetězec Deklarace identity, která se vytvoří po vyvolání této transformace deklarací identity, data ve formátu JSON. 
<ClaimsTransformation Id="ConvertXmlToJson" TransformationMethod="XmlStringToJsonString">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="inputXML" TransformationClaimType="xml" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="outputJson" TransformationClaimType="json" />
  </OutputClaims>
</ClaimsTransformation>

Příklad XmlStringToJsonString

V následujícím příkladu transformace deklarací identity převede následující data XML do formátu JSON.

Vstupní deklarace identity:

<user>
  <name>Someone</name>
  <email>someone@example.com</email>
</user>

Výstupní deklarace identity:

{
  "user": {
    "name":"Someone",
    "email":"someone@example.com"
  }
}

Další kroky

  • Další ukázky transformace deklarací identity najdete v úložišti GitHub komunity Azure AD B2C.
  • Last updated on