Integraciones personalizadas

Las integraciones personalizadas son integraciones que se desarrollan mediante las API de Autodesk y están disponibles al público para ampliar las capacidades de su plataforma. Regístrese en los servicios de plataforma de Autodesk. También puede encontrar la documentación de la API aquí.

Los permisos de las integraciones personalizadas pueden estar controlados por cuentas de servicio seguro (SSA). Más información sobre las SSA en Cuentas de servicio seguras.

Añadir integraciones personalizadas

Para añadir una integración personalizada, primero debe crear una integración personalizada en el portal de Autodesk Platform Services (APS). Después de crear la integración personalizada, puede añadirla a la plataforma de Autodesk Construction Cloud (ACC).

1. Haga clic en Añadir Integraciones personalizadas, en la herramienta Integraciones personalizadas.
2. Proporcione el ID de cliente de APS. El ID de cliente es el identificador único de la integración personalizada. Puede encontrar el ID de cliente en el portal de APS.
3. Proporcione el nombre de la integración.
4. Proporcione una descripción de la integración.
5. Haga clic en Siguiente.

6. El sistema recupera automáticamente las Cuentas de servicio seguro (SSA) configuradas previamente para su ID de cliente.
   • Si no se encuentra ninguna SSA, no habrá forma de controlar los permisos para esta integración y actuará como administrador de cuentas con acceso inmediato a todos los datos de su cuenta. Haga clic en Continuar de todos modos para completar la integración.
   • Si se detecta una única SSA, la integración se adjunta automáticamente a esta SSA. No se concede acceso a los datos a la integración hasta que la cuenta SSA ha sido invitada a un proyecto. Haga clic en Entendido para completar la integración.
   • Si se detectan varias SSA, proporcione la dirección de correo electrónico de la SSA que desea asociar a esta integración. Haga clic en Añadir para completar la integración.

Estado de integración

El estado de integración indica si la integración está activa o inactiva. Puede cambiar el estado de la integración en cualquier momento. Para solucionar incidencias con la integración, se recomienda establecer el estado de la integración como inactiva.

• Activa: la integración puede leer y escribir datos en la plataforma de Autodesk Construction Cloud (ACC) mediante las API de Autodesk.
• Inactiva: la integración no lee ni escribe datos en la plataforma de ACC mediante las API de Autodesk.

Para cambiar el estado de una integración:

1. Seleccione la integración de la lista de integraciones en la herramienta Integraciones personalizadas.
2. Seleccione la lista desplegable de estado y elija el estado deseado.

Acceso a la integración

Al seleccionar una integración personalizada de la lista de la herramienta Integraciones personalizadas, se muestran detalles sobre la integración, incluido su nivel de acceso. Aquí se muestra el nivel más alto de acceso que tiene la integración en todos los proyectos. Por ejemplo, si la integración tiene acceso completo a uno de sus proyectos, pero acceso restringido a otro proyecto, el acceso a la integración sigue siendo "Acceso completo al proyecto".

Para ver los detalles sobre el nivel de acceso de una integración por proyecto:

1. Seleccione la integración de la lista de integraciones en la herramienta Integraciones personalizadas.
2. En "Acceso a la integración", haga clic en el vínculo del número de proyectos.

Existen tres niveles de acceso posibles, cada uno de los cuales significa lo siguiente:

• Acceso completo a cuentas:
  • No hay SSA asociada, por lo que la integración tiene acceso a los datos de nivel de cuenta (en lugar de solo a nivel de proyecto). Los datos de cuenta disponibles son aquellos a los que pueden acceder las API públicas. Esto se aplica a las integraciones creadas antes de la compatibilidad con SSA. Si se ha creado la integración en la interfaz de usuario de BIM 360 y se ha limitado el acceso a Admin o Gestión de documentos, se sigue respetando la configuración. La integración no tiene acceso al servicio que estaba restringido. En este caso, la integración puede utilizar la autenticación de dos partes. El campo de correo electrónico de integración está vacío.
  • Se ha concedido a una SSA asociada acceso de "Administrador de cuentas" en su cuenta. Se rellena el campo de correo electrónico de integración. La integración que utiliza la SSA actúa como un usuario de automatización y tiene el permiso solo en el contexto del usuario, que se puede utilizar como parte de la autenticación de tres partes.
• Acceso completo al proyecto: la SSA asociada a la integración es un administrador de proyectos en al menos un proyecto.
• Acceso al proyecto: la SSA asociada a la integración es miembro del proyecto en todos los proyectos a los que se le ha invitado.

Para modificar el acceso de una SSA existente, vaya a la herramienta Miembros de Project Admin dentro de cada proyecto.

Suprimir integración

Puede suprimir una integración que ya no sea útil. El estado Inactivo se debe utilizar para detener temporalmente la transferencia de datos de una integración a y desde la ACC. Al suprimir la integración, se elimina de la lista, pero se puede volver a añadir. Para suprimir una integración:

1. Seleccione la integración de la lista de integraciones en la herramienta Integraciones personalizadas.
2. Haga clic en el menú Más del cajón.
3. Seleccione Suprimir integración.
4. Haga clic en Eliminar en el cuadro de diálogo de confirmación.