Migrowanie subskrypcji do nowego środowiska handlowego przy użyciu narzędzia do migracji wsadowej (BAM)

Artykuł
10/23/2023

Możesz wydajnie migrować dużą liczbę subskrypcji do nowego środowiska handlowego (NCE) przy użyciu narzędzia do migracji wsadowej (BAM).

(Można również migrować partie subskrypcji przy użyciu interfejsu API migracji z zestawu .NET SDK w wersji 3.0.1).

Ważne

Od czerwca 2023 r. najnowsza wersja zestawu .NET SDK Centrum partnerskiego 3.4.0 jest teraz archiwizowana. Możesz pobrać wersję zestawu SDK z usługi GitHub wraz z plikiem readme zawierającym przydatne informacje.

Zachęcamy partnerów do dalszego korzystania z interfejsów API REST Centrum partnerskiego.

Narzędzie BAM:

Obsługuje wysokiej jakości, powtarzalne i dostosowywane migracje wsadowe.
Zarządzanie edycjami migracji przy użyciu programu Excel
Nie wymaga kodu
Można pobrać przy użyciu przykładowego kodu w witrynie GitHub.

Możliwości narzędzia do migracji wsadowej

Za pomocą narzędzia BAM można wykonywać następujące czynności:

Pobierz listę wszystkich klientów dla dzierżawy.
Pobierz starsze subskrypcje klienta w pliku CSV.
Przygotuj plik CSV do migracji i edytuj subskrypcje (takie jak zmiany liczby miejsc, terminów i cyklu rozliczeniowego) podczas migracji.
Przekaż zaktualizowany plik CSV subskrypcji do narzędzia, po którym narzędzie wykonuje żądania migracji.
Przejrzyj stan żądań migracji.
Pobierz wszystkie subskrypcje usługi NCE dla wszystkich klientów w pliku wejściowym.

Wymagania wstępne

Zestaw .NET 6.0 SDK jest wymagany do korzystania z narzędzia BAM.

Zestaw SDK i przykładowy kod

Aby uzyskać szczegółowe informacje i zasoby dotyczące wersji zestawu SDK oraz przykładowy kod aplikacji, którego można użyć do uzyskania dostępu do narzędzia BAM:

Korzystanie z narzędzia BAM

Uwaga

Aby uzyskać szczegółowe instrukcje, zobacz Przepływ krok po kroku dotyczący migrowania partii.

Aby załadować opcje przepływu pracy migracji wsadowej, wykonaj następujące kroki:

Uruchom narzędzie BAM i w wierszu polecenia wprowadź ciąg ncebulkmigration [identyfikator aplikacji] {IDENTYFIKATOR NAZWY UPN].

Wśród akcji, które można wykonać na tym etapie, są:

Eksportowanie listy klientów.
Eksportowanie starszych subskrypcji z uprawnieniami do migracji.
Przekazywanie subskrypcji do migracji.
Wyeksportuj stan migracji partii, które zostały już przekazane do migracji.
Wyeksportuj listę nowych subskrypcji środowiska handlowego.

Uwierzytelnianie konta

Narzędzie BAM nie jest skonfigurowane dla aplikacji wielodostępnych. Podczas kończenia uwierzytelniania użyj identyfikatora AppID aplikacji z konfiguracją pojedynczej dzierżawy.

Firma Microsoft ocenia opcje włączania migracji wsadowej dla aplikacji wielodostępnych.

Eksportowanie listy klientów

Aby wyeksportować listę klientów, wykonaj następujące kroki:

Uruchom narzędzie BAM i wprowadź polecenie 1.

Wyeksportowana lista klientów jest zapisywana w pliku wyjściowym folderów narzędzia BAM.

Wyświetl wyeksportowanych klientów w pliku customers.csv.

Dla każdego klienta w ramach identyfikatora dzierżawy partnera można wyświetlić:

Identyfikator dzierżawy klienta
Domena klienta
Nazwa firmy klienta

