Ana içeriğe geç

Alfresco

ONLYOFFICE ve Alfresco entegrasyonu hakkında​

ONLYOFFICE, ONLYOFFICE Docs'u Alfresco ile entegre etmek ve ofis belgelerini belge kitaplığında oluşturmak, düzenlemek ve dönüştürmek için resmi bir bağlayıcı sunar. ONLYOFFICE bağlayıcısını resmi Alfresco Add-ons dizininden veya ONLYOFFICE GitHub sayfasından indirebilirsiniz.

not

ONLYOFFICE ve Alfresco modülü ile nasıl çalıştığı hakkında ayrıntılı bilgi için lütfen API belgelerini ziyaret edin.

Ana özellikler​

  • Metin belgelerini, e-tabloları ve sunumları oluşturma, düzenleme ve görüntüleme.
  • Dosyaları dönüştürme.
  • Belgeleri gerçek zamanlı olarak birlikte düzenleme: iki ortak düzenleme modu (Hızlı ve Katı), Değişiklikleri izle modu, yorumlar ve yerleşik sohbet.
  • Trafiğinizi korumak için JWT desteği: belgelerinize yalnızca uygun haklara sahip kullanıcılar erişebilir.

Desteklenen biçimler​

  • Oluşturma, düzenleme ve görüntüleme için: DOCX, PPTX, XLSX
  • Formlarla çalışmak için: PDF
  • Dönüştürme için: ODT, ODP, ODS, DOC, XLS, PPT, RTF
  • OOXML'e dönüştürerek düzenleme için: ODP, ODS, ODT, RTF, CSV, TXT
  • Yalnızca görüntüleme için: PDF

8.1.0 sürümündeki yenilikler​

Eklenenler

  • Düzenleyicide olay desteği eklendi: onRequestReferenceData, onRequestReferenceSource, onRequestOpen

Değişenler

  • Ignore SSL Certificate ayarındaki hata düzeltildi

Değişikliklerin tam listesine buradan ulaşabilirsiniz.

ONLYOFFICE Docs'u Alfresco Share'e bağlama​

Gereksinimler​

  • ONLYOFFICE Document Server v7.1 (sunucu veya bulut sürümü) veya üzeri

    Hem Alfresco'dan hem de tüm son istemcilerden çözümlenebilen ve erişilebilen bir ONLYOFFICE Docs örneğine ihtiyacınız vardır. Örneğin doğrudan Alfresco'ya POST isteği gönderebilmesi gerekir.

    not

    ONLYOFFICE Docs'un kurulumu hakkında daha fazla bilgi için resmi belgeler sayfasına bakın.

  • Alfresco v.7.4, 23, 25

  • Alfresco için ONLYOFFICE Bağlayıcısı 7.0.0

ONLYOFFICE ve Alfresco modül paketini kurma​

En son derlenmiş paket dosyaları GitHub üzerinde bulunur. onlyoffice-integration-repo.amp ve onlyoffice-integration-share.amp dosyalarına ihtiyacınız vardır.

Derlenmiş paketlerle kurulum​

  1. Derlenmiş .amp paket dosyalarını yukarıdaki bağlantıdan indirin.

  2. Sunucunuzda aşağıdaki dizinleri oluşturun:

    sudo mkdir -p /var/opt/alfresco/amps
    sudo mkdir -p /var/opt/alfresco/amps_share

  3. Derlenmiş .amp paket dosyalarını yeni oluşturulan dizinlere taşıyın:

    • onlyoffice-integration-repo.amp için /var/opt/alfresco/amps
    • onlyoffice-integration-share.amp için /var/opt/alfresco/amps_share

  4. Alfresco hizmetlerini aşağıdaki yöntemlerden biriyle durdurun:

    1. Yöntem 1:

      sudo systemctl stop alfresco
      not

      Alfresco'nun tüm hizmetlerinin durdurulduğundan emin olun. Hizmetler sırayla durdurulmalıdır; en son durdurulacaklar adında content geçenlerdir, örneğin:

      alfresco-tengine-aio.service.service
      alfresco-search.service
      alfresco-content-monitored-startup.service
      alfresco-content.service

    2. Yöntem 2:

      sudo ./alfresco.sh stop

      Bu yöntemin yalnızca betik sürümünüzde yer alıyorsa çalıştığını unutmayın; bu her zaman böyle değildir.

  5. alfresco.war ve share.war dosyalarının yolunu bulun, örneğin:

    sudo find / -type f -iname '*alfresco.war*' 2>/dev/null

  6. alfresco-mmt.jar araç dosyasının yolunu bulun.

  7. Eklentinin repo bileşenini kurun:

    java -jar /PATH/alfresco-mmt.jar install \
    /PATH/onlyoffice-integration-repo.amp \
    /PATH/alfresco.war \
    -verbose -nobackup -force

    Burada PATH, daha önce bulduğunuz dosya yollarını ifade eder. Yukarıdaki komutta PATH değerlerinin her satırda farklı olduğunu unutmayın.

    not

    alfresco-mmt.jar dosyasını çalıştırmak için Java'yı güncellemeniz gerekebilir:

    sudo apt update
    sudo apt install openjdk-17-jre-headless

  8. Eklentinin share bileşenini kurun:

    java -jar /PATH/alfresco-mmt.jar install \
    /PATH/onlyoffice-integration-share.amp \
    /PATH/share.war \
    -verbose -nobackup -force

    Burada PATH, daha önce bulduğunuz dosya yollarını ifade eder. Yukarıdaki komutta PATH değerlerinin her satırda farklı olduğunu unutmayın.

  9. Alfresco'nun yeniden başlatıldığında yeniden derlenmesi için Tomcat dizinlerini silin:

    sudo rm -rf /var/opt/alfresco/tomcat/webapps/alfresco
    sudo rm -rf /var/opt/alfresco/tomcat/webapps/share

  10. Alfresco'yu aşağıdaki yöntemlerden biriyle yeniden başlatın:

    1. sudo systemctl start alfresco
    2. sudo ./alfresco.sh start
    not

    Hizmetleri durdurduğunuz sırayla başlattığınızdan emin olun.

