Bu sayfa, özel etki alanına özgü Web UI’leri oluşturmak için kullanılan Alfresco Uygulama Geliştirme Çerçevesine (ADF) bir giriş sağlar.

Alfresco Uygulama Geliştirme Çerçeve olarak anılacaktır, ADF’ye , Açısal 5 JavaScript çerçevesinin üzerine inşa edilmiştir. ADF’yi , bir  içerik yönetimi web uygulaması ve / veya bir süreç yönetimi web uygulaması oluşturmak için kullanılabilecek Alfresco web bileşenleri kütüphanesi olarak  düşünebilirsiniz . Web uygulamanızı Alfresco ile entegre etmek için kullanabileceğiniz bir dizi web bileşeni vardır. İçerik Hizmetleri ( ACS ). İşte bu bileşenlerden bazıları:

  • Klasör Hiyerarşisi Ekmek  kırıntıları – tıklanabilir klasör yolu olan bir ekmek kırıntısı görüntüleyin
  • Belge Listesi  – klasörleri ve dosyaları listeleyin
  • Ara  – klasörleri ve dosyaları ara
  • Etiket  – etiketleri yönetin ve listeleyin
  • Yükle  – dosyaları düğme veya sürükle ve bırak yöntemiyle yükleyin
  • Viewer  – dosyaları tarayıcıda önizleme
  • Webscript  – bir Web Script’i çağırın (örneğin bir ReST çağrısı)

Alfresco Process Services ( APS ) ile entegrasyon için aşağıdaki bileşenlere sahipsiniz:

  • Analytics  – işlem vakasına genel bakış gibi grafik raporlarını görüntüleme
  • Diyagram  – süreç tanımlama diyagramını göster, eğer çalışan proses örneği ile ilişkilendirilmişse, faaliyetler durumlarına göre vurgulanır
  • Proses Uygulamaları  – proses uygulamalarının bir listesini gösterir
  • İşlem Listesi  – işlem örneklerinin bir listesini göster
  • İşlem Ayrıntıları  – bir işlem için farklı ayrıntılar göstermek üzere birden çok bileşen mevcuttur
  • Görev Listesi  – işlem örnekleri için görev örnekleri listesini göster
  • Görev Ayrıntıları  – bir görevin farklı ayrıntılarını göstermek için birden fazla bileşen mevcuttur

Hem ACS hem de APS ile kullanılan bir dizi genel bileşen de vardır:

  • Ekmek kırıntıları  – gezinme hiyerarşisindeki geçerli konumu gösterir
  • Araç Çubuğu  – Açısal Malzeme araç çubuğunun bir başlığı ve rengi olan bir uzantısı
  • Akordeon  – daraltılabilir bir akordeon menüsü oluşturur
  • Kart Görünümü  – özellikleri hoş bir düzende görüntüler
  • Veri Tablosu  – örneğin Belge Listesi tarafından kullanılan genel veri tablosu uygulaması
  • Sürükle ve Bırak  – Dosyaları örneğin bir klasöre sürükleyip bırakın
  • Form  – düğümlerden, görevlerden ve diğer kaynaklardan JSON’da tanımlanan bir formdaki özellikleri görüntüleme
  • Giriş  – her iki hizmetle kimlik doğrulaması yapar
  • Kullanıcı Bilgisi  – bir kullanıcı hakkındaki bilgileri görüntüleme

Belgelere sahip tüm bileşenlerin tam listesi için bkz.  ADF Bileşen Kataloğu .

Mimari

Bu ADF bileşenleri doğrudan ACS ve APS arka uç hizmetleriyle konuşmaz. Kodlamaya başlamadan önce aralarında bilinmeye değer bazı katmanlar vardır. ADF bileşenleri ADF hizmetleriyle konuşur, bu da Alfresco JS API ile konuşur ve  ACS ve APS’yi kendi ReST API’leri aracılığıyla dahili olarak çağırır. İstediğinizi yapabileceğiniz bir ADF bileşeni yoksa, hem ADF hizmetlerini hem de Alfresco JS API’sini doğrudan uygulamanızdan kullanabilirsiniz. Aslında, içerik düğümlerini, işlem örneklerini, görev örneklerini vb. Almak için uygulamanızdaki ADF hizmetlerini sık sık kullanmanız gerekecektir.

Aşağıdaki resim bir ADF çözümünün mimarisini göstermektedir: 

ADF bileşenleri ve hizmetleri Angular’da uygulanır ve bu da TypeScript’te uygulanır. Alfresco JavaScript kütüphanesi saf JavaScript’tir ve diğer herhangi bir JavaScript çerçevesiyle kullanılabilir. Uygulama Üreticisi  Bir demo veya kavram kanıtı senaryosu gibi bir ADF projesine hızlı bir şekilde devam etmek istiyorsanız çok yararlı olabilecek bir  ADF uygulama üreticisi vardır. Hem ACS hem de APS için kullanım durumlarını kapsar. Aşağıdaki ADF uygulama türlerini oluşturmak için kullanılabilir:

  • ADF İçerik Yönetimi Uygulaması (uygulamanız yalnızca ACS ile konuşacaksa bu şablonu kullanın)
  • ADF Process Management App (uygulamanız yalnızca APS ile konuşacaksa bu şablonu kullanın)
  • ADF İçerik ve Süreç Yönetimi Uygulaması

App Generator kullanımı basittir. Yeoman  aracını takın  .

Ardından App Generator’ı aşağıdaki gibi yükleyin:

$ sudo npm install generator-alfresco-adf-app -g
Parola:
+ jeneratör-alfresco-adf-app@2.3.0
5.438'lere 243 paket ekledi                  
          

Jeneratörü çalıştırmak kolaydır:

$ yo
? 'Allo Martin! Ne yapmak istersin? (Ok tuşlarını kullan)
  Bir jeneratör çalıştırın
❯ Alfresco Adf Uygulaması 
  ──────────────
  Jeneratörlerinizi güncelleyin 
  Jeneratör kurun 
  Biraz yardım bulun 
  Global yapılandırmayı temizle             
          

Alfresco ADF Uygulaması jeneratörünü seçin ve talimatları izleyin.