Conexiones externas
Conecte otro servicio con el contexto de proyecto adecuado
Describa el servicio externo que desea conectar, aporte su documentación y asócielo a las áreas de negocio correspondientes.
Reúna la documentación y los datos de acceso
- Declare el servicio
Identifique la API externa y aporte un enlace o un texto de documentación.
- Separe los datos de acceso
Aporte las credenciales de prueba y de producción solicitadas para la conexión.
- Vincule el contexto de negocio
Asocie una conexión existente a las áreas que la utilizan.
Dé a una integración la información que necesita
Una conexión empieza por el nombre del servicio y su documentación. Explique qué acción de negocio la requiere y qué información debe circular entre los sistemas.
La declaración admite datos de acceso separados para pruebas y producción. Revise esos datos en la página de detalle de la conexión, manteniendo claro el contexto del entorno.
Prepare una integración en torno a la acción de negocio que respalda
Explique el intercambio que necesita. Un servicio externo puede aportar o recibir información utilizada por una tarea de negocio. Declare su nombre y su documentación y después explique el intercambio previsto en el contexto del proyecto. Así, la integración tiene una finalidad práctica más allá de la URL de un servicio.
Distinga las pruebas de la producción. Las credenciales de prueba y de producción pueden pertenecer a cuentas distintas del proveedor. Manténgalas en los campos correspondientes y verifique su uso previsto. Separar esos contextos ayuda a preparar la integración para sus etapas de desarrollo y de producción.
Reutilice una conexión declarada. El mismo servicio externo puede dar soporte a varias áreas de negocio. Vincule la conexión existente allí donde corresponda y después revise sus asociaciones. Desvincularla de un área y eliminarla de todo el proyecto son decisiones diferentes.
Reutilice la conexión allí donde corresponda
Una conexión declarada puede vincularse a más de un área de negocio. Consulte las conexiones vinculadas en un área y asocie o desvincule el servicio adecuado.
Declarar el servicio aporta los requisitos de la integración. Revise su estado y pruebe el flujo de trabajo de negocio completo antes de confiar en él en producción.
Explique el intercambio que necesita su aplicación
Especifique el servicio, la información que se envía o se recibe y el área de negocio que lo utiliza. Un enlace a la documentación actual ayuda a describir el contrato externo real.
Describa un ejemplo útil y la respuesta esperada cuando el servicio no esté disponible. Así, la conexión puede debatirse en función del trabajo de sus usuarios y no solo del nombre de un proveedor.
De la declaración del servicio a un flujo de trabajo probado
Aporte la información del servicio. Aporte un enlace a la documentación o su contenido y los datos de acceso solicitados. Identifique la operación de negocio que requiere la conexión.
Asocie las áreas adecuadas. Vincule la conexión declarada a las áreas que la utilizan. Revise las asociaciones existentes antes de añadir o quitar una.
Verifique la integración completada. Siga su estado y pruebe el intercambio previsto en el entorno correspondiente. La declaración por sí sola no demuestra que el flujo de trabajo funcione.
Prepare la conexión que su aplicación necesita realmente
Empiece por la documentación del servicio y el resultado de negocio. Mantenga claros los datos de acceso y las asociaciones a lo largo del proyecto.
Preguntas sobre las conexiones externas
Indique el nombre del servicio externo y un enlace a la documentación o su contenido pegado. Aporte los datos de acceso solicitados para pruebas y producción. Un nombre por sí solo no define el comportamiento de la integración.
Una conexión existente puede asociarse a varias áreas de negocio. Revise las áreas vinculadas en los detalles del conector para que su alcance siga siendo comprensible.
Una conexión externa describe cómo su aplicación utiliza otro servicio. La API de proyecto opcional expone las operaciones acordadas de su aplicación. Responden a necesidades de integración distintas.
Desvincular un conector afecta a su vínculo con un área. Eliminar el conector del proyecto es una acción aparte con un alcance distinto; revise la confirmación antes de continuar.
Siga la implementación y pruebe el intercambio de negocio completo. El servicio declarado y su estado de activación son un contexto útil, pero no sustituyen la verificación del resultado.