4.15.07.00 – Notas da versão do Portal de serviços para desenvolvedores da Apigee

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
informações

Na terça-feira, 8 de setembro de 2015, lançamos uma versão trimestral do Apigee Edge Developer Services Portal para nuvem privada.

O antigo nome de produto "Apigee Edge On-Prem Developer Services Portal" ou "OPDK" agora se chama "Apigee Edge Developer Services Portal para Private Cloud".

Se você tiver dúvidas, acesse o suporte ao cliente da Apigee.

Para ver uma lista de todas as notas da versão do Apigee Edge, consulte as Notas de lançamento da Apigee.

Requisitos do Apigee Edge para o portal

Se você estiver conectando esta versão do portal a uma instalação do Edge para nuvem privada, será necessário conectá-la à versão 4.15.07.00 ou posterior para garantir que todos os recursos do SmartDocs sejam compatíveis. Consulte 4.15.07.00 - Notas de lançamento do Apigee Edge para nuvem privada para mais informações.

Novos recursos

Disponibilidade geral do SmartDocs

O SmartDocs está passando da versão Beta para a disponibilidade geral. As atualizações e os novos recursos incluem:

  • Suporte para Swagger 2.0, incluindo importação por arquivo ou URL, inclusive suporte a objetos de segurança com nomes personalizados.
  • Melhorias de design visual nos modelos que geram SmartDocs.
  • Melhorias de usabilidade e fluxo de trabalho no portal do desenvolvedor, disponíveis no menu Conteúdo > SmartDocs no Drupal.
  • O que era conhecido como autenticação por "token personalizado" agora é chamado de "chave de API".
  • Objetos de "segurança" de autenticação definidos no nível da revisão.
  • Configuração da autenticação do cliente no nível do modelo. As novas revisões não redefinem mais as credenciais pré-configuradas do cliente SmartDocs.

Para ver mais descrições de recursos, consulte esta postagem do blog (link em inglês).

Para conferir a documentação do SmartDocs, consulte Como usar o SmartDocs para documentar APIs.

Processo de upgrade do SmartDocs

Se você já usa o SmartDocs durante o período Beta, os novos recursos na versão de disponibilidade geral exigem que você faça upgrade do SmartDocs no portal do desenvolvedor.

Todas as páginas SmartDocs que já tiverem sido publicadas no seu portal do desenvolvedor continuarão funcionando, mas você precisará seguir o processo de atualização antes de editar ou publicar qualquer alteração em páginas novas ou existentes.

É importante lembrar que, embora seja possível renderizar e publicar SmartDocs dentro do portal do desenvolvedor, os SmartDocs são gerados a partir do modelo de API que reside nos serviços de gerenciamento de APIs Edge da Apigee. Todas as alterações feitas em um modelo de API no Edge serão as mesmas em todos os ambientes do Pantheon (semelhante à forma como os desenvolvedores existem nos ambientes do Pantheon).

Fazer upgrade da versão Beta do SmartDocs para a disponibilidade geral

  1. Atualize e teste a versão 15.05.27 nos seus ambientes dev ou test do Pantheon.
  2. Crie um novo modelo para substituir qualquer modelo de API que você esteja usando.
    • Se você estiver importando documentos Swagger ou WADL, importe-os novamente para uma nova revisão.
    • Se você tem mantido seu modelo de API por meio do módulo SmartDocs, exporte como JSON SmartDocs e importe-o para o novo modelo usando o anexo de arquivo.
  3. Defina as propriedades de segurança da revisão do modelo. Na página Conteúdo > SmartDocs > modelo, selecione Configurações de segurança.
  4. Verifique as autenticaçãos pré-configuradas na página de configurações do modelo (Conteúdo > SmartDocs) clicando em Configurações na coluna "Operações".
  5. Atualize todos os modelos personalizados para usar a v6 dos recursos CSS e JS e faça alterações para refletir os novos nomes de objeto, como authSchemes e apiSchema. Para informações sobre como atualizar modelos do SmartDocs, consulte Como usar o SmartDocs para documentar APIs.
  6. Renderize novamente e publique a revisão do modelo.
  7. Depois de validar a nova documentação, atualize seu portal de produção para a versão 15.05.27.

Se você for um cliente Enterprise do Edge e tiver dúvidas sobre o processo de upgrade, envie um e-mail para marsh@apigee.com e cnovak@apigee.com. Caso contrário, use a Comunidade Apigee para receber a melhor resposta.

Bugs corrigidos

