Introducción
El conector de Amazon S3 de Bizagi está disponible en el Connectors Xchange de Bizagi.
A través de este conector, podrá conectar sus procesos de Bizagi a una cuenta de Amazon S3 y usar sus servicios.
Para más información de las capacidades de este conector, visite nuestro Connectors Xchange.
|
Este Conector se desarrolló de acuerdo con los contenidos del API o información sobre los mismos suminstrada por Amazon S3. Bizagi no se hace responsable por errores derivados del llamado de los servicios del API, incongruencias en la documentación presentada por Amazon S3. Ni Bizagi ni sus filiales serán responsables de ofrecer cualquier tipo de garantía sobre los contenidos o errores derivados del llamado de los servicios del API. Bizagi y sus filiales no se harán responsables de las pérdidas, los costos o los daños en los que se incurra como consecuencia del acceso o el uso de los servicios del API de Amazon S3.
Este conector se encuentra actualmente en versión Beta. Úselo en ambientes de producción bajo su propio riesgo. |
Antes de iniciar
Para probar y usar este conector, necesita:
1.Bizagi Studio previamente instalado.
2.El conector previamente instalado, tal como se describe en https://help.bizagi.com/platform/es/index.html?Connectors_Xchange.htm, o a través del manual de instalación descrito en https://help.bizagi.com/platform/es/index.html?connectors_setup.htm.
3.Una cuenta en https://aws.amazon.com/s3/.
4.Un Access Key
5.Un Secret Access
6.La región en la que se alojan sus servicios de Amazon S3
7.El nombre de un bucket que se usara como el bucket por defecto
Obtener la región de sus servicios
Su cuenta de servicios de S3 se aloja en una región especifica, independientemente de las configuraciones individuales de sus bucket. Diríjasea https://s3.console.aws.amazon.com/. El nombre de la región se mostrara en la URL de la pagina web.
Obtener su access key y su secret access
Siga estos pasos para obtener su access key y su secret access.
1.Ingrese a su cuenta de AWS y diríjase a https://console.aws.amazon.com/iam/home#/home y haga clic en la opción Users
2.Haga clic en Add user
3.Inserte un User name para su nuevo usuario, active la opción Programmatic access y de clic en Next: Permission
4.Haga clic en Create Group
5.Inserte un Group name para su nuevo grupo, active la opción AdministratorAccess y haga clic en Create group
6.Haga clic en Next: Tags
7.Haga clic en Next: Review
8.Haga clic en Create User
9.Haga clic en Download .csv y guarde este archivo en un lugar seguro ya que contiene su Access key y su Secret Access. Haga clic en Close.
Configurar el conector
Para configurar el conector siga los pasos descritos en el capítulo de configuración en https://help.bizagi.com/platform/es/index.html?connectors_setup.htm.
Tenga en cuenta los siguientes parámetros de autenticación:
•Authentication method: Custom
•ACCESS_KEY: El access key que se copio en el paso anterior.
•SECRET_ACCESS: El secret access que se copio en el paso anterior.
•REGION: La región en la que se encuntra alojado su servicio de S3.
•BUKET: El nombre del bucket que se usará por defecto para las diferentes operaciones del conector.
Usar el conector
Éste conector permite el uso desde Bizagi de varios métodos disponibles para el uso de los servicios de .
Para configurar el conector, por favor visite el artículo https://help.bizagi.com/platform/es/index.html?Connectors_Studio.htm.
Al usar el conector, asegúrese de tener en cuenta, para los métodos disponibles, los siguientes detalles:
Create bucket (Crear bucket)
Esta acción crea un nuevo bucket.
Para configurar las entradas de esta acción tenga en cuenta:
• bucketName (Requerido): nombre del bucket a crear. Este parametro debe ser de tipo String en su modelo de Bizagi.
Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.
Para mas información de este metodo diríjase a la documentacón oficial de Amazon S3 - https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#createBucket-property.
Delete bucket (Borrar bucket)
Esta acción elimina un bucket.
Para configurar las entradas de esta acción tenga en cuenta:
• bucketName (Requerido): nombre del bucket a eliminar. Es obligatorio que el usuario escriba el nombre del bucket que quiere eliminar. Como precaución no se utiliza el BUCKET global (configurado en las propiedades del conector) para eliminar. Este parametro debe ser de tipo String en su modelo de Bizagi.
Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.
Para mas información de este metodo diríjase a la documentacón oficial de Amazon S3 - https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#deleteBucket-property.
Get bucket ACL (Obtener la información del ACL der un bucket)
Esta acción obtiene la información del Access Control List (ACL) del bucket.
Para configurar las entradas de esta acción tenga en cuenta:
• bucketName (Requerido): nombre del bucket a obtener. Si no se especifica un bucket explicitamente, se toma el bucket especificado en el parámetro global del conector (BUCKET). Este parametro debe ser de tipo String en su modelo de Bizagi.
Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.
Para mas información de este metodo diríjase a la documentacón oficial de Amazon S3 - https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#getBucketAcl-property.
Get bucket location (Get la ubicaión de un bucket)
Esta acción obtiene la región donde está ubicado un bucket.
Para configurar las entradas de esta acción tenga en cuenta:
• bucketName: nombre del bucket. Si no se especifica un bucket explicitamente, se toma el bucket especificado en el parámetro global del conector (BUCKET). Este parametro debe ser de tipo String en su modelo de Bizagi.
Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.
Para mas información de este metodo diríjase a la documentacón oficial de Amazon S3 - https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#getBucketLocation-property.
Get bucket policy (Obtener las politicas de un bucket)
Esta acción obtiene la información sobre la política del bucket.
|
Para usar este metodo primero debe crear una política en su bucket. De lo contrario esta acción retornara un objeto vacio. |
Para configurar las entradas de esta acción tenga en cuenta:
• bucketName: nombre del bucket. Si no se especifica un bucket explicitamente, se toma el bucket especificado en el parámetro global del conector (BUCKET). Este parametro debe ser de tipo String en su modelo de Bizagi.
Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.
Para mas información de este metodo diríjase a la documentacón oficial de Amazon S3 - https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#getBucketPolicy-property.
Get bucket website configuration (Obtiene la configuración del versionado de un bucket)
Esta acción obtiene la configuración de website hosting (si está activada) del bucket.
|
Para usar este metodo primero debe activar para su bucket la opción de Static website hosting. De lo contrario esta acción retornara un objeto vacio. |
Para configurar las entradas de esta acción tenga en cuenta:
• bucketName: nombre del bucket. Si no se especifica un bucket explicitamente, se toma el bucket especificado en el parámetro global del conector (BUCKET). Este parametro debe ser de tipo String en su modelo de Bizagi.
Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.
Para mas información de este metodo diríjase a la documentacón oficial de Amazon S3 - https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#getBucketWebsite-property.
Get bucket versioning configuration (Obtiene la configuración de website de un bucket)
Esta acción obtiene la información de configuración de versionamiento del bucket (si Versioning está activado).
|
Para usar este metodo primero debe activar para su bucket la opción de Versioning. De lo contrario esta acción retornara un objeto vacio. |
Para configurar las entradas de esta acción tenga en cuenta:
• bucketName: nombre del bucket. Si no se especifica un bucket explicitamente, se toma el bucket especificado en el parámetro global del conector (BUCKET). Este parametro debe ser de tipo String en su modelo de Bizagi.
Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.
Para mas información de este metodo diríjase a la documentacón oficial de Amazon S3 - https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#getBucketVersioning-property.
Head bucket (Encabezados del bucket)
Esta acción obtiene los metadatos de un bucket.
Para configurar las entradas de esta acción tenga en cuenta:
• bucketName: nombre del bucket. Si no se especifica un bucket explicitamente, se toma el bucket especificado en el parámetro global del conector (BUCKET). Este parametro debe ser de tipo String en su modelo de Bizagi.
Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.
Para mas información de este metodo diríjase a la documentacón oficial de Amazon S3 - https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#headBucket-property.
List buckets (Lista de buckets)
Esta acción obtiene todos los buckets de un usuario.
Esta acción no requiere ningún parámetro de entrada.
Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.
Para mas información de este metodo diríjase a la documentacón oficial de Amazon S3 - https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#listBuckets-property.
Upload file (Subir archivo)
Esta acción sube un archivo a un bucket.
Para configurar las entradas de esta acción tenga en cuenta:
• bucketName: nombre del bucket. Si no se especifica un bucket explicitamente, se toma el bucket especificado en el parámetro global del conector (BUCKET). Este parametro debe ser de tipo String en su modelo de Bizagi.
• file (Requerido): datos del archivo en base64. Este parametro debe ser de tipo String en su modelo de Bizagi.
• fileName (Requerido): nombre del archivo (key). Este parametro debe ser de tipo String en su modelo de Bizagi.
Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.
Para mas información de este metodo diríjase a la documentacón oficial de Amazon S3 - https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#upload-property.
Get object (Obtener objeto)
Esta acción obtiene un objeto de un bucket.
Para configurar las entradas de esta acción tenga en cuenta:
• bucketName: nombre del bucket. Si no se especifica un bucket explicitamente, se toma el bucket especificado en el parámetro global del conector (BUCKET). Este parametro debe ser de tipo String en su modelo de Bizagi.
• key (Requerido): nombre del objeto (archivo). Este parametro debe ser de tipo String en su modelo de Bizagi.
Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.
Para mas información de este metodo diríjase a la documentacón oficial de Amazon S3 - https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#getObject-property.
Delete object (Borrar objeto)
Esta acción elimina un objeto de un bucket.
Para configurar las entradas de esta acción tenga en cuenta:
• bucketName: nombre del bucket. Si no se especifica un bucket explicitamente, se toma el bucket especificado en el parámetro global del conector (BUCKET). Este parametro debe ser de tipo String en su modelo de Bizagi.
• key (Requerido): nombre del objeto (archivo). Este parametro debe ser de tipo String en su modelo de Bizagi.
Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.
Para mas información de este metodo diríjase a la documentacón oficial de Amazon S3 - https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#deleteObject-property.
List objects (Lista de objects)
Esta acción obtiene todos los objetos de un bucket.
Para configurar las entradas de esta acción tenga en cuenta:
• bucketName: nombre del bucket. Si no se especifica un bucket explicitamente, se toma el bucket especificado en el parámetro global del conector (BUCKET). Este parametro debe ser de tipo String en su modelo de Bizagi.
• delimiter : un delimiter es un caracter que se utiliza para agrupar Keys. Este parametro debe ser de tipo String en su modelo de Bizagi.
• encodingType : le pide a AWS que codifique los Keys en la respuesta utilizando el encoding especificado aquí. El único valor posible es: "url". Si se especifica otro, se ignorará y no se hará codificación. Este parametro debe ser de tipo String en su modelo de Bizagi.
• marker : básicamente es un cursor. Desde donde empieza la consulta. Este parametro debe ser de tipo String en su modelo de Bizagi.
• maxKeys : máximo número de keys que se deben retornar en la respuesta. Por defecto es 1000. Este parametro debe ser un número en su modelo de Bizagi.
• prefix : limita la respuesta a keys que empiezan con el prefijo especificado aquí. Este parametro debe ser de tipo String en su modelo de Bizagi.
Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.
Para mas información de este metodo diríjase a la documentacón oficial de Amazon S3 - https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#listObjects-property.
List object versions (Lista de las versiones de los objetos)
Esta acción obtiene todas las versiones de un objeto(s).
Para configurar las entradas de esta acción tenga en cuenta:
• bucketName: nombre del bucket. Si no se especifica un bucket explicitamente, se toma el bucket especificado en el parámetro global del conector (BUCKET). Este parametro debe ser de tipo String en su modelo de Bizagi.
• delimiter : un delimiter es un caracter que se utiliza para agrupar Keys. Este parametro debe ser de tipo String en su modelo de Bizagi.
• encodingType : le pide a AWS que codifique los Keys en la respuesta utilizando el encoding especificado aquí. El único valor posible es: "url". Si se especifica otro, se ignorará y no se hará codificación. Este parametro debe ser de tipo String en su modelo de Bizagi.
• marker : básicamente es un cursor. Desde donde empieza la consulta. Este parametro debe ser de tipo String en su modelo de Bizagi.
• maxKeys : máximo número de keys que se deben retornar en la respuesta. Por defecto es 1000. Este parametro debe ser un número en su modelo de Bizagi.
• prefix : limita la respuesta a keys que empiezan con el prefijo especificado aquí. Este parametro debe ser de tipo String en su modelo de Bizagi.
• keyMarker : especifica con cual key se debe empezar cuando se listan los objetos de un bucket. Este parametro debe ser de tipo String en su modelo de Bizagi.
• versionIdMarker : especifica la versión del objeto desde la cual se desea listar. Este parametro debe ser de tipo String en su modelo de Bizagi.
Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.
Para mas información de este metodo diríjase a la documentacón oficial de Amazon S3 - https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#listObjectVersions-property.
Get object metadata (Obvtener metadata de los objetos)
Esta acción obtiene los metadatos de un bucket.
Para configurar las entradas de esta acción tenga en cuenta:
• bucketName: nombre del bucket. Si no se especifica un bucket explicitamente, se toma el bucket especificado en el parámetro global del conector (BUCKET). Este parametro debe ser de tipo String en su modelo de Bizagi.
• key (Requerido): nombre del objeto (archivo). Este parametro debe ser de tipo String en su modelo de Bizagi.
Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.
Para mas información de este metodo diríjase a la documentacón oficial de Amazon S3 - https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#headObject-property.
Copy object (Copiar objeto)
Esta acción copia un objeto de un bucket a otro (o el mismo).
Para configurar las entradas de esta acción tenga en cuenta:
• destinationBucket: nombre del bucket al cual se quiere copiar el objeto (destino). Si no se especifica un bucket explicitamente, se toma el bucket especificado en el parámetro global del conector (BUCKET). Este parametro debe ser de tipo String en su modelo de Bizagi.
• destinationKey (Requerido): nombre del archivo con el que se guardará el objeto copiado. Este parametro debe ser de tipo String en su modelo de Bizagi.
• sourceBucket: nombre del bucket del cual se quiere copiar el objeto (origen). Si no se especifica un bucket explicitamente, se toma el bucket especificado en el parámetro global del conector (BUCKET). Este parametro debe ser de tipo String en su modelo de Bizagi.
• sourceKey (Requerido): nombre del archivo que se copiará. Debe estar codificado en URL. Este parametro debe ser de tipo String en su modelo de Bizagi.
Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.
Para mas información de este metodo diríjase a la documentacón oficial de Amazon S3 - https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#copyObject-property.
Create object URL (Create URL para un objeto)
Esta acción crea una URL para acceder a un objeto públicamente.
Para configurar las entradas de esta acción tenga en cuenta:
• bucketName: nombre del bucket. Si no se especifica un bucket explicitamente, se toma el bucket especificado en el parámetro global del conector (BUCKET). Este parametro debe ser de tipo String en su modelo de Bizagi.
• key (Requerido): nombre del objeto (archivo). Este parametro debe ser de tipo String en su modelo de Bizagi.
• expires : segundos hasta que expire el URL. Por defecto: 900 (15 minutos). Este parametro debe ser un número en su modelo de Bizagi.
Para configurar las salidas de esta acción relacione el objeto output con la entidad correspondiente en Bizagi, vinculando los atributos de esta entidad.
Para mas información de este metodo diríjase a la documentacón oficial de Amazon S3 - https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#getSignedUrl-property.
Last Updated 10/28/2022 11:26:17 AM