O ciclo de vida do produto

Editar online

Ao gerenciar as versões do seu produto, você as conduz por uma série de estágios do ciclo de vida. Da preparação inicial de uma versão do Produto para um Catálogo, até a publicação para tornar a versão do Produto disponível para seus desenvolvedores de aplicativos e para eventual desativação e arquivamento. O recurso de organização em IBM® API Connect significa que os estados de ciclo de vida de Produto também podem ser gerenciados em Espaços no Catálogo associado.

Diagrama de estado do ciclo de vida do produto

O diagrama a seguir mostra os possíveis estados de ciclo de vida para uma versão de Produto e as operações de gerenciamento de Produto que movem uma versão de Produto de um estado de ciclo de vida para outro... Por exemplo, a operação de desativação transfere uma versão do produto do estado “Publicado” para o estado “Desativado”.

Diagrama de estado do ciclo de vida para produtos
Nota: os mesmos estados de ciclo de vida do Produto se aplicam independentemente de seu Produto ser gerenciado em um Catálogo ou em um Espaço em um Catálogo. Para obter mais informações sobre o recurso de distribuição, consulte “Usando a distribuição ” em API Connect.
Se a aprovação for necessária para uma operação de gerenciamento de Produto, uma solicitação de aprovação será enviada e a versão do produto será movida para o estado pendente.. Quando a solicitação é aprovada, a operação é concluída e a versão do Produto é movida para o próximo estado do ciclo de vida.. Se a aprovação não for necessária, a operação será concluída imediatamente
Nota: a aprovação não é necessária para as seguintes transições de estado do ciclo de vida:
  • Retirado para a fase de preparação.
  • De "obsoleto" para "publicado".
Para obter mais informações sobre como configurar aprovações do ciclo de vida do produto para um catálogo, consulte Criação e configuração de catálogos. Para obter mais informações sobre a aprovação de solicitações, consulte Aprovação de solicitações relacionadas ao ciclo de vida do produto e à assinatura.
Nota:
  • A aprovação para mudanças de estado do ciclo de vida do produto em um catálogo está desativada por padrão. Deve-se ativar explicitamente as mudanças de estado do ciclo de vida do produto que você deseja aplicar.
  • As aprovações de ciclo de vida do produto podem ser configuradas somente no nível do Catálogo Esse recurso não está disponível no nível de Espaço
  • Para visualizar o histórico de tarefas de assinatura, siga estas etapas:
    • No painel de navegação da interface do usuário do API Manager, clique em Gerenciar e, em seguida, selecione o catálogo com o qual deseja trabalhar.
    • Clique na guia "Tarefas".
    • Clique em “Histórico de aprovações” no painel de navegação.
  • Você pode visualizar o histórico de solicitações e aprovações do ciclo de vida do produto clicando no ícone de opções Ícone Opções ao lado do produto com o qual deseja trabalhar e selecionando “Visualizar histórico de aprovações ”.
As seções a seguir descrevem os vários estados do ciclo de vida para uma versão do Produto..
Nota: Todas as referências a um Catálogo feitas neste tópico também se aplicam a um Espaço dentro de um Catálogo, salvo indicação em contrário.

Rascunho

O estado de rascunho para um Produto ou API é quando uma definição de Produto ou API não é implementada e não está associada a nenhum Catálogo.

Com Estágio Definido

Ao preparar um Produto, uma cópia da versão do Produto é implementada no Catálogo de destino. Preparado é o estado inicial quando você publica um Produto. Quando um produto está no estado em estágios, ele ainda não está visível, ou pode ser assinado, por quaisquer desenvolvedores. Para obter mais informações sobre como preparar um produto, consulte Preparando um produto.

Você prepara um produto para que as aprovações necessárias, internamente na organização, possam ser concedidas e o produto possa ser publicado. Para obter mais informações sobre como configurar aprovações do ciclo de vida do produto para um catálogo, consulte Criação e configuração de catálogos. Para obter mais informações sobre a aprovação de solicitações, consulte Aprovação de solicitações relacionadas ao ciclo de vida do produto e à assinatura. Para obter mais informações sobre como publicar um produto, consulte Publicar um produto.

Publicado

Ao publicar um Produto, uma cópia fixa da versão do Produto é implementada no catálogo de destino. A versão do Produto pode ser visualizada e assinada pelos desenvolvedores ou pelas comunidades de destino. Quando um Produto é publicado em um Catálogo, as configurações de visibilidade e assinatura podem ser alteradas para a versão publicada desse Produto. Quaisquer mudanças adicionais requerem que uma nova versão do produto seja montada e publicada antes de entrarem em vigor.