Ubuntu'ya kurulum​

ONLYOFFICE Docs'u Alfresco ile kullanmaya başlamak için Ubuntu 24.04 üzerinde şu adımları izleyin:

  1. Derlenmiş *.amp paketlerini Alfresco kurulumunuza uygun dizinlere yükleyin:

    • Alfresco deposu için onlyoffice-alfresco/repo/target/ dizininden /usr/local/tomcat/amps/ dizinine,
    • Share için onlyoffice-alfresco/share/target/ dizininden /usr/local/tomcat/amps_share/ dizinine.

  2. Önceden derlenmiş paket dosyalarını buradan indirip ilgili dizinlere koyabilirsiniz.

    Modülleri kurmak için Module Management Tool (MMT) aracını kullanın ve şu komutları çalıştırın:

    • Alfresco

      java -jar /usr/local/tomcat/alfresco-mmt/alfresco-mmt.jar install /usr/local/tomcat/amps/onlyoffice-integration-repo.amp /usr/local/tomcat/webapps/alfresco

    • Share

      java -jar /usr/local/tomcat/alfresco-mmt/alfresco-mmt.jar install /usr/local/tomcat/amps_share/onlyoffice-integration-share.amp /usr/local/tomcat/webapps/share

    MMT kullanımı hakkında daha fazla ayrıntıyı Alfresco kurulum kılavuzunda bulabilirsiniz.

  3. Document Server'ın Alfresco'ya POST isteği gönderebildiğinden emin olun.

    Bunun için alfresco-global.properties dosyasındaki şu satırları değiştirmeniz gerekebilir veya yapılandırma sayfasından ayarlayabilirsiniz:

    alfresco.host=<hostname>
    alfresco.port=443
    alfresco.protocol=https

    share.host=<hostname>
    share.port=443
    share.protocol=https

  4. Alfresco'yu yeniden başlatın:

    sudo ./alfresco.sh stop
    sudo ./alfresco.sh start

Modülü, Alfresco'daki /share/page/console/admin-console/module-package adresinde bulunan yönetici araçlarından kontrol edebilirsiniz.

ONLYOFFICE Alfresco modül paketini derleme​

ONLYOFFICE Alfresco modül paketini kendiniz derlemeyi planlıyorsanız (örneğin kaynak kodunu düzenleyip sonra derlemek için) şu adımları izleyin:

  1. Başarılı bir derleme için en son kararlı Oracle Java sürümü gerekir. Kurulu değilse Oracle Java 8'i kurmak için şu komutları kullanın:

    sudo apt-get update
    sudo apt-get install openjdk-8-jdk

  2. En son Maven sürümünü kurun. Kurulum süreci resmi Maven kılavuzunda açıklanmıştır.

  3. ONLYOFFICE Alfresco modül paketinin kaynak kodunu indirin:

    git clone https://github.com/ONLYOFFICE/onlyoffice-alfresco.git

  4. Alt modülü alın:

    git submodule update --init --recursive

  5. repo ve share dizinlerindeki paketleri derleyin:

    cd onlyoffice-alfresco && mvn clean install

