RapidStart CRM Kurulumu için Business Central Eklentisi

Yüksek Seviyeli Adımlar

1. Dataverse etkinleştirilmiş bir ortam oluşturun veya mevcut bir ortamı kullanın.
2. Dataverse etkinleştirilmiş ortamda AppSource'tan RapidStart CRM yükleyin.
3. Business Central Şirket Sistem Kimliğini edinin.
4. Business Central içinde Entegrasyonu yapılandırın.
5. Business Central entegrasyon uygulama kullanıcı rolünü doğrulayın
6. Kayıt Eşlemesini Ayarlayın
7. Ortamları Bağlayın (İsteğe Bağlı)
8. Dataverse etkinleştirilmiş ortamda AppSource'tan RapidStart CRM için Business Central Eklentisini yükleyin.
9. RapidStart Ayarları uygulamasında tamamlayın

Başlamadan Önce

Business Central Eklentisi kurulumuna başlamadan önce bu gereksinimleri doğrulayın:

• Business Central ve Dataverse, Business Central sanal tabloları için aynı Microsoft Entra kiracısında olmalıdır.
• Kurulum sırasında gerekli Business Central izinlerine ve Dataverse Sistem Yöneticisi erişimine sahip bir insan kurulum yöneticisi kullanın.
• Bağlanmayı planladığınız Dataverse ortamında RapidStart CRM'in yüklü olduğunu doğrulayın.

Adım 3: Şirket Kimliğini Edinin

Şirket kimliğinizi edinmek için Business Central'da Şirketler arayın. Hedef şirketi seçin ve Ctrl+Alt+F1 tuşlarına basarak Sayfa İncelemesi açın. Gösterilen ID'yi kopyalayın ve daha sonra kullanmak üzere saklayın.

Adım 4: Business Central İçinden Entegrasyonu Yapılandırın

Bağlanmak istediğiniz Business Central Ortamına giriş yapın.

Adres çubuğundaki Business Central ortam adını not alın. URL ayrıca şirket görüntüleme adını da gösterebilir, ancak bir önceki adımda Şirket Sistem Kimliği GUID'sini zaten kaydettiniz.

Business Central ortam adını, Şirket Sistem Kimliği GUID'sini kaydettiğiniz aynı notlara kopyalayın.

1. Dişliye tıklayın
2. “Yardımlı Kurulum” seçeneğini seçin

“Diğer sistemlerle bağlantı kur” bölümüne kadar aşağı kaydırın ve “Dataverse'e bir bağlantı kur” seçeneğine tıklayın.

1. Veri senkronizasyonunu etkinleştirmeyi seçin
2. Sanal tabloları ve olayları etkinleştirmeyi seçin
3. “İleri”ye tıklayın

Şartları kabul edin ve “İleri”ye tıklayın

Dataverse bağlantısını “Her Zaman İzin Ver” olarak kabul edin ve Tamam'a tıklayın

Hedef Dataverse etkinleştirilmiş ortamı seçin ve “Tamam”a tıklayın

Ortamın doğru olduğunu doğrulayın, ardından Dataverse ortamına giriş yapmak için bağlantıya tıklayın. Giriş yaptıktan sonra “İleri”ye tıklayın

Önerilen Takım sahipliğini seçin, senkronizasyon olmadan Tamamla'ya geçin (bunu daha sonra yapacağız) ve “İleri”ye tıklayın