Uzyskiwanie dostępu do subskrypcji dla wybranych klientów

Możesz usunąć wiersze klientów z pobranego pliku customers.csv , którego subskrypcje nie chcesz eksportować w następnym pobraniu pliku. Klienci, którzy pozostają w pliku, są weryfikowani pod kątem uprawnień do migracji w następnym kroku przepływu pracy narzędzia BAM.

Zapisz zaktualizowany plik customers.csv w folderze input , aby można było wykonać następny krok odbierania subskrypcji dla określonych klientów.
- Folder wejściowy ma dwa zagnieżdżone foldery, migracje i subskrypcje.
- Nie umieszczaj pliku customers.csv w zagnieżdżonych folderach. Zachowaj je w folderze wejściowym.

Aby wyeksportować subskrypcje z uprawnieniami do migracji, wykonaj następujące kroki:

Uruchom narzędzie BAM i wprowadź polecenie 2.

Narzędzie działa i wskazuje, że subskrypcje są weryfikowane pod kątem uprawnień. Po zakończeniu eksportowania lista subskrypcji dla określonych klientów jest dostępna w folderze wyjściowym jako subscriptions.csv, który zawiera listę wszystkich starszych subskrypcji (zarówno aktywnych, jak i zawieszonych) dla klientów wcześniej określonych.

Dla każdej subskrypcji można wyświetlić następujące pola:

Identyfikator dzierżawy partnera
Identyfikator partnera odsprzedawcy pośredniego
Nazwa klienta
Identyfikator dzierżawy klienta
Starszy identyfikator subskrypcji
Starsza nazwa subskrypcji
Starsza nazwa produktu
Data wygaśnięcia
Migracja kwalifikują się (prawda lub fałsz)
Bieżący termin
Bieżący plan rozliczeniowy
Bieżąca liczba miejsc
Rozpocznij nowy termin (po migracji w usłudze NCE)
Termin (po migracji w usłudze NCE)
Plan rozliczeniowy (po migracji w usłudze NCE)
Liczba miejsc (po migracji w usłudze NCE)
Dodaj włączone (prawda lub fałsz)
Subskrypcja podstawowa (jeśli dodatek)
Przyczyna niekwalifikowaności migracji (jeśli subskrypcja nie kwalifikuje się do migracji)

Określanie, które subskrypcje zostaną zmigrowane i jak

Korzystając z powyższych pól, można filtrować wyeksportowaną listę subskrypcji, aby określić, które subskrypcje mają zostać zmigrowane do usługi NCE w partii. Na przykład można filtrować, aby przeprowadzić migrację partii subskrypcji określonego typu produktu lub partii subskrypcji w ramach określonego odsprzedawcy pośredniego.

Po przefiltrowanej i wybranej subskrypcji usuń wszystkie subskrypcje, które nie zostały wybrane dla partii z pliku CSV. Uniemożliwia to niezamierzone migracje.

