Introduction to Logi Studio

Logi Info includes our primary development tool, Logi Studio. This integrated development environment is the recommended tool for use by developers creating Logi applications. This topic provides a brief introduction to the features of Logi Studio.

This is just a brief introduction to Logi Studio; we recommend you follow up by reading the user guide Using Logi 12 Studio.

About Logi Studio

Logi Studio is a tool designed to let developers create Logi applications as easily and efficiently as possible. The definition files that form the "source code" of a Logi application are simple text files and can be edited with any text editor; however, Logi Studio makes the development and testing process typical of programming much easier.

Logi Studio is not a web application; it's a .NET application and a licensed copy must be installed on the Windows computer of each developer. It allows you to create both .NET and Java-based Logi applications and reports.

All of the files that make up a Logi application, including definitions, images, style sheets, scripts, and more, can be managed within Studio. All files, with the exception of images, can be created and edited within Studio. Files can also be managed directly in the Windows file system.

Studio includes a number of wizards and other tools that automate many standard development tasks, incorporates a set of "rules" that prevents you from combining incompatible objects. It also provides Intellisense-like features that provide code completion options to speed development. Its element-based technique of adding and arranging objects in a hierarchical tree eliminates tedious coding and allows for code-reuse.

This topic refers to the latest version, Logi 12 Studio. A detailed user guide, Using Logi 12 Studio, is also available.

Welcome to Logi Studio. We hope you'll enjoy working with it.

Launching Logi Studio

When Logi Info is installed, it creates a Start menu entry for Logi Studio:
 

The installer (or you) may also create a Desktop shortcut, shown above, right. Click either of these to launch Logi Studio.

You can also launch Logi Studio, and open an application in it, from a Command Line window. To do this:

  1. Open a Command Window.
  2. Navigate to the Logi Info installation folder. The default is: C:\Program Files\LogiXML IES Dev.
  3. In that folder, navigate to the LogiStudio\bin folder.
  4. Issue the command: LogiStudio.exe "Logi application path"  where the path is a fully-qualified path to the Logi application folder.

Logi Studio Geography

Logi Studio has a simple layout that makes it easy to develop applications and provides an array of features and tools. Learning "what's where" is the first thing you should do when beginning to work with Studio.
 

The Getting Started Dialog Box

The first time you launch Studio, you'll see the Getting Started dialog box:
 

The dialog box, shown above, contains everything you need to quickly become familiar and productive with Studio. You should definitely explore all of its contents if you're a Logi Info newbie. You can hide it when you no longer need it.
 

The Welcome Panel

With the Getting Started dialog box hidden, you'll see the Welcome panel when you start Studio and whenever there's no application open.
 

The Welcome panel provides quick links to recently-opened applications, links that open applications using a variety of methods, and a link to DevNet, our online community. In addition, you'll see some useful content, from DevNet, displayed in a scrolling area.
 

Working on an Application

When you open an application in Studio and begin editing a report definition, it looks like this:
 


Logi Studio uses six standard panels, which can be resized to suit your needs:
 

 

  1. The Application panel groups all of the files that make up a Logi application together into one file management tree.

    A Filter Definitions control is available at the top of the Application panel for filtering definitions in all categories at once. Clear the control to remove all filters.
  1. The Workspace panel is where files are edited. Tabs at the top are displayed for each file that's opened, as well as the Welcome and Application pages. Different editors are displayed within the tab pages depending on the file type being edited (report definition, style sheet, XML data, etc.). Report definitions (shown) display the elements that make up a report, in a hierarchical Element Tree.

    When editing report definitions, tabs at the bottom are displayed for switching between views of the Element Tree (the Definition), the underlying XML source code (Source), and a mini-browser preview of your work (Preview). When the Preview or Source tab is selected, the Element Toolbox, Attributes, and Test Parameters panels are automatically hidden, allowing the full width of the Workspace panel to be used.
  1. The Attributes panel is where developers enter element attribute values. Attributes can be sorted Alphabetically or by Category and the Attribute Spy feature can be invoked. Attribute names can be double-clicked to open a "zoom" window for easier data entry. For some attributes, valid choices, in a selection list, can be summoned by clicking a down-arrow or mini-browse button in their value field.

  1. The Test Parameters panel allows you to insert values as for parameters that are normally passed to the page. This panel is only visible if the report expects parameters and is not displayed until a report has been run or previewed once. Test values entered here are applied to a definition viewed inside Studio using Preview, but are not applied if the definition is viewed in a browser.
     
  2. When an element is selected in the Element Tree in the Workspace panel, the Element Toolbox panel provides a list of context-appropriate wizards and child elements that can be added to the Element Tree. Tabs at the bottom filter the element selection between child and sibling elements.

    A Filter Elements control is available at the top of the Element Toolbox panel for filtering elements in all categories at once. Clear the control to remove all filters.
  1. The Information panel includes quick help text; the element or topic name is a link to more information on DevNet .
     

Panel Arrangement

The Attribute and Element Toolbox panels can be re-arranged to suit your preference, using the ToolsView menu options:

In a vertical layout, the order of the Element Toolbox and Attributes/Test Parameters panels can be specified, as shown above.


Or, in the optional horizontal layout, the panels can be arranged in the order you desire, as shown above.

Ribbon Menu

Studio operations can be controlled using the Ribbon Menu at the top of the screen. Here are its tabs and major items:
 

New Application