ONLYOFFICE Alfresco modül paketini derlemenin başka bir yolu da docker-compose dosyasını kullanmaktır.

Proje dizininde şu komutu çalıştırın:

docker-compose up

ONLYOFFICE ve Alfresco modül paketini yapılandırma​

Alfresco Administration Console sayfasına gidin. http://<alfrescohost>/alfresco/s/onlyoffice/onlyoffice-config adresini açın ve aşağıdaki parametreleri belirtin.

Ayarlar:

  • Document Editing Service address - Belge Düzenleme Hizmeti'nin kurulu olduğu URL adresini belirtin.

    Önemli

    ONLYOFFICE Docs adresi Alfresco'dan erişilebilir olmalıdır, aynı şekilde Alfresco adresi de ONLYOFFICE Docs'tan erişilebilir olmalıdır.

  • Secret Key - verileri imzalamak için kullanılan gizli anahtarı belirtin.

    not

    ONLYOFFICE Docs v7.2 sürümünden itibaren JWT varsayılan olarak etkindir ve gizli anahtar otomatik olarak oluşturulur. JWT'yi Alfresco tarafında da etkinleştirmeniz gerekir: gizli anahtarınızı ONLYOFFICE Docs yapılandırma dosyasında bulun, ardından aynı gizli anahtarı bağlayıcı ayarlarında belirtin. Daha fazla bilgi için bu makalenin ONLYOFFICE ve Alfresco entegrasyonu için JWT'yi etkinleştirme bölümüne bakın.

Gelişmiş sunucu ayarları:

  • Document Editing Service address for internal requests from the Alfresco server - Alfresco sunucusundan Belge Düzenleme Hizmeti'ne erişmek için kullanılan adresi belirtin.
  • Alfresco server address for internal requests from the Document Editing Service - Belge Düzenleme Hizmeti'nden Alfresco sunucusuna erişmek için kullanılan adresi belirtin.
  • Authorization header (varsayılan başlığı kullanmak için boş bırakın) - ONLYOFFICE'te kullanılan yetkilendirme JWT başlığı Authorization'dır. Bu başlık kurulumunuzla çakışırsa, başlığı özel bir başlıkla değiştirebilirsiniz.

Ortak ayarlar:

  • Ignore SSL Certificate - SSL'yi kapatır.
  • Enable Force Save - Kaydet düğmesine tıklandıktan sonra belge değişikliklerinin doğrudan Alfresco depolama alanına kaydedilmesini sağlar (devre dışıysa belge, kapatılana kadar belge düzenleyicisinin önbelleğinde kaydedilir).
  • Save docx, xlsx, pptx as a new version of the original file after conversion - devre dışıysa ayrı bir dosya oluşturulur ve aynı klasöre yerleştirilir.
  • Open the file for editing - yöneticilerin OOXML biçimlerine dönüştürülerek düzenlenecek belge biçimlerini seçmesini sağlar.
  • After closing the editor, save the document as a minor version - belge sürümlerinin kapatıldıktan sonra ana sürüm (2.0, 3.0) olarak mı yoksa düzenleme sırasında ara sürüm (1.1, 1.2) olarak mı kaydedileceğini belirler; 1.0 ilk boş belgedir.
not

onlyoffice.url değerini alfresco-global.properties dosyasına da ekleyebilirsiniz. Ayarlar sayfasından yapılan yapılandırma, alfresco-global.properties dosyasındaki değerlerin yerine geçer.

Settings_menu

Nasıl çalışır​

