AEM Sites için Adobe Learning Manager referans site (ALM referans site) paketi

Adobe Learning Manager (ALM), Adobe Experience Manager (AEM) siteleri ile entegredir. Bu da Adobe Learning Manager için kendi web sitenizi ve duyarlı mobil arayüzlerinizi kodlamaya çok az vakit ayırarak oluşturmanıza olanak tanır. Bu entegrasyon sayesinde, kullanıcılarınız için özelleştirilmiş eğitim deneyimleri oluşturabilirsiniz.

Böyle bir deneyim oluşturmak için ALM, AEM Sites için AEM Sites örneğinize yükleyebileceğiniz ZIP dosyası şeklinde Adobe Learning Manager referans site paketi (ALM referans site paketi) sağlar.

Paket, AEM Sites web sayfası şablonları ve web sitesi bileşenleriyle birlikte gömülü bileşenleri (örneğin Eğitim kataloğu), gömülebilir bileşenleri, takvimi vb. içerir.

ALM referans sitesi paketini yükledikten sonra, AEM Sites örneğinizde barındırabileceğiniz Adobe Learning Manager için bir web sitesi oluşturmaya başlayabilirsiniz. Daha sonra kullanıcılarınız, bileşenleri web sitenize sürükleyip bırakabilir.

ALM referans site paketini yükleme

Ön koşullar

  • Adobe Sites ve Adobe Commerce Lisansları.

  • AEM şirket içi 6.5 veya Adobe Experience Manager – Bulut Hizmeti

  • Adobe Commerce 2.4.3

AEM Sites ortamınızı güvenceye aldıktan sonra, ALM referans site paketini yüklemeniz gerekir. Bu paket, eğitim platformunu oluşturmanıza yardımcı olan AEM web sayfalarını ve web sitesi bileşenlerini içerir.

Referans site paketi GitHub havuzunda barındırılır.

Daha fazla bilgi için bkz. README.

Adobe Learning Manager'da uygulama oluşturma

AEM site paketini yükledikten sonra, eğitim portalınızı AEM sitesi ile bağlamak için bir ALM uygulaması yapılandırmanız gerekir.

Bu senaryo, AEM Adobe Learning Manager ile kullanıldığında geçerlidir.

Aşağıdaki adımları takip edin:

  1. Entegrasyon Yöneticisi olarak Uygulamalar'ı tıklayın.
  2. Yeni bir uygulama oluşturmak için sayfanın sağ üst köşesinde Kaydet'i tıklayın.
  3. Yeni bir uygulama kaydedin ekranında, aşağıdaki ayrıntıları girin:
    1. Uygulama Adı: Oluşturduğunuz uygulamanın adı.
    2. URL: Kuruluşunuzun URL'si.
    3. Yeniden Yönlendirme Etki Alanları: AEM web sitesinin barındırma etki alanları. Ayrıca joker karakterler de belirtebilirsiniz.
    4. Açıklama: Uygulamanın açıklaması.
    5. Kapsamlar: Öğrenci rolü okuma erişimi ve Öğrenci rolü yazma erişimini seçin.
    6. Yalnızca bu hesap için mi?: Uygulamayı mevcut ALM hesabı için kullanmak istiyorsanız Evet'i seçin.
  4. Değişiklikler yaptıktan sonra, Kaydet seçeneğini tıklayın.

Ekrandaki uygulama kimlik bilgilerini not edin.

Uygulama. kimlik bilgileri
Uygulama. kimlik bilgileri

Uygulamayı onaylamak için Kabul Et'i tıklayın.

