Step 5: Add a policy

New Proxy Editor

There are two steps to add the XMLtoJSON policy to your proxy:

• Create an instance of the policy.
• Attach the policy to a step in the PreFlow.

Create an instance of the policy

To use a policy, you first have to create a new instance of the policy from the policy template as follows:

1. If you are using the Apigee UI in Cloud console: Select Proxy development > API Proxies.

   If you are using the classic Apigee UI: Select Develop > API Proxies and in the Proxies pane, select the environment for the proxy.

2. From the proxies list, select the proxy in which you want to add the policy.

3. Click the Develop tab.

4. In the left-hand pane, click the + button next to the Policies folder.
5. In the Create policy dialog, select Standard policies to filter the available policy list by policy type.
6. In the Select policy type text box, scroll down to Mediation and select XML To JSON.

7. Optionally, you can change the Name and Display name of the policy. By default, Apigee provides a short prefix for the policy name, in this case, X2J-, You can add a sequence of descriptive words separated by dashes, after the prefix. See Naming conventions.

   

   When you are done, click Create to create the policy.

The XML To JSON policy is now displayed in the right-hand pane of the Develop view:

The lower half of the pane displays the XML code for the policy.

To learn more about the policy, select the information icon next to the policy name and click XML To JSON policy. This displays the reference page for the policy.

Use Gemini Code Assist to review policy instructions

If you have the Gemini Code Assist add-on, you can highlight a policy element to see information about that element and how to use it. See Use Gemini Code Assist code explain with policies for information.

Change the policy name

To change the name of a policy:

1. Select the policy under Policies in the left-hand pane.
2. In the <DisplayName> element in the XML code for the policy, add a descriptive phrase for the policy, such as change-xml-to-json, after the abbreviation for the policy name:

   

   This automatically updates the policy name, displayed under Policies.

   See Naming conventions.

Attach the policy to a step in the PreFlow

Now that you have created the XML To JSON policy, you can attach it to a step in the PreFlow:

1. Select Proxy Endpoints > default > PreFlow in the left-hand pane:

   

   Note: You may need to expand the visual editor in the right-hand pane to see all the elements. To do so, click and drag the divider between the visual editor and the text editor down a little.

2. Click the + button next to PreFlow in the Response pane at the bottom-right of the visual editor:

   

3. In the Add policy step dialog, select the X2J-change-xml-to-json policy.

4. Click Add to attach the policy.

   The X2J-change-xml-to-json policy is now displayed in the Response pane:

   

5. Click Save to save the current revision with your changes.
6. To deploy your changes to the revision, click Deploy and follow the instructions in Deploy an API proxy.

Classic Proxy Editor

To add the XMLtoJSON policy to your proxy:

1. Open the Apigee UI in a browser and log in.
2. Click API Proxies in the main window and select a proxy. For this example, select the proxy that you created in Step 2: Create an API proxy.

3. Click the Develop tab:

   

   Apigee displays the API Proxy Editor.

4. In the Navigator pane, click Proxy Endpoints > default > PreFlow:

   

   Apigee displays the Flow editor:

   

   In addition, Apigee displays the default Proxy Endpoint configuration in the Code pane:

   <?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. To add a policy to your proxy, click the + Step button in the response PreFlow (the bottom half of the Flow editor):

   

   Apigee displays a categorized list of policies in the Add dialog box that you can add to your flow:

   

6. Scroll down and select the XMLtoJSON policy in the Mediation category.

7. Leave the default names, and click Add.

   Apigee attaches the new policy to the PreFlow of the response:

   

   Note that when you click Add, Apigee does the following:

   • Adds the new policy under Policies in the Navigator pane.
   • Adds the XMLtoJSON policy in the Flow pane.
   • Displays the policy's configuration XML in the Code pane.
8. Click Save to save the current revision with your changes.
9. To deploy your changes, click the Overview tab and click the Deploy button.