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 neler yaşadığına ilişkin 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 için alt yolculukları kullanabilir veya iş mantığını daha iyi göstermek için dallanma uygulayabilirsiniz.
Kullanıcı yolculuğu dallanma
Her ikisi de başarılı bir işlem için izlenmesi gereken bir düzenleme dizisi olarak temsil edilen 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 geldiği (aynı önkoşullara sahip) bir yolculuğu basitleştirebilir. Alt yolculuk yalnızca 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.
- Aktarım - Denetimi alt yolculuğa (geri alınamaz dallanma) aktarır. Talepleri bağlı olan taraf uygulamasına geri döndürmek için alt yolculuğun SendClaims adımı olmalıdır.
Örnek senaryolar
Çağrı 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 izin vererek ebeveyn onayı tasarımında kolaylık sağlar ve kullanıcıyı bulduktan sonra ebeveyn onayı kullanıcı yolculuğuna dallanarak onay gerektirir.
- Oturum açmak için kaydolun: Bir kullanıcının dizinde zaten var olduğu ancak aslında bir hesap oluşturmuş olabileceğini 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 ilkenin bir kaydolma 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 belirteç 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 Call
bir 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 Transfer
bir 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 | Açıklama |
---|---|---|
AltJourney | 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 | İlkedeki alt yolculuğa başvurmak için kullanıcı yolculuğu tarafından kullanılabilecek alt yolculuk tanımlayıcısı. Candidate öğesinin SubJourneyReferenceId öğesi bu özniteliği gösterir. |
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 | Açıklama |
---|---|---|
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