Belirteçler alın

  1. Geliştirici Kaynakları sekmesinde, Test ve Geliştirme için Erişim Belirteçleri seçeneğini tıklayın. 

  2. Aşağıdaki bilgileri girin:

    1. OAuth Kodu Al: Önceki bölümdeki istemci kimliğini girin ve kapsamı değiştirin. Oauth kodu almak için Gönder'i tıklayın.
    2. Yeni Belirteç Al: Önceki bölümdeki istemci kimliğini ve gizli anahtarını girin. Ayrıca önceki adımda aldığınız OAuth kodunu da girin. Gönder
      'i tıklayın.
    3. Erişim Belirteci Al: Önceki bölümdeki istemci kimliğini ve gizli anahtarını girin. Ayrıca önceki adımda aldığınız Yeni belirteci de girin. Gönder
      'i tıklayın.
    4. Erişim Belirteci Ayrıntılarını Al: Önceki adımda aldığınız erişim belirtecini girin. Gönder
      'i tıklayın.
  3. Ayrıntıları aşağıdaki JSON yanıtından alabilirsiniz. Yanıt erişim belirteci, yenileme belirteci, kullanıcı rolü, hesap kimliği, kullanıcı kimliği ve sona erme süresinden oluşur. Yenileme belirtecini not edin, bunu daha sonra yeniden kullanacaksınız. 

ALM hesabını AEM'de yapılandırma

  1. AEM örneğinizi başlatın.

  2. Ayarlar > Bulut Hizmetleri seçeneğini tıklayın. 

  3. Adobe Learning Manager Yapılandırması'nı tıklayın.

  4. Oluştur > Yapılandırma Klasörü'nü tıklayın. Klasörünüze bir ad verin.

  5. Eğitim projesinde, oluşturduğunuz yapılandırmayı seçin.

  6. Yapılandırmanın ayrıntılarını girin. 

    1. Adobe Learning Manager modu: Hem oturum açmış hem de oturum açmamış öğrenciler için eğitim deneyiminin nasıl olmasını istediğinizi seçin.
    2. Adobe Learning Manager URL'si: Eğitim hizmetlerinin barındırıldığı ALM örneğinin URL'sini girin.
    3. Hesap Kimliği: ALM hesabının kimliği.
    4. İstemci Kimliği, İstemci Gizli Anahtarı ve Yazar Yenileme Belirteci: ALM'de uygulama oluştururken aldığınız kimlik bilgilerini girin. 
    5. Bileşen Özelleştirmesi: Daha fazla bilgi için bkz. AEM ile Entegrasyon.
  7. Yapılandırmayı kaydedip kapatın.

AEM + Adobe Learning Manager (oturum açmış/oturum açmamış kullanıcılar)

Adobe Learning Manager artık hesap oluşturma veya oturum açmayı zorunlu kılmadan mevcut ve potansiyel müşterileriniz ve iş ortaklarınız için ürün ile eğitiminizi sergilemenize olanak sağlar. Bu işlevsellik, öğrencilere ürün özelliklerini ön plana çıkartıp tanıtmanıza yardımcı olacak ürün eğitiminin hızlı ve kolay bir önizlemesini sağlayarak ürün ile eğitimlerin benimsenmesini teşvik eder. Böylece ürünlerinizi ve tekliflerinizi, özellikle potansiyel müşterilere ve iş ortaklarına etkin bir şekilde sergileyerek ürün farkındalığını artırabilirsiniz. Erişim kolaylığı ve daha iyi ulaşılabilirlik ilgiyi artırır. Bu da, eğitim kayıtlarını ve eğitimin benimsenmesini teşvik etmeye yardımcı olur. 

Bir öğrenci; bu iş akışını kullanarak bir eğitimi önizleyebilir, eğitim bilgilerine erişebilir veya Adobe Learning Manager'da oturum açmadan bir eğitimi arayabilir. Bu iş akışı, yerel Learning Manager arayüzü için geçerli değildir. (YALNIZCA AEM Sites ve diğer başlıksız arayüzler için geçerlidir.)

Eğitim platformu bağlayıcısını yapılandırma ve etkinleştirme

Bu bölümde, aşağıdaki bağlayıcıyı yapılandırmak ve etkinleştirmek için gerekli adımlar belirtilmektedir:

