Etapa 5: adicionar uma política

Novo Editor de Proxy

Há duas etapas para adicionar a política XMLtoJSON ao proxy:

• Crie uma instância da política.
• Anexe a política a uma etapa no Pré-fluxo.

Criar uma instância da política

Para usar uma política, primeiro é necessário criar uma nova instância da política a partir do modelo de política, da seguinte maneira:

1. Se você estiver usando a interface da Apigee no console do Cloud: selecione Desenvolvimento de proxy > Proxies de API.

   Se você estiver usando a interface clássica da Apigee: selecione Desenvolver > Proxies de API e, no painel Proxies, selecione o ambiente do proxy.

2. Na lista de proxies, selecione o proxy em que você quer adicionar a política.

3. Clique na guia Desenvolver.

4. No painel à esquerda, clique no botão + ao lado da pasta Políticas.
5. Na caixa de diálogo Criar política, selecione Políticas padrão para filtrar a lista de políticas disponíveis por tipo de política.
6. Na caixa de texto Selecionar tipo de política, role para baixo até Mediação e selecione XML para JSON.

7. Também é possível alterar o Nome e o Nome de exibição da política. Por padrão, a Apigee fornece um prefixo curto para o nome da política. Neste caso, X2J-, é possível adicionar uma sequência de palavras descritivas separadas por traços, após o prefixo. Consulte as convenções de nomenclatura.

   

   Quando terminar, clique em Criar para criar a política.

A política XML para JSON agora é exibida no painel direito da visualização Desenvolver:

A metade inferior do painel mostra o código XML da política.

Para saber mais sobre a política, selecione o ícone de informações ao lado do nome da política e clique em Política de XML para JSON. A página de referência da política será exibida.

Use o Gemini Code Assist para consultar as instruções da política

Se você tiver o complemento Gemini Code Assist, poderá destacar um elemento de política para conferir informações sobre ele e como usá-lo. Consulte Usar a explicação do código do Gemini Code Assist com políticas para mais informações.

Mudar o nome da política

Para mudar o nome de uma política:

1. Selecione a política em Políticas no painel à esquerda.
2. No elemento <DisplayName> do código XML da política, adicione uma frase descritiva, como change-xml-to-json, depois da abreviação do nome da política:

   

   Isso atualiza automaticamente o nome da política exibido em Políticas.

   Consulte as convenções de nomenclatura.

Anexar a política a uma etapa do Pré-fluxo

Agora que você criou a política XML para JSON, pode anexá-la a uma etapa no Pré-fluxo:

1. Selecione Endpoints de Proxy > padrão > Pré-fluxo no painel à esquerda:

   

   Observação: talvez seja necessário expandir o editor visual no painel à direita para ver todos os elementos. Para fazer isso, clique e arraste um pouco o divisor entre o editor visual e o editor de texto.

2. Clique no botão + ao lado de PreFlow no painel Response no canto inferior direito do Editor de recursos visuais:

   

3. Na caixa de diálogo Adicionar etapa de política, selecione a política X2J-change-xml-to-json.

4. Clique em Adicionar para anexar a política.

   A política X2J-change-xml-to-json agora é exibida no painel Resposta:

   

5. Clique em Save para salvar a revisão atual com as alterações.
6. Para implantar as alterações na revisão, clique em Implantar e siga as instruções Implantar um proxy de API.

Editor de Proxy clássico

Para adicionar a política XMLtoJSON ao seu proxy:

1. Abra a IU da Apigee em um navegador e faça login.
2. Clique em Proxies de API na janela principal e selecione um proxy. Para este exemplo, selecione o proxy que você criou na Etapa 2: criar um proxy de API.

3. Clique na guia Desenvolver:

   

   A Apigee exibe a API Proxy Editor.

4. No painel Navigator, clique em Endpoints de proxy > padrão > PreFlow:

   

   A Apigee exibe o Editor de fluxo:

   

   Além disso, a Apigee exibe a configuração padrão do endpoint de proxy no painel Código:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <ProxyEndpoint name="default">
     <Description/>
     <FaultRules/>
     <PreFlow name="PreFlow">
       <Request/>
       <Response/>
     </PreFlow>
     <PostFlow name="PostFlow">
       <Request/>
       <Response/>
     </PostFlow>
     <Flows/>
     <HTTPProxyConnection>
       <BasePath>/myproxy</BasePath>
       <Properties/>
       <VirtualHost>default</VirtualHost>
       <VirtualHost>secure</VirtualHost>
     </HTTPProxyConnection>
     <RouteRule name="default">
       <TargetEndpoint>default</TargetEndpoint>
     </RouteRule>
   </ProxyEndpoint>

5. Para adicionar uma política ao seu proxy, clique no botão + Etapa na resposta pré-fluxo (a metade inferior do Editor de fluxo):

   

   A Apigee exibe uma lista categorizada de políticas na caixa de diálogo Adicionar que pode ser adicionada ao fluxo:

   

6. Role para baixo e selecione a política XMLtoJSON na categoria "Mediação".

7. Mantenha os nomes padrão e clique em Adicionar.

   A Apigee anexa a nova política ao PreFlow da resposta:

   

   Quando você clica em Adicionar, a Apigee faz o seguinte:

   • Adiciona a nova política em Políticas no painel Navegador.
   • Adiciona a política XMLtoJSON no painel Fluxo.
   • Exibe o XML de configuração da política no painel Código.
8. Clique em Save para salvar a revisão atual com as alterações.
9. Para implantar as alterações, clique na guia Visão geral e clique no botão Implantar.