1. Business Central Sanal Tablo uygulamasını yüklemek için Bağlantıya tıklayın
2. “İleri”ye tıklayın (AppSource'a yeni bir sekme açılacak)

“Şimdi al” düğmesine tıklayın (Bu eklenti ücretsizdir) ve aşağıdaki sayfa açılacaktır:

1. RapidStart CRM'i yüklediğiniz hedef ortamı seçin.
2. Şartları kabul edin.
3. “Yükle”ye tıklayın.

Çözümün “Yükleniyor” olduğunu göreceksiniz. Bu, tamamlanması birkaç dakika sürebilir. “Yüklendi” olduğunu görene kadar ara sıra “yeni sayfa”ya tıklayın, ardından devam etmek için Business Central Tarayıcı sekmesine geri dönün.

“Yenile”ye tıklayın

Sanal Tablolar uygulamasının başarıyla yüklendiğini göreceksiniz. “Bitir”ye tıklayın

Birkaç dakika sonra bu sayfa görünecektir. Sanal Tablolar Sekmesini seçin ve ardından “Mevcut Sanal Tablolar”ı seçin

1. “Öğe” satırını seçerek başlayın
2. “Etkinleştir” seçeneğine tıklayın (Bu, Dataverse'te öğeler için sanal tablo oluşturacaktır)
3. “Görünür” kutusunun işaretlendiğini görene kadar bekleyin. Birkaç kez yenilemeniz gerekebilir.

Bu adımları şu öğeler için tekrarlayın: salesInvoice, salesInvoiceLine, salesOrder, salesOrderLine, salesQuote, salesQuoteLine, salesShipment ve salesShipmentLine. Her birinin etkinleştirilmesi birkaç dakika sürecektir.

Görünür/azalan olarak sıralamayı değiştirin ve bu tabloların tümünü gördüğünüzü doğrulayın. Şu anda daha fazla Sanal Tablo eklemeyin. Ekranı olduğu gibi bırakabilirsiniz (geri döneceğiz) ve yeni bir sekme açabilirsiniz.

Adım 5: Business Central Entegrasyon Uygulama Kullanıcısını Doğrulayın

Business Central-Dataverse senkronizasyon izinleri zarar görmüş görünüyorsa, Business Central'da Dataverse Bağlantı Kurulumu açın ve Entegrasyon Çözümünü Yeniden Dağıt seçeneğini kullanın. Bu, Microsoft'un entegrasyon çözümünü geri yükler ve Business Central entegrasyon güvenlik rolünü dağıtır.

Bağlantı testi başarılı olduktan ve Business Central entegrasyon uygulama kullanıcısı Microsoft'un Business Central Dataverse Entegrasyonu rolüne sahip olduktan sonra devam edin.

Adım 6: Kayıt Eşlemesi ve Bağlama Ayarlayın

MÜŞTERİ'den önce yapılandırılacak referans eşlemeleri

• PARA BİRİMİ: Business Central Para Birimi → Dataverse İşlem Para Birimi. Yön Business Central'dan Dataverse'e olmalıdır. Bu etkin alan eşlemelerini doğrulayın: Kod → Para Birimi Kodu, Sembol → Para Birimi Sembolü ve Açıklama → Para Birimi Adı.
• MÜŞTERİ eşlemesinin Para Birimi Kodu → Para Birimi içerdiğini doğrulayın. Müşterilerden önce para birimlerini senkronize edin. Dataverse temel para birimi ve Business Central yerel para birimi aynı olmalı ve gerekli döviz kurları mevcut olmalıdır.
• Ödeme Koşulları: müşteri testinden önce Hesap Ödeme Koşullarına senkronize edin.
• Gönderim Yöntemi: müşteri testinden önce Hesap Nakliye Koşullarına senkronize edin.
• Gönderim Acentesi: müşteri testinden önce Hesap Nakliye Yöntemine senkronize edin.

Müşteri oluşturma politikası

Hesaplar/şirketler her iki tarafta da oluşturulabiliyorsa MÜŞTERİ'yi Çift Yönlü olarak ayarlayın. Ardından müşteri dağıtım kararı olarak Yalnızca Bağlı Kayıtları Senkronize Et politikasını seçin:

Otomatik müşteri oluşturma ve eşleme

1. Müşteri yerel otomatik oluşturma seçerse, CUSTOMER üzerinde Bidirectional ayarlayın ve Sync. Only Coupled Records'i Kapalı olarak ayarlayın. Sync New Account to BC kapalı tutun.
2. Disable Event-driven Synch. Job Rescheduling işaretlenmemiş bırakın.
3. CUSTOMER entegrasyon-tablosu filtresinin seçili Company System ID içerdiğinden emin olun. Yalnızca kasıtlı olarak desteklenen eski veya atanmış Dataverse satırlarını içeren 00000000-0000-0000-0000-000000000000 içerenleri ekleyin.
4. CUSTOMER entegrasyon eşitleme işinin var olduğundan ve aralığının müşterinin ihtiyaçlarını karşıladığından emin olun. İşlemler arasında On Hold with Inactivity Timeout beklenen bir durumdur; 30-dakikalık aralık gerçek zamanlı değildir.
5. Geniş çaplı eşitlemeden önce, her iki tarafta zaten mevcut olan kayıtları manuel olarak eşleyin veya eşleşmeye dayalı eşleme kriterlerini ve sonuçlarını dikkatlice inceleyin. Otomatik oluşturma her mevcut çifti güvenle tanımlamaz.

Eşleme, Business Central müşteri numarası değil, entegrasyon GUID kullanır. Numara, görüntüleme ve arama için faydalıdır; Dataverse içinde göstermek için, CUSTOMER alan eşlemelerini Business Central No.'den Dataverse Hesap No.'ya doğrulayın.

Seçenek-değer doğrulaması

Business Central enum değer kimlikleri, Ödeme Koşulları, Gönderim Yöntemi ve Gönderim Acentesi için kullanılan, karşılık gelen Dataverse seçenek kimlikleriyle eşleşmelidir. Yalnızca görüntü metni veya kod etiketi yeterli değildir. Business Central'da Dataverse'te bulunmayan özel enum değerleri olduğunda, tam bir senkronizasyon bir kimlik uyumsuzluğunu düzeltmez.

1. Ödeme Koşulları, Gönderim Yöntemi ve Gönderim Acentesi için Değiştirilen Kayıtları Senkronize Et çalıştırın.
2. MÜŞTERİ'yi test etmeden önce Dataverse Seçenek Eşlemesi ve senkronizasyon hata günlüğünü inceleyin.
3. Kimlikler uyumlu değilse, MÜŞTERİ alan eşlemelerinde güvenli varsayılanı kullanın: Ödeme Koşulları Kodu → Ödeme Koşulları = FromIntegrationTable; Gönderim Yöntemi Kodu → Adres 1: Nakliye Koşulları = FromIntegrationTable; Gönderim Acentesi Kodu → Adres 1: Nakliye Yöntemi = FromIntegrationTable.
4. Bu üç alanı yalnızca bir geliştirici her iki tarafta da eşleşen seçenek kimlikleri ekledikten sonra Çift Yönlü olarak değiştirin.
5. Kurulum sırasında seçenek kimlikleri icat etmeyin veya yeniden numaralandırmayın. Özel Dataverse değerleri ve Business Central enum uzantıları tam olarak aynı kimlikleri kullanmalıdır.

Bu CUSTOMER alan eşlemeleri için, FromIntegrationTable yalnızca Dataverse → Business Central anlamına gelir. Bu, Business Central eşlememiş seçenek kimliklerinin Business Central → Dataverse oluşturmayı engellemesini önlerken hesap/müşteri oluşturmayı iki yönlü tutar.

Tarayıcınızda açık bıraktığımız Business Central sekmesine geri dönün.

1. “Entegrasyon” sekmesine tıklayın
2. ardından “Entegrasyon Tablo Eşlemeleri”

Müşteri kararı: müşteri Microsoft'un standart Dataverse-kullanıcıdan-Business-Central-satış temsilcisine senkronizasyonunu istiyorsa SATIŞ TEMSİLCİLERİni tutun. Bu standart senkronizasyon kasıtlı olarak kullanılmadığında yalnızca bu eşlemeyi silin veya devre dışı bırakın.

1. İLETİŞİM'i seçin
2. Bağlamayı seçin
3. Ardından “Eşleşme Tabanlı Bağlama”ya tıklayın.
4. Yukarıdakiyle eşleştirin ve Tamam'a tıklayın

1. PARA BİRİMİ'ni seçin
2. Bağlamayı seçin
3. Ardından “Eşleşme Tabanlı Bağlama”ya tıklayın.
4. Yukarıdakiyle eşleştirin ve Tamam'a tıklayın

CUSTOMER için, Eşleme/Alanlar'ı seçin, ardından Listeyi Düzenle üzerine tıklayın. Müşteri numarasının Dataverse hesapta görünmesi gerekiyorsa, Business Central No.'dan Dataverse Hesap No. için eşlemeyi etkinleştirin. Bu, entegrasyon-GUID eşlemesini değiştirmez.

Hala MÜŞTERİ için, Bağlama/Eşleşme Tabanlı Bağlama'yı seçin. Ekran görüntüsünde gösterilen müşteri/hesap tanımlayıcı alanlarını kullanarak eşleştirin ve eşleşen alanların her iki tarafta da aynı müşteriyi benzersiz şekilde tanımladığını doğrulayın.

ÖDEME KOŞULLARI için, Bağlama/Eşleşme Tabanlı Bağlama'yı seçin. Business Central ödeme koşulu kayıtlarını, yapılandırılmış kimliklerle karşılık gelen Dataverse ödeme koşulu seçenek değerleriyle eşleştirin.

GÖNDERİM YÖNTEMİ için, Bağlama/Eşleşme Tabanlı Bağlama'yı seçin. Business Central gönderim yöntemlerini, yapılandırılmış kimliklerle karşılık gelen Dataverse nakliye koşulu seçenek değerleriyle eşleştirin.

GÖNDERİM ACENTESİ için, Bağlama/Eşleşme Tabanlı Bağlama'yı seçin. Business Central gönderim acentelerini, yapılandırılmış kimliklerle karşılık gelen Dataverse gönderim yöntemi seçenek değerleriyle eşleştirin.

TEDARİKÇİ için Eşleme/Alanları Seçin
1. “Listeyi Düzenle”yi seçin
2. ve “etkinleştir” Hesap numarası.

Hala TEDARİKÇİ için, Bağlama/Eşleşme Tabanlı Bağlama'yı seçin. Ekran görüntüsünde gösterilen tedarikçi/hesap tanımlayıcı alanlarını kullanarak eşleştirin ve eşleşen alanların her iki tarafta da aynı tedarikçiyi benzersiz şekilde tanımladığını doğrulayın.

Adım 7: Ortamları Bağlayın (İsteğe Bağlı)

Birinin ortamları yanlışlıkla silmesini önlemek için, onları bağlayabilirsiniz. Business Central'dan başlayın.

1. Dişli simgesini seçin
2. Ardından Yönetim Merkezi'ni seçin

Hedef ortam bağlantısını seçin

“Bağla”ya tıklayın ve Dataverse ortamınızı seçin

Adım 8: AppSource'tan RapidStart CRM için Business Central Eklentisini Yükleyin

Microsoft'un AppSource'unu açmak ve iş hesabınızla oturum açtığınızı doğrulamak için bu bağlantıya tıklayın.

Yüklemeyi başlatmak için “Şimdi al” seçeneğini seçin.

1. Sanal Tablolar çözümünü yüklediğiniz ortamı seçin.
2. Şartları kabul edin.
3. Yükle'ye tıklayın. Yüklemenin tamamlanması birkaç dakika sürebilir.

Çözümün “Yükleniyor” olduğunu göreceksiniz. Bu, tamamlanması birkaç dakika sürebilir. “Yüklendi” olduğunu görene kadar ara sıra “yeni sayfa”ya tıklayın.

Adım 9: RapidStart Ayarları uygulamasında tamamlayın

RapidStart CRM'e gidin ve RapidStart Ayarları Uygulamasını seçin.

RapidStart Ayarları uygulamasını RapidStart CRM'deki Uygulama Seçicisinden veya üretici portalından açabilirsiniz:
1. Kenar çubuğunda Uygulamalar'ı seçin.
2. RapidStart Ayarları uygulaması için Çalıştır simgesine tıklayın.

1. RapidStart Ayarları Uygulamasında olduğunuzu doğrulayın.
2. Kenar çubuğunda “Uygulamalar ve Eklentiler” seçeneğini seçin.
3. Business Central Eklentisi için “Yapılandır” seçeneğine tıklayın.

Öncelikle Connections açın. AppSource manuel bir çözüm içe aktarması sırasında kullanılan bağlantı eşleştirme istemini göstermez. Sihirbaz bağlantı durumunu rapor eder ancak bağlantılar oluşturmaz veya bağlantı referanslarını bağlamaz.

1. Connections seçeneğinde, Configure'i Microsoft Dataverse bağlantı referansı için seçin. Bu, Power Apps'yi açar.
2. Aynı Dataverse ortamını seçin, ardından Solutions → RapidStart BC Addon → Connection references'yi açın. Microsoft Dataverse referansına geçerli bir bağlantı atayın ve kaydedin.
3. Dynamics 365 Business Central bağlantı referansı için Configure'i tekrarlayın. Power Apps içinde, bu referansa geçerli bir Business Central bağlantısı atayın ve kaydedin.
4. RapidStart Settings sihirbazına geri dönün ve Refresh'i seçin. Her iki referansın da canlı bağlantılara bağlı olduğundan emin olun.
5. Hâlâ Connections içindeyken, BC Environment'yı Business Central ortam adı ve BC Company System ID'yı Adım 3'da alınan Company System ID GUID olarak kaydedin, düzenlenebilir şirket adını değil.
6. Gerekli bağlantılar ve ayarlar hazır olduğunda, Automations'yı açın ve önerilen akışları etkinleştirin. Sync New Account to BC ve Sync New Contact to BC kapalı tutun, müşteri bu oluşturma yollarını seçmediyse. Yerel CUSTOMER eşitleme müşteri oluşturmayı sahiplendiğinde, Sync New Account to BC kapalı tutun.

Dağıtımdan önce doğrulayın

Geniş çaplı eşitlemeden önce küçük, kontrollü bir test yapın. Aşağıdaki oluşturma testleri yerel otomatik oluşturmanın seçildiği durumlarda geçerlidir. Sync. Only Coupled Records açık ise, test kayıtlarını önce eşleyin ve otomatik oluşturma beklemek yerine güncellemeleri doğrulayın.

1. Hedef Dataverse ortamını, Business Central ortamını ve Company System ID'yi doğrulayın; Business Central aracılığıyla Dataverse bağlantısını sınayın.
2. Oluşturma sahibini doğrulayın. Yerel otomatik oluşturma için, testten önce Sync New Account to BC kapalı tutun.
3. CURRENCY, PAYMENT TERMS, SHIPMENT METHOD ve SHIPPING AGENT'yi yapılandırın ve senkronize edin. Dataverse Option Mapping ve eşleşme hatalarını kontrol edin. Seçenek kimlikleri uyumlu değilse, Adım 6'de açıklanan üç CUSTOMER seçenek alanı eşlemeleri için FromIntegrationTable kullanın.
4. CUSTOMER'in Bidirectional olduğunu doğrulayın ve seçilen Sync. Only Coupled Records politikasını onaylayın. Otomatik oluşturma için, kapalı olarak ayarlayın ve Disable Event-driven Synch. Job Rescheduling işaretlenmemiş bırakın.
5. CUSTOMER şirket filtrelerini gözden geçirin, iş kuyruğu girişinin var olduğundan emin olun ve eşitleme aralığını not edin. Bilinen mevcut çiftleri manuel olarak eşleyin; eşleşmeye dayalı eşleme sonuçlarını kabul etmeden önce inceleyin.
6. İlk kontrollü test için tam bir eşitleme yerine Synchronize Modified Records'ı çalıştırın. Integration Synchronization Jobs'yu inceler ve hataları genişletmeden önce giderin.
7. CUSTOMER filtrelerini karşılayan, özel olarak adlandırılmış bir Dataverse hesabı oluşturun ve Business Central müşteri numarası eklemeyin. Senkronizasyonu çalıştırın veya bekleyin. Bir Business Central müşterisinin atanan bir müşteri numarasına sahip Coupled to Dataverse = Yes ile birlikte oluşturulduğundan emin olun.
8. Dataverse hesabında eşlenmiş bir alanı değiştirin; bir sonraki eşitlemeyi çalıştırın veya bekleyin ve eşlenmiş Business Central müşteri güncellemelerini doğrulayın.
9. Belirlenen filtreleri karşılayan, özel olarak adlandırılmış bir Business Central müşterisi oluşturun. Eşlenen Dataverse hesabının oluşturulduğunu doğrulayın; Business Central'de bir eşlenmiş alanı değiştirin ve Dataverse güncellemesini doğrulayın.
10. Temel olmayan bir para birimi ile bir müşteri test edin. Para birimi haritalamanın ve döviz kurlarının geçerli olduğundan emin olun.
11. Hesap geçerli bir Business Central müşterisiyle eşlendikten sonra yalnızca teklif oluşturulmasını test edin.
12. Filtreleri, referans verilerini, seçenek eşlemelerini, mevcut çiftleri ve hata günlüklerini incelemeden tam bir eşitleme çalıştırmayın.

Sorun Giderme

Eksik bağlantı kimlikleri

Power Apps'deki bağlantı referanslarını onarın: aynı Dataverse ortamını seçin, ardından Solutions → RapidStart BC Addon → Connection references. Geçerli Microsoft Dataverse ve Dynamics 365 Business Central bağlantıları atayın ve kaydedin. RapidStart Settings sihirbazına dönün ve Refresh'yi seçin, ardından Automations altında gerekli akışı yeniden etkinleştirin. Sihirbaz bağlantı bağlamalarını onarmaz. Sadece bir bağlantıyı oluşturmak yeterli değildir, eğer referansı hala eski bağlantıya işaret ediyorsa.

Para birimi eşleme hataları

Hata: Table CRM Transactioncurrency must be mapped to table Currency to transfer value between fields TransactionCurrencyId and Currency Code.

CUSTOMER eşlemesi Dataverse Para Birimi'ni referans alır, ancak CURRENCY eşlemesi veya Kod → Para Birimi Kodu alan eşlemesi eksik, devre dışı veya referans alınan para birimini senkronize etmememiş olabilir.

1. CURRENCY eşlemesini geri yükleyin veya oluşturun ve yönünü Business Central'dan Dataverse'e olarak ayarlayın.
2. Kod → Para Birimi Kodu'u etkinleştirin ve para birimlerini senkronize edin.
3. Müşterinin para biriminin Dataverse'de mevcut olduğunu doğrulayın, ardından CUSTOMER senkronizasyonunu yeniden deneyin.

Seçenek uyumsuzlukları

Örnek: The value 100000003 of 'paymenttermscode' on record of type 'account' is outside the valid range. Accepted Values: 1,2,3,4.

Business Central, Dataverse Hesap Ödeme Koşulları seçeneğinde mevcut olmayan özel bir Ödeme Koşulları enum kimliği gönderdi.

1. Geçerli Dataverse seçim kimlikleri ile Dataverse Option Mapping karşılaştırın.
2. Seçenek her iki yöne de senkronize olmalıysa, bir geliştirici Dataverse seçim değerlerini ve aynı sayısal kimliklerle Business Central enum uzantı değerlerini eklesin. Ayarlama sırasında kimlik icat etmeyin veya yeniden numaralandırmayın.
3. Aksi durumda, CUSTOMER Ödeme Koşulları Kodu alan eşlemesini FromIntegrationTable olarak ayarlayın. Aynı kontrolü Nakliye Yöntemi ve Kargo Acentesi için uygulayın.
4. Bir müşteriyi yeniden deneyin ve Business Central Hesap eyleminin eşlenen Dataverse hesabını açtığını doğrulayın.

Silinmiş kayıtlara işaret eden bağlamalar

Bir kayıt bağlı görünüyor ancak senkronizasyon silinmiş veya eksik bir kayda işaret ediyorsa, Business Central'da eski bağlamayı kaldırın ve senkronizasyonu yeniden çalıştırmadan önce doğru Dataverse hesap veya iletişim bilgisine yeni bir bağlama oluşturun.

Microsoft referansları

• Business Central ve Dataverse'ü Senkronize Edin
• Eşitleme işleri zamanlayın
• Dataverse bağlantısı ayarlayın
• Eksik Dataverse seçim değerlerini işleyin