Os bugs abaixo foram corrigidos nesta versão.

Id do problema Descrição
DEVSOL-487 O formato do dia na monetização precisa ser configurado pelos administradores
Agora o formato de data pode ser configurado em "Monetização" nas configurações de monetização para formatos de data europeus e americanos.
DEVSOL-584 O parâmetro de caminho não era lembrado no primeiro uso
O parâmetro de caminho ao fazer chamadas nem sempre era lembrado.
DEVSOL-603 A página do plano de conflito está mal formatada
Ao comprar um plano que se sobrepõe a um plano atual, a página exibida agora está formatada corretamente para o usuário.
DEVSOL-709 SmartDocs: parâmetro de modelo de URL não editável após o envio de solicitação com valor vazio
Corrige o problema que torna os parâmetros de modelo não editáveis depois de enviar a solicitação do SmartDocs após excluir o parâmetro do modelo na documentação do método.
DEVSOL-723 Mostrar mensagens fáceis de usar em caso de falha na importação do SmartDocs
DEVSOL-1013 Tornar os endereços de e-mail dos usuários do Portal do desenvolvedor editáveis
O campo de endereço de e-mail na página de edição do perfil não será mais desativado, e os desenvolvedores poderão alterar os endereços de e-mail.
DEVSOL-1244 Não ativar o módulo do indicador de ambiente para versões do OPDK
DEVSOL-1273 "DevConnect Mint" aparece duas vezes na lista de módulos
Em "Módulos", o "Dev Connect Mint" aparece duas vezes. Isso já foi corrigido
DEVSOL-1313 Suporte à importação de arquivos JSON/YAML ou URL para Swagger e WADL
Agora é possível importar os arquivos WADL usando URL. Também é possível fazer upload de arquivos Swagger.
DEVSOL-1339 Mudar locais do menu Administrador do SmartDocs
Agora o SmartDocs está no menu de conteúdo, e as configurações do SmartDocs estão no menu Administrador de configurações.
DEVSOL-1340 Remover a versão Beta quando acessar o GA
DEVSOL-1390

A biblioteca PHP SDK Edge foi atualizada para corrigir o problema de chamar __toString()
A biblioteca PHP SDK Edge foi atualizada para corrigir o problema de chamar __toString() no objeto DeveloperRatePlan, que cria este erro:

Erro fatal: chamada para uma função de membro format() em um não objeto em /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/library//mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php na linha 221

Esse é um bug que afeta apenas os clientes de monetização que têm código personalizado chamando o método toString().

