Data Workbench 6.3 Release Notes

Data Workbench 6.3 release notes include new features, upgrade requirements, fixed bugs, and known issues.

New Features

Data Workbench 6.3 includes these new features:

Upgrade Requirements and Recommendations

New profiles for Data Workbench are located on the Software and Docs profile at

Profiles - Current\DataWorkBench\
  English Translated\DataWorkBench_6.31-en-us\

Upgrade Server:

• Update the Meta.cfg file (E:\..\Profiles\<your custom profile>\Context\meta.cfg) to set updated password encryption for the File System Unit (FSU server), and to add entries for the Name Value Pair tranformations to take advantage of Query String Grouping.

  1. Open the meta.cfg file on the FSU.

  2. Change the data type for Proxy Password from " string" to " EncryptedString" in the Workstation Configuration section.

     Proxy User Name = string:
     Proxy Password = EncryptedString:   (from Proxy Password = String)
     Use Address File = bool: true
     

  3. Add new entries to enable the new Name Value Pair transformations: BuildNameValuePair and ExtractNameValuePairs.

     Open a workspace and right-click Admin > Profile Manager.

     Under Context, click the meta.cfg file in the Base column and then click Make Local. From the User table column, right-click and select Open > in Workstation.

     

     • In the new window, click metadata and add acceptable children templates.

     

     • Open transformation and add new templates.

     

• Update for Fast Merge improvements. Add parameters or change values to the following configuration files to take advantage of speed improvements in Data Workbench during a transformation.

  • Communications.cfg (E:\Server\Components\Communications.cfg)

    18 = SourceListServer:
        URI = string: /SourceListServer/
        Listing Interval = int: 10 (new)
    

  • Disk Files.cfg (at E:\Server\Components and E:\Server\Components for Processing Servers)

    Disk Cache Size (MB) = double: 1024 (from double: 256)
    Disk Cache Read Limit (MB) = double: 768 (new)
    

  • Log Processing Mode.cfg ( E:\Server\Profiles<your profile>\Dataset\Log Processing Mode.cfg)

    <i>(changed)</i>
    Batch Bytes = int: 268435456
    Cloud Bytes = int: 268435456
    Real Time FIFO Bytes = int: 268435456
    

    (new)
    Cache Bytes = int: 32000000
    Fast Input Decision Ratio = double: 200
    Fast Input FIFO Bytes = int: 268435456
    FIFO Hash Mask = int: 16383
    Fast Merge Buffer Bytes = int: 536870912
    Slow Merge Buffer Bytes = int: 268435456
    Fast Merge Fan In = int: 64
    Key Cache Size Logarithm = int: 21
    Max Seeks = int: 512
    Output Old Buffer Bytes = int: 536870912
    Overflow FIFO Bytes = int: 67108864
    Paused = bool: false
    

    NOTE

    • To take advantage of the Fast Merge improvements, make sure you have at least 8 GBs of RAM per DPU.

    • The Save Interval, the duration between dataset saves, might need to be reduced if the new Log Processing Mode parameters are applied. Because the Transformation will complete faster, the dataset state file will contain more data between Save Intervals compared to prior versions.

      It is recommended to reduce the Save Interval setting to 1800 seconds (30 minutes)—the default Save Interval is 3600 seconds (1 hour). (If this line needs to be added to the Log Processing Mode.cfg, note that there are two (2) leading spaces).

    Save Interval (sec) = int: 1800

    • It is recommend that the new Log Processing Mode parameters not be applied to a dataset that is configured with a CrossRows using the All operation. With these settings, the memory usage for this operation can become too great for the environment.

• Adobe Target with DWB integration update. A new export file, ExportIntegration.exe, replaces the existing TnTSend.exe file on the Insight Server ( E:\Server\Scripts\TnTSend.exe). This new export file supports both Adobe Target integration and coordination with the new Master Marketing Profile (MMP) and Adobe Audience Manager.

  You will need to update the following commands for Adobe Target exports.

  Command = string: TnTSend.exe

  to

  <filepath>
  Command = string: ExportIntegration.exe
  </filepath>
  

  NOTE

  This will only affect exports created prior to version 6.3.

  You can also try the following to employ the old export process:

  • Create a new Test And Target Export in the workstation.
  • Modify the old Test and Target export found in Server/Profiles/<your profile>/Export.

• Update the Adobe SC profile. Changes to the Exclude Hit.cfg file require a field to be declared in the associated Decoding Instructions.cfg file.

  NOTE

  If your Adobe SC profile includes a customized Decoding Instructions.cfg file, you will need to include a DelimitedDecoder parameter to your customized file.

  0 = DelimitedDecoder:
     Delimiter = string: \t
     Fields = vector: x items
     …
        5 = string:
  Changed to:
  
  5 = string: x-hit_source
  

  Adding the DelimitedDecoder field allows you to take advantage of feature updates and to avoid possible Log Processing problems resulting from these updates.