Eğitim Verileri Erişimi

Bu bağlayıcı, AEM Sites tabanlı veya başka bir özel olarak oluşturulmuş başlıksız kullanıcı arayüzünüzün eğitim bilgilerini alıp öğrenciler için işlemesini ve bir öğrenci oturum açmadan önce ya da sonra sorunsuz bir eğitim bilgisi araması gerçekleştirmesini sağlar. 

Bu bağlayıcı, yalnızca AEM Sites tabanlı veya başka bir başlıksız arayüz kullanıyorsanız gereklidir. 

Bağlayıcı eğitim meta verilerini bir veri depolama alanına ve alma çözümünün yanı sıra bir arama etkinleştirme sistemine aktarır. Dolayısıyla, eğitim verilerini almak, web sayfaları oluşturmak ve öğrencilere optimize edilmiş eğitim arama işlevi sağlamak için bu iki hizmeti kullanmak üzere AEM Sites tabanlı veya diğer özel olarak oluşturulmuş başlıksız kullanıcı arayüzünüzü yapılandırabilirsiniz. Örneğin, AEM Sites tabanlı arayüzde oturum açılmamış iş akışı öğrencinin eğitim bilgilerini gösteren eğitim sayfalarını aramasına, taramasına ve erişmesine yardımcı olmak için dışa aktarılan meta verileri kullanabilir. 

AEM Sites tabanlı web sayfalarınızı oluşturmak ve işlemek için bu bağlayıcıyı etkinleştirin ve hem oturum açmadan önce hem de oturum açtıktan sonra öğrencilerinize özelleştirilmiş deneyimler sağlayın. AEM Sites tabanlı web sayfalarınızı oluşturmak ve işlemek için bu bağlayıcıyı etkinleştirin ve hem oturum açmadan önce hem de oturum açtıktan sonra öğrencilerinize özelleştirilmiş deneyimler sağlayın.

  • Adobe Learning Manager cdn ana URL'si - Eğitim Verileri Erişimi bağlantı sayfasından veri alma CDN hizmeti yolunun ana URL'sini girin.
  • Yönetici yenileme belirteci - Önceki bölümde belirlediğiniz yenileme belirtecini girin. 
  • Eğitim Meta Verileri ana URL'si - Eğitim Verileri Erişimi bağlantı sayfasından arama etkinleştirme ve arama verileri alma hizmeti yolunun ana URL'sini girin.
  • Adobe Learning Manager Kayıt URL'si - Öğrencilerin eğitime kaydolmak üzere kullandıkları hesap için entegrasyon yöneticisi tarafından oluşturulan kendi kendine kayıt URL'sini girin.

AEM + Adobe Learning Manager + Adobe Commerce (oturum açmış/oturum açmamış kullanıcılar)

Adobe Learning Manager artık eğitim platformunu Adobe Commerce ile sorunsuz şekilde entegre etmenize yardımcı olacak çözümler sağlar. Bu sürüm; yerel, AEM Sites tabanlı veya diğer başlıksız Learning Manager arabirimlerinizi Adobe Commerce'e kolayca bağlamanıza olanak tanır. Bu entegrasyon, eğitim platformunuzun içindeki e-ticaret becerilerini kullanabilmenizi sağlar. Artık müşterilerinize ve iş ortaklarınıza ücretli eğitim sunabilir ve hem yerel hem de yerel olmayan Learning Manager arayüzlerinde eğitim satın alımlarını kolayca etkinleştirebilirsiniz. Ayrıca bir öğrenci, Adobe Learning Manager'da oturum açmadan bir eğitimi arayabilir, bir eğitimi önizleyebilir ve eğitim bilgilerine erişebilir.

