Migrazione dei sottoscrittori dell'applicazione a nuove versioni del prodotto

Quando vengono create nuove versioni di prodotti in IBM® API Connect, è possibile spostare i sottoscrittori nei piani del nuovo prodotto in diversi modi.

Informazioni su questa attività

È possibile trasferire gli utenti ai nuovi piani in diversi modi, a seconda della strategia di prodotto, utilizzando l'icona delle opzioni icona opzioni accanto al prodotto nel catalogo associato nell'interfaccia utente di API Manager.

Procedura

Per migrare automaticamente tutti i sottoscrittori esistenti a un nuovo prodotto, ad esempio, quando si applicano le fix a un prodotto:
  • Sostituisci la versione originale del prodotto con una nuova versione del prodotto.
    • Il prodotto di sostituzione è Pubblicato.
    • Il prodotto originale è Ritirato.
    • I sottoscrittori del prodotto originale vengono migrati automaticamente al prodotto di sostituzione.
    Per ulteriori informazioni sulla sostituzione dei prodotti, consultare la sezione "Sostituzione di un prodotto con un altro ".
Per incoraggiare i sottoscrittori a passare a un nuovo prodotto e impedire ai nuovi utenti di sottoscrivere il prodotto originale, ad esempio, se viene aggiunto un miglioramento o una nuova funzione:
  • Si consiglia di sostituire la versione originale del prodotto con una nuova versione del prodotto.
    • Il prodotto di sostituzione è Pubblicato.
    • Il prodotto originale è Obsoleto.
    • Gli sviluppatori di applicazioni già sottoscritti al prodotto ora obsoleto possono continuare a utilizzarlo, ma nessun nuovo sviluppatore può sottoscrivere il prodotto. Nel Catalogo consumatori, gli abbonati vedranno il messaggio " Trasferisci questo abbonamento ", su cui potranno cliccare per aggiornare il proprio abbonamento alla destinazione della migrazione.
    Per ulteriori informazioni sulla sostituzione dei prodotti, consultare la sezione "Sostituzione di un prodotto con un altro ".
Per preparare un prodotto da rimuovere dalla produzione, ma lasciare le sottoscrizioni esistenti così come sono:
  • È necessario dichiarare il prodotto originale.
    • Il prodotto è Obsoleto.
    • Gli sviluppatori di applicazioni già sottoscritti al prodotto ora obsoleto possono continuare a utilizzarlo, ma nessun nuovo sviluppatore può sottoscrivere il prodotto.
    • È possibile definire un prodotto di sostituzione utilizzando l'opzione Imposta destinazione della migrazione nel catalogo. Gli sviluppatori di applicazioni vedranno quindi nel Catalogo dei consumatori il messaggio "Migra questo abbonamento", sul quale potranno cliccare per aggiornare il proprio abbonamento alla destinazione della migrazione.
    • Utilizza l'opzione "Imposta destinazione della migrazione" per eseguire la stessa operazione dell'opzione "Sostituisci ". Prepara gli abbonamenti per la migrazione al prodotto di destinazione, ma non rende obsoleto il prodotto di origine. Il prodotto di destinazione deve essere già stato pubblicato.
      Nota:

      Sia l'opzione "Sostituisci prodotto" che "Imposta destinazione della migrazione" presuppongono che il prodotto di origine non verrà più utilizzato una volta completata la migrazione di tutti gli abbonamenti e che non verrà utilizzato come destinazione della migrazione in futuro.

      Queste opzioni vengono solitamente utilizzate quando una nuova versione del prodotto A sostituisce una versione precedente dello stesso prodotto. I prodotti di origine e di destinazione sono contrassegnati rispettivamente dagli attributi superseded_by e supersedes.

    • Utilizza "Esegui migrazione destinazione" per forzare la migrazione di tutti gli abbonamenti da un prodotto obsoleto prima di ritirarlo dal mercato.
      Nota:

      Le opzioni "Sostituisci prodotto" e "Imposta destinazione di migrazione" impediscono di impostare come destinazione di migrazione una versione precedente del prodotto, al fine di evitare dipendenze circolari in cui due prodotti si indicano a vicenda come destinazioni di migrazione.

      Per reimpostare la destinazione della migrazione su una versione precedente, cancellare innanzitutto le impostazioni superseded_by supersedes e create dalle funzioni "Sostituisci prodotto" o "Imposta destinazione della migrazione ". Quindi, eseguire "Esegui destinazione migrazione" per migrare tutti gli abbonamenti al prodotto di destinazione.

      Una volta completata la migrazione di tutti gli abbonamenti, disattivare il prodotto di origine. Per riutilizzarlo, aggiorna e ripubblicalo prima di utilizzare "Imposta destinazione migrazione" con la versione precedente.

    Per ulteriori informazioni sulla dismissione dei prodotti, consulta la sezione "Dismissione di un prodotto".