Aracılığıyla paylaş


Öğe yaşam döngüsü

Doku kullanıcı arabiriminde öğe oluşturma için önerilen akış şu şekildedir:

  1. Kullanıcıdan öğe adını iste.
  2. "Boş" bir öğe oluşturun.
  3. Yeni öğeyi düzenleyin ve kaydedin.

Microsoft Fabric'te öğe yaşam döngüsü yönetiminin ilk bölümünün şematik gösterimi.

Bu işlem aşağıdaki aşamalara ayrılabilir:

  1. Boş öğe oluşturma
  2. Öğeyi yükleme
  3. Öğeyi düzenleme

Microsoft Fabric'te öğe yaşam döngüsü yönetiminin ikinci bölümünün şematik gösterimi.

Kullanıcı herhangi bir türde öğe oluşturmak için bir düğme seçtiğinde, Doku FE (Portal) kodunun ilgili öğe düzenleyicisini yüklemesi gerekir. Fabric FE, kaynak URL, Microsoft Entra Id uygulama ayrıntıları ve iş yükü BE URL'si dahil olmak üzere gerekli bilgileri getirmek için Doku BE'ye bir API çağrısı yapar ve bunların tümü geçerli bağlama karşılık gelen iş yükü BE URL'sidir. Bu bilgiler kullanılabilir olduğunda bir öğe oluşturulur. Öğe genellikle HTML, JavaScript, CSS ve CDN'den görüntüler gibi statik kaynaklarını yükler. Çok bölgeli CDN dağıtımı kullanmanızı ve kaynak URL'nin tarayıcının geçerli konumuna fiziksel olarak en yakın CDN sunucusuna çözümlenmesi için ad çözümlemesini yapılandırmanızı öneririz.

Not

Genellikle öğe düzenleyicisinin büyük olasılıkla düzenleme aşamasında iş yükü BE'ye çağrı yapması gerekir. Bunun için iş yükü BE URL'sinin geçerli bağlama göre çözülmesi gerekir. Şu anda kod sabit kodlanmış bir BE URL'si kullanabilir.

Boş öğe oluşturma

Doku'da, öğe adı dışında kullanıcı girişi olmayan bir öğe oluşturmaya izin vermek yaygın bir uygulamadır. Bu tür öğelerin anlamlı (dolayısıyla "boş") bir şey yapması beklenmez, ancak çalışma alanında görünürler ve temel akışlara ve işlemlere katılabilirler. Ayrıca, bazı durumlarda iş yükü tarafından ayarlanan makul varsayılan değerlere göre işlevsel bile olabilirler.

Bu akış, kullanıcıdan yeni öğe için bir ad belirtmesini istemeyle başlar. Ada sahip olan iframe, öğe oluşturma akışını başlatmak için konak JS API'sine bir çağrı yapar ve isteğe bağlı JSON nesnesini "oluşturma yükü" olarak geçirir ve konak Doku BE'ye bir çağrı yapar. Kimlik doğrulaması konak tarafından işlenir. Fabric BE, iş yükü BE URL'sini bağlama göre çözümler ve iframe tarafından gönderilen "oluşturma yükünü" geçirerek iş yükü API'sini çağırır CreateItem . BE iş yükünün yeni öğe meta verilerini depolaması, büyük olasılıkla bazı kaynaklar ayırması (bu adım daha sonraki bir noktaya ertelenebilir) ve diğer ilgili işleri yapması beklenir. İş yükü BE perspektifinden öğe oluşturma işlemi tamamlandığında, öğe meta veri değişikliğinde Doku BE'ye bildirmesi gerekir. Öğe meta verilerinin herhangi bir güncelleştirmesinde aynı işlemin gerçekleşmesi gerekir ve bu nedenle konu belirtecinin Doku BE hedef kitlesi için değiştirilmesi gerekir.

Not

Öğe meta veri güncelleştirmesini bildirme API'si şu anda kullanılamıyor.

Öğeyi yükleme

Bir öğeyi düzenlemek için iframe'in meta verilerini yüklemesi gerekir. Bu işlem, "boş" ve "başlatılan" öğeleri yüklemek için aynıdır. iframe konak JS API'sine çağrı yapar ve bu çağrının ardından GetItemPayload iş yükü API'sini çağıran Doku BE'yi çağırır. BE iş yükü, daha sonra iframe'e geri geçirilen bir JSON nesnesi döndürebilir. Kimlik doğrulaması konak tarafından işlenir.

Öğeyi düzenleme

Öğe meta verileri yüklendikten sonra düzenleme oturumu başlatılabilir. Bu oturumun başında veya sırasında iframe'in iş yükü BE'sine çağrı yapması gerekebilir (örneğin bir yapılandırma getirmek, kullanıcı arabirimi denetimlerini doldurmak, doğrulamalar gerçekleştirmek ve daha fazlası için). Bu amaçla, konak JS API'sinden bir belirteç istemesi gerekir.