Cloud Events Storage – Help

Cloud Events Storage is a Business Central extension by Origo that exposes the standard BC external file storage connectors (Azure Blob Storage, Azure File Share, and SharePoint) as Cloud Events message types. External systems gain direct read/write access to cloud storage from Business Central through the Cloud Events API.

The extension adds file, directory, and chunked upload operations as message types to the Cloud Events framework. Each operation is addressed by a storageCode that maps to a configured storage connection.

Pages

Page Description
Cloud Events Storage Setup List of configured storage connections. Each row binds a storage code to a BC file account.
Cloud Events Storage Connection Card for editing a single storage connection — connector, file account, base path, and test.

Message Types

Message Type Description
Help.Storage.GetReturns a Markdown overview of the storage connector and all message types.
Storage.Account.ListLists configured storage connections (codes and connectors; no secrets).
Storage.File.ListLists the files in a directory.
Storage.File.GetDownloads a file as base64.
Storage.File.CreateUploads a base64 file to storage.
Storage.File.DeleteDeletes a file.
Storage.File.CopyCopies a file to a new path.
Storage.File.MoveMoves a file to a new path.
Storage.File.ExistsChecks whether a file exists.
Storage.Directory.ListLists the directories in a path.
Storage.Directory.CreateCreates a directory.
Storage.Directory.DeleteDeletes a directory.
Storage.Directory.ExistsChecks whether a directory exists.
Storage.Attachment.OffloadOffloads an attachment file to storage and clears it from the database.
Storage.Attachment.RestoreRestores an offloaded attachment from storage back into the database.
Storage.Attachment.CreateLinkedAttaches a file already in storage to a new or existing incoming document.
Storage.Upload.BeginOpens a chunked upload session for large files.
Storage.Upload.AppendAppends one base64 chunk to an open upload session.
Storage.Upload.CommitAssembles chunks and writes the file to storage.
Storage.Upload.AbortDiscards an upload session without writing to storage.
Storage.Upload.StatusReports the progress and state of an upload session.

Getting Started

  1. Install a BC file storage connector app (Azure Blob Storage, Azure File Share, or SharePoint).
  2. Configure a file account in the connector's setup.
  3. Open Cloud Events Storage Setup and create a connection binding a code to that account.
  4. Use the Test Connection action on the Storage Connection card to verify connectivity.
  5. Send Cloud Event messages with "storageCode": "YOUR-CODE" in the request payload.