Aracılığıyla paylaş

Toplu geçiş aracını (BAM) kullanarak abonelikleri yeni ticaret deneyimine geçirme

  • Makale

Toplu geçiş aracını (BAM) kullanarak çok sayıda aboneliği yeni ticaret deneyimine (NCE) verimli bir şekilde geçirebilirsiniz.

(.NET SDK sürüm 3.0.1'den Geçiş API'sini kullanarak abonelik toplu işlemlerini de geçirebilirsiniz).

Önemli

Haziran 2023 itibarıyla en son İş Ortağı Merkezi .NET SDK sürümü 3.4.0 arşivlenmiştir. SDK sürümünü, yararlı bilgiler içeren bir benioku dosyasıyla birlikte GitHub'dan indirebilirsiniz.

İş ortaklarının İş Ortağı Merkezi REST API'lerini kullanmaya devam etmesi teşvik edilir.

BAM aracı:

  • Yüksek kaliteli, yinelenebilir, özelleştirilebilir toplu geçişleri destekler.
  • Geçiş düzenlemelerini yönetmek için Excel'i kullanır
  • Kod gerektirmez
  • GitHub'daki örnek kod kullanılarak indirilebilir.

Toplu geçiş aracı özellikleri

BAM aracını kullanarak şunları yapabilirsiniz:

  • Bir kiracı için tüm müşterilerin listesini alın.

  • Bir .csv dosyasında müşteri eski aboneliklerini alma.

  • Dışarı aktarılan .csv dosyasını geçiş için hazırlayın ve geçiş sırasında abonelikleri (koltuk sayısı, terim ve faturalama döngüsü değişiklikleri gibi) düzenleyin.

  • Aracın geçiş isteklerini yürütmesinin ardından güncelleştirilmiş bir abonelik .csv dosyasını aralığa yükleyin.

  • Geçiş isteklerinin durumunu gözden geçirin.

  • Giriş dosyasındaki tüm müşteri listesi için tüm NCE aboneliklerini indirin.

Önkoşullar

BAM aracını kullanmak için .NET 6.0 SDK gereklidir.

SDK ve örnek kod

SDK sürümleriyle ilgili ayrıntılar ve kaynaklar ile BAM aracına erişmek için kullanabileceğiniz örnek uygulama kodu için:

BAM aracını kullanma

Not

Ayrıntılı yönergeler için bkz . Toplu işlemi geçirmenin adım adım akışı.

Toplu geçiş için iş akışı seçeneklerini yüklemek için aşağıdaki adımları kullanın:

  • BAM aracını çalıştırın ve komut istemine ncebulkmigration [uygulama kimliği] {UPN Kimliği] girin.

Bu aşamada gerçekleştirebileceğiniz eylemler arasında şunlar bulunur:

  • Müşteri listesini dışarı aktarın.
  • Geçişe uygunluk ile eski abonelikleri dışarı aktarın.
  • Geçirilecek abonelikleri karşıya yükleyin.
  • Geçiş için zaten karşıya yüklenmiş toplu işlerin geçiş durumunu dışarı aktarın.
  • Yeni ticaret deneyimi aboneliklerinin listesini dışarı aktarın.

Screenshot of the bulk migration tool command line menu.

Hesap kimlik doğrulaması

BAM aracı çok kiracılı uygulamalar için yapılandırılmamış. Kimlik doğrulamasını tamamlarken, tek kiracı yapılandırmasına sahip bir uygulamanın AppID'sini kullanın.

Microsoft, çok kiracılı uygulamalar için toplu geçişi etkinleştirme seçeneklerini değerlendiriyor.

Müşteri listesini dışarı aktarma

Müşteri listesini dışarı aktarmak için aşağıdaki adımları kullanın:

Dışarı aktarılan müşteri listesi, BAM aracının klasörlerinin çıkış dosyasına kaydedilir.

Dışarı aktarılan müşterileri customers.csv dosyasında görüntüleyin.

İş ortağı kiracı kimliği altındaki her müşteri için şunları görüntüleyebilirsiniz:

  • Müşteri kiracısı kimliği
  • Müşteri etki alanı
  • Müşteri şirket adı

Belirli müşteriler için aboneliklere erişme

