Cómo utilizar IBM® App Connect con Box

Box es un servicio web seguro para compartir archivos que ayuda a tu equipo a colaborar. Puede crear y editar documentos con sus colegas en tiempo real desde cualquier lugar y dispositivo.

Con Box, todo el equipo puede ver el mismo conjunto de archivos y modificarlos en tiempo real desde cualquier lugar y dispositivo. Así, no es necesario enviar copias de los archivos como adjuntos de correo electrónico, y todo el mundo tiene siempre a mano la última versión del archivo, lo que facilita la colaboración. Utiliza App Connect para conectar más aplicaciones a Box. Así, por ejemplo, cada vez que se crea una nueva campaña en Salesforce, se crea automáticamente una carpeta en Box, lo que hace que su equipo colabore más y ahorre tiempo para otras tareas.

Versiones de productos y API compatibles

Para saber qué versiones de producto y API admite este conector, consulte Requisitos detallados del sistema en la página de asistencia IBM.

Conexión a la caja

Para conectar App Connect a una cuenta de Box, seleccione el tipo de usuario:
  • usuario administrativo
  • Usuario no administrador

A continuación, facilite los siguientes datos de conexión:

Método de autorización Campo de conexión Descripción Aplicabilidad
ACCESO BÁSICO Señal de acceso En la consola de desarrollador de Box, cree una aplicación personalizada utilizando el método OAuth estándar 2.0 (autenticación de usuario) para generar un ID de cliente y un secreto de cliente. Se genera un token de acceso a partir del ID de cliente, el secreto de cliente y el URI de redirección. Para más información, consulte http://ibm.biz/acboxoauth2nosdk. App Connect in containers y App Connect
Renovar señal El token de actualización que se genera a partir del ID de cliente de la aplicación y el secreto de cliente. Para más información, consulte http://ibm.biz/acboxoauth2nosdk.
ID de cliente El identificador único que se genera después de crear una aplicación en la consola de desarrollador de Box. Puedes encontrar este valor en la página de Configuración de tu aplicación.
Secreto de cliente El secreto de cliente de aplicación que se genera después de crear una aplicación en la consola de desarrollador de Box. Puedes encontrar este valor en la página de Configuración de tu aplicación.
OAUTH 2.0 CÓDIGO DE AUTENTICACIÓN
Consejo: Autorice la conexión a Box iniciando sesión en su cuenta.
   App Connect

Para conectarse a Box desde la página Conectar > Aplicaciones y API del Diseñador de App Connect Conectar ( anteriormente la página Catálogo ) por primera vez, en Box, haga clic en Conectar. Cuando se le solicite, conceda a App Connect acceso de lectura y escritura a los archivos y carpetas almacenados en Box. Estos pasos crean una cuenta en App Connect. Para más información, consulte Gestión de cuentas.

Para obtener los valores de conexión para Box, consulte Obtención de valores de conexión para Box.

Consejo:
  • Si ya ha iniciado sesión en Box en la misma ventana del navegador que App ConnectApp Connect se conecta a esa cuenta de Box sin pedirle la dirección de correo electrónico ni la contraseña. Para conectarse a otra cuenta de Box, cierre primero la sesión de Box o abra App Connect en una nueva ventana del navegador.
  • Si no tienes una cuenta de Box, puedes crear una cuenta individual para probar Box gratis.

Antes de utilizar la cuenta creada en App Connect en un flujo, cambie el nombre de la cuenta por algo significativo que le ayude a identificarla. Para cambiar el nombre de la cuenta en la página Aplicaciones y API, seleccione la cuenta, abra su menú de opciones (⋮) y, a continuación, haga clic en Cambiar nombre de cuenta.

Lo primero que hay que tener en cuenta

Antes de utilizar App Connect Designer con Box, tenga en cuenta las siguientes consideraciones.

  • (Consideración general) Puede ver listas de los eventos y acciones desencadenantes que están disponibles en la página Aplicaciones y API del Diseñador de App Connect.

    Para algunas aplicaciones, los eventos y acciones dependen del entorno y de si el conector admite eventos configurables y descubrimiento dinámico de acciones. Si la aplicación admite eventos configurables, verá un enlace Mostrar más eventos configurables bajo la lista de eventos. Si la aplicación admite la detección dinámica de acciones, verá un enlace Mostrar más debajo de la lista de acciones.

  • (Consideración general) Si utiliza varias cuentas para una aplicación, el conjunto de campos que se muestra al seleccionar una acción para esa aplicación puede variar para las distintas cuentas. En el editor de flujo, algunas aplicaciones siempre proporcionan un conjunto curado de campos estáticos para una acción. Otras aplicaciones utilizan la detección dinámica para recuperar el conjunto de campos configurados en la instancia a la que está conectado. Por ejemplo, si tiene dos cuentas para dos instancias de una aplicación, la primera cuenta podría utilizar configuraciones listas para su uso inmediato. Sin embargo, la segunda cuenta puede estar configurada con campos personalizados adicionales.

