Modificaciones en la IU

Puedes realizar cambios menores en la IU de Edge para mejorar la experiencia de tu comunidad de desarrolladores. Por ejemplo, puedes cambiar lo siguiente:

  • Contacto de asistencia: El destinatario de los errores internos de la IU.
  • Banner de consentimiento: Es el texto que se muestra cuando un usuario accede por primera vez a la IU de Edge. El banner de consentimiento muestra texto en formato HTML y un botón que el usuario selecciona para ir a la pantalla de acceso.

Si cambias esta configuración, los desarrolladores tendrán una experiencia más coherente y te ayudarán a garantizar que los problemas se enruten al lugar correcto.

Para realizar estos cambios, edita los archivos de propiedades con la técnica Código con configuración (CwC).

Cambia el contacto de asistencia

Cuando la IU experimenta ciertos errores (por ejemplo, cuando un desarrollador accede como un usuario que no tiene una organización asociada), es posible que se muestre un error como el siguiente:

Debes cambiar el valor predeterminado del contacto del “equipo de asistencia al cliente” para que apunte a un recurso activo de tu organización que pueda brindarles asistencia oportuna a los desarrolladores.

Para cambiar el contacto de asistencia, haz lo siguiente:

  1. Abre el archivo /opt/apigee/customer/application/ui.properties en un editor. Si el archivo no existe, créalo.
  2. Si acabas de crear el archivo, cambia el propietario a “apigee:apigee”, como se muestra en el siguiente ejemplo:
    chown apigee:apigee /opt/apigee/customer/application/ui.properties
  3. Establece el valor de la propiedad conf_apigee_apigee.branding.contactemailsupport en tu contacto de asistencia interno. Por ejemplo:
    conf_apigee_apigee.branding.contactemailsupport="api-support@mycompany.com"
    .
  4. Guarda los cambios.
  5. Reinicia el servicio de IU de Edge:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

La próxima vez que tus desarrolladores experimenten un error interno, el vínculo “Comunicarse con el equipo” enviará un correo electrónico a tu organización de asistencia interna.

El banner de consentimiento se muestra cuando un usuario accede por primera vez a la IU de Edge. Por ejemplo:

Para agregar un banner de consentimiento, haz lo siguiente:

  1. Abre el archivo /opt/apigee/customer/application/ui.properties en un editor. Si el archivo no existe, créalo.
  2. Si acabas de crear el archivo, cambia el propietario a “apigee:apigee”, como se muestra en el siguiente ejemplo:
    chown apigee:apigee /opt/apigee/customer/application/ui.properties
  3. Configura las siguientes propiedades:
    # Enable the consent banner:
    conf_apigee-base_apigee.feature.enableconsentbanner="true"
    # Set the button text:
    conf_apigee-base_apigee.consentbanner.buttoncaption="I Agree"
    # Set the HTML text:
    conf_apigee-base_apigee.consentbanner.body="<h1>Notice and Consent Banner</h1>
    <div><p>Enter your consent text here.</p></div>"
  4. Guarda los cambios.
  5. Reinicia el servicio de IU de Edge:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

La próxima vez que los desarrolladores abran la IU de Edge en un navegador, deberán aceptar el acuerdo de consentimiento para poder acceder.