İndirilen customers.csv dosyasından bir sonraki dosya indirmesinde aboneliklerini dışarı aktarmak istemediğiniz müşteri satırlarını kaldırabilirsiniz. Dosyada kalan müşterilerin, BAM aracının iş akışındaki bir sonraki adım sırasında geçişe uygunluk durumu doğrulanır.

  • Belirtilen müşteriler için abonelik alma işleminin sonraki adımını yürütebilmeniz için güncelleştirilmiş customers.csv dosyasını giriş klasörüne kaydedin.
    • Giriş klasöründe iki iç içe klasör vardır: geçişler ve abonelikler.
    • customers.csv dosyasını iç içe klasörlere yerleştirmeyin. Giriş klasöründe tutun.

Geçişe uygun abonelikleri dışarı aktarmak için aşağıdaki adımları kullanın:

  • BAM aracını çalıştırın ve 2 komutunu girin.

    Araç çalışır ve aboneliklerin uygunluk için doğrulandığını gösterir. Dışarı aktarma tamamlandıktan sonra, belirtilen müşterilerin abonelik listesi, daha önce belirtilen müşteriler için tüm eski aboneliklerin (hem etkin hem de askıya alınmış) listesini sağlayan subscriptions.csv olarak çıktı klasöründe bulunur.

