Table of Contents
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.
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.
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.
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.