Zalecamy eksportowanie nie więcej niż 200 subskrypcji na partię. (Zobacz Migrowanie więcej niż 200 subskrypcji w dalszej części tego artykułu, jeśli chcesz przeprowadzić migrację więcej.

Następnym krokiem jest określenie sposobu migrowania subskrypcji (na przykład takich jak lubię lub zaktualizowanych atrybutów rozpoczęcia nowego terminu, częstotliwości rozliczeń, czasu trwania terminu lub liczby miejsc).

W wierszach dla subskrypcji, które mają zostać zmigrowane, możesz zastąpić następujące pola:

Rozpocznij nowy termin
Termin
Plan rozliczeniowy
Liczba miejsc

Powyższe pola reprezentują instrukcje lub atrybuty, które subskrypcja usługi NCE będzie stosować się do po migracji. Wartości domyślne dla tych pól to wartości migrowanych starszych subskrypcji. Jeśli żadne zmiany nie zostaną wprowadzone w polu, odpowiednia subskrypcja usługi NCE ma taką samą wartość jak starsza subskrypcja migrowana z. Jeśli na przykład migrowana starsza subskrypcja ma bieżącą liczbę miejsc i nie zostaną wprowadzone żadne zmiany w polu Liczba miejsc, subskrypcja NCE będzie miała liczbę miejsc po migracji.

Aby rozpocząć subskrypcję z nowym terminem w usłudze NCE, wykonaj następujący krok:

Zmień flagę Rozpocznij nowy termin z FALSE na TRUE.

Nie zmieniaj wartości poza następującymi kolumnami:
- Rozpocznij nowy termin
- Termin
- Plan rozliczeniowy
- Liczba miejsc

Przekazywanie partii do migracji

Po określeniu sposobu migrowania wsadowego (czyli po przefiltrowanych subskrypcjach pod kątem migracji i zaktualizowaniu wartości NCE, w razie potrzeby), zapisz zaktualizowany plik subscriptions.csv w folderze subscriptions, który jest zagnieżdżony w folderze wejściowym. Każdy plik zapisany w folderze subscriptions reprezentuje partię do migracji.

Po przetworzeniu pliku z folderu subskrypcji na potrzeby migracji narzędzie BAM przenosi ten plik do zagnieżdżonego przetworzonego folderu, co wskazuje, że żądania migracji dla tej partii zostały wykonane. Nie trzeba ręcznie przenosić plików do przetworzonego folderu. Pliki w przetworzonym folderze nie są odczytywane przez narzędzie BAM do wykonania migracji, ponieważ zostały już przetworzone.

Aby przekazać migracje, wykonaj następujący krok:

W wierszu polecenia uruchom narzędzie BAM i wybierz opcję 3, przekaż migracje, po czym:
- Narzędzie BAM odczytuje pliki wsadowe z folderu subscriptions i wykonuje żądania migracji.
- Okno konsoli wskazuje, że żądania migracji są przetwarzane.
  
  Plik dla każdej partii zawierającej identyfikatory migracji jest eksportowany i jest dostępny w folderze migracji zagnieżdżonym w folderze wyjściowym.
  - Wyeksportowane pliki są oznaczone etykietą [batchID].csv.
  - [batchID].csv ma te same pola co wejściowy plik subscriptions.csv , ale z dwiema kolumnami: Identyfikator partii i Identyfikator migracji.
  - Identyfikator usługi Batch jest taki sam dla każdej subskrypcji w pliku, co wskazuje, że te subskrypcje należą do tej samej partii lub zestawu żądań migracji, które zostały przetworzone razem.
  - Identyfikator usługi Batch jest również odzwierciedlony w nazwie pliku CSV: [batchID].csv.

Sprawdzanie stanu migracji

Jeśli migracja zakończy się pomyślnie, jego stan migracji to Ukończono.

Jeśli migracja nie powiedzie się, jej stan migracji to Niepowodzenie i możesz wyświetlić przyczynę niepowodzenia.

Identyfikator migracji jest unikatowy dla każdej migrowanej subskrypcji, więc możesz użyć identyfikatora migracji do śledzenia stanu migracji.

Identyfikator subskrypcji usługi NCE jest również wypełniany po pomyślnej migracji.

Aby pobrać odświeżony plik stanu dla partii, wykonaj następujący krok:

Skopiuj lub zapisz wyeksportowany plik [batchID].csv (który jest eksportowany do folderu migracji zagnieżdżonego w danych wyjściowych) do folderu migracji (który jest zagnieżdżony w folderze wejściowym).

Dzięki temu narzędzie może odczytać stan partii i przygotować raporty do wyeksportowania.

Pliki stanu nie są aktualizowane automatycznie. Aby pobrać zaktualizowane stany, należy za każdym razem wykonać nowe żądanie.

Aby pobrać zaktualizowane stany migracji, wykonaj następujący krok:

Uruchom narzędzie BAM i wprowadź polecenie 4.

Narzędzie BAM działa i wskazuje, że szuka stanu migracji i że plik został wyeksportowany do folderu migrationstatus . Nazwy wyeksportowanych plików stanu migracji reprezentują identyfikator partii subskrypcji zawartych w woluminach CSV.

Plik [batchID].csv wyeksportowany do folderu migrationstatus zawiera zaktualizowane stany żądań migracji, które zostały przetworzone. Jeśli w pliku jest reprezentowanych więcej niż jedna partia, użyj kolumny Identyfikator usługi Batch, aby filtrować, aby uzyskać dostęp do stanów żądań w określonej partii.

Eksportowanie listy nowych subskrypcji środowiska handlowego

Aby wyeksportować subskrypcje usługi NCE, wykonaj następujący krok:

Uruchom narzędzie BAM i wprowadź polecenie 5.

Wyeksportowana lista jest zapisywana w folderze wyjściowym. Ten krok nie jest wymagany do migracji, ale można go użyć do organizowania subskrypcji usługi NCE dla różnych klientów.

Migrowanie ponad 200 subskrypcji

Jeśli chcesz przeprowadzić migrację ponad 200 subskrypcji (co jest maksymalnym zalecanym rozmiarem partii), możesz przekazać wiele partii do narzędzia BAM. Foldery można organizować według różnych pól, aby zmniejszyć rozmiar plików, które mają zostać przekazane. Na przykład można organizować subskrypcje, które mają być migrowane przez:

Odsprzedawca pośredni
Nazwa produktu
Nazwa subskrypcji
Inne kryteria

Jeśli zorganizowany plik wsadowy przekracza maksymalny zalecany rozmiar 200 subskrypcji, możesz rozdzielić jeden plik CSV na wiele, skutecznie kopiując subskrypcje do nowych plików, aby zachować maksymalnie 200 subskrypcji każdej partii. Jeśli na przykład chcesz przeprowadzić migrację 425 subskrypcji, możesz podzielić je na trzy oddzielne pliki (dwa pliki zawierające 200 subskrypcji, a drugi z 25).

Przekazywanie wielu plików

Jednocześnie możesz przekazać wiele plików do narzędzia BAM. Narzędzie odczytuje żądania migracji jeden plik wsadowy naraz i automatycznie rozpoczyna odczytywanie w innych plikach wsadowych zapisanych w katalogu wejściowym (jeśli dodano wiele partii).

Narzędzie BAM odczytuje partie pojedynczo i wywołuje interfejs API tworzenia migracji osobno dla każdej subskrypcji.

Nie musisz czekać, aż jeden plik wsadowy zakończy wykonywanie, aby dodać więcej plików wsadowych do katalogu wejściowego.

Limity szybkości i ograniczanie przepustowości

Aby wykonać polecenie 2 (pobieranie subskrypcji dla klientów i weryfikowanie tych subskrypcji na potrzeby migracji), narzędzie BAM wywołuje interfejs API weryfikacji migracji . Limit szybkości interfejsu API weryfikacji migracji wynosi 450 wywołań na partnera i kombinację klienta w ciągu pięciu minut. W przypadku tego limitu szybkości i bieżącego opóźnienia interfejsu API weryfikacji migracji nie przewidujemy ograniczenia przepustowości podczas uruchamiania narzędzia BAM. Ponadto narzędzie ma limity współbieżności, aby upewnić się, że ograniczanie przepustowości nie występuje.

Jeśli jednak wystąpi problem, możesz śledzić, które subskrypcje klienta nie zostały ściągnięte i zweryfikowane. Jeśli nie można ściągnąć subskrypcji klienta lub występują problemy podczas walidacji subskrypcji, w folderze wyjściowym narzędzia zostanie wyświetlony oddzielny plik CSV o tytule failedCustomers.csv. Możesz ponowić próbę ściągnięcia i weryfikacji subskrypcji dla tych klientów.