Alt yolculuklar

Alt yolculuklar, kullanıcı yolculuğundaki düzenleme adımlarının akışını düzenlemek ve basitleştirmek için kullanılabilir. Kullanıcı yolculukları, bağlı olan taraf uygulamasının kullanıcı için istenen talepleri elde etmesine izin veren bir ilkenin kullandığı belirgin yolları belirtir. Kullanıcı, bağlı olan tarafa sunulacak talepleri almak için bu yolları izler. Başka bir deyişle kullanıcı yolculukları, Azure AD B2C Kimlik Deneyimi Çerçevesi isteği işlerken son kullanıcının yaşadığı iş mantığını tanımlar. Kullanıcı yolculuğu, başarılı bir işlem için izlenmesi gereken bir düzenleme dizisi olarak temsil edilir. Düzenleme adımının ClaimsExchange öğesi, yürütülen tek bir teknik profile bağlıdır.

Alt yolculuk, kullanıcı yolculuğunun herhangi bir noktasında çağrılabilen düzenleme adımları grubudur. Yeniden kullanılabilir adım dizileri oluşturmak veya iş mantığını daha iyi göstermek için dallanma uygulamak için alt yolculukları kullanabilirsiniz.

Kullanıcı yolculuğu dallanma

Her ikisi de başarılı bir işlem için izlenmesi gereken bir düzenleme dizisi olarak gösterildiğinden, alt yolculuklar kullanıcı yolculukları gibi davranır. Kullanıcı yolculukları kendi başına çağrılabilir ve yürütülmesi için bir SendClaims adımı gerekir. Alt yolculuklar, kullanıcı yolculuklarının bileşenleridir ve bağımsız olarak çağrılamaz ve her zaman bir kullanıcı yolculuğundan çağrılır.

Dallanmanın temel bileşeni, kullanıcı yolculuğunda daha iyi iş mantığı işlemeye olanak sağlamaktır. Yaygın düzenleme adımları ayrı ayrı çağrılacak tek tek parçalar halinde gruplandırılır. Alt yolculuk, birden çok düzenleme adımının bir araya getirildiği (aynı önkoşullara sahip) bir yolculuğu basitleştirebilir. Alt yolculuk yalnızca bir kullanıcı yolculuğundan çağrılır; başka bir alt yolculuk olarak adlandırılamaz.

İki tür alt yolculuk vardır:

  • Call - Denetimi çağırana döndürür. Alt yolculuk yürütülür ve denetim şu anda kullanıcı yolculuğu içinde yürütülen düzenleme adımına döndürülür.
  • Transfer - Denetimi alt yolculuğuna aktarır (geri alınamaz dallanma). Talepleri bağlı olan taraf uygulamasına geri döndürmek için alt yolculuğun SendClaims adımı olmalıdır.

Örnek senaryolar

Arama alt yolculuğu

Arama alt yolculuğu aşağıdaki senaryolarda yararlıdır:

  • Yaş Gating: Yaş gating için, kullanıcı yolculukları arasında birçok paylaşılan bileşen vardır. Dallanma, ortak öğelerin paylaşılabilir bileşenler halinde derlenmesine olanak tanır.
  • Ebeveyn Onayı: Dallanma, reşit olmayanın yürüttüğü kullanıcı yolculuğundan taleplere erişmemize ve kullanıcıyı bulduktan sonra ebeveyn izni kullanıcı yolculuğuna dallanmamıza izin vererek ebeveyn onayı tasarımında kolaylık sağlar.
  • Oturum açmak için kaydolun: Bir kullanıcının dizinde zaten var olduğu ancak aslında bir hesap oluşturduğunu unutmuş olabileceği bir senaryoyu düşünün. Böyle bir durumda, kullanıcıya girdiği kimlik bilgilerinin zaten var olduğunu söylemek ve kullanıcıyı ilkenin bir kayıt akışından bu kullanıcı için oturum açma akışına geçiş yapabilmesi yolculuğunu yeniden başlatmaya zorlamak yerine tercih edilebilir.

