Documentos de Académico
Documentos de Profesional
Documentos de Cultura
Chapter Overview
This chapter introduces and discusses some additional tools and capabilities provided by
Rollbase such as multi-currency support, approval processes (sequential, parallel and tallied
votes), record queues, surveys (online questions), integration with Google Apps (Gmail, Google
Spreadsheets and Google Calendar), Google Maps and even Facebook.
Multi-Currency Support
Rollbase supports conversion between monetary values in different currencies. It is common for
businesses to keep their accounting books in one currency (let us call this the base currency),
while sending and receiving money in several other foreign currencies. In addition, exchange
rates between currencies tend to change over time.
Rollbase provides a multi-currency framework for all customers. To start utilizing multi-
currency, follow the steps below:
{D}US Dollar|USD
Note: Currencies are essentially shared picklist items (see Chapter 2. Basic Concepts for
more details).
1
Chapter 13: Additional Application Tools: Advanced Rollbase in Action
Note: By entering the exchange ratio between one unit of foreign currency and one unit of
base currency, the inverse is handled for you automatically. For example, defining a EUR/USD
ratio as x also defines an USD/EUR ratio as 1/x.
You can also use the SOAP API to store exchange rates. See Chapter 15. Integration and
Rollbase APIs: SOAP, REST and RSS for more details. If you will be using multi-currency
capabilities on a daily basis you might consider building an automated integration with another
web service to retrieve exchange rates and populate them in Rollbase for you.
Note: To managing exchange rates user must have Administrator role or “Manage Exchange
Rates” administrative permission.
Multi-Currency Attribute
Enable the Multi-Currency attribute on the desired Objects that adds two new fields:
Currency Code, used to specify the type of currency for a particular record (e.g.,
Invoice)
Rate Date, used to determine the date for the exchange rate calculation (current date by
default). This field ensures that the exchange rate calculation for any given record does
not change over time as the exchange rates change.
2
Chapter 13: Additional Application Tools: Advanced Rollbase in Action
The exchange rate on 05/25/2010 is set to: GBP/USD = 1.4472. Rollbase calculates and displays
the value for the Base Amount (which is configured to use USD) as $2,894.40.
Note: Although the Base-Currency field is read-only, you can use it in Formula fields and
Triggers, as well as to calculate totals in List Views and Reports.
Important: Modifying an exchange rate on a particular date will not affect any Base
Currency values that already have been calculated because, unlike Formula fields which are
3
Chapter 13: Additional Application Tools: Advanced Rollbase in Action
dynamically computed, Base Currency fields are calculated and stored in your database.
However, when you edit and save an existing record, this value will automatically be updated
using the currently available exchange rate corresponding to the assigned rate date.
Approvals
Rollbase Approvals involve multi-step processes which you should be planned in advance to
provide the best results.
Tip: The Approval process starts when a particular record is moved to the Workflow status
called “Waiting for Approval,” and ends when the record is moved to the status called
“Approved” or “Rejected.” Rollbase provides a default implementation for this process that you
can customize, including the names of these statuses.
Select Approvers
Next, select a group of Users who will participate in the Approval process. Make sure the
“Approver” checkbox is checked for each of these Users in the User Edit page (if you do not see
this box, use the Page Editor to add it to the Page).
4
Chapter 13: Additional Application Tools: Advanced Rollbase in Action
Tip: If you want more than one object participate in approval process set "Approval"
attribute on each object.
5
Chapter 13: Additional Application Tools: Advanced Rollbase in Action
Any user with sufficient permissions can invoke the “Start Approval Process” action for a
selected record (or a number of records if the “Group Action” attribute is enabled).
An email to the first approver will be sent (or all approvers for a parallel or tally votes
process).
The email should include a link to the record being approved, with one-click login (see
Chapter 11. Security and Access Control for details).
Approvers will also see a list of records currently waiting for their approval in the “My
Approvals” tab.
After reviewing a record submitted for approval, the approver clicks the “Approve or
Reject” button, where he/she can:
o Provide comments
o Click the “Approve” or “Reject” button
6
Chapter 13: Additional Application Tools: Advanced Rollbase in Action
If the record is approved, the sequential process will continue and an email will be sent to
the next approver in the sequence.
If the record is rejected, the approval process will end and the record will be moved to the
“Rejected” status (any approver has veto power, except for the “Tally Votes” process
described above).
When all approvers have approved the record, it is moved to “Approved” status.
Tip: You can associate Triggers to run when a record’s Status is changed to the Approved or
Rejected status. It is common to configure a Trigger to notify specific Users when a record has
been approved or rejected using this technique.
Record Queue
This Record Queue feature is a type of Workflow process specifically tailored for situations in
which a queue of records of a certain type need to be processed by a specific group of Users.
Rollbase automatically creates this Workflow process when you add the Queue attribute to an
Object definition.
Note: The Queue attribute will enable the Workflow attribute if not already enabled.
When you enable the “Queue” attribute on your Object definition, Rollbase will create the
following Object components:
Two new Workflow Statuses: “In Queue” and “In Process.” The former is assigned by
default to the first Workflow Process of your Object.
A Relationship between this Object and the User object (if not already created).
A new Workflow Action named “Start Processing” with a Status Change Page (more
details below). This Page assigns the current User to the record being updated. The “Start
Processing” action is available for the “In Queue” Status and can be used for one record
or a group of records.
7
Chapter 13: Additional Application Tools: Advanced Rollbase in Action
A View named “In Queue,” which shows only records in the “In Queue” Status in the
order that they were created.
New records are created (for instance, leads from a Portal) and placed in the “In Queue”
status.
Any user who has permission to access these records and the “Start Processing”
Workflow Action can invoke this action on one or more groups of records.
That User’s name will be associated with the record(s) and the status of each record will
be changed to “In Process”.
Tip: You can further modify the “Start Processing” action and make the entire Workflow
more sophisticated by adding more steps to emulate your business process. The “Queue”
attribute helps you start building such a process with minimal effort.
The diagram below illustrates the process of creating and taking a survey.
8
Chapter 13: Additional Application Tools: Advanced Rollbase in Action
Tip: If you enable the “Survey” attribute on an existing object you can add the “Questions”
menu to its tab.
Questions Library
Survey Questions form a shared library that can be used by any survey of any object type.
Survey questions are grouped by categories. One category is available by default: Generic. You
can create new categories and rename or delete existing categories.
Tip: You can only delete categories that have no questions associated with them.
9
Chapter 13: Additional Application Tools: Advanced Rollbase in Action
Click “New Question” next to a particular category to create a new Survey Question. Next select
the type of question:
Text: Users can enter any combination of characters. You can optionally define an input
mask to enforce certain kinds of input.
Text Area: Users can enter multiple lines of text. You can optionally enable a rich text
editor so users can enter text as formatted HTML.
Picklist: Users can select a value from a list of values defined by you.
Picklist (Multi-Select): Users can select any number of values from a list of values
defined by you.
Radio Buttons: Group of radio buttons with mutually exclusive selection
Checkbox: Users can select a Checked (true) or Unchecked (false) value.
Group of Checkboxes: Group of checkboxes with multiple selections
Currency: Users can enter a dollar or other currency amount.
Date: Users can enter a date or pick a date from a calendar popup.
Date/Time: Users can enter a date and a time, or pick a date from a calendar popup
(when a date is selected from the calendar popup, that date and the current time are
entered into the Date/Time field).
Email: Users can enter an email address which is checked to ensure that it is a valid
format.
Integer: Users can enter any number (without decimals).
URL: Users can enter any website address.
Next, select properties for your question that can be different for different types. For instance,
Text questions have the following properties:
Question label
Short label
Category (the list of categories can be managed from the “Questions” menu)
Check if this question must be answered
Check if you want to publish this question in any application which includes the Survey
object
Size of HTML input box
Keywords: you can specify keywords and their ranking in the range from -1000 to 1000.
A score calculator will award scores for specified keywords in the answer.
10
Chapter 13: Additional Application Tools: Advanced Rollbase in Action
Tip: You can attach questions from the library directly or create a copy (clone) of each
question. In the latter case if you modify the selected question it will not affect the version in the
Library.
11
Chapter 13: Additional Application Tools: Advanced Rollbase in Action
You can access pages of this type from an object definition’s page. Click on the “Config” link to
configure page-level settings:
Now you can add a URL to your “Take Survey” page to any template on an application or portal
page using the “Surveys” section in the Template helper. The “Survey Pages” group in the
Template helper provides you with a merge field token that will be resolved into the URL of the
Survey page. You can use this URL in links or in an HTML button control.
Tip: The URL to a Take Survey page may include the ID of a particular survey:
&surveyId=123456 If that ID is not included the default Survey record (selected in the Config
page) will be used. If this URL parameter is not included – the system will use last survey record
in scope (being viewed or accessed).
12
Chapter 13: Additional Application Tools: Advanced Rollbase in Action
Survey Takers
Both regular Rollbase Users and Portal Visitors can take surveys. To enable someone to take a
survey you need to make sure that User or Portal Visitor has the special object attribute enabled
called “Survey Taker”.
The Rollbase User object by default has the “Survey Taker” attribute. If for some reason the
User object in your Customer does not have this attribute, you can manually edit the User object
and enable the “Survey Taker” attribute.
If you wish to post your survey questions in a portal page, make sure to enable both Portal
Visitor and Survey Taker attributes on the appropriate object.
Tip: A portal visitor must be authenticated in order to take a survey. Surveys will only work
in portals that have authentication enabled (this is required in order for Rollbase to know who is
taking the survey).
Taking a Survey
Using the right link (as described above), an application user or portal visitor can navigate to
“Take Survey” page. There he/she will be presented a list of selected questions grouped in
sections by category.
Answers to survey questions are subject to validation rules similar to those for Object Fields:
required questions must be answered, integer questions must be parsed as integers, etc.
13
Chapter 13: Additional Application Tools: Advanced Rollbase in Action
Finally the results of a survey are recorded and can be viewed along with the record of each
Survey Taker. On the record View page you will find a “Survey Answers” component (use the
Page Editor to add it if it is not automatically added to your View page).
The “Survey Answers” component lists all surveys taken. For each survey it displays a list of
questions and answers provided. If ranking criteria was set for a particular question, the system
also calculates and displays an assigned score along with maximum and minimum possible
scores.
Tip: Minimum score is only used when negative ranking was specified. Otherwise the
minimum score is 0.
The object fields “Survey Score” and “Rank” (i.e. score as a percentage of maximum score) can
be used to set up triggers (i.e. business logic and automation) related to surveys.
Make sure that your “Portal Visitor” object also has the “Survey Taker” attribute.
Create a Survey object, survey questions and survey record (see above).
Use the Page Editor to add the “Survey Answers” component to the New and Edit pages
of your Portal Visitor/Survey Taker object.
Use the “Config” link on that Survey Taker page to select the Survey record to be used
by that page.
Now when a visitor is created or updated, the portal page will display a list of survey questions.
Answers to these questions will be associated with the visitor record and available on the View
page.
14
Chapter 13: Additional Application Tools: Advanced Rollbase in Action
Tip: You can include a desired survey ID directly into the link to a survey page by adding
the following additional URL parameter: &surveyId=12345
Gmail (rather than Rollbase email server) should be used to send emails for this User.
Google Calendar should be synchronized when Rollbase records with the Event or Task
attribute (related to the current User) are created or updated.
Tip: These fields may not be on your page by default. In this case use "Edit Page" link to add
"Google User Name" and other fields to the page.
Important: To use Gmail integration, beyond providing your credentials you also need to
do the following setup in Gmail:
1. Login to your Gmail account
2. Click “Settings” then click “Forwarding and POP/IMAP” tab
3. In the IMAP Access section make sure “Enable IMAP” is selected.
Now if you provided the correct credentials and checked the “Use Gmail” checkbox, Rollbase
will use Gmail to send emails on your behalf. This means that you will now see all Rollbase-
generated emails in your “Sent Mail” folder. Also, when a recipient replies, Gmail will group
reply message with your original message for convenience.
15
Chapter 13: Additional Application Tools: Advanced Rollbase in Action
Important: Whenever you are sending an email using Gmail integration, Rollbase will
display a reminder about it and give you a chance to test your Gmail connections to ensure that
your stored credentials are up-to-date with your Google account.
Tip: If you do not see the “Gmail” tab in your default “Rollbase” application use the Page
Editor and add the “Incoming Emails (Gmail)” component to any Generic page.
The list of messages in your Gmail inbox displays the sender’s email address, as well as the
subject and date of the email. Unread messages are shown in bold and starred messages have a
star as you would see them in your Gmail account. This list is sorted by date in descending order
and can be scrolled back and forth.
16
Chapter 13: Additional Application Tools: Advanced Rollbase in Action
Tip: Rollbase will try to match the email addresses in a message to the records in your
Tenant. If a match is found, Rollbase will display a link to the matched record.
Tip: If a message in your inbox was originated by Rollbase and relates to a particular data
record (such as an Invoice) Rollbase will resolve this and display a link to that record (see
“Related To” field in the above screenshot). This is generally true even if the original message
was replied or forwarded before landing in your mailbox.
17
Chapter 13: Additional Application Tools: Advanced Rollbase in Action
Second, make sure that “Synch Calendar” box is checked on your Personal Settings page (see
Section 6.1 above). From this point on Rollbase will automatically update your Google calendar
every time an event assigned to you is created or updated.
Tip: You may need to refresh your Google calendar to view the result of synchronization
with Rollbase calendar.
Tip: To synchronize your events with other calendars such as Microsoft Outlook Rollbase
provides the capability to export your Event and Task records in the standard iCal format. Click
on the “Synchronize” link (make sure “iCal File” field is present on your Event or Task View
page). Outlook will read data from your event or task record and prompt you to create a record in
your calendar.
The Google Maps component will render a map of the record’s address as shown here:
18
Chapter 13: Additional Application Tools: Advanced Rollbase in Action
Height of component in pixels (it will take 100% of available width by default)
Default zoom level (can be changed at run time)
Default map’s type (street, satellite, etc.; can be changed at run time)
Mobile Interface
Rollbase on iPhone and Android
All Rollbase applications can be easily accessed on iPhone and Android devices via a dedicated
mobile user interface specifically designed for smart phone browsers. The screenshots below
illustrate the core capabilities of the Rollbase Mobile user interface.
Existing Rollbase applications can be mobile-enabled in just a few clicks. Use Application View
> More Actions > Mobile Enabled page. Then check "Mobile Edition" box and select menus
which should be available for Mobile Edition of your application.
19
Chapter 13: Additional Application Tools: Advanced Rollbase in Action
Secure Login
Users can login to Rollbase.com Hosted Cloud
or any Private Cloud instance via a dedicated
mobile login page. The standard Rollbase login
page automatically redirects smart phone
browsers to this mobile-friendly page.
20
Chapter 13: Additional Application Tools: Advanced Rollbase in Action
Browse Applications
By simply checking a box to mobile-enabled
your Rollbase application, users who have
permissions to access it will see it in their list
of available applications when the login. As an
Administrator you can control which objects
from each app are mobile-accessible.
Browse Records
Touching a menu drills down to a list of
records for the associated Object. Users can
select any Views they have access to for
navigating lists of records. Flagged records
will be shown with the standard flag icon and
unviewed records will be shown in bold blue.
21
Chapter 13: Additional Application Tools: Advanced Rollbase in Action
View a Record
Touching a record brings the user to a detail
view showing each of the record's values
organized into sections defined by the Object's
default View page layout. As an Administrator
you can customize how this page is organized.
Users can touch Email addresses to send an
email and phone numbers to make a call
directly from their phone.
Global Search
A global text search box at the top of every
page in Rollbase Mobile allows quick and easy
searching through any records the user has
access to. Results are shown in a pageable list
from which the user can drill down to view
individual records.
22
Chapter 13: Additional Application Tools: Advanced Rollbase in Action
Wrapping Up
In this chapter we introduced and discussed some additional tools and capabilities provided by
Rollbase such as multi-currency support, approval processes (sequential, parallel and tallied
votes), record queues, surveys (online questions) and integration with Google Apps (Gmail,
Google Spreadsheets and Google Calendar), Google Maps and Facebook. In the next chapter we
will cover several Setup and Administration features not yet discussed in detail.
23