Switch to: V14V13V12V11V10V9V8V7V6V5

Valentina Project File Help

Valentina Project files are a special storage file format used in several Paradigma Software products. This article explains what a Valentina Project file is and also a basic introduction to working with Valentina Project files in general and specifically from within Valentina Studio.

Overview

Valentina Project files are special storage files that can include assets used by several Paradigma Software products. You can manage Valentina Projects visually through the Project Window. These include assets such as:

They can be created or used locally or registered under Valentina Server to provide multi-user access.

Physically, a Valentina Project is a file with the .vsp extension. Because Project files are based on the Valentina DB specification, you may also find a journal file behind it with the same name.

Local Project Files

Project files are just like any other file system file. When you open an unopened Project file with Valentina Studio Pro, you have read / write access.

Just like most files, if you share a .vsp file by itself on a network and multiple instances of Valentina Studio Pro try to open and it it, you run the risk of file corruption.

Hosted Project Files

Project files registered on Valentina Server operate differently than local files. If a Project file registered on Valentina Server is opened for editing, then subsequent connections are Read Only. The contents of a Project file though, can each be opened and edited by different connections. For example one can read / write to a Form within a Project, while another can read / write to a Report in the same Project.

Create a new Valentina Project

You must use Valentina Studio Pro to be able to create a new .vsp file.

For this use, menu Project → NEW…

Choose where you want to keep the project:

  • locally? Then specify a location on the disk.
  • remotely? Then you will be asked about the VServer connection.
Creating, modifying, and saving Valentina Projects requires Valentina Studio Pro or higher. See the most recent update of the Valentina Studio feature comparison chart for more information.

Open a Valentina Project

To open a LOCAL project, you can

  • use menu Project → Open…
  • double click the project file
  • drag it to the icon of Valentina Studio (on Mac)
  • drag it to the Start Page of Valentina Studio and drop it into the section Projects.

To open a REMOTE project, you should connect to Valentina Server, then you will see a list of databases and projects on that server. Double click project you need.

Any version of Valentina Studio can open a Valentina Project for the purposes of using it. Saving new or modified Valentina Projects requires Valentina Studio Pro.

Project Window

When you create or open a Valentina Project you will see Project Window where you will be able to see items of the project and manage them.

Use Valentina Projects with Reports ADK

Reports are a Valentina Project object type. To create or modify a Valentina Project or a Report Object, you need Valentina Studio Pro.

Valentina Reports ADK is a local application and remote connection solution that includes the Valentina Reports engine, but also incorporates a native interface, including C++/NET/Java/PHP/etc and more. It can…

  • Programmatically work with the embedded report engine locally.
  • Connect to a Valentina Server and programmatically work with reports hosted by Valentina Server

Each Valentina ADK has a set of examples about the usage of Reports in your application. They use VProject Class and VReport Class to work with project file and its reports.

Notes about Valentina Projects

Valentina Studio Free Version has limited but powerful end user functionality with Valentina Projects. You can:

  • Create temporary projects with temporary tables, Reports, and Forms (none of these temporary items are saved when closed)
  • View or 'run' a Report using the Report Viewer as an end user (can also use any programmatic functionality in the report)
  • Open and use a Valentina Form as an end user (can also use any programmatic functionality in the form)

For this reason, Valentina Studio Free Version acts as a very powerful 'runtime' engine for end users.

See Also