ONLYOFFICE entegrasyonu burada açıklanan API'yi izler.

  1. Kullanıcı Alfresco Share içinde bir belgeye gider ve Edit in ONLYOFFICE menü seçeneğini seçer.
  2. Alfresco Share, repo ucuna istek gönderir (URL biçimi: /parashift/onlyoffice/prepare?nodeRef={nodeRef}).
  3. Alfresco Repo ucu, Share için aşağıdaki özelliklere sahip bir JSON nesnesi hazırlar:
    • url - ONLYOFFICE Docs'un belgeyi indirmek için kullandığı URL (geçerli kullanıcının alf_ticket değerini içerir);
    • callbackUrl - ONLYOFFICE Docs'un belge düzenleme durumunu bildirdiği URL;
    • onlyofficeUrl - istemcinin ONLYOFFICE Docs'a yanıt vermek için kullanması gereken URL (onlyoffice.url özelliğiyle sağlanır);
    • key - ONLYOFFICE Docs'a belgeyi yeniden indirip indirmeyeceğini bildiren UUID+Modified Timestamp;
    • title - belge başlığı (adı).
  4. Alfresco Share bu nesneyi alır ve istemci tarayıcısının düzenleyiciyi yükleyebilmesi için tüm bu değerleri doldurarak bir freemarker şablonundan sayfa oluşturur.
  5. İstemci tarayıcısı ONLYOFFICE Docs'un JavaScript kitaplığına istek gönderir ve yukarıdaki özellikleri içeren DocEditor yapılandırmasını ONLYOFFICE Docs'a iletir.
  6. Ardından ONLYOFFICE Docs belgeyi Alfresco'dan indirir ve kullanıcı düzenlemeye başlar.
  7. ONLYOFFICE Docs, bir kullanıcının belgeyi düzenlediğini Alfresco'ya bildirmek için callbackUrl adresine POST isteği gönderir.
  8. Alfresco belgeyi kilitler, ancak Action öğesini görünür bırakarak yazma erişimi olan diğer kullanıcıların ONLYOFFICE Docs ile gerçek zamanlı olarak birlikte çalışmasına izin vermeye devam eder.
  9. Tüm kullanıcılar ve istemci tarayıcıları düzenlemeyi bitirdiğinde düzenleme penceresini kapatır.
  10. 10 saniyelik hareketsizlikten sonra ONLYOFFICE Docs, istemcilerin belgeyi düzenlemeyi bitirip kapattığını Alfresco'ya bildirmek için callbackUrl adresine POST isteği gönderir.
  11. Alfresco belgenin yeni sürümünü indirir ve eskisinin yerine koyar.

ONLYOFFICE ve Alfresco entegrasyonu için JWT'yi etkinleştirme​

Belgeleri yetkisiz erişime karşı korumak için ONLYOFFICE düzenleyicileri JSON Web Token (JWT) kullanır. Token, Belge Düzenleyici başlatılırken yapılandırmaya ve ONLYOFFICE Docs'un iç hizmetleri arasındaki komut alışverişi sırasında eklenir. Gizli anahtar, JSON web token'ı imzalamak ve ONLYOFFICE Docs'a gelen istekte token'ı doğrulamak için kullanılır.

ONLYOFFICE Docs v7.2 sürümünden itibaren JWT varsayılan olarak etkindir ve gizli anahtar otomatik olarak oluşturulur. Gizli anahtarınızı ONLYOFFICE Docs yapılandırma dosyasında bulmanız, ardından aynı gizli anahtarı bağlayıcı ayarlarında belirtmeniz gerekir.

Adım 1: Gizli anahtarınızı ONLYOFFICE Docs yapılandırma dosyasında bulun

  1. local.json dosyasını herhangi bir metin düzenleyiciyle açın.

    • Linux için - /etc/onlyoffice/documentserver/local.json

    • Windows için - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json

    • Docker için - docker exec -it <containerID> bash komutuyla ONLYOFFICE Docs kapsayıcısına girin ve /etc/onlyoffice/documentserver/local.json dosyasını açın

      Alternatif olarak, local.json dosyasını açmadan varsayılan gizli anahtarı bulmak için aşağıdaki komutu kullanabilirsiniz:

      sudo docker exec <containerID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'

    local.json dosyası şöyle görünmelidir:

    {
      "services": {
        "CoAuthoring": {
          "token": {
            "enable": {
              "request": {
                "inbox": true,
                "outbox": true
              },
              "browser": true
            }
          },
          "secret": {
            "inbox": {
              "string": "yoursecret"
            },
            "outbox": {
              "string": "yoursecret"
            },
            "session": {
              "string": "yoursecret"
            }
          }
        }
      }
    }

  2. true değeri üç bölümde belirtilmiştir. Bu, token doğrulamasının etkin olduğu anlamına gelir.

    • services.CoAuthoring.token.enable.browser
    • services.CoAuthoring.token.enable.request.inbox
    • services.CoAuthoring.token.enable.request.outbox

  3. Otomatik olarak oluşturulan gizli anahtar üç bölümde belirtilmiştir. Varsayılan gizli değeri kendi gizli anahtarınızla değiştirebilirsiniz. Gizli anahtar üç bölümde de aynı olmalıdır.

    • services.CoAuthoring.secret.inbox.string
    • services.CoAuthoring.secret.outbox.string
    • services.CoAuthoring.secret.session.string

  4. Değişiklik yaparsanız kaydedin ve yapılandırma değişikliklerinin geçerli olması için hizmetleri yeniden başlatın.

    supervisorctl restart all

Adım 2: Aynı gizli anahtarı bağlayıcı ayarlarında belirtin

Bağlayıcı ayarlarında Secret key alanına aynı gizli anahtarı girin ve ayarları kaydedin.

