Você está visualizando a documentação do Apigee Edge.
Acesse a
documentação da
Apigee X. info
Na terça-feira, 8 de setembro de 2015, lançamos uma versão trimestral do portal de serviços para desenvolvedores do Apigee Edge para nuvem particular.
O nome do produto "Portal de serviços para desenvolvedores do Apigee Edge on-premise" ou "OPDK" agora é "Portal de serviços para desenvolvedores do Apigee Edge para nuvem privada".
Se tiver dúvidas, acesse o suporte ao cliente da Apigee.
Para conferir uma lista de todas as notas da versão do Apigee Edge, consulte Notas da versão do 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, conecte-a à versão 4.15.07.00 ou mais recente para garantir que todos os recursos do SmartDocs sejam compatíveis. Consulte 4.15.07.00 - Notas da versão do Apigee Edge para nuvem privada para saber mais.
Novos recursos
Disponibilidade geral do SmartDocs
O SmartDocs está saindo da versão Beta e vai ser disponibilizado para todos os usuários. As atualizações e os novos recursos incluem:
- Suporte ao Swagger 2.0, incluindo importação por arquivo ou URL, incluindo suporte a objetos de segurança com nomes personalizados.
- Melhorias no design visual dos modelos que geram SmartDocs.
- Melhorias na usabilidade e no fluxo de trabalho no portal do desenvolvedor, disponíveis no menu "Conteúdo" > "SmartDocs" no Drupal.
- O que era conhecido como autenticação de "Token personalizado" agora é chamado de "Chave de API".
- Objetos de "segurança" de autenticação definidos no nível de revisão.
- Configuração da autenticação do cliente no nível do modelo. As novas revisões não redefiniram mais nenhuma credencial de cliente pré-configurada do SmartDocs.
Para mais descrições de recursos, consulte esta postagem do blog.
Para conferir a documentação do SmartDocs, consulte Como usar o SmartDocs para documentar APIs.
Processo de upgrade do SmartDocs
Se você já estava usando o SmartDocs durante o período Beta, os novos recursos e recursos na versão de disponibilidade geral exigem que você faça upgrade do SmartDocs no portal do desenvolvedor.
As páginas do SmartDocs que já foram publicadas no seu portal de desenvolvedores vão continuar funcionando, mas você precisa seguir o processo de atualização antes de editar ou publicar as mudanças nas páginas atuais ou novas.
É possível renderizar e publicar SmartDocs no portal do desenvolvedor, mas eles são gerados com base no modelo de API que está nos serviços de gerenciamento de API do Edge da Apigee. Todas as mudanças feitas em um modelo de API no Edge serão as mesmas em todos os ambientes do Pantheon, semelhante à forma como os desenvolvedores existem em todos os ambientes do Pantheon.
Para fazer upgrade da versão Beta do SmartDocs para a versão de disponibilidade geral
- Atualize e teste a versão 15.05.27 nos ambientes de desenvolvimento ou teste no Pantheon.
- 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ê estiver mantendo seu modelo de API pelo módulo SmartDocs, exporte como JSON do SmartDocs e importe para o novo modelo usando o anexo de arquivo.
- Defina as propriedades de segurança da revisão do modelo. Na página Conteúdo >
SmartDocs > modelo, selecione Configurações de segurança.
- Verifique qualquer autenticação pré-configurada na página de configurações do modelo (Conteúdo >
SmartDocs) clicando em Configurações na coluna "Operações".
- Atualize os modelos personalizados para usar a v6 dos recursos de CSS e JS e faça mudanças para refletir novos nomes de objetos, como authSchemes e apiSchema. Para informações sobre como atualizar modelos do SmartDocs, consulte Como usar SmartDocs para documentar APIs.
- Renderize e publique a revisão do modelo.
- Depois de validar a nova documentação, atualize o portal de produção para a versão 15.05.27.
Se você é um cliente empresarial do Edge e tem 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 da 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 de dia na monetização precisa ser configurável 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 dos EUA. |
| DEVSOL-584 | Parâmetro de caminho não lembrado no primeiro uso O parâmetro de caminho ao fazer chamadas não era sempre lembrado. |
| DEVSOL-603 | A página "Conflict Plan" está com o formato incorreto Ao comprar um plano que se sobrepõe a um plano existente, a página mostrada agora está formatada corretamente para o usuário. |
| DEVSOL-709 | SmartDocs: o parâmetro do modelo de URL não pode ser editado depois de enviar uma solicitação com valor
em branco Corrige o problema que torna os parâmetros do 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 amigáveis ao usuário em caso de falha na importação do SmartDocs |
| DEVSOL-1013 | Edição de endereços de e-mail de usuários no portal do desenvolvedor 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 mudar os próprios 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", "Dev Connect Mint" apareceu 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 arquivos WADL por URL e fazer upload de arquivos Swagger. |
| DEVSOL-1339 | Mudanças nos locais do menu "Administrador" do SmartDocs Agora o SmartDocs está localizado no menu "Conteúdo", e as configurações do SmartDocs estão no menu "Administrador". |
| DEVSOL-1340 | Remover a versão Beta ao passar para a GA |
| DEVSOL-1390 |
A biblioteca do SDK do PHP Edge foi atualizada para corrigir o problema de chamada de
__toString() Erro fatal: chamada para uma função de membro format() em um não objeto em /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php na linha 221 Esse é um bug que afeta apenas os clientes da Monetização com código personalizado que chama o método toString(). |
| DEVSOL-1398 | O modelo Petstore do SmartDocs é importado na instalação sem solicitar ao usuário O SmartDocs agora importa o exemplo de swagger da Petstore durante a instalação do site (http://petstore.swagger.io/v2/swagger.json) em vez do modelo de clima 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 causaria 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 Melhoramos a mensagem de erro no instalador quando a conexão de gerenciamento do Edge não funciona para minimizar problemas de solução de problemas. |
| DEVSOL-1422 | Remoção do formulário de configuração SMTP do perfil do 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 do Drupal de ativar o módulo SMTP e configurá-lo corretamente. |
| DEVSOL-1427 |
Adição de hooks ao módulo Devconnect Developer Apps para permitir a alteração dos
dados de análise # 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 apps para desenvolvedores. |
| DEVSOL-1464 | Erro fatal ao salvar as configurações de autenticação de um modelo Quando um esquema de segurança é excluído, agora há uma caixa de seleção para selecionar se o esquema de autenticação de modelo associado também precisa ser excluído. |
| DEVSOL-1470 | Criar link de menu "APIs" e visualização correspondente O portal do desenvolvedor SmartDocs agora vem por padrão com um link para a documentação renderizada do SmartDocs no menu principal "APIs", que vincula 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 fornecidas pelo usuário e pré-fornecidas. |
| DEVSOL-1499 | O código HTML não é analisado em descrições de parâmetros do SmartDocs O código HTML agora é analisado em 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" Agora é possível adicionar vários parâmetros a uma API do SmartDocs ao editar o método. |
| DEVSOL-1509 | Não há como editar o campo "sample" de uma API SmartDocs Agora é possível definir o "Body MIME type", "Body documentation" e "Body sample" ao editar uma página do SmartDocs. |
| DEVSOL-1534 | O tipo de conteúdo não está sendo preenchido na saída do SmartDocs O tipo de conteúdo agora está sendo preenchido na página de método do SmartDocs. |
| DEVSOL-1554 | Comparação de datas inválida na monetização Na guia do plano comprado para monetização, os botões "Cancelar" nunca eram mostrados para um plano com uma data de início futura. |
| DEVSOL-1556 | Versão antiga dos módulos do Drupal sendo enviada O módulo media_youtube e features foi atualizado para a versão mais recente. |
| DEVSOL-1558 | As páginas de método do SmartDocs não são renderizadas para o exemplo do PetStore Em novas instalações, os métodos de exemplo do PetStore do SmartDocs agora são renderizados corretamente. |
| DEVSOL-1562 | Gerar uma visualização para cada modelo do SmartDocs Ao criar um novo modelo, uma nova visualização é criada por padrão para ele. |
| DEVSOL-1565 | A edição do método do SmartDocs gera um erro fatal Correção do problema em que a edição de um método do SmartDocs às vezes gerava um erro. |
| DEVSOL-1567 | "Adicionar modelo" sendo mostrado no menu principal de administração Foi corrigido o problema em que o item de menu "Adicionar modelo" estava sendo mostrado no menu principal de administração. |
| 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 que aparece ao clicar em "APIs" no menu mostrava o nome interno do modelo em vez do nome de exibição. Se você estiver atualizando para a versão e tiver alterado essa visualização, será necessário reverter a visualização para conferir as mudanças seguindo estas etapas: # Faça login como administrador # Acesse Estrutura > Visualizações # Clique no menu suspenso ao lado de "Editar" em "Modelos do SmartDocs" para conferir todas as operações. # Se você encontrar "revert", significa que você substituiu o código com sua própria mudança. Clique em "Reverter" para voltar à visualização para o estado padrão. Isso vai remover todas as mudanças feitas nessa visualização. |
| DEVSOL-1578 | Renderizar os modelos do Weather e da Petstore nas instalações do site Os modelos do Weather e da Petstore do SmartDocs são importados em novos sites. |
| DEVSOL-1584 | Não é possível comprar planos Foi corrigido o problema em que o formulário de compra de planos de monetização não era enviado para a versão da nuvem 15.05.27.00 e 15.06.08.00 se você estivesse usando o tema responsivo do Apigee ou um subtema do tema responsivo do Apigee. |
| DEVSOL-1597 | Não é possível mudar as configurações de tempo limite do desenvolvedor Foi corrigido um bug em que as configurações de tempo limite da conexão do Edge não eram aplicadas corretamente. |
| DEVSOL-1620 |
Upgrade do módulo "me", indicador de ambiente e recursos https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator |
| DEVSOL-1648 | Verifique se arg_separator.output é '&' para evitar a quebra do reCAPTCHA Um problema relacionado à plataforma em que o uso do Google reCAPTCHA estava quebrado foi corrigido. |
| DEVSOL-1651 | O tema Apigee Base 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 |
Aumento da versão de admin_views para corrigir uma falha de segurança crítica
|