Bir kullanıcı yeni bir AEM uygulaması oluşturmak yerine daha önceden hazırlanmış bir AEM uygulaması kullanıp onaylayabilir.

  • Adobe Learning Manager cdn ana URL'si - Adobe Commerce bağlantı sayfasından, veri alma CDN hizmeti yolunun ana URL'sini girin.
  • Adobe Commerce URL'si - Kullandığınız Adobe Commerce örneğinin URL'sini girin. 
  • GraphQL proxy yolu - İstemci tarafı Learning Manager bileşenleri, Adobe Commerce GraphQL uç noktasına doğrudan erişir ve bu nedenle CORS hatası oluşabilir. Bu hatayı önlemek için, tüm çağrılar ya AEM ile aynı uç noktadan ya da CORS başlıkları ekleyen bir proxy aracılığıyla sunulmalıdır.
  • Adobe Commerce - Önceki bölümde belirlediğiniz Adobe Commerce mağaza adını girin.
  • Adobe Commerce müşteri belirteci ömrü (saniye cinsinden) - Oturum açma oturumu için önceden belirlenmiş süreyi gösteren müşteri belirteci ömrünü girin. 
  • Yönetici yenileme belirteci - Önceki bölümde belirlediğiniz yenileme belirtecini girin.

Web sayfalarını özelleştirme

AEM referans site ve kullanılabilir bileşenlerle web sayfalarınızı özelleştirin. 

  1. AEM örneğinizi başlatın.

  2. Siteler'i tıklayın ve yapılandırma sayfasını açın.

  3. Eğitim Sitesi > Ana Dil > İngilizce. Projedeki tüm web sayfaları klasöre dahil edilir. 

  4. Herhangi bir şablonu seçin ve Düzenle'yi tıklayın.

  5. Sayfada, bileşen ayarları düğmesini tıklatın ve bileşenin özelliklerini değiştirin.

  6. Değişikliklerinizi önizleyin veya dilerseniz sayfayı yayınlayabilirsiniz. 

Web sayfaları oluşturma

Referans site paketiyle sağlanan kullanabileceğiniz şablonların yanı sıra AEM'deki şablonların temel alındığı web sayfaları da oluşturabilirsiniz.

  1. AEM ana sayfasında, Oluştur > Sayfa'yı tıklayın. 

  2. Özelleştirmek istediğiniz şablonu seçin. Sonraki
    öğesine tıklayın. 

  3. Sayfa özelliklerini girin. 

  4. Sayfayı oluşturmak için Oluştur'u tıklayın.

  5. Yeni sayfayı seçin ve Düzenle'yi tıklayın.

  6. Sayfaya bir bileşen ekleyin (örneğin Eğitim İçeriği).

  7. Sayfada görüntülenecek gerekli Katalog filtrelerini seçin.

Ayrıntılı plandan site oluşturma

ALM referans site paketi, öğrenme platformunuz için bir web sitesi oluşturmanıza olanak tanıyan bir "Eğitim Sitesi Ayrıntılı Planı" sağlar. AEM ayrıntılı planları, doğrudan AEM Sites bileşenlerinden web sayfaları oluşturmanıza olanak tanır. Şablon kullanmanıza gerek yoktur. 

  1. AEM başlangıç sayfasında, Siteler'i tıklayın.

  2. Oluştur > Site seçeneğini tıklayın. 

  3. Eğitim Sitesi Ayrıntılı Planı'nı tıklayın. 

  4. Sonraki
    öğesini tıklayın. 

  5. Özellikler sayfasında sayfa ana verilerini girin. Oluştur
    'u tıklayın. 

  6. Ana Sayfa köprüsünü tıklayarak, oluşturduğunuz sitenin ana sayfasına gidin. Bu sayfada, bileşenleri ve katalog bileşenleri özelleştirebilirsiniz.

Web sitenize kod yazma

Yerleşik şablonları kullanmanın ve WYSIWYG bileşenlerini kullanarak web sitenizi sıfırdan oluşturmanın yanı sıra kod yazabilir ve siteyi oluşturabilirsiniz.

Başlamanıza yardımcı olmak için kod Referans sitesi GitHub havuzunda bulunur.

