Toplu geçiş aracını (BAM) kullanarak abonelikleri yeni ticaret deneyimine geçirme
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.
.csv dosyasında müşteri eski aboneliklerini alma.
Geçiş sırasında dışarı aktarılan .csv dosyasını hazırlayın ve abonelikleri (oturma sayısı, dönem ve faturalama döngüsü değişiklikleri gibi) düzenleyin.
Araç, geçiş isteklerini yürütürken 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şama, iş ortağının şunları yapmasına olanak tanır:
- 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.
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:
- BAM aracını çalıştırın ve 1 komutunu girin.
Dışarı aktarılan müşteri listesi, BAM aracının klasörlerinin çıkış dosyasına kaydedilir.
Dışarı aktarılan müşterileri dosya customers.csv 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 aboneliklerini dışarı aktarmak istemediğiniz müşteri satırlarını bir sonraki dosya indirmede 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.
- Güncelleştirilmiş customers.csv dosyasını giriş klasörüne kaydedin, böylece belirtilen müşteriler için abonelik alma işleminin sonraki adımını yürütebilirsiniz.
- Giriş klasöründe iki iç içe klasör vardır: geçişler ve abonelikler.
- customers.csv 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 işlemi 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
vIndirect Reseller PartnerID*
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ı
urrent Seat Count
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)
Geçirecek abonelikleri 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, geçiş toplu işlemlerini ürün türüne veya belirli bir dolaylı kurumsal bayiye göre filtreleyebilirsiniz.
İş ortakları, geçirilmesini istemedikleri .csv toplu işleminden abonelikleri kaldırabilir.
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. Geçişe hangi özelliklerin uygulanacağını iş ortakları belirler.
Geçirmek istediğiniz abonelikler için satırlardaki aşağıdaki alanların üzerine yazabilirsiniz:
Yeni Terim Başlat
Süre
Faturalama Planı
Koltuk Sayısı
Önceki alanlar, NCE aboneliğinin geçiş sonrası için bağlı olduğu 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
- Süre
- Faturalama Planı
- Koltuk Sayısı
Geçiş için toplu iş yükleme
Güncelleştirilmiş subscriptions.csv dosyasını giriş klasörüne 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ünden bir dosya işlenip geçiş için yürütüldükten sonra, BAM aracı bu dosyayı iç içe işlenmiş klasöre taşır. Dosyaları el ile işlenen klasöre taşımanız gerekmez. BAM aracı, işlenmiş klasördeki dosyaları zaten işlendiği için kategorilere ayırıyor.
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 giriş subscriptions.csv dosyasıyla aynı alanlara sahiptir, ancak iki sütunu daha vardır: Toplu İş 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ı output/migrations klasöründen input/migrations klasörüne kopyalayın veya kaydedin.
Bunun yapılması, aracın hangi toplu işin durumunun istendiği okumasına ve raporları dışarı aktarmaya 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 durumu migrationstatus klasörüne aktardığını gösterir. Dışarı aktarılan geçiş durumu dosyalarının adları, .csv dosyalarında yer alan 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:
- Dolaylı kurumsal bayi
- Ürün adı
- Abonelik adı
- Diğer ölçütler
Önerilen maksimum 200 abonelik boyutunu aşan batch dosyaları ayrı .csv dosyalarına ayrılabilir.
Birden çok dosyayı karşıya yükleme
BAM aracına aynı anda birden çok dosya yükleyebilirsiniz. Araç, giriş dizinindeki tüm dosyaları işlemeyi bitirene kadar geçiş isteklerini bir kerede bir toplu iş dosyası okur.
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 iş ortaklarının çoğu azaltma deneyimi yaşamaz. İş ortakları, azaltmanın gerçekleşmediğinden emin olmak için eşzamanlılık sınırlarını artırabilir.
Ancak bir sorun oluşursa hangi müşterinin aboneliklerinin çekilmediğini ve doğrulanmadığını izleyebilirsiniz. Müşterinin abonelikleri çekilemiyorsa veya başka doğrulama sorunları varsa aracın çıkış klasöründe failedCustomers.csv başlıklı 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.
- BAM aracını kullanma hakkında ayrıntılı yönergeler için bkz . Toplu işlemi geçirmenin adım adım akışı.