Upgrade Client:

• Update your client from the server.

  Once your server has been updated, your client can update automatically if the Insight.cfg file is configured properly:

  1. Edit the Insight.cfg file.

     Update Software = bool: true
     

     Then Save.

  2. Exit and launch the client.

  3. Connect to the profile.

     The client will automatically upgrade to Data Workbench 6.3.

  4. Exit out of the client.

  5. Edit Insight.cfg

     • Change Proxy Password = string:

       to Proxy Password = EncryptedString:

       Remove the value of the previous Proxy Address and Proxy Password.

     • Save.

  6. Launch the client.

  7. Edit Insight.cfg.

     • Enter Proxy Password for all the servers and Save.

     • Enter the Proxy Address for all the servers and Save.

       IMPORTANT

       The Proxy Address and Proxy Password must be entered and saved from within the client.

  8. Connect to the profile.

  NOTE

  • Follow the exact upgrade sequence in order to avoid an account lockout. If the account is locked, please perform all the required changes in the exact sequence listed, save your work, and exit out of the client. Wait for the lockout to release (about 45 minutes), then launch the client again.
    • The password modification should be performed in the client only due to the fact that the passwords are saved in Windows Credential Vault.

• Recommendation: **New Windows Aero Themes. ** Upgrade the look of your client application using Windows Aero Themes.

• Recommendation: Fonts for Chinese and Japanese versions:

  Chinese:

  • Arial
  • SimSun

  Japanese:

  • MS Gothic
  • Meiryo
  • MS Mincho
  • Arial
  • SimSun
  NOTE

  SimSun can be used for Chinese and Japanese. If attempting to write in half-byte characters in Japanese, you also need to include MS Mincho. To enable these fonts in Insight.cfg, you can add these parameters.

  0 = string: Arial
  1 = string: SimSun
  2 = string: MS Mincho
  

  These fonts should be listed in the workstation configuration file: Insight.cfg.

Upgrade to Adobe Analytics Premium

To run Best Fit Attribution in Data Workbench, you need to receive new certificates from Adobe ClientCare for your Client, Server, and Report Server (.pem files) to support Adobe Analytics Premium. Each of the new certificates will have this parameter:

Product = Premium

The Premium Package is available for download on Software and Docs under the Getting Started tab on the Profiles and Lookup files workspace. Navigate to Profiles - Current\DataWorkBench\<language>\Data WorkBench_6.30-en-us\Premium_6.30_en-us.zip. Once the Premium profile is loaded on your Server, you will need to add a Premium parameter to your custom Profile.cfg file. This allows your custom profile to include the menus, visualizations, and workspaces as part of Adobe Analytics Premium.

Fixed Bugs

• Fixed issue where the Density Map visualization was missing largest elements.
• Fixed issue in Density Map where area of elements was not portraying the proportion of the metric value.
• Fixed issue where dragging metric from Finders panel to metric legend outside of the metric column would delete the legend from the workspace.
• Fixed issue where Print Workspace using Sidebar and Both options will not include the Copyright info in the printed page.

Known Issues

• Users of AMD Radeon™ graphics cards should update to the latest graphics drivers. Some early versions of the driver claim they support openGL 3.2 but are inconsistent.

• Output generated by Segment Export configuration without a header declaration can result in a bogus header appearing at the beginning of the file that conflicts with the first set of rows.

• Add Dimensions is showing only the Extended Dimensions. The workaround is to use the Finders tool to drag dimensions to tables.

• When 3D Scatter Plot Visualization includes callouts, the zoom might display plots outside the border of the visualization. To work around this issue, zoom the 3D Scatter Plot first and then add callouts to your visualization.

• Using Workstation in Remote Desktop session will crash when renaming workspaces.

• List Item

• Legacy Segment export files output with double quotes even if the export file doesn’t contain quotes in the Output Format field.

  Workaround: Add these three lines to the .export file. Setting these values will not trigger an MMP integration (as other configuration fields are required) but will bypass unwanted automatic escapes.

    MMP Configuration = MMPConfiguration:
      MMP Segment Name = string: UNESCAPE DUMMY
      MMP Visitor ID Field = string: [Specify a Dimension from the output of
                                      the current export]
  

  (The first line has two (2) leading spaces and the next lines four (4). The Dimension from the output of the current export needs to be referenced in the MMP Visitor ID Field.)

Business.Adobe.com resources

Audience Analytics Contribution Analysis Cohort Analysis General Data Protection Regulation Predictive Analytics Analytics