Consideraciones posteriores a la conexión

  • Cuando se utiliza la acción Create file para añadir un archivo a Box, se aplican los siguientes puntos.
    • Especifique una carpeta principal para el archivo que desea crear. Esta carpeta debe existir en Box, y puede seleccionarse de una lista prepoblada de carpetas de Box en su cuenta.
      Crear campos de archivo para Box con carpeta seleccionada
      Consejo: Para especificar un valor dinámico (que devuelve un evento o acción anterior) para una carpeta en lugar de un valor estático de la lista rellenada, cambie al modo avanzado. La lista se convierte en un cuadro de texto, que puede utilizar para asignar un ID de carpeta de un nodo anterior.
      Especificación de un valor dinámico para una carpeta utilizando el modo avanzado
    • Si no indica una extensión para el nombre del archivo, se creará por defecto un archivo de texto (.txt).
    • Utilice el campo Tipo de archivo para indicar si el contenido del archivo debe tratarse como texto sin formato (Texto ), o si debe aplicarse la codificación Base64 (Binario ) para formatos de archivo como PDF y Microsoft Word.
  • Cuando se utiliza la acción Create folder para crear una carpeta Box, la carpeta se crea por defecto en el nivel raíz. Cuando se crea una carpeta en el nivel raíz, el valor por defecto de 0 (cero) que se muestra en el campo Parent ID.
    Crear campos de carpeta para Box

    En la interfaz de usuario de Box, puede encontrar este ID en la carpeta raíz URL.

    ID de padre en la carpeta raíz de un Box URL

    Para especificar una carpeta padre diferente para la carpeta que se está creando, sobrescriba el ID predeterminado de 0 con un valor codificado o un valor asignado. La carpeta padre debe existir.

    • Para obtener el ID codificado de una carpeta padre, abra la carpeta en Box. El ID de la carpeta se muestra como una secuencia de números al final de URL en la barra de direcciones del navegador. Por ejemplo, en URL https://app.box.com/folder/31234567893, el ID de la carpeta es 31234567893.
    • Si su flujo contiene una acción previa que devuelve un ID de carpeta (por ejemplo, una acción "Recuperar carpetas"), también puede especificar el ID padre como campo asignado.
      El campo ID del padre muestra un valor asignado
  • Al recuperar o transferir el contenido de un archivo, si es necesario analizarlo o transformarlo mediante funciones JSONata, el tamaño máximo del archivo es de 10 MB. En caso contrario, el tamaño máximo del archivo es de 50 MB.

    Para la acción Create file , puede especificar el contenido del archivo especificando texto o asignándolo al contenido de un nodo anterior del flujo. Si asigna al contenido, especifique sólo un valor asignado y no añada ni agregue un prefijo de una cadena de texto al valor asignado. En la siguiente tabla se muestran ejemplos válidos e inválidos.

    Ejemplos válidos Ejemplos no válidos
    Ejemplo válido de campo de contenido de archivo asignado a sólo texto
    Ejemplo válido que muestra el campo Contenido de archivo asignado únicamente al contenido de archivo de Box
    Ejemplo no válido que muestra el campo de contenido de Box File asignado a texto preimpreso y contenido de Box file
    Ejemplo no válido que muestra el campo Contenido de archivo asignado tanto al contenido de archivo de Box como al texto añadido
    Ejemplo no válido que muestra un campo de contenido de archivo asignado a dos instancias de contenido de archivo de Box
  • Cuando utilice la acción Recuperar metadatos de archivo, debe especificar una condición de filtro. Proporcione el ID de un archivo Box (condición ID ) o proporcione una cadena de búsqueda (condición de cadena de búsqueda ) que se buscará en el nombre, la descripción y los comentarios de los archivos.
  • Cuando utiliza la acción 'Crear tarea' para agregar una tarea a un archivo de Box, debe especificar el ID del archivo (campo ID de artículo ). Puede asignar el valor ID desde una acción anterior (por ejemplo, Recuperar metadatos de archivo ) o especificando un ID de archivo conocido (por ejemplo, desde la dirección del archivo en la interfaz del navegador web de Box https://app.box.com/file/File_ID).
  • Cuando se utiliza una acción Recuperar que contiene el parámetro Campos (por ejemplo, la acción Recuperar archivo basura ), el esquema de respuesta incluye muchas propiedades que no se devuelven por defecto desde la API de Box. Aunque estas propiedades aparecen en el editor de mapas, sus valores no se rellenan a menos que se soliciten explícitamente.

    Recuperar un archivo perdido en Box

    Para recuperar los valores de estas propiedades, debe especificar sus nombres en el parámetro Campos como una lista separada por comas. Si no incluye los nombres de las propiedades en el parámetro Fields, la respuesta no contendrá valores para esas propiedades, aunque las mapee. Por ejemplo, si desea recuperar nombre, versión_archivo y descripción, introduzca name,file_version,description en la entrada Campos. La respuesta incluirá los valores de estas propiedades.

Sugerencias sobre resolución de problemas

Cuando se añaden a un flujo, algunas acciones de Box realizan inmediatamente una llamada a la API de Box para recuperar el conjunto de objetos existentes sobre los que o contra los que se puede completar la acción. Por ejemplo, la acción Create file realiza una llamada inicial para obtener la lista de carpetas existentes en las que se puede crear el archivo. Si ve unNot connectedcuando añada dichas acciones, pero no vea este error para otras acciones de Box (que normalmente realizan una llamada sólo cuando se ejecuta el flujo), es posible que la conexión entre App Connect y Box esté interrumpida.

La acción Box / Crear archivo muestra el mensaje "No conectado

Para restablecer una conexión interrumpida, debe volver a autorizar su cuenta de Box actualizando los datos de conexión de dicha cuenta.

Eventos y acciones

Eventos de caja

Estos eventos son para cambios en esta aplicación que desencadenan un flujo para empezar a completar las acciones en el flujo.

Nota: Los eventos no están disponibles para cambios en esta aplicación. Puede activar un flujo de otras formas, como a un intervalo programado o en fechas y horas concretas.

Acciones en caja

Su flujo completa estas acciones en esta aplicación.

Objecto Acción Descripción
Favoritos Crear marcador Crea un marcador en Box
Suprimir marcadores Elimina un enlace web de una cuenta de Box
Recuperar favoritos Obtiene información sobre un enlace web
Actualizar marcadores Actualiza un enlace web
Colaboraciones Crear colaboración Crea una colaboración en Box
Borrar colaboraciones Elimina una colaboración de la cuenta de Box
Recuperar colaboraciones Obtiene información sobre las colaboraciones
Actualizar colaboraciones Actualiza una colaboración
Comentarios Crear comentario Crea un comentario en Box
Eliminar comentarios Elimina un comentario de una cuenta de Box
Recuperar comentarios Obtiene información sobre los comentarios
Actualizar comentarios Actualiza un comentario
Archivos Copiar archivo Crea una copia de un archivo en otra carpeta. La versión original del archivo no se alterará.
Crear archivo Crea un archivo en una carpeta específica de su cuenta de Box
Suprimir archivos Elimina un archivo de tu cuenta de Box
Recuperar el contenido del archivo Descarga un archivo de tu cuenta de Box
Recuperar metadatos de archivos Obtiene información sobre los archivos de su cuenta de Box
Actualizar archivos Actualiza el contenido de un archivo específico
Recuperar versiones de archivos Recupera una lista de las versiones anteriores de un archivo
Recuperar archivo basura Recupera un archivo que se ha movido a la papelera
Elementos de carpeta Recuperar elementos de la carpeta Obtiene todos los elementos de la carpeta
Carpetas Copiar carpeta Crea una copia de una carpeta en otra carpeta
Crear carpeta Añade una nueva carpeta en Box
Eliminar carpetas Elimina una carpeta de una cuenta de Box
Recuperar carpetas Obtiene información sobre las carpetas
Actualizar carpetas Actualiza la configuración de una carpeta específica
Pertenencias a grupos Crear pertenencia a un grupo Crea una pertenencia a un grupo
Borrar pertenencias a grupos Elimina la pertenencia a un grupo de una cuenta de Box
Recuperar la pertenencia a un grupo Obtiene información sobre la pertenencia a grupos
Actualizar la pertenencia a grupos Actualiza la pertenencia a un grupo
Enlaces compartidos Crear o actualizar enlace compartido Crea o actualiza un enlace compartido
Recuperar enlaces compartidos Obtiene información sobre los enlaces compartidos
Asignación de tareas Crear asignación de tareas Crea una asignación de tarea para una tarea en el buzón
Eliminar asignaciones de tareas Elimina una asignación de tarea para una tarea en la cuenta de buzón
Recuperar asignaciones de tareas Recupera las asignaciones de una tarea en Box
Actualizar la asignación de tareas Actualiza la asignación de una tarea en la cuenta de Box
Tareas Crear tarea Crea una tarea en un archivo
Suprimir tareas Elimina una tarea de una cuenta de Box
Recuperar tareas Obtiene información sobre las tareas
Actualizar tareas Actualiza una tarea

Hay más elementos disponibles después de conectar App Connect a Box.

Ejemplos

Mosaico del panel de control para una plantilla que utiliza Box
Mosaico del panel de control para una plantilla que utiliza Box
Mosaico del panel de control para una plantilla que utiliza Box

Utilice plantillas para crear rápidamente flujos para Box

Aprenda a utilizar las plantillas de App Connect para crear rápidamente flujos que completen acciones en Box. Por ejemplo, abra Discover y busque Box.

Más información

Mosaico del panel de control para una plantilla que utiliza Box