Versions Compared

Old Version 3

changes.mady.by.user admin

Saved on

compared with

New Version 4

changes.mady.by.user admin

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Wiki Markup
h1. Your First Solution (5 Minutes)

h2. What You'll

...

In just 5 minutes, create a working solution with:

 Build

Create a working solution with:
* Real-time data tags

...


* Interactive display with controls

...


* Live value updates

...


* Running application

...

Prerequisites

Before starting, ensure you have:

...



h2. Prerequisites

|| Requirement || Details ||
| FrameworX 10.1

...

Step 1: Create Your Solution (1 minute)

Launch Solution Center

  1. Start FrameworX
    • Windows: Start Menu → FrameworX 10.1 → Solution Center
    • Or desktop shortcut if created during installation
  2. Create New Solution
    • Click New Solution button
    • Name: MyFirstSolution
    • Product Family: FrameworX Unlimited
    • Location: Keep default or browse
    • Click Create

? Checkpoint: Solution created and appears in the solution list

Step 2: Add Your First Tag (1 minute)

Open Designer

  1. With your solution selected, click Edit
  2. Designer opens with your solution loaded

Create a Tag

  1. Navigate to Tags
    • In left tree: Unified Namespace → Tags
  2. Add New Tag
    • Click in first empty row or press Insert
    • Configure:
      • Name: Temperature
      • Type: Float
      • Initial Value: 75.5
      • Description: Room Temperature
    • Press Enter to confirm
  3. Add Control Tags
    • Add another tag:
      • Name: SetPoint
      • Type: Float
      • Initial Value: 72.0
    • Add boolean tag:
      • Name: SystemEnabled
      • Type: Boolean
      • Initial Value: True

? Checkpoint: Three tags visible in the tag grid

Step 3: Design Your Display (2 minutes)

Create Display

  1. Navigate to Displays
    • In left tree: Displays → MainPage
    • Click Edit icon or double-click
  2. Add Title
    • From toolbox, drag Text to canvas
    • Double-click and type: "My First FrameworX Solution"
    • Set font size: 24
    • Position at top of display
  3. Add Temperature Display
    • From right panel, expand Tags tree
    • Find Temperature tag
    • Drag and drop onto display
    • Default TextBox appears showing value
  4. Add SetPoint Control
    • Drag SetPoint tag to display
    • Right-click the TextBox → Replace With → Slider
    • Set slider range: Min=50, Max=100
  5. Add Enable Switch
    • Drag SystemEnabled tag to display
    • Right-click → Replace With → CheckBox
    • Set label: "System Enabled"
  6. Arrange Layout
    • Position elements nicely
    • Use alignment tools if needed
    • Save display (Ctrl+S)

? Checkpoint: Display shows title, temperature value, setpoint slider, and enable checkbox

Step 4: Run Your Solution (1 minute)

Start Runtime

...

  • Close Designer (changes auto-save)

...

  • Select your solution
  • Click Run button
  • Runtime starts and display opens automatically

...

  • Move the SetPoint slider - value changes
  • Toggle System Enabled checkbox
  • Watch Temperature value (static for now)

...

 installed | See [Installation Guide] |
| Valid license | Trial, Development, or Combined |
| Administrator access | Required for first-time setup |
| Time required | 5 minutes |

h2. Step 1: Create Your Solution (1 minute)

h3. Launch Solution Center

# Start FrameworX
** Windows: Start Menu ? FrameworX 10.1 ? Solution Center
** Or use desktop shortcut

h3. Create New Solution

# Click *New Solution* button
# Configure:
** Name: {{MyFirstSolution}}
** Product Family: {{FrameworX Unlimited}}
** Location: Keep default or browse
# Click *Create*

{info:title=Checkpoint}
Solution created and appears in the solution list
{info}

h2. Step 2: Add Your First Tag (1 minute)

h3. Open Designer

# Select your solution
# Click *Edit* - Designer opens

h3. Create Tags

# Navigate to *Unified Namespace ? Tags*
# Add Temperature tag:
** Name: {{Temperature}}
** Type: {{Float}}
** Initial Value: {{75.5}}
** Description: {{Room Temperature}}
# Add SetPoint tag:
** Name: {{SetPoint}}
** Type: {{Float}}
** Initial Value: {{72.0}}
# Add SystemEnabled tag:
** Name: {{SystemEnabled}}
** Type: {{Boolean}}
** Initial Value: {{True}}

{info:title=Checkpoint}
Three tags visible in the tag grid
{info}

h2. Step 3: Design Your Display (2 minutes)

h3. Create Display

# Navigate to *Displays ? MainPage*
# Click Edit icon or double-click

h3. Build Interface

# Add title:
** Drag *Text* from toolbox
** Enter: "My First FrameworX Solution"
** Set font size: 24
# Add Temperature display:
** From Tags tree, drag *Temperature* to canvas
** TextBox appears showing value
# Add SetPoint control:
** Drag *SetPoint* to display
** Right-click ? Replace With ? *Slider*
** Set range: Min=50, Max=100
# Add Enable switch:
** Drag *SystemEnabled* to display
** Right-click ? Replace With ? *CheckBox*
** Set label: "System Enabled"
# Save display (Ctrl+S)

{info:title=Checkpoint}
Display shows title, temperature value, setpoint slider, and enable checkbox
{info}

h2. Step 4: Run Your Solution (1 minute)

h3. Start Runtime

# Return to Solution Center (close Designer)
# Select your solution
# Click *Run* button
# Runtime starts and display opens

h3. Test Your Solution

* Move SetPoint slider - value updates
* Toggle System Enabled checkbox
* Observe Temperature value

h3. Make It Dynamic (Optional)

# Return to Designer
# Add expression to Temperature tag:
{code}
@Tag.SetPoint + (Random(-5, 5))

...

? Success! You've created your first FrameworX solution!

Next Steps

After Quick Start

Expand Your Knowledge

  1. Platform Architecture - Understand the complete system
  2. Building Solutions - Master the four-pillar methodology
  3. Solution Examples - Explore industry templates

Get Certified

Join the Community

Troubleshooting Quick Start

Common First-Time Issues

ProblemSolution
Can't create solutionRun Solution Center as Administrator
Designer won't openCheck for development license
Runtime won't startVerify no port conflicts on 9000
Display blankCheck if Runtime is actually running
Tags not updatingVerify Runtime started successfully

Getting Help

...


{code}
# Restart Runtime - Temperature fluctuates around SetPoint

{success:title=Success}
You've created your first FrameworX solution
{success}

h2. Next Steps

|| Topic || Description || Link ||
| Platform Architecture | Understand the complete system | [System Architecture] |
| Building Solutions | Master the four-pillar methodology | [Solution Development] |
| Solution Examples | Explore industry templates | [Implementation Examples] |

h2. Troubleshooting

|| Issue || Solution ||
| Can't create solution | Run Solution Center as Administrator |
| Designer won't open | Verify development license |
| Runtime won't start | Check port 9000 availability |
| Display blank | Confirm Runtime is running |
| Tags not updating | Verify Runtime started successfully |

h3. Getting Help

* Built-in Help: Press F1
* [Documentation Home]
* [Community Forum]
* [Support Portal]