İlk ADF uygulaması nasıl oluşturulur?

Alfresco Framework

Mehmet Demirel

İlk ADF uygulamanızı oluşturma

Bu içerik Alfresco ADF başlangıç eğitiminin bir parçasıdır ve Alfresco Content Services, Activiti tarafından desteklenen Alfresco Process Services veya her ikisinden oluşan bir hizmet katmanının üstünde açısal uygulamanızı nasıl oluşturacağınızı açıklamaktadır. Aşağıdaki bölümlerde, açıklanan ön koşulları gözden geçirdiğinizi varsayarak, Alfresco ADF ile nasıl yepyeni bir uygulama oluşturulacağını göreceğiz. Bunun için aşağıdaki görevleri yerine getireceğiz:

1. Yeoman Jeneratör kullanarak ADF uygulaması oluşturulması.

2. Alfresco ADF uygulamasını Alfresco Content Services, Activiti tarafından desteklenen Alfresco Process Services veya her ikisi tarafından yapılan doğru hizmet katmanlarını gösterecek şekilde yapılandırma.

3. Bir kez başlatıldığında Alfresco ADF uygulamasının kullanıcı deneyimini açıklamak.


Bu eğitici, geliştirme ortamınızı nasıl kuracağınızı ve bir ADF uygulaması nasıl oluşturacağınızı gösterir.

Aşağıda, her bir görevin "adım adım" tanımını bulabilirsiniz, eğer teknolojilere son derece aşina değilseniz da çok basittir.

ADF geliştirmeye başlamak için birkaç ön koşul yüklemeniz gerekir: node.js, Yeoman ve bir kod editörü. Ön koşullar yüklendikten sonra, ADF Yeoman üretecini kullanarak uygulamayı oluşturmanız ve ardından ADF uygulamanızı Alfresco İçerik Hizmetleri deponuzu gösterecek şekilde yapılandırmanız gerekir.

Node.js dosyasını yükleyin

Https://nodejs.org/en/ adresinden indirebileceğiniz en son node.js sürümüne ihtiyacınız var. İşletim sisteminiz için yükleyiciyi seçin ve kurulum talimatlarını izleyin. Tamamlandığında, bir terminal açın ve kurulumu aşağıdaki komutla doğrulayın:

node -v

Not: Hem 10.x hem de 11.x sürümleri iyi çalışmalıdır.

İPUCU: ADF, node.js ve Angular ile kapsamlı geliştirme yapmayı planlıyorsanız, node.js için n veya nvm gibi bir sürüm yöneticisi yüklemeyi düşünebilirsiniz. Bu araç, aynı anda birden fazla node.js sürümüne sahip olmanızı ve sürümler arasında kolayca geçiş yapmanızı sağlar.


Kod düzenleyicisi yükleme

Tüm Açısal geliştirme Typcript kullanılarak yapılacaktır. Bunu göz önünde bulundurarak, gelişimi biraz daha kolaylaştıran araçlara sahip olmak harika bir şey, ancak gerçekten herhangi bir metin editörü iyi olacak.

Visual Studio Code'u öneririz - Microsoft'un Angular geliştirmesiyle iyi çalışan ve geliştirici deneyimini daha da iyi hale getirmek için büyük bir eklenti ekosistemine sahip ücretsiz, hafif ve çok güçlü bir araçtır.

Diğer öneriler arasında JetBrains'ten IntelliJ IDEA veya WebStorm bulunmaktadır ancak topluluk sürümünün Typcript'i desteklemediğini unutmayın.


ADF Yeoman jeneratörünü kurun

Yomanvers çalıştırarak Yeoman'ın kurulu olduğundan emin olmalısınız. Sisteminizde yoksa, çalıştırmalısınız:

npm install -g yo

Not: Linux veya macOS'taysanız, bu komutları sudo ile çalıştırmanız gerekebilir.


Şimdi generator-alfresco-adf-app uygulamasının en son sürümünü yükleyin:

npm install -g [email protected]


İlk ADF uygulamanızı oluşturun

Artık tüm ön koşullara sahibiz, bir uygulama oluşturmanın zamanı geldi:

yo alfresco-adf-app

yeoman_creation

Bir ad girin ve uygulama planı olarak İçerik Hizmetleri'ni seçin, ardından bağımlılıkları yüklemek için Y girin.

Yeoman jeneratörü şimdi yeni bir proje oluşturacak ve başvurunuz için gereken tüm bağımlılıkları kuracaktır.

Not: Yeoman jeneratörü projeniz için yeni bir dizin oluşturur. Bu yeni dizine geçtiğinizden emin olun.


ADF'yi Alfresco İçerik Hizmetleri ile çalışacak şekilde yapılandırma

Bir sonraki adım, yeni oluşturulan projeyi kod düzenleyicinizde açmak ve proxy.conf.json dosyasını açmaktır. Bu dosyadaki target özelliğini Alfresco İçerik Hizmetleri URL'nizi ve bağlantı noktanızı gösterecek şekilde değiştirin. Bu URL'yi bulmak için lütfen kurulum kılavuzunuza bakın veya çevrimiçi bir deneme sürümü kullanıyorsanız bilgileri e-postada bulabilirsiniz.

"target": "http://localhost:8080" ifadesini URL'nizle eşleşecek şekilde değiştirin ve dosyayı kaydedin.

Hedef URL'nin sonunda /alfresco olmamalı, lütfen unutmayın. Diyelim ki Docer Compose kullanarak Alfresco Content Services 6.1'i başlattınız. Alfresco İçerik Hizmetleri deponuza http://localhost:8082/alfresco adresinden ulaşılabilir.

Bu durumda proxy.conf.json dosyasının şu şekilde olmalıdır:

{
    "/alfresco": {
        "target": "http://localhost:8082",
        "güvenli": false,
        "changeOrigin": true
    }
}

Çevrimiçi deneme sürümü kullanıyorsanız, doğru URL için e-postalarınıza başvurun. proxy.conf.json şöyle olmalıdır:

{
    "/alfresco": {
        "target": "https://xyz.trial.alfresco.com",
        "güvenli": true,
        "changeOrigin": true
    }
}

Uygulamayı başlatın

Projeyi çalıştırmak için bir terminal açın ve çalıştırın

npm start

Bir tarayıcı otomatik olarak http://localhost:4200 adresinde açılır.

yeoman_creation


Yan taraftaki gezinme panelinde yer alan anahtar simgesini tıkladığınızda artık giriş yapabilirsiniz!

Not: Çevrimiçi bir deneme sürümü kullanıyorsanız, giriş kimlik bilgilerinizi hoş geldiniz e-postasında bulabilirsiniz.

Başvurunuzu keşfetmek için birkaç dakikanızı ayırın. Temel özelliklere sahipsiniz: Depoya göz atma, belgeleri yükleme ve önizleme.