Create a new application with the assistance of the New Application wizard.

Open Application

Open an existing application from the File Explorer, the recent apps list, or a list of apps registered with the local web server.

New File

Create a new file by selecting a file category.

Recent  

Re-open a recently closed file.

Save, Save All, Close

Save the file in the current Workspace editor tab, save all edited files, and close the current application, with a prompt to save any unsaved files.

Edit Actions, Remark,
Move Up/Down

Standard editing actions including Cut, Copy, Paste and more. Comment and uncomment elements and rearrange their order.

Search/Replace

Search current, or all, definitions and supporting text files, and replace text, if desired.

Element Navigation,
Expand/Collapse

Navigate to previous or next element in the Element Tree navigation history. Expand or collapse all child elements beneath the selected element.

Test Actions

Control debugging, and preview a definition in a browser or in a separate "live" window.


 

Master Report Layout
 

Runs the Master Report Layout wizard, which lets you design the layout of a master report template.

Theme Editor
 

Runs the Theme Editor wizard, which lets you change Theme colors, typography, etc.

Themes

Apply the selected Theme to the current report, or to the entire application.


 

Application Deployment

Deploy the application to other servers using the Application Deployment Tool.

Application Obfuscation

Render definitions unreadable by humans to prevent tampering and theft using the Application Obfuscation Tool.

Server Manager

View registered applications and change their Logi Engine versions individually or in bulk.

Team Development

Manage built-in Logi source code control with file check-in/out and change history.

Database Browser

View schema, stored procedures, and basic data samples from databases with connections in the _Settings file.

Bookmark Storage

Create a SQL database table for Bookmark storage and migrate Bookmarks stored in the file system into it.

Dataview Authoring
 

Create, edit, and manage Dataviews - representations of data that can be used and re-used throughout an application. Menu item is only visible when Discovery v3.x is installed.
Deprecated in Info v12.6+.

SuperWidget Authoring
 

Create, edit, and manage client-side components, such as charts and dashboards, to create single-page applications that make use of Dataviews. Menu item is only visible when Discovery v3.x is installed.
Deprecated in Info v12.6+.

Elements/Attributes Panel

Specify the arrangement and order of the Element Toolbox and Attributes panels in Studio.

Options

Specify Studio options including file encoding and definition editor colors.


 

The Wizards tab appears when an element that has supporting wizards is selected in the Workspace panel. The number of wizards available varies, depending on the selected element.

General Features

Logi Studio provides development convenience and efficiency. It includes many features added in direct response to requests from our developer community. General features include:

  • Wizards - More than 50 wizards are provided to help you create applications and visualizations, and to accomplish other activities.
     
  • Multiple-Document Editor - The Workspace panel allows multiple files of different file types to be opened simultaneously, including report and process definitions, style sheets, script files, and XML data files. Elements and attribute values can be easily copied between definitions.
     
  • Support File Editing - Studio's internal support file editor provides improved editing and intelligent formatting of the source material based on file type. Features include line numbering, collapsible code regions, and syntax-specific highlighting.
     
  • Global Search and Replace - The editor's Find and Replace feature supports current document and cross-document searching using a variety of criteria.
     
  • Attribute Spy - This feature displays in the element tree, next to all relevant elements, their values for a selected attribute. For example, this feature allows you to quickly see which style class has been assigned to each element.
     
  • Tree-based Element Selection - Child elements can be selected and added to the element tree either from the Element Toolbox panel or by right-clicking a parent element and selecting from the popup menu that appears.
     
  • Intelligent Code and Token Completion - The task of entering tokens in attribute values is simplified by this feature, which dynamically presents selection lists for token types and appropriate identifiers in a drop-down list.
     
  • Attribute Value Selection Lists - Values can be selected from drop-down lists for attributes with discrete sets of value options, such as True/False, Percent/Pixels, etc.
     
  • Color Picker Tool - Attribute color values can be selected from a "color picker" tool, which can be opened from the attribute value.
     
  • Theme Editor - An editor that allows you to create custom Themes, based on the provided standard Themes, by selecting colors, typography, and more in an easy-to-use interface.
     
  • Test Parameters Panel - Parameters used in previews and tests remain accessible for easy use in the Test Parameters panel.
  • Element Copy/Paste and Drag/Drop - Multiple elements can be selected at once in the element tree and copied, moved, or deleted.
     
  • Query Tools - The SQL Query Builder is a separate dialog box that allows queries to be created from graphic table representations, using drag-and-drop techniques. SQL statements can be extended across multiple lines, allowing more complex statements. In addition, statements can be tested by selecting them and pressing F5; the operation will be limited to just the selected portions of the query statement.
     
  • Attribute Display Order - Element attributes can be viewed listed either in functional groups or sorted alphabetically.
  • Database Browser - This handy utility launches from the toolbar and allows browsing of the structure and data in connected databases. It's also a non-modal window, so it can be kept open and referred to it while working with elements and attributes.
     
  • Style Class Selector - This utility, shown as the first option in a the drop-down list of available classes for any Class attribute, appears as a dialog box and displays available classes and previews their effects as each is selected. Classes can also be edited right in place in the dialog box.
     
  • Deployment Tool - Allows you to easily deploy Logi applications by copying their files to local or shared network drives, or using one of three flavors of FTP (regular, SSL, or SSH).
     

Detailed information about how to use Studio is available in Using Logi 12 Studio.