Biuwer Docs
Biuwer.comBlogLog InTry for free
English
English
  • Welcome
  • Getting Started
    • What is Biuwer?
    • Glossary
    • How to use Biuwer?
      • Sign Up process
      • Accessing Biuwer
      • Home page and navigation
      • My user Profile
      • Managing content
      • Exploring data
      • Filtering data
      • Collaborating with data
      • The Film Rentals space
    • How Biuwer works
    • Next steps
  • Managing Data
    • Introduction
    • Data Connections
    • Datasets
    • Data Models
  • Content Management
    • Introduction
    • Personal space
    • Shared spaces
    • Favourite content
    • Pages
    • Cards
      • Data Card Editor
      • Data queries
      • KPI card
      • Vertical Table Card
      • Cross Table Card
      • Chart Card
      • Map Card
      • Custom Card
      • Calculated fields
    • Filters
    • Multilanguage
  • Creating a Dashboard
    • What questions I want to answer
    • What data sources are there
    • Setting up data connections
    • Setting up datasets
    • Setting up data models
    • Create cards
    • Create the page
    • Setting up access security
  • Security Management
    • Introduction
    • Platform permissions
    • Roles
    • Object permissions
    • Permission inheritance
    • Property of objects
    • User access logs
  • Administration
    • Organization
      • 🎨Themes
      • 🎨Color palettes
    • Users
    • Groups
    • Roles
    • Authentication tokens
  • INTEGRATION GUIDE
    • Introduction
    • Concepts to take into account
      • Contents to integrate
      • Shared resources
      • Users
      • Groups of users
      • Authentication Tokens
      • Data Policies
    • How do I integrate Biuwer into my application?
      • Items to prepare
      • Content access security
      • Data access security
      • Embedding a resource in my application
    • Integration Types
      • Manual integration
      • Automated integration
Powered by GitBook
On this page

Was this helpful?

  1. INTEGRATION GUIDE
  2. Concepts to take into account

Shared resources

PreviousContents to integrateNextUsers

Last updated 11 months ago

Was this helpful?

Using the Biuwer interface, from the content listings, you can share any Collection, Page or Card. This step will generate what is called a "shared resource" that has a unique alphanumeric identifier, the Shared Resource Token, that you must take into account to be able to identify the content correctly.

A shared resource includes a validity period, that is, it is valid from a certain date and time, and you can optionally configure a date and time until which it is valid and can be used. If a user accesses a share outside the validity time range, the content not found screen will be displayed.

The integration of a shared resource in an external application is done by inserting an HTML IFRAME in the application code, which can be written using different technologies and languages, but at the end of the day it must be a web application that speaks HTML , CSS and of course, Javascript.

The IFRAME code follows this pattern:

<iframe 
	frameborder="0" 
	width="800" 
	height="1000" 
	name="HERE_MUST_BE_A_RESOURCE_TOKEN:HERE_MUST_BE_AN_AUTH_TOKEN" 
	src="https://INSTANCE_NAME.biuwer.com/share"
>
</iframe>

In the previous code, you can modify the width and height of the IFRAME, taking into account that scrolls (horizontal and/or vertical) will be shown when the content does not fit in the configured size. Something common, if you define in your application a DIV with exact dimensions to embed within content, is that in the IFRAME the dimensions are indicated as 100%. This way it would be: width="100%" and height="100%".

The most important thing is the correct configuration of the value of the "name" attribute of the IFRAME, which includes two alphanumeric codes separated by the character ":".

  • User Authentication Token: this is the unique alphanumeric code that is generated when creating an Authentication Token associated with a specific user in Biuwer.

  • Shared Resource Token: this is the unique alphanumeric code that has been generated when sharing the content on Biuwer.

In practice, integrating a resource into an application involves including in its code, associated with a route or menu item, an IFRAME like the previous one, where the Shared Resource Token is whatever you want, but it is fixed for the same resource, and the Authentication Token is that of the Biuwer user with which the user identified within your application is uniquely associated.

Share a collection in Biuwer, to obtain a shared resource