Alt yolculuğu aktarma

Aktarım alt yolculuğu aşağıdaki senaryolarda yararlıdır:

  • Blok sayfası gösteriliyor.
  • Bir belirteci yürütmek ve vermek için isteği bir alt yolculuğa yönlendirerek A/B testi.

SubJourneys öğesi ekleme

Aşağıda, denetimi kullanıcı yolculuğuna döndüren türünde Callbir SubJourney öğe örneği verilmiştir.

<SubJourneys>
  <SubJourney Id="ConditionalAccess_Evaluation" Type="Call">
    <OrchestrationSteps>
      <OrchestrationStep Order="1" Type="ClaimsExchange">
       <ClaimsExchanges>
        <ClaimsExchange Id="ConditionalAccessEvaluation" TechnicalProfileReferenceId="ConditionalAccessEvaluation" />
       </ClaimsExchanges>
      </OrchestrationStep>
      <OrchestrationStep Order="2" Type="ClaimsExchange">
        <Preconditions>
          <Precondition Type="ClaimsExist" ExecuteActionsIf="false">
            <Value>conditionalAccessClaimCollection</Value>
            <Action>SkipThisOrchestrationStep</Action>
          </Precondition>
        </Preconditions>
        <ClaimsExchanges>
          <ClaimsExchange Id="GenerateCAClaimFlags" TechnicalProfileReferenceId="GenerateCAClaimFlags" />
        </ClaimsExchanges>
      </OrchestrationStep>
    </OrchestrationSteps>
  </SubJourney>
</SubJourneys>

Aşağıda, bağlı olan taraf uygulamasına bir belirteç döndüren türünde Transferbir SubJourney öğe örneği verilmiştir.

<SubJourneys>
  <SubJourney Id="B" Type="Transfer">
    <OrchestrationSteps>
      ...
      <OrchestrationStep Order="5" Type="SendClaims">
    </OrchestrationSteps>
  </SubJourney>
</SubJourneys>

Alt yolculuk adımlarını çağırma

Alt yolculuğu yürütmek için türünde InvokeSubJourney yeni bir düzenleme adımı kullanılır. Aşağıda, bu düzenleme adımının tüm yürütme öğelerini gösteren bir örnek verilmiştir.

<OrchestrationStep Order="5" Type="InvokeSubJourney">
  <JourneyList>
    <Candidate SubJourneyReferenceId="ConditionalAccess_Evaluation" />
  </JourneyList>
</OrchestrationStep>

Bileşenler

İlke tarafından desteklenen alt yolculukları tanımlamak için, ilke dosyasının üst düzey öğesinin altına bir SubJourneys öğesi ekleyin.

SubJourneys öğesi aşağıdaki öğeyi içerir:

Öğe Oluşum Description
SubJourney 1:n Tam bir kullanıcı akışı için gerekli olan tüm yapıları tanımlayan bir alt yolculuk.

SubJourneys öğesi aşağıdaki öznitelikleri içerir:

Öznitelik Gerekli Açıklama
Id Yes Kullanıcı yolculuğunun ilkedeki alt yolculuğuna başvurması için kullanabileceği alt yolculuk tanımlayıcısı. Candidate öğesinin SubJourneyReferenceId öğesi bu özniteliğe işaret etmektedir.
Tür Yes Olası değerler: Call, veya Transfer. Daha fazla bilgi için bkz . Kullanıcı yolculuğu dallanma

SubJourney öğesi aşağıdaki öğeyi içerir:

Öğe Oluşum Description
OrchestrationSteps 1:n Başarılı bir işlem için izlenmesi gereken bir düzenleme dizisi. Her kullanıcı yolculuğu, sırayla yürütülen düzenleme adımlarının sıralı bir listesinden oluşur. Herhangi bir adım başarısız olursa işlem başarısız olur.

OrchestrationSteps

Düzenleme adımı öğelerinin tam listesi için bkz. UserJourneys.

Sonraki adımlar

UserJourneys hakkında bilgi edinin