Her abonelik için aşağıdaki alanlar görüntülenebilir:

  • İş ortağı kiracı kimliği

  • Dolaylı Kurumsal Bayi İş Ortağı Kimliği

  • Müşteri Adı

  • Müşteri Kiracı Kimliği

  • Eski Abonelik Kimliği

  • Eski Abonelik Adı

  • Eski Ürün Adı

  • Bitiş Tarihi

  • Geçişe Uygun (Doğru veya Yanlış)

  • Geçerli Terim

  • Geçerli Faturalama Planı

  • Geçerli Koltuk Sayısı

  • Yeni Terim Başlat (NCE'de geçiş sonrası)

  • Terim (NCE'de geçiş sonrası)

  • Faturalama Planı (NCE'de geçiş sonrası)

  • Koltuk Sayısı (NCE'de geçiş sonrası)

  • Ekleme Tarihi (Doğru veya Yanlış)

  • Temel Abonelik (eklentiyse)

  • Geçiş Uygunluk Dışı Olma Nedeni (abonelik geçiş için uygun değilse)

Hangi aboneliklerin geçirileceğini ve nasıl geçirileceğini belirleme

Önceki alanları kullanarak, toplu olarak NCE'ye geçirmek istediğiniz abonelikleri belirlemek için dışarı aktarılan abonelik listesini filtreleyebilirsiniz. Örneğin, belirli bir ürün türündeki bir grup aboneliği veya belirli bir dolaylı kurumsal bayi altındaki bir grup aboneliği geçirmek için filtreleyebilirsiniz.

Abonelikleri filtreleyip seçtikten sonra toplu iş için seçilmeyen tüm abonelikleri .csv dosyasından silin. Bunu yaptığınızda istenmeyen geçişler engellenir.

Toplu iş başına en fazla 200 aboneliği dışarı aktarmanızı öneririz. (Bkz. Daha fazlasını geçirmeniz gerekiyorsa bu makalenin devamında 200'den fazla aboneliği geçirin.)

Sonraki adım aboneliklerin nasıl geçirileceğini belirtmektir (örneğin, beğenilen veya güncelleştirilmiş yeni başlangıç dönemi, faturalama sıklığı, terim süresi veya koltuk sayısı öznitelikleri).

Geçirmek istediğiniz abonelikler için satırlardaki aşağıdaki alanların üzerine yazabilirsiniz:

  • Yeni Terim Başlat

  • Terim

  • Faturalama Planı

  • Koltuk Sayısı

Önceki alanlar, NCE aboneliğinin geçiş sonrası uyması gereken yönergeleri veya öznitelikleri temsil eder. Bu alanların varsayılan değerleri, geçirilmekte olan eski aboneliklerin değerleridir. Bir alanda değişiklik yapılmazsa, ilgili NCE aboneliğinin değeri, geçirdiği eski abonelikle aynı değere sahiptir. Örneğin, geçirilen eski bir aboneliğin Geçerli Koltuk Sayısı iki ise ve Koltuk Sayısı alanında değişiklik yapılmazsa, NCE aboneliğinin geçişten sonra iki kişilik bir koltuk sayısı olur.

NCE'de yeni bir terimle abonelik başlatmak için aşağıdaki adımı kullanın:

  • Yeni Terimi Başlat bayrağını FALSE olan TRUE olarak değiştirin.

    Değerleri aşağıdaki sütunların dışında değiştirmeyin:

    • Yeni Terim Başlat
    • Terim
    • Faturalama Planı
    • Koltuk Sayısı

Geçiş için toplu iş yükleme

Toplu işlemlerin nasıl geçirildiğini belirttikten sonra (yani, geçiş için abonelikleri filtreledikten ve isterseniz güncelleştirilmiş NCE değerlerine sahip olduktan sonra), güncelleştirilmiş subscriptions.csv dosyasını giriş klasöründe iç içe yerleştirilmiş abonelikler klasörüne kaydedin. Abonelikler klasörüne kaydedilen her dosya geçirilen bir toplu işlemi temsil eder.

Abonelikler klasöründeki bir dosya geçiş için işlendikten sonra, BAM aracı bu dosyayı iç içe işlenmiş klasöre taşır ve bu da bu toplu iş için geçiş isteklerinin yürütüldüğünü gösterir. Dosyaları el ile işlenen klasöre taşımanız gerekmez. İşlenen klasördeki dosyalar, zaten işlendiği için geçişi yürütmek için BAM aracı tarafından okunmuyor.

Geçişleri karşıya yüklemek için aşağıdaki adımı kullanın:

  • Komut isteminde BAM aracını çalıştırın ve 3 seçeneğini belirleyin, geçişleri karşıya yükleyin ve ardından:

    • BAM aracı, abonelikler klasöründen toplu iş dosyalarını okur ve geçiş isteklerini yürütür.

    • Konsol penceresi, geçiş isteklerinin işlendiğini gösterir.

      Geçiş kimliklerini içeren her toplu iş için bir dosya dışarı aktarılır ve çıkış klasöründe iç içe yerleştirilmiş geçişler klasöründe bulunur.

      • Dışarı aktarılan dosyalar [batchID].csv olarak etiketlenir.
      • [batchID].csv, subscriptions.csv dosyasıyla aynı alanlara sahiptir, ancak iki sütunu daha vardır: Batch Kimliği ve Geçiş Kimliği.
      • Batch Kimliği , dosyadaki her abonelik için aynıdır ve bu aboneliklerin birlikte işlenen aynı toplu işleme veya geçiş istekleri kümesine ait olduğunu gösterir.
      • Batch Kimliği, .csv dosyasının adına da yansıtılır: [batchID].csv.

Geçiş durumunu denetle

Geçiş başarılı olursa, geçiş durumu Tamamlandı olur.

Geçiş başarısız olursa, geçiş durumu Başarısız olur ve hatanın nedenini görüntüleyebilirsiniz.

Geçiş Kimliği geçirilen her abonelik için benzersizdir, bu nedenle geçiş durumunu izlemek için Geçiş Kimliği'ni kullanabilirsiniz.

Başarılı geçişte NCE Abonelik Kimliği de doldurulur.

Toplu iş için yenilenen durum dosyasını almak için aşağıdaki adımı kullanın:

  • Dışarı aktarılan [batchID].csv dosyasını (çıktıda iç içe geçişler klasörüne aktarılır) geçişler klasörüne (giriş klasöründe iç içe yerleştirilmiştir) kopyalayın veya kaydedin.

    Bunun yapılması, aracın hangi toplu işin durumunun istendiğini okumasına ve dışarı aktarmaya yönelik raporlar hazırlamasına olanak tanır.

Durum dosyaları otomatik olarak güncelleştirilmez. Güncelleştirilmiş durumları almak için her seferinde yeni bir istek yapılmalıdır.

Güncelleştirilmiş geçiş durumlarını almak için aşağıdaki adımı kullanın:

  • BAM aracını çalıştırın ve 4 komutunu girin.

    BAM aracı çalışır ve geçiş durumunu aradığını ve bir dosyanın migrationstatus klasörüne aktarıldığını gösterir. Dışarı aktarılan geçiş durumu dosyalarının adları, CSV'lerde bulunan aboneliklerin toplu iş kimliğini temsil eder.

Migrationstatus klasörüne aktarılan [batchID].csv dosyası, işlenen geçiş istekleri için güncelleştirilmiş durumlar sağlar. Dosyada birden fazla toplu iş gösteriliyorsa, belirli bir toplu işlemdeki isteklerin durumlarına erişmek üzere filtrelemek için Batch Id sütununu kullanın.

Yeni ticaret deneyimi aboneliklerinin listesini dışarı aktarma

NCE aboneliklerini dışarı aktarmak için aşağıdaki adımı kullanın:

  • BAM aracını çalıştırın ve 5 komutunu girin.

    Dışarı aktarılan liste çıkış klasörüne kaydedilir. Bu adım geçiş için gerekli değildir, ancak bunu farklı müşteriler için NCE aboneliklerini düzenlemek için kullanabilirsiniz.

200'den fazla aboneliği geçirme

200'den fazla aboneliği (önerilen en yüksek toplu iş boyutudur) geçirmek istiyorsanız, BAM aracına birden çok toplu iş yükleyebilirsiniz. Karşıya yüklemek istediğiniz dosyaların boyutunu küçültmek için klasörleri çeşitli alanlara göre düzenleyebilirsiniz. Örneğin, geçirilecek abonelikleri şu şekilde düzenleyebilirsiniz:

  • Dolaylı kurumsal bayi
  • Ürün adı
  • Abonelik adı
  • Diğer ölçütler

Düzenlediğiniz bir toplu iş dosyası önerilen en fazla 200 abonelik boyutunu aşarsa, her toplu işlem için 200 abonelik üst sınırını korumak için abonelikleri yeni dosyalara etkili bir şekilde kopyalayarak bir .csv dosyasını birden çok dosyaya ayırabilirsiniz. Örneğin, 425 aboneliği geçirmek istiyorsanız, bunları üç ayrı dosyaya (200 abonelik içeren iki dosya ve 25 aboneliği olan başka bir dosya) bölebilirsiniz.

Birden çok dosyayı karşıya yükleme

BAM aracına aynı anda birden çok dosya yükleyebilirsiniz. Araç, geçiş isteklerini bir kerede bir toplu iş dosyası okur ve giriş dizinine kaydedilmiş diğer toplu iş dosyalarında (birden çok toplu işlem eklendiyse) otomatik olarak okumaya başlar.

BAM aracı toplu işlemleri tek tek okur ve her abonelikte Ayrı Ayrı Geçiş API'sini çağırır.

Giriş dizinine daha fazla toplu iş dosyası eklemek için bir toplu iş dosyasının yürütülmesini beklemeniz gerekmez.

Hız sınırları ve azaltma

2. komutu yürütmek için (müşterilerin aboneliklerini alma ve geçiş için bu abonelikleri doğrulama), BAM aracı Geçişi Doğrulama API'sini çağırır. Geçişi Doğrulama API'sinin hız sınırı, beş dakika içinde iş ortağı başına 450 çağrı ve müşteri birleşimidir. Bu hız sınırı ve Geçişi Doğrulama API'sinin geçerli gecikme süresiyle, BAM aracını çalıştırdığınızda azaltmayla karşılaşabileceğinizi tahmin etmeyeceğiz. Ayrıca araç, azaltmanın gerçekleşmediğinden emin olmak için eşzamanlılık sınırlarına sahiptir.

Ancak bir sorun oluşursa hangi müşterinin aboneliklerinin çekilmediğini ve doğrulanmadığını izleyebilirsiniz. Müşterinin abonelikleri çekilemiyorsa veya abonelikleri doğrularken sorunlar varsa, aracın çıkış klasöründe failedCustomers.csv adlı ayrı bir .csv görüntülenir. Bu müşteriler için abonelikleri çekmeyi ve doğrulamayı yeniden deneyebilirsiniz.

Not

Lisans tabanlı hizmetler için Yeni ticaret deneyimleri birçok yeni özellik içerir ve tüm Bulut Çözümü Sağlayıcısı (CSP' ler) tarafından kullanılabilir. Daha fazla bilgi için bkz . Lisans tabanlı hizmetler için yeni ticaret deneyimi.

Sonraki adımlar

  • BAM aracını kullanma hakkında ayrıntılı yönergeler için bkz . Toplu işlemi geçirmenin adım adım akışı.