Şablonun ana bölümleri şunlardır:

  • temel: OSGi hizmetleri, dinleyiciler veya zamanlayıcılar gibi tüm temel işlevlerin yanı sıra sunucu uygulamaları ya da talep filtreleri gibi bileşenle ilgili Java kodunu içeren Java paketi.
  • ui.apps: projenin /apps (ve /etc) kısımlarını içerir, yani JS&CSS clientlibs, componentler, templates.
  • ui.content: ui.apps bileşenlerini kullanan örnek içeriği içerir
  • ui.frontend: React bileşenlerini içerir.

Hazırlanıp kullanmaya başlamanız için tüm kodlar havuzdadır. 

Mevcut web sayfasına veya şablona eğitim yöneticisi bileşenlerini içe aktarma ve ekleme

AEM referans site paketi yüklendiğinde, Learning Manager bileşenleri AEM Sites örneğinize eklenir. Varsayılan olarak bu bileşenleri, kullanıma hazır şekilde sunduğumuz web projesi (web sitesi) Eğitim Sitesine ekleyebilirsiniz. Bu bileşenler, Eğitim Sitesi Ayrıntılı Planı'ndan oluşturduğunuz web sitesinde de mevcuttur.

Ancak, yeni eklenen bu Learning Manager bileşenlerini mevcut web projeniz veya web siteniz için kullanmak istiyorsanız aşağıdaki prosedürü kullanarak bunları içe aktarmanız gerekir.

  1. ALM referans site paketini yükleyin.

  2. Web projesini açın ve HTML dosyasına gidin (Learning Manager bileşenlerini eklemek istediğiniz web sayfası veya web şablonu için).

  3. Toplantıya katılma

    HTML dosyasını açın ve aşağıdaki kod parçacıklarını sayfa bileşenine ekleyin. Böylece kod, sayfada bulunan eğitim bileşenleri oluşturulmadan önce yürütülür.

    <sly data-sly-use.configModel="com.adobe.learning.core.models.GlobalConfigurationModel"/>

    <meta name="cp-config" content="${configModel.config}" />

    Önceki kod, eğitim bileşenlerinin oluşturması için gerekli olan sayfanın meta etiketine eşlenen yapılandırmayı ekler. Daha fazla bilgi için bkz. https://github.com/adobe/adobe-learning-manager-reference-site/blob/master/ui.apps/src/main/content/jcr_root/apps/learning/components/page/customheaderlibs.html.

  4. Yapılandırmayı web projesi ile eşlediğinizden emin olun.

  5. Learning Manager bileşenlerini içe aktarmak istediğiniz AEM Sites şablonunu açın.

  6. Şablon sayfası düzenleyicide, İzin Verilen Bileşenler kapsayıcısına gidin ve İlke'yi tıklayın.

  7. İlke sayfasında, Özellikler > İzin Verilen Bileşenler kısmına gidin ve şu bileşenleri seçin: 'Eğitim - İçerik,' 'Eğitim - Form' ve 'Eğitim - Yapı'

Aşağıdaki prosedür, şablonun içe aktarılan Learning Manager bileşenlerinin istemci kitaplığı bağımlılıklarını yerine getirmesini sağlar.

Bu bileşenleri içeren web sayfaları, bileşenleri başarıyla oluşturmak ve kullanmak için bu kitaplıkları yüklemelidir.

  1. Şablon sayfası düzenleyicisinde Sayfa Bilgileri'ni ve ardından Sayfa İlkesi'ni tıklayın.
  2. İlke sayfasında, Özellikler > İstemci Kitaplıkları kısmına gidin ve bunları şablon sayfanıza ekleyin:
    1. learning.site
    2. learning.ui
    3. learning.commerce

Bu şablonu kaydettikten sonra, bu şablondan türetilen tüm web sayfalarına Learning Manager bileşenlerini ekleyebilirsiniz.

Adobe logosu

Hesabınıza giriş yapın