DEVSOL-1398 Modelo de petstore do SmartDocs importado na instalação sem comando do usuário
Agora o SmartDocs importa o exemplo de swagger durante a instalação do site (http://petstore.swagger.io/v2/swagger.json) em vez do modelo meteorológico para ter um exemplo mais completo de uso do SmartDocs.
DEVSOL-1407 O cron falha quando há muitos desenvolvedores
Ao executar o cron do Drupal, uma grande quantidade de desenvolvedores causava um problema de tempo limite. Quando uma organização tem mais de 200 usuários, um processo em lote é usado.
DEVSOL-1410 Erros de conexão não aparentes ao instalar o Dev Portal
Adicionamos mensagens de erro melhores ao instalador quando a conexão de gerenciamento do Edge não está funcionando para minimizar a solução de problemas.
DEVSOL-1422 Remover o formulário de configuração SMTP do perfil da Apigee
O processo de instalação não pergunta mais se você quer configurar o SMTP. Em vez disso, isso pode ser feito após a conclusão da instalação, seguindo a prática padrão Drupal de ativar o módulo SMTP e configurá-lo corretamente.
DEVSOL-1427

Adicione hooks ao módulo Devconnect Developer Apps para permitir a alteração dos dados de análise
O módulo devconnect_developer_apps agora fornece três novos hooks:

# hook_devconnect_developer_apps_analytics_chart_data_alter()

# hook_devconnect_developer_app_analytics_datapoints_params_alter()

# hook_devconnect_developer_app_analytics_datapoints_alter()

Eles permitem que os módulos personalizados alterem o gráfico de análise de aplicativos do desenvolvedor.

DEVSOL-1464 Erro fatal ao salvar as configurações de autenticação de um modelo
Quando um esquema de segurança é excluído, ele mostra uma caixa de seleção para marcar se o esquema de autenticação do modelo associado também precisa ser excluído.
DEVSOL-1470 Criar link do menu "APIs" e visualização correspondente
Os SmartDocs do portal de desenvolvedor agora têm um link para a documentação renderizada do SmartDocs no menu principal chamado "APIs", que leva a todos os modelos com métodos publicados.
DEVSOL-1486 As chamadas do SmartDocs podem ser autenticadas com uma chave predefinida
Permite a autenticação com chaves de API pré e fornecidas pelo usuário.
DEVSOL-1499 Código HTML não analisado nas descrições de parâmetros do SmartDocs
Agora o código HTML é analisado nas descrições de parâmetros do SmartDocs.
DEVSOL-1507 Não é possível adicionar vários parâmetros a uma API com o método "Adicionar método"
Agora você pode adicionar vários parâmetros a uma API SmartDocs ao editar o método.
DEVSOL-1509 Não há uma maneira de editar o campo "exemplo" de uma API SmartDocs
Agora você pode definir "Tipo MIME do corpo", "Documentação do corpo" e "Exemplo de corpo" ao editar uma página do SmartDocs.
DEVSOL-1534 O tipo de conteúdo não está sendo preenchido na saída do SmartDocs
Agora o tipo de conteúdo está sendo preenchido na página do método SmartDocs.
DEVSOL-1554 Comparação de datas inválida na Monetização
Na guia do plano comprado para portais de desenvolvedores com monetização ativada, o botão "Cancelar" não era exibido para um plano com uma data de início futura.
DEVSOL-1556 Lançamento da versão antiga dos módulos do Drupal
O módulo media_youtube e de recursos foi atualizado para a versão mais recente.
DEVSOL-1558 Exemplo de páginas de método SmartDocs que não são renderizadas para PetStore
Em novas instalações, os métodos de exemplo do SmartDocs PetStore agora são renderizados corretamente.
DEVSOL-1562 Gerar uma visualização para cada modelo SmartDocs
Quando você cria um novo modelo, uma nova visualização é criada por padrão para ele.
DEVSOL-1565 A edição do método SmartDocs gera um erro fatal
Corrigimos o problema em que a edição de um método SmartDocs às vezes gerava um erro.
DEVSOL-1567 "Adicionar modelo" exibido no menu Administrador superior
Correção do problema em que o item "Adicionar modelo" era exibido no menu superior Admin.
DEVSOL-1576 A visualização da documentação da API mostra o nome do modelo, não o nome de exibição
A página de documentação da API mostrada ao clicar em "APIs" no menu mostrava o nome interno do modelo, e não o de exibição. Se você estiver atualizando para a versão e tiver alterado a visualização, será necessário reverter a visualização para ver essas alterações seguindo estas etapas: # Faça login como administrador # Vá para Estrutura > Visualizações # Clique no menu suspenso ao lado de "Editar" em "Modelos SmartDocs" para ver todas as operações. # Se aparecer "reverter", significa que você substituiu o código com sua própria alteração. Clique em "reverter" para retornar ao estado padrão. Isso vai remover todas as mudanças feitas nessa vista.
DEVSOL-1578 Renderizar modelos Clima e Petstore nas instalações do site
Os modelos Petstore e Weather SmartDocs são importados em novos sites.
DEVSOL-1584 Não é possível comprar planos
Corrigimos o problema em que o formulário de compra de planos de monetização não era enviado para as versões 15.05.27.00 e 15.06.08.00 se você estivesse usando o tema responsivo da Apigee ou um subtema do tema responsivo da Apigee.
DEVSOL-1597 Não é possível mudar as configurações de tempo limite do desenvolvedor
Corrigimos um bug em que as configurações de tempo limite da conexão de borda não eram aplicadas corretamente.
DEVSOL-1620

Upgrades de mim, indicador de ambiente e módulos de recursos
Atualização de segurança moderadamente crítica para as atualizações do módulo Me, do indicador de ambiente e dos recursos. Mais informações:

https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator (em inglês)

https://www.drupal.org/project/features

DEVSOL-1648 Verifique se arg_separator.output é "&" para evitar falhas no reCAPTCHA
Um problema relacionado à plataforma em que o uso do reCAPTCHA do Google estava corrompido foi corrigido.
DEVSOL-1651 O tema base da Apigee falha se o módulo smartdocs não estiver ativado
O tema apigee_base não depende mais da ativação do módulo SmartDocs.
DEVSOL-1654

Versão de aumento de admin_views para detectar correção de segurança crítica
Os seguintes módulos de contribuição foram atualizados:

  • Visualizações administrativas
  • Migrar
  • Redirecionamento
  • Redis
  • Operações em massa de visualizações