Versioned files: datasheets, certificates and packages in Bruxel

By Manuel Mattar4 min read

In short

In Bruxel every product can carry its documents —datasheets, certificates, drawings, artwork— in the same library as its photos. Each file has a type, versions that can require approval, a virus scan before it can be downloaded, an expiry date if you need one, and output in ZIP packages with an index.

The problem: the right document in the wrong folder

A product's datasheet usually lives far from the product: in a shared folder, in an email from the supplier, on the computer of whoever received it. When a retailer asks for the certificates of 200 products, someone builds the package by hand, renames files and hopes none of them is the version from two years ago. And nobody notices that a registration expired until someone asks for it.

Bruxel solves this with the Files module: documents live next to each product, with versions, approval and expiry.

How it works in Bruxel, step by step

1. Upload the document to the product page

On the product page, the "Files" tab offers "Upload document" or "From the library". Bruxel recognizes each file by what it is, not by its name, and gives it a starting type: a PDF is a "Datasheet", a CAD file is a "Drawing", a 3D or BIM file is a "3D model". You can change it whenever you want, and the change applies to every product that shares that file.

Documents count against the same space as your images, but they never have a public address: they are downloaded through a link that lasts 5 minutes, and only after passing the virus scan.

2. Define your own file types

In "File types", under Media, an administrator creates the organization's own types —for example "Standards certificate" or "Packaging artwork"—, says which files each one accepts, whether it has an expiry date and whether it requires approval. Types no longer in use are archived.

3. Versions with approval

If a type requires approval, every new version of a file of that type stays as a "Draft" and products keep using the approved one. Whoever uploaded the version sends it for review; the approver gets a notification. "Approve" makes it the current version and the previous one becomes "Superseded". "Reject" asks for a reason, which stays in the version's comments.

To request a specific review there is "Assign review": who, by when, and a note. And the "Files by status" report tells you, for each file, whether it complies, whether it expired, whether it is missing its date or its approval, and whose turn it is.

4. Expiry

A file type with expiry asks for the expiration date and shows "Valid", "Expiring soon" or "Expired". In addition, any date attribute of the product can be marked as an expiry: the product page shows how many days are left, the catalog filters what expires within 30, 60 or 90 days, and every morning Bruxel notifies in the bell when a date enters its notice window and when it expires. The expiry alerts guide explains who receives them.

5. File packages

When someone asks for the documents of many products, you pick the products in the catalog —or a filter, or a saved view— and request a file package. It is built with a template from your organization: which types it carries, whether it takes the current version or the latest approved one, which images, what each file is called inside the ZIP and whether it includes an index. The index, in CSV and PDF, lists each file with its SKU, type, version, who approved it and its sha256 fingerprint, so whoever receives it can check that it is exactly that file. We notify you in the bell when the ZIP is ready.

Who it is for

A hypothetical example: an electrical supplies manufacturer with 3,000 products, each with a datasheet, a certificate and a drawing. With Files, the engineering team uploads new versions, quality approves them, dated certificates warn before they expire, and sales requests a package with the names each tender requires.

In general it serves anyone who sells products with technical or regulatory documentation: construction, hardware, electrical, personal care, food. The technical documents guide has the full list of formats and sizes.

What you need to get started

  • Your products in Bruxel, with their SKU.
  • Space in the library: documents count just like images, as the images and storage guide explains.
  • Decide on your file types: which ones each product needs, which ones expire and which ones require approval.
  • For packages, a template with the file names your destinations ask for.

Uploading and changing the type is for Editors and above; downloading, for anyone who can see the product.

Honest limits

  • Expiry alerts live in the bell, not in email, and they only check the attribute's general value, not the value for a language or a channel.
  • The virus scan takes a few minutes. Until then the file cannot be downloaded, and the tab does not refresh by itself: you have to reload.
  • A password-protected file cannot be scanned: upload it without the password.
  • Using a document to describe the product does not change what is generated yet. The flag exists for when Bruxel reads your datasheets while generating.
  • A 3D model uploaded as a document is an attachment: it does not show in the product page's 3D viewer.
  • Packages have caps: up to 5,000 products, 10,000 files and 10 GB per package, and the ZIP is deleted after 7 days, although you can request it again.
  • Up to 60 downloads per minute per organization.

To see the whole module on one page, open the Files page.

Frequently asked questions

Do documents have a public address?

No. They are downloaded through a link that lasts 5 minutes, and only after passing the virus scan. A file with a threat goes into quarantine and is removed from its products.

Which formats are accepted?

PDF, HTML, text and CSV, Word, Excel and PowerPoint, CAD, BIM, 3D models and design files such as Illustrator or Photoshop. A ZIP, an executable or an Office file with macros is not accepted.

Does Bruxel warn me when a certificate expires?

Yes, in the notification bell. A date marked as an expiry warns when it enters its notice window and when it expires. For now these alerts are not sent by email.

Can a draft end up in a package?

No. A package only carries approved or current versions that passed the virus scan, according to what its template says.

Sources

  1. Digital asset management (Wikipedia)
  2. Version control (Wikipedia)
  3. SHA-2 (Wikipedia)

About the author

Manuel Mattar

Founder of Bruxel.AI

In 2014 he founded Wolf Sellers, an e-commerce agency in Mexico City, and later Bruxel.AI, the AI-powered PIM.

See all posts by Manuel Mattar

Try it with your catalog

Create your free account and try Bruxel with your own products using the welcome credits.

Keep reading

Versioned files: datasheets, certificates and packages in Bruxel