Broadcasting Action group

This topic describes the Procedure Actions included in the Broadcasting Action group and their specific properties.


The Broadcasting Actions allow you to send Presentations via email to a specified list of recipients, in different file formats. The Presentations can also be exported to specific paths within your Board environment. 

When Broadcasting is part of a Procedure, it can only be launched from the Procedures menu by a Developer or by an end user from a button configured with a Capsule Procedure.
When Broadcasting is part of a Procedure, it cannot be launched or scheduled from the Task Scheduler nor from a Board Public API. This will throw an error.

The Broadcasting Action group offers the following steps:

  • Broadcast to Board users. This step allows you to send an existing Presentation to a list of manually selected Board users.
    To configure this step, proceed as follows:
    1. Choose the desired Presentation from the “Presentation” drop-down list
    2. Choose the desired format for the attached Presentation (PDF, MS Word, MS Excel, MS PowerPoint) from the “File format” drop-down list
    3. Choose the Board users you want to send the Presentation to in the “Board Recipients” section. You can select or deselect them by clicking on the checkbox to the left of each user’s name.

      Please note that only users with an email associated with their Board account will be shown. See this page for more information about configuring Board users

    4. Enter the subject of the broadcast email in the “Subject” field
    5. Enter the email body in the “Message body” section (optional).

    This step also supports Substitution formulas and Metadata variables in the “Subject”  and "Message body" fields.

     

  • Broadcast to email list. This step allows you to send an existing Presentation to a list of manually entered email addresses.
    To configure this step, proceed as follows:
    1. Choose the desired Presentation from the “Presentation” drop-down list
    2. Choose the desired Presentation format (PDF, MS Word, MS Excel, MS PowerPoint) from the “File format” drop-down list
    3. Enter the email addresses of the recipients you want to send the Presentation to in the “Recipients” section.
      To add an email, enter the email address in the “New email” field and click the “+ADD” button on the right. You can add only one email address at a time.
      To remove an email address, hover over it and click the "X" icon at the end of the row
    4. Enter the subject of the Presentation email in the “Subject” field
    5. Enter the body of the email in the “Message body” section (optional).

    This step also supports Substitution formulas and Metadata variables in the “Subject”  and "Message body" fields.

     

  • Advanced broadcast rule. This step allows you to send emails using a Board Layout to extract all information to compose the email message: email addresses, message bodies, and email subjects will be retrieved from the Data Blocks configured in the associated Layout.
    Unlike the steps described above, this step does not require a Presentation attached, so you can use it to automatically send emails without attachments.

    To configure this step, proceed as follows:

    1. Choose the desired Presentation you want to send from the “Presentation” drop-down list. You can also choose “No attachment” if you want to just send emails without a Presentation attached

    2.  Configure the Layout with Data Blocks (usually text Cubes) containing the information needed to compose the email message, then associate them to the correct field as described below:

      • Address block: select the Data Block that contains the email addresses of the recipients

      • Email body block: select the Data Block that contains the message body of the email

      • Subject block: select the Data Block that contains the subject of the email

      • Cc block: select the Data Block that contains the email addresses of people you want to send a copy of the email ( CC, “carbon copy”) to, apart from the recipients identified through the "Address block" field

      • Bcc block: select the Data Block that contains the email the addresses of people you want to send a "hidden" copy of the email (BCC, “blind carbon copy”) to, without allowing other recipients to see that someone else has been sent a copy of the email



    The subject and message body of the email can also be filled in manually, instead of using Data Blocks, by entering the desired text in the "Subject" and "Message Body" fields on the right. These fields are available only if no Data Block has been selected in the "Subject block" and "Email body block" fields.

    Enable the ”Generate the presentation for each recipient using the layout row as filter” option and insert the desired Entity in the row axis of the configured Layout to filter the Presentation: the data shown in the attached Presentation will be related to each member of the Entity (as if using a Pager for each Slide of the Presentation). Therefore, each recipient will receive a Presentation with data only related to the members of the Entity set By Row that are in the active selection.
    For example, in the case where different area managers need reports of the countries they manage, you can dimension the Cube containing email addresses with a “Country” Entity and fill in the email of the Area Manager for each country. When configuring the Layout of the Procedure step, insert the address data block (Cube containing email addresses) and insert the “Country” Entity in the row axis.
    You should see a similar Layout:

    The result of this Layout is that each Area Manager will receive an email with a Presentation attached for each country he or she manages. Every attached Presentation will be filtered by showing data only related to each member of the “Country” Entity: Susan Meyer will receive three Presentations about France, Germany, and Switzerland, while Frank Cray and George Cowan will receive two Presentations each, about Italy and Spain and about the United Kingdom and the United States, respectively.
    For this option to work, the Layouts in the Presentation must also contain data related to the Entity set as a filter (i.e. the "Country" Entity in the example above).

    The option is disabled by default and, in this case, the Presentation attached to the email will be the same for all recipients.

For the three steps described above, Board Substitution formulas and Layout Blocks can also be included in the message body (provided a Layout has been configured in the "Advanced broadcast rule" step or in the "Export presentation to file" step). You can either choose them from the “Layout blocks” and “Substitution formulas” menus on the top right of the message body field or you can manually enter them into the message body.
This step also supports Metadata variables in the “Subject”  and "Message body" fields.

 

  • Export presentation to file. This step allows you to export a Presentation to a file, in a specified directory.
    To configure this step, proceed as follows:
    1. Choose the Presentation you want to export from the “Presentation” drop-down list
    2. Choose the desired Presentation format from the “File format” drop-down list The available formats are: Excel (XLSX), PDF, Word (DOCX), PowerPoint (PPTX)
    3. Choose the directory where the Presentation will be exported from the “Output folder” drop-down list. The “Board\Export” path is the default one.
      If needed, you can enter the path of a sub-folder in the “Sub folder” field. That sub-folder must be a valid sub-folder of the output folder defined in the previous field.

    Enable the ”Generate the presentation for each recipient using the layout row as filter” option and insert the desired Entity in the row axis of the configured Layout to filter the Presentation for each member of that Entity (as if using a Pager for each Slide of the Presentation): the Presentation will be exported into multiple files with the same name as each Member related to the Entity chosen as a filter, and each file will contain data only related to each Member of that Entity.

    For this option to work, the Layouts in the Presentation must also contain data related to the Entity set as a filter.

    The exported filename will have the following format: PresentationTitle_Member.xxx, where "Member" is the member code, description, or both, depending on the "Display" property of the Entity chosen as a filter  (for example, "Monthly report_June").

     

    This step supports the following Substitution formulas in the “Sub folder” field: @User, @UserName, @Database, and all the @Date variants except @Datetime.
    In addition, environment variables such as %bss% can also be used in the “Sub folder” field.

     

In the case of a Capsule Procedure, a Data model drop-down menu on the upper right corner allows you to select the Data model on which the Procedure step will be executed, except in cases where the Procedure step has specific options that act on other Data models (for example, the "Save Pending Changes to Disk" step in the "Advanced Action Group" can be configured to act on all Data models or only on the Data model where the Procedure resides).