Se você substituir um Produto Publicado por um Produto Preparado ou Reprovado, o Produto de substituição será publicado e o Produto substituído será retirado.

Se você suplantar um Produto Publicado por um Produto Preparado ou Reprovado, o Produto Substituído será publicado e o Produto Substituído será descontinuado.

Para obter mais informações sobre como publicar um produto, consulte Publicar um produto.

Nota: se você deseja atualizar um Produto, deve-se republicá-lo. O comando products:update atualiza apenas metadados de um Produto.

Descontinuado

Quando você marca um produto como obsoleto, a versão do produto fica visível apenas para os desenvolvedores cujas aplicações estão inscritas. Não é possível fazer novas assinaturas dos planos do produto. Para obter mais informações sobre a descontinuação de produtos, consulte Descontinuando um produto.

Um Produto também será descontinuado se ele for substituído por outro Produto. Para obter mais informações, consulte “Substituir um produto por outro ”.

Desativado

Quando você retira um produto de circulação, a versão do produto não pode ser visualizada, não é possível assinar seus planos e todas as APIs associadas são desativadas. Para obter mais informações sobre a retirada de produtos, consulte Retirada de um produto.

Um Produto também será retirado se você substituí-lo por outro Produto. Para obter mais informações, consulte “Substituição de um produto por outro ”.

Substituir produto

Use a opção “Substituir produto” quando quiser substituir o produto A pelo produto B e migrar todas as assinaturas. Esta ação retira o produto de origem e publica o produto de destino. Para obter mais informações, consulte “Substituição de um produto por outro ”.

Migrar assinaturas

Use a opção “Migrar assinaturas” para realizar a mesma função que a opção “Substituir produto”, com a diferença de que ela não retira o produto de origem de circulação, e o produto de destino já deve estar publicado.

Você também pode usar a função "Migrar assinaturas" para migrar assinaturas individuais entre produtos diferentes ou entre planos dentro do mesmo produto. Para obter mais informações, consulte “Migração de assinaturas de aplicativos para outro produto” e “Migração de assinantes de aplicativos para novas versões do produto ”.

Suplantar produto

Use a opção “Substituir produto” para substituir o produto A pelo produto B e migrar todas as assinaturas posteriormente. Esta opção desativa o produto de origem e publica o produto de destino.

Quando um produto é descontinuado, não são permitidas novas assinaturas, mas as assinaturas existentes continuam funcionando até que sejam migradas. Os consumidores podem migrar todas as assinaturas ou assinaturas individuais no momento que lhes for mais conveniente. Para obter mais informações, consulte “Substituir um produto por outro ”.

Configurar destino de migração

Use a opção “Definir destino de migração” para executar a mesma função da opção “Substituir ”. Ele prepara as assinaturas para a migração para o produto de destino, mas não desativa o produto de origem. O produto de destino já deve estar publicado. Para obter mais informações, consulte Migração de assinantes de aplicativos para novas versões do produto.
Nota:

Tanto a opção “Substituir produto” quanto a opção “Definir destino de migração” pressupõem que o produto de origem não será mais utilizado após a migração de todas as assinaturas e que não será utilizado como destino de migração no futuro.

Essas opções são normalmente utilizadas quando uma nova versão do produto A substitui uma versão anterior do mesmo produto. Os produtos de origem e de destino são identificados pelos atributos superseded_by e supersedes, respectivamente.

Executar o destino de migração

Use a opção “Executar destino de migração” para forçar a migração de todas as assinaturas de um produto descontinuado antes de retirá-lo de circulação. Para obter mais informações, consulte Migração de assinantes de aplicativos para novas versões do produto.
Nota:

As opções “Substituir produto” e “Definir destino de migração” impedem que o destino de migração seja definido como uma versão mais antiga do produto, a fim de evitar dependências circulares, nas quais dois produtos se indicam mutuamente como destinos de migração.

Para redefinir o destino da migração para uma versão anterior, primeiro limpe as configurações superseded_by criadas supersedes pelas opções “Substituir produto” ou “Definir destino da migração ”. Em seguida, execute “Execute Migration Target” para migrar todas as assinaturas para o produto de destino.

Depois que todas as assinaturas forem migradas, desative o produto de origem. Para reutilizá-lo, reestruture-o e publique-o novamente antes de usar a opção “Definir destino de migração” com a versão anterior.