Demo ONLYOFFICE Docs'a bağlanma​

ONLYOFFICE bağlayıcısı 5.0.0 sürümünden itibaren ONLYOFFICE Docs'u kurmadan ONLYOFFICE çevrimiçi düzenleyicilerini Alfresco içinde deneyebilirsiniz.

Bağlantıyı açmak için Connect to demo ONLYOFFICE Document Server onay kutusuna tıklayın ve Save düğmesine tıklayın.

Önemli

Bu, 30 günlük süre boyunca kullanılabilecek herkese açık bir test sunucusudur. Hassas verilerinizi burada paylaşmayın.

Alfresco içinde ONLYOFFICE Docs'u kullanmaya başlama​

Bir belge oluşturmak için:

  1. Belgeyi oluşturmak istediğiniz klasörü açın.
  2. Create... düğmesine tıklayın.
  3. Oluşturmak istediğiniz dosya türünü seçin: Document, Spreadsheet veya Presentation.

new_menu

Bir belgeyi düzenlemek veya görüntülemek için:

  1. Gerekli belgeyi bulun.
  2. Edit in ONLYOFFICE düğmesine tıklayın.

edit_menu

OOXML olmayan bir belgeyi OOXML biçimine (DOCX, XLSX veya PPTX) dönüştürmek için:

  1. Gerekli belgeyi bulun.
  2. Convert using ONLYOFFICE düğmesine tıklayın.

Belge otomatik olarak OOXML karşılığına dönüştürülür. Oluşan dosyalar aynı klasöre yerleştirilir. Bir klasör için otomatik dönüştürme kuralları da yapılandırabilirsiniz. Kural yapılandırması hakkında daha fazla bilgi için resmi Alfresco belgelerine bakın.

convert_menu

Dosyayı tercih ettiğiniz biçimde indirmek için:

  1. Gerekli dosyayı bulun.
  2. Download as... düğmesine tıklayın ve ihtiyacınız olan biçimi seçin.

download_menu

Dosya değişiklik geçmişini görmek için:

  1. Dosya ayrıntıları sekmesini açmak için dosya adına veya simgesine tıklayın.
  2. Sağ paneldeki Version History sekmesini bulun.
  3. Kullanılabilir bölümler: Latest Version ve Older Versions. Dosyada yapılan değişiklikler vurgulanır.
  4. Yeni bir sürüm yüklemek için sağ üst köşedeki ilgili simgeye tıklayın.
  5. Geçerli dosya sürümünü hızlıca görmek için fare imlecini dosyanın üzerine getirin. Sürüm numarası dosya adının sağında görüntülenir, örneğin Version number.

properties

veya

  1. Düzenleyicide Dosya sekmesine gidin.
  2. Menüden Versiyon geçmişi seçeneğini seçin.

Belge Düzenleyicide doğrudan yeni bir dosya oluşturmak için:

  1. Dosya sekmesini açın.
  2. Yeni oluştur seçeneğine tıklayın.

Yeni bir .docx dosyası yeni bir sekmede açılır.

Özel şablonlar oluşturmak için:

  1. Alfresco portalında, onu oluşturan yönetici olarak oturum açın.
  2. My files -> Data Dictionary -> Node Templates yolunu izleyin.
  3. Kullanılabilir biçimlerde (.docx, .xlsx, .pptx) özel şablonlar ekleyin.

create_template

Şablonlardan belge oluşturmak için:

  1. Belgeyi oluşturmak istediğiniz klasörü açın.

  2. Create... düğmesine tıklayın.

  3. Create document from template seçeneğini seçin ve kullanılabilir şablonlardan birini belirleyin.

    create_from_template

    veya

  4. Düzenleyicide Dosya sekmesine gidin.

  5. Yeni oluştur... seçeneğine tıklayın.

  6. Gerekli şablonu seçin.

    create_from_template_editor

Depolama alanındaki dosyaları karşılaştırmayı öğrenmek için bu makaledeki yönergeleri izleyin.

compare_files

Depolama alanından e-posta birleştirmeyi kullanmayı öğrenmek için bu makaledeki yönergeleri izleyin.

mail_merge

Depolama alanından resim eklemeyi öğrenmek için bu makaledeki yönergeleri izleyin.

insert_images

Belgeyi doğrudan Belge Düzenleyicide favori olarak işaretlemeyi öğrenmek için bu makaledeki yönergeleri izleyin.

mark_fav

not

En sık karşılaşılan sorunlar ve çözüm yolları hakkında daha fazla bilgi için lütfen sorun giderme kılavuzumuzu inceleyin.