User Tools

Site Tools


transformations:projectmetadata

PROJECT METADATA

Category: Import / File


Description

Generate lists of various EasyMorph (.morph) project metadata:

  • Connectors used in project's actions
  • Parameters
  • Modules
  • Groups
  • Tables
  • Actions (with connector names, and parameter names, when applicable)


Use cases

The Project metadata action can be convenient in the various cases, for instance:

  • Find projects that use a particular connector
  • Validate one or more projects without executing them (e.g. before publishing to Server)
  • Check if a project has disabled actions
  • Obtain a list of modules and use it for iterations (in all calling actions the module name can be specified using a parameter)


Action settings

Setting Description
Load file*Fully-qualified file name of the EasyMorph .morph project file (includes relative or absolute path).
Mode Defines the metadata category that EasyMorph will generate a list of for the file selected.
Options: List of connectors, List of parameters, List of modules, List of groups, List of tables, List of actions.

* Setting can be specified using a parameter.

Modes

ModeList fields
Project metadataEdited by, Last edited (UTC), Application version, Start module, and Project validation. See "Remarks" section below.
ConnectorsConnector name, Parameter name, Connector name type, Connector location, Connector type, Connector
annotation, and Connector validation.
ParametersModule name, Parameter name, Parameter type, Parameter value, Parameter annotation, and Parameter
validation.
ModulesModule name and Module annotation.
Optionally, dependency information can be included: Calls, Connectors, Files/folders, Programs. See below.
GroupsModule name, Group name, and Group annotation.
Optionally, dependency information can be included: Groups, Calls, Connectors, Files/folders, Programs.
See below.
TablesModule name, Group name, Table name, Table annotation, Default result table.
Optionally, dependency information can be included: Tables, Calls, Connectors, Files/folders, Programs.
See below.
ActionsModule name, Group name, Table name, Action position, Action name, Action description, Action annotation,
Action state, Connector name, Parameter name (for connector), Connector name type, Action parameters,
and Action validation.


Include dependencies options

DependencyAppends these fields to the dataset…
CallsCall target, Call target name type, and Call target name.
ConnectorsDependency type, Connector name type, and Connector name.
Files/foldersDependency type, File path, and Folder path.
ProgramsDependency type and Program path.
GroupsDependency type and Other group name.
TablesDependency type and Other table name.


Validation

Some modes produce validation columns. See the table below for an explanation of validation in each mode.

SettingValidation explanation
Project metadata Project file is considered valid when it was saved in EasyMorph and hasn't been modified by a 3rd party application after that. The project validation only works for projects saved in v4.7.1 or later. See also the Remarks section below.
Connectors A connector is valid when it can be found in the current repository.
Parameters A parameter is valid when it passes validation rules defined in parameter settings, can be successfully evaluated (calculated parameters only), and its value is in the list of acceptable values.
Actions An action is valid when its properties are properly configured.


Remarks

Project (.morph) files created in EasyMorph versions 4.7.1 or later contain a cryptographic signature that certifies that the project was saved in EasyMorph and it wasn't modified by a 3rd party application. If the project is found to be modified in some way, the Project validation column created in the "Project metadata" mode will result in the error "The project has been tampered with".

If project validation is successful, it also means that the most recent project editor and the last edited time are certified to be correct.

This action can import multiple files. See Importing Multiple Files for more information.


Community examples


Shortcuts

Fast ways to create the action:

  • Press the "Add data" menu button. Pick "Import file" or "Import multiple files".


See also

transformations/projectmetadata.txt · Last modified: 2021/07/15 12:35 by craigt