SuiteCRM

ONLYOFFICE ve SuiteCRM entegrasyonu hakkında

SuiteCRM, bir müşteri ilişkileri yönetim sistemidir. ONLYOFFICE, ONLYOFFICE Docs çözümünü SuiteCRM ile entegre etmek ve ofis belgelerini SuiteCRM alanınızda düzenlemek için resmi bir modül sunar. ONLYOFFICE entegrasyon modülünü GitHub sayfasından edinebilirsiniz. Modül AGPL-3 lisansı altında dağıtılmaktadır.

not

ONLYOFFICE ve SuiteCRM bağlayıcısının nasıl çalıştığı hakkında daha fazla bilgi için API belgeleri sayfamızı ziyaret edin.

Ana özellikler

• Metin belgelerini, e-tabloları ve sunumları düzenleme ve görüntüleme.

• Belgelerde gerçek zamanlı ortak düzenleme: iki ortak düzenleme modu (Hızlı ve Katı), Değişiklikleri izle modu, yorumlar ve yerleşik sohbet.

• Form şablonlarını oluşturma ve düzenleme.

  not

  Formlar hakkında daha fazla bilgi için oluşturma ve doldurma makalelerini okuyun.

• Trafiğinizi korumak için JWT desteği; böylece uygun haklara sahip kullanıcılar dışında kimse belgelerinize erişemez.

Desteklenen biçimler

• Görüntüleme ve düzenleme için: DOCX, XLSX, PPTX.
• Yalnızca görüntüleme için: PDF, ODT, ODS, ODP, DOC, XLS, PPT, PPS, EPUB, RTF, HTML, HTM, TXT, CSV.

ONLYOFFICE Docs'u SuiteCRM'e bağlama

Gereksinimler

• ONLYOFFICE Document Server v7.1 (sunucu) veya üzeri

  Hem SuiteCRM'den hem de tüm son istemcilerden erişilebilen ve adı çözümlenebilen bir ONLYOFFICE Docs örneğine ihtiyacınız vardır. Örnek, doğrudan SuiteCRM'e POST isteği gönderebilmelidir.

  not

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

• SuiteCRM 7 (tüm 7.x sürümleri)

• SuiteCRM için ONLYOFFICE bağlayıcısı v1.0.0 ve üzeri

SuiteCRM için ONLYOFFICE entegrasyon modülünü kurma

ONLYOFFICE uygulamasını kurmak için:

1. ONLYOFFICE entegrasyon eklentisinin en son derlenmiş paket dosyalarını GitHub sayfasından edinin.

2. SuiteCRM'i başlatın ve Admin > Admin Tools > Module Loader yoluna gidin.

   

3. ONLYOFFICE eklenti arşivini yükleyin.

4. Yüklenen modülü Install düğmesine basarak kurun.

5. Admin > Admin Tools > Repair yoluna gidin.

6. Quick Repair and Rebuild işlemini çalıştırın.

   

Nasıl çalışır

Kullanıcı ile belge arasındaki etkileşim hem istemci tarafında hem de sunucu tarafında gerçekleşir.

Aşağıda, bu belgelerde kullanılan temel terimler açıklanmıştır.

İstemci tarafı şunları içerir:

• Belge yöneticisi - kullanıcının tarayıcısında görüntülenen belge listesi. Kullanıcı gerekli belgeyi seçip üzerinde bazı işlemler yapabilir (verilen haklara bağlı olarak belgeyi görüntülemek veya düzenlemek için açabilir, belgeyi diğer kullanıcılarla paylaşabilir).
• Belge düzenleyici - bilinen belge düzenleme özelliklerinin çoğunu sunan belge görüntüleme ve düzenleme arayüzü. Kullanıcı ile belge düzenleme hizmeti arasında aracı olarak çalışır.

Sunucu tarafı şunları içerir:

• Belge depolama hizmeti - uygun erişim haklarına sahip kullanıcıların erişebildiği tüm belgeleri saklayan sunucu hizmeti. Kullanıcının tarayıcıda gördüğü belge yöneticisine belge kimliklerini ve bu belgelerin bağlantılarını sağlar.
• Belge düzenleme hizmeti - belgelerin görüntülenmesini ve (kullanıcının uygun hakları varsa) düzenlenmesini sağlayan sunucu hizmeti. Belge düzenleyici arayüzü, belge düzenleme hizmetinin tüm özelliklerine erişmek için kullanılır.
• Belge komut hizmeti - belge düzenleme hizmeti ile ek komutlar yürütmeyi sağlayan sunucu hizmeti.
• Belge dönüştürme hizmeti - belge dosyasını düzenleme veya indirme için uygun Office Open XML biçimine (metin belgeleri için docx, e-tablolar için xlsx ve sunumlar için pptx) dönüştüren sunucu hizmeti.
• Belge oluşturucu hizmeti - bir belge işleme düzenleyicisini çalıştırmaya gerek kalmadan belgeyi kolayca oluşturmayı sağlayan sunucu hizmeti.

ONLYOFFICE Document Server, belge düzenleyiciyi, belge düzenleme hizmetini, belge komut hizmetini, belge dönüştürme hizmetini ve belge oluşturucu hizmetini içerir. Belge yöneticisi ve belge depolama hizmeti ya Community Server'a dahildir ya da ONLYOFFICE Document Server'ı kendi sunucusunda kullanan yazılım entegratörleri tarafından uygulanmalıdır.

ONLYOFFICE ve SuiteCRM entegrasyonu için JWT'yi yapılandırma

JWT veya JSON Web Token, istemcinin kimliğini doğrulamak için istemciden sunucuya HTTP isteği içinde gönderilen bir dizedir. JWT yalnızca istemci tarafında saklanır; bu nedenle taraflar arasındaki iletim korunur ve dijital olarak imzalanır.

Belirteç JWT (JSON Web Tokens) standardı kullanılarak oluşturulur. Belirteçler sunucunun anahtarıyla imzalanır; böylece istemci belirtecin geçerli olduğunu doğrulayabilir.

ONLYOFFICE Docs belirteci doğrular. Yükteki veriler geçerli kabul edilir ve ana parametrelerdeki ilgili veriler yerine kullanılır. Belirteç geçersizse komut yürütülmez. Daha fazla bilgi için API Güvenlik kılavuzunu okuyun.

ONLYOFFICE Docs'ta JWT, 7.2 sürümünden itibaren varsayılan olarak etkindir.

Gerekirse manuel olarak yapılandırmak için şu adımları izleyin:

1. Admin > ONLYOFFICE > ONLYOFFICE Settings yoluna gidin.

   

2. Aşağıdaki alanlara değerleri girin:

   • Document Editing Service Address: ONLYOFFICE Docs'un kurulu olduğu URL adresini belirtin (örneğin https://documentserver).
   • Secret key (devre dışı bırakmak için boş bırakın): Gizli anahtar, ONLYOFFICE Docs'a erişimi kısıtlamak için otomatik olarak oluşturulur. Bu alanda kendi gizli anahtarınızı belirtmek isterseniz, doğrulamayı etkinleştirmek için aynı gizli anahtarı ONLYOFFICE Docs yapılandırma dosyasında da belirtin.
   • Authorization header (varsayılan başlığı kullanmak için boş bırakın): ONLYOFFICE'te kullanılan standart JWT başlığı Authorization'dır. Bu başlık kurulumunuzla çakışırsa başlığı özel bir başlıkla değiştirebilirsiniz.

   

SuiteCRM içinde ONLYOFFICE Docs'u kullanmaya başlama

Ofis dosyalarını düzenlemek ve birlikte çalışmak için:

• Documents modülüne gidin.
• Dosya adına tıklayarak Detail View sayfasını açın.
• Detail View sayfasında, açılır ACTIONS menüsünde Open in ONLYOFFICE seçeneğine tıklayın - dosya aynı sekmede açılır.

not

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