Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: excerpt fixed

The Designer provides means to access S3 file storage services, e.g. as a part of Amazon AWS or other implementation. S3 support is native and you do not need to install client tools or drivers. Also, your PAS system comes with a MinIO installation minio pre-installed that you can use out of the box.

Using the S3 Adapter, you can

TaskAdapter OperationDocumentation ReferenceRemarks
Create buckets
  • createBucket
  • The name of the bucket must match the S3 naming rules.
Store and retrieve objects from and to a bucket
  • putObject
  • getObject
  • The bucket may be versioned or not.
  • The stored data may be provided directly or come from a file.
Copy objects between buckets
  • copyObject
  • Source and target bucket cannot be the same.
List buckets and objects
  • listBuckets
  • listObjects


Delete buckets and objects within buckets
  • deleteBucket
  • deleteObject
  • Buckets may be deleted recursively.
  • Objects can be deleted as well as object versions.
Get status information on buckets and objects
  • bucketStatus
  • objectStatus

To use the S3 adapter it is helpful if you are familiar with the concepts of S3.

Adding an S3 Adapter Operation to a Diagram

Expand the path to the S3 adapter in the service panel (Base Types/Bridge Base/Base Components/Add Ons/S3).

You can drag out operations from the data model to any diagram:

The example on the left shows how to add a S3 adapter operation to an BPMN execution diagram.

Configuring the S3 Adapter Operation

Once an operation has been added to a diagram, it needs to be configured as a S3 adapter.

Select the newly added S3 adapter operation and switch to the Attributes panel. Depending on the diagram type you can see the following information (example BPMN execution diagram):

AttributeDescriptionAllowed Values / Example
NameThe name of the S3 adapter operation. putObject
TypeThe path to the operation within the data model. Base Components.Add Ons.S3.Object
Symbol TypeOperations added to a execution diagram are execution steps.Execution Step


Click Add Stereotype to define the selected operation as to bea S3 adapter.

Select S3 from the list of available adapter stereotypes.
Click Save.

The Attributes panel now shows the added adapter stereotype. Now you still need to configure the adapter.

Expand the stereotype by clicking the arrow on the right.

To configure a S3 adapter, you have the following options:

  • alias
    The S3 adapter is configured via its alias. The alias is mandatory.
    For more information see below.
  • action
    The adapter action derives from the used operation. Do not configure this.

You can select an existing alias from a drop-down list by clicking the text Select alias.

Alternatively, you can also create and add a new alias by clicking the corresponding icon.

Refer to Aliases for more information on how to create a new alias.

A new dialog opens where you can name and configure the new alias.
Refer to S3 for more information on the configuration options of this adapter.

Click Save to add the new created alias.


Otp
Floatingfalse

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNameS3Adapter_FileProductExportProductExport_Example
PageWithExcerptINTERNAL:_designer_examples
shouldDisplayInlineCommentsInIncludesfalse
Rp

Children Display