Skipper support site - Recent questions in How To & Manuals

[Answered] Manually create migrations

Thu, 20 Oct 2022 16:19:03 +0000

I have a rather complex Skippermodel from a earlier project. I want to import into a fresh Laravel project..

Is there a way to tell Skipper that some models already have migrations?
Like users, passwordresets and failedjobs are tables created by a fresh Laravel project, so I want these models omitted when I export to ORM. But I want the models in skipper, so I can link relations to them.

/Frode

How to do references with mongodb odm?

Tue, 14 Sep 2021 20:57:35 +0000

I'm new to skipper but i managed to work with ORM with success; but now i need to design ODM entities in mongodb and i can't figure out how to make the references between entity fields as shown here:
https://www.doctrine-project.org/projects/doctrine-mongodb-odm/en/2.2/reference/reference-mapping.html

thanks!

Can I hide an entity from the graph

Fri, 18 Jun 2021 21:16:52 +0000

Hi
I have one central entity "Domain" that has a relation with just about all other tables.
Currently it's simply creating more lines in the graph than necessary. So I would like to hide that entity and its associations from the graph (the module...?) to clean it up. Is this possible. Or even better: is it possible to hide the associations of that particular entity?

Import laravel migrations

Wed, 12 May 2021 06:08:12 +0000

Hello,

I have Laravel+Postgress project and I would like to import migrations to the Skipper to see visualisation of schema.

I tried Import existing project -> Laravel -> Laravel -> Database -> Postgres -> Connection settings OK -> In the root path I selected Laravel project root path.

After import I have message:

And nothing imported.
Could you please help to solve this ?

Thank you very much in advance.

[Solved] Skipper not get started on ubuntu 18.04

Wed, 09 Dec 2020 08:51:39 +0000

I have fresh Ubuntu 18.04.5 LTS with LAMP Ready. Now when I going to run Skipper. Get following error. Pls refer Screenshot.

[Answered] cardinality options

Fri, 03 Apr 2020 05:30:44 +0000

Hello,

this is my 1st use of Skipper,
i don't understand the logic in cardinality, i want to qualify my entities associations into 0,n but dont find such choice in the association options,
cant find also how to determine cardinality for both elements of the association,
i can just define for one side,

any help? or any link that explain how making cardinalities in Skipper?

thank you.

Can I store visual changes to an external module in the project?

Thu, 19 Dec 2019 14:35:28 +0000

I'm storing a skipper.module.xml file within a package that is then distributed via composer to an application that has a Project.skipper file.

When I then make any visual changes to the project file (e.g. to get things lined up better since there are inheritances in the application that don't show at the module level) this ends up saving them to the skipper.module.xml under the vendor directory.

When trying to perform composer update, if there are updates to the module, there are changes which I then have to discard (by rerunning the composer update command with --no-interaction and "discard-changes": true set in the config).

Aside from that last point just being an annoyance, I can work around it, however when I then reopen the project file the visual styles are all over the place and I have to realign things to make sense on the project level. So my question is, is it possible to set the visual styles at the project level and leave the vendor files unmodified?

Thanks.

abstract base model class

Thu, 21 Nov 2019 19:05:58 +0000

I'm new to skipper.

How can I set my own abstract base class to all the abstract classes?

Also I have createdby and updatedby fields.

Both these fields have a relationship to Users, but how can I make it so these methods get a special name?

I mean obviously I can do a find and replace on all the abstract models with a script, but wonder if skipper had a method of doing that?

Thanks

[Fixed] Problems with migrations using this

Thu, 07 Nov 2019 09:31:51 +0000

I added this:

I have a Account and a Tag Model and it looks like this:

Migration fails because it looks like this:

Error:

   Symfony\Component\Debug\Exception\FatalThrowableError  : Too few arguments to function Illuminate\Database\Schema\Blueprint::foreign(), 0 passed in /Users/marton/Sites/mBud/database/migrations/2019_11_07_102754_skipper_migrations_2019110710275404.php on line 276 and at least 1 expected

[Answered] Polymorphic relations

Thu, 07 Nov 2019 08:07:53 +0000

How to create Eloquent polymorphic relations like:

MorphTo, morphMany and morphToMany?

[Answered] Add custom Base Model class

Mon, 04 Nov 2019 19:08:45 +0000

Is it possible to make a Base Model class for each Module?

So in BaseModel get:

use App\MyModule\MyModuleModel;

abstract class generated_class extends MyModuleModel

The reason is that I want possibility to override $connection for a complete module, so it fetches data from a second database.

/Frode

[Solved] Start Laravel project - Import from migrations

Wed, 23 Oct 2019 05:37:03 +0000

When starting a new Laravel 6 project, I want to import the default migrations that are added by default when creating a Laravel project

Is this possible?
How to do this in a simple way?
I want to add them, since I want to make relations from users to other models.

Configuration Files stored with Module

Mon, 06 May 2019 12:59:18 +0000

I have a module.xml that I would like to use to offer a datatype. My packages are split into composer repositories with a *.module.xml file stored in that repository containing the entities for that module.

What I wish to do, is use that to offer a *.skipper.cfg.xml along side it.

I can see 2 possible solutions:
- Load skipper configuration files stored in the same directory as skipper module files
- Allow the skipper module files to store configuration that can be shared (specifically data types)

Are either of the above solutions possible now?

Kind Regards,

Gary Lockett

How do I add a uuid_binary as a field type?

Wed, 10 Apr 2019 19:28:51 +0000

In my previous version of skipper I had added uuid_binary as a type. Now that I have updated, I see this has disappeared. Unfortunately, I can not remember how I did it before...

Kindly advise what file I need to edit in order to add this type!

thanks

[Answered] Association not exported, instead i get list of indexes

Thu, 31 Jan 2019 09:24:37 +0000

Hi,

i'm testing Skipper and whereas i created a new project from mysql workbench model, then i realized that even if associations are well described in Diagram of Skipper, the generated Entities doesn't have any JoinColumn annotation. All foreign keys are also not in the class but in Class annotation as index.

Here is a sample with this class that has a foreign key idagence in the diagram but is not part of the entity property. In place, there is an @ROM\Index with indid_agence (which is the name of the the related index.
/** * @ORM\Entity * @ORM\Table( * name="timeline_agence", * indexes={ * @ORM\Index(name="ind_id_agence", columns={"IdAgence"}) * } * ) */ class timeline_agence { ...

And the Agence Class:
/** * @ORM\Entity * @ORM\Table(name="agence", indexes={@ORM\Index(name="agence_id_concept", columns={"IdConcept"})}) */ class agence { /** * @ORM\Id * @ORM\Column(type="integer", length=11) * @ORM\GeneratedValue(strategy="AUTO") */ private $id_agence; ...

I expected timelineagence to get a property idagence with JOIN annotation. Maybe i missed some config somewhere.

Skipper version: 3.2.15.1478

Thanks

[Answered] How can I set default NULL for a string field in XML?

Tue, 08 Jan 2019 08:48:23 +0000

This may be a bug, but being a new user of Skipper, I'm hoping it's user error, so I am posting this to "How To".

I am using Skipper 3.2.14.1430, Doctrine DBAL v2.8.0, and MySQL v14.14.

Using YML ORM files, I have gotten my database to be completely in sync with Skipper. However, because of the issue with Gedmo Timestampable, I have to manually remove the dashes in order for this to work. After reading this forum, I decided to try XML ORM files as I learned that YML will soon be deprecated in Doctrine.

When I simply changed the Skipper setting to output as XML, Doctrine now reports numerous SQL updates. I found this to be disturbing, but let me continue.

An issue I found is with the default value of a nullable string field. In Skipper, under the General Properties of the field, if "not-null" is set to false (in other words, nullable is true), and default is set to NULL, the resulting XML in the ORM file will be:

<field name="label" type="string" length="50" nullable="true">
  <options>
    <option name="default">NULL</option>
  </options>
</field>

When I run the doctrine command:

bin/console doctrine:schema:update --dump-sql

The resulting SQL will shows:

ALTER TABLE network CHANGE label label VARCHAR(50) DEFAULT 'NULL';

Notice, NULL is wrapped in quotes.

If I try leaving the default option blank in Skipper the resulting XML is:

<field name="label" type="string" length="50" nullable="true">
  <options>
    <option name="default"/>
  </options>
</field>

So now when I run the doctrine command, the resulting SQL is:

ALTER TABLE network CHANGE label label VARCHAR(50) DEFAULT '';

Notice it will not set the field with a default empty string.

The only way I have found to get the result I am wanting, is to manually remove the options block from the ORM file.

<field name="label" type="string" length="50" nullable="true">
</field>

Now the resulting SQL is:

ALTER TABLE network CHANGE label label VARCHAR(50) DEFAULT NULL;

Notice, NULL is no longer wrapped in quotes, but is a literal NULL value. This is what I want.

Is there any way to have Skipper create the correct XML ORM file for me?

[Answered] Why are many-to-many Entities not created via export?

Tue, 13 Nov 2018 15:23:28 +0000

We are exporting to doctrine2 annotations, but can not find the many-to-many relationships we create as entities. Why might that be?

[Answered] installing Skipper on Debian stretch

Mon, 02 Apr 2018 06:07:39 +0000

Hello,
I have just downloaded the Linux version. How do I install it on Debian 9 (stretch)? This may well be a stupid question - but I cannot find any instructions to do so.
Thanks a lot for your help
H. Stoellinger

Write extension

Fri, 29 Dec 2017 08:27:57 +0000

Thanks a lot.
Another question, can i write extension ? and How ?
Thanks

add use and custom annotation

Thu, 28 Dec 2017 16:38:22 +0000

Please can you help me if a solution exist.
I need to add custom annotation when export entities

In ApiPlatflorm Bundle i need this annotation: @Apiplatform()

And use statment

use ApiPlatform\Core\Annotation\ApiResource;

thanks a lot

[Answered] is It posible to generate the class in Entity and the yml in config?

Tue, 01 Aug 2017 11:56:56 +0000

I want to generate the entity class with properties without annotations and the entity.orm.yml inside config folder. is it posible?

Now I have data format: doctrine 2 Yml and only the entity.orm.yml is generated inside config dir. The yml indentation generated only have 2 spaces, how I can change to 4?

AppBundle\Entity\ProductVariant:
  type: entity
  fields:
    points:
      type: integer
      nullable: true

Is it possible to run / test dql queries

Thu, 04 May 2017 11:01:59 +0000

Hi,
just installed the trial because I wanted to see if it would be possible to write some dql queries and test them before writing them into my Symfony application code.

So, is this possible somehow?

Thanks

Extended php parsers to support class constants -- Howto??

Mon, 10 Apr 2017 12:55:35 +0000

Where is this new feature documented?

Thanks,
Peter

[Answered] Is where a way to import from existing postgres database connection

Sun, 26 Mar 2017 19:11:40 +0000

I would like to import existing database from a postgres server

Any ready solutions?

[Solved] How to use Gedmo when starting a new project ?

Mon, 06 Mar 2017 14:39:22 +0000

Hey,

I start a new project today and i need to use Gedmo in my entities !

So how to do that ?

Thk.

[Solved] Printer configuration

Fri, 17 Feb 2017 16:48:46 +0000

Hello,
I would have liked to set up printing so that I could print a schema on one page and not on more than one page.
Thank you for your help.

config generation but with relationships replaced by regular fields

Fri, 17 Feb 2017 12:08:32 +0000

Hi, using Doctrine2 less and less. I am now getting to a point were I want to use Doctrine only for migrations and without any enforced relations. Let me explain.

I'm moving towards a CQRS event sourced system and am replacing 'Enityties' with DDD concepts. Projections and Queries are now simple tables wit hardly any relationships.

Skipper is still great; I noticed I can create a relation and simply remove the 'entity alias'. This would enable me to use skipper to design an overal bounded context that shows some relationships but have doctrine generate almost no real relationships.

Unfortunately removing the alias does not add the required field.

The following block is removed when the 'store' alias is removed from the relationship.

<many-to-one field="store" target-entity="HF\Model\Entity\Commerce\Store">
  <join-columns>
    <join-column name="store_id" referenced-column-name="store_id" nullable="false"/>
  </join-columns>
</many-to-one>

Offcource I still need the store_id column to be present, but the skipper does not generate the following.

<doctrine-mapping xmlns="http://doctrine-project.org/schemas/orm/doctrine-mapping" xsi="http://www.w3.org/2001/XMLSchema-instance" schemaLocation="http://doctrine-project.org/schemas/orm/doctrine-mapping.xsd">
  <entity name="HF\Model\Entity\Commerce\ArticleGroup" table="read_commerce_articlegroup">
    <id name="articleGroupId" type="string" length="36" column="articlegroup_id"/>
    <field name="ledgerNumber" type="string" length="5" nullable="false" column="ledger_number"/>
    <field name="code" type="string" length="30" nullable="false"/>
    <field name="store_id" type="string" length="36" nullable="false"/>
    <field name="description" type="string" length="250" nullable="true" column="description"/>
  </entity>
</doctrine-mapping>

Now my question: Does or could Skipper support this? Visually available relationships, but generated xml without them

ps. I am aware this is probably an edge case + I hope I made myself clear

Bas

[Solved] name of files for entities

Mon, 06 Feb 2017 14:29:00 +0000

Hello,

I would like to configure the file names of the entities.
When I create an entity Product, the default file is AppBundle.Entity.Product.php
I would like it to be called Product.php
Thanks for giving me the configuration parameter

Best regards

[Solved] How do I represent an abstract class in Skipper?

Mon, 05 Sep 2016 10:08:11 +0000

Hi.

I've been using Skipper for years now, but always with concrete classes.

We've inherited a project which has used annotations and we're very keen to migrate this to a Skipper model.

We have an abstract class AbstractInvite which has (let's say) and id and a name

We then have two super-classes
class ParticipantInvite extends AbstractInvite
class PublicInvite extends AbstractInvite

I can't for the life of me work out how to represent AbstractInvite in Skipper so that the two super-classes will inherit from it.

When I create AbstractInvite in Skipper it creates the class as a concrete class rather than an abstract class...

I'm sure this is my stupidity, but how should this be drawn in Skipper?

Thanks
Dave

[Creation Error] The annotation .... a property named "unsigned"

Mon, 01 Aug 2016 17:17:57 +0000

So I have this error. I am trying to update my doctrine schema in console but I get this error.

[Creation Error] The annotation @ORM\Column declared on property Programmes\Entity\Programmes::$id does not have a property named "unsigned". Available properties: name, type, length, precision, scale, unique, nullable, options, columnDefinition

So I read your tickets and found some solutions but they are not working for me. For one, my first of skipper that I downloaded 2 days ago as a trial does not have the blank values for unsigned attribute as was indicated implemented in the new release. So I attempted to add this to my custom template (that I found a solution to in another ticket):

<skipper-configuration>
  <global-configuration>
    <element-templates>
      <!-- put your templates here -->
      <struct name="Field">
        <struct name="options">
          <attribute name="unsigned" type="bool"/>
        </struct>
      </struct>
    </element-templates>
  </global-configuration>
</skipper-configuration>

But this is not getting picked up. I tried to edit the config file directory but I got access denied. So I have to work on my permissions with windows to attempt to get that worked out in the meantime, while I am waiting to get this ticket answered.

Is there anything else I can do? Is there a better custom template attribute to remove it?

When will this get fixed, I am on a trial of your software and I want to know before purchase. Also, when is symphony 3 be supported?

[Answered] Can skipper work with MySQL POINT data? Specifically for doctrine?

Tue, 01 Dec 2015 15:26:42 +0000

I have setup Doctrine such that it is capable of working with MySQL POINT and DISTANCE geometrical data types and functions.

Now I need to define fields as the POINT type, but I am not sure Skipper supports this.

Does it?

/**
 * @ORM\Column(name="geo_point", type="point", nullable=true)
 *
 * @var string $geoPoint
 */
protected $geoPoint;

[Answered] Correct way to import FOSUserBundle ORM to my project?

Thu, 30 Jul 2015 19:58:09 +0000

Hello, I'm trying to import the User and Group doctrine mapping files from FOSUserBundle. What I did was: File > Create or Import New > Import ORM Schema Files, then I pointed to my symfony2 project: /home/me/app/vendor/friendsofsymfony/user-bundle/Resources/config/doctrine-mapping/. It went alright, Skipper imported both User and Group Entities, and I started developing the rest from there.

Is this the correct way to do it?

[Closed] How to edit the location of an Entity in properties

Sat, 18 Apr 2015 09:59:37 +0000

I have created the following relationship in skipper and am having trouble getting the annotations of the Entity in user to point to the Entity in Trade.

My User module has a one to many relationship to my Trade module. Now when the annotations are exported, the Users TradeItem annotation attempts to link to TradeItem in the Users folder, like so:

The path is set as: TradeItem rather than: Trade\Entity\TradeItem

I know to get the correct mapping to the TradeItem entity I need to update something in the property editor... I am just not sure which one.

Please advise!

Is possible to export model as (My)SQL?

Thu, 11 Dec 2014 19:08:24 +0000

Hi all,

I have made an entity–relationship model in Skipper that I want to implement in (My)SQL. Does Skipper allow me to export it as SQL code, or I'll have to write/draw it again in MySQL Workbench? Unfortunately I think that I'll really have to do it all over again there, since I can't find an export option to do it on Skipper, so I'm just trying to confirm it.

Thanks,
João

Doctrine MongoDB ODM alpha support

Tue, 14 Oct 2014 12:03:27 +0000

Hi,

We would like to introduce Skipper MongoDB ODM support. Currently the state of this framework support is Alpha and there are several features (described bellow) which aren't fully supported.

Please keep in mind that structure of project file can (and probably will) change because of implementation of missing features. Use this version only for testing purpose and keep in mind that it is only the prototype.

What to test:

Please test following areas of support:

Make backup of your project before testing Skipper!
Import your existing MongoDB ODM projects and try to export it back. Check if Skipper doesn't drop any of your settings.
You can try to edit/add model objects, but currently some advanced techniques are simulated through universal-object (check description bellow).

What is implemented:

Skipper can import/export complete set of ALL features described here:
- in MongoDB ODM support page: http://doctrine-mongodb-odm.readthedocs.org/en/latest/
- in MongoDB ODM XSD schema file: https://github.com/doctrine/mongodb-odm/blob/master/doctrine-mongo-mapping.xsd
Skipper is able to edit any of these objects, but some features have to be edited via ORM property editor.
Skipper supports XML, YML and PHP Annotations format for import/export.

What is missing:

Visualization of reference (associations) to collections. Currently handled by universal-objects.
Visualization of embedded to other entities or collections. Currently handled by universal-objects.
Visualization of collection settings. Currently handled by universal-objects.
UI (editors) for reference to collections. Editing is available through ORM properties
UI (editors) for embedded to entity/collection. Editing is available through ORM properties
UI (editors) for one-way reversed associations from parent-to-child defined on parent-side. Not possible to edit it currently

Next TODO items:

Disable editing of data-type size (not available for MongoDB).
Disable creating of MN associations (not available for MongoDB).

Please report any unusual behavior, experiences or ideas here or to mongodb@skipper18.com

Download files:

Latest ORM Designer 2 beta version is 3.0.2.1135

Windows

Linux

MacOS

[How To]Skipper Support for Doctrine Extensions

Tue, 05 Aug 2014 12:38:52 +0000

Starting with version 3.2.5.1264 Skipper fully supports Gedmo extensions.

Currently support is in beta stage.

More info http://support.skipper18.com/2290/gedmo-extensions-beta-support

[Tip]How to set up a namespace for bundle

Wed, 23 Jul 2014 10:27:04 +0000

Hello,
I have been using Skipper for a few days and have added new modules to my project and split a module in order to get a better layout. However I now have some entity that is a parent to entities in other modules. Each time I Export to ORM I need to manually correct the object name to include the full path.

In this application race circuits are children of countries as are race drivers.

In the entity DriverBundle\Entities\NewgtDriver the $country field generated by Skipper does not refer to the Common Bundle:

/**
 * 
 * 
 @ORM\ManyToOne(targetEntity="NewgtCountry", inversedBy="driver")
 @ORM\JoinColumn(name="country_id", referencedColumnName="id")*/
private $country;

And I have to manually edit it:

  /**
     * 
     * 
     @ORM\ManyToOne(targetEntity="\Newgt\CommonBundle\Entity\NewgtCountry", inversedBy="driver")
     @ORM\JoinColumn(name="country_id", referencedColumnName="id")*/
    private $country;

The NewgtCountry associations are defined as follows:

I tried to change the namespace ORM property for the common bundle, but this did not help.
I had hoped to set it to \Newgt\CommonBundle\Entity but I just ended up with some very long entity file names – Newgt.CommonBundle.Entity.NewgtCountry.php

Tried with leading slash
Tried with slashes and backslashes
Tried to find the right page in the manual….

In the end I went back to leaving this blank and manually editing the two (for now) entries to include the full path.

I hope you can point me in the right direction.

Best regards
Steve

[How to] Create uni-directional many-to-many relationship with skipper?

Wed, 09 Jul 2014 11:38:24 +0000

Similarly to common assocation, directions on many to many assoc are handled by aliases.

As you can see in following examples, based on these aliases you can control how your association should looks like. It's because Doctrine2 handles associations based on the aliases.

In all next examples I will use following model:

In case you fill only alias to inverse entity, you will get unidirectional (one-way) association heading from first to second entity. As export, you will get:

 @ORM\ManyToMany(targetEntity="First")
 @ORM\JoinTable(
     name="mn",
     joinColumns={@ORM\JoinColumn(name="second_id", referencedColumnName="id", nullable=false)},
     inverseJoinColumns={@ORM\JoinColumn(name="first_id", referencedColumnName="id", nullable=false)}
 )

In case you fill only alias to owner entity, you will get incorrect unidirectional (one-way) association heading from second to first. I'm writing incorrect, because this isn't correct Doctrine2 configuration and based on the ERD modelling it's not possible to create such association without helper table. In this situation you will get:

 @ORM\ManyToMany(targetEntity="Second", mappedBy=)

In case you fill both aliases, you get bidirectional association (two-way) between first and second entity. In this case, Skipper exports annotations to both entities:

 SecondEntity:
  @ORM\ManyToMany(targetEntity="First", inversedBy="second")
  @ORM\JoinTable(
     name="mn",
     joinColumns={@ORM\JoinColumn(name="second_id", referencedColumnName="id", nullable=false)},
     inverseJoinColumns={@ORM\JoinColumn(name="first_id", referencedColumnName="id", nullable=false)}
  )
  private $first; 

 FirstEntity:
 @ORM\ManyToMany(targetEntity="Second", mappedBy="first")
 private $second;

Hope these examples will help you understand the concept of creating many to many association on our application.

[Tip]How to use External Tools to generate Doctrine Getters and Setters

Wed, 09 Jul 2014 10:59:24 +0000

Getters and Setters are generated by Doctrine tools. In order to avoid duplication of the functionality, Skipper will not contain this feature as one of its core functions.

But because of the large interest for this functionality, we have prepared a workaround how to configure External tools to generate Getters and Setters in one click, for this see the answer below.

This was prepared thanks to renaatdemuynck and his Doctrine export schema tutorial.

how can I add "use Symfony\Component\Validator\Constraints as Assert;" in generated files?

Wed, 09 Jul 2014 09:33:28 +0000

how can I add "use Symfony\Component\Validator\Constraints as Assert;" in generated files?

I would like too add information about symfony in class files entities side by side with namespace and information about using doctrine. Is it a bundle property as namespace?

[How to] Create uni-directional relationships with skipper?

Wed, 09 Jul 2014 09:27:28 +0000

When i try to create a one-to-one uni-directional relationship between two entities, skipper's Associations dialog shows only bi-directional option.

How can i tell to skkipper that "Hey, there are no reference from second entity to first entity. This is uni-directional relationship"

[HowTo] Integrating MySQL Workbench with ORM Designer

Tue, 29 Apr 2014 09:52:27 +0000

Inspired by a customers inquiry on email:

There is a crucial point, that is blocking my work with ORM Designer:

I build my database schema with MySQL Workbench
Then i imported the .mwb file into ORM Designer
All entities was imported with underscore style (because are defined like that at the DB, and i would like to keep them how they are)
Then i renamed all Entities from underscore to camel case:
user_addresses -> UserAddress and so on
ORM Designer now doesn't know that UserAddress actualy is user_addresses (despite that Doctrine2 knows becouse it's described in its anotation), and when a tried to synchronize my .mwb to ORM Designer, i have two Entities for one table:

Table: useraddresses
Entities:
- useraddresses: which is up to date
- UserAddress: which it's not up to date

So far, the only possibility that i get it's just to stop using MySQL Workbench, and to use only ORM Designer because of the sync issue described above.

The way i would like to work ORM Designer is to recognize that i already have an entitiy which represents a table, and to update this entity instead of creating a new one.If i can achieve this behavior with ORM Designer, i can continue use both ORM Designer and MySQL Workbench, otherwise i have to stop using one of them,which my opinion it's very pitty.

[Tip] Creating an association with single table inherited entity

Thu, 19 Dec 2013 16:29:52 +0000

If you need to create association with an inherited entity, there may occur following problem: inherited entity does not have ID (it is inherited from the parrent), but Skipper validators won't let you to create association with an entity without primary key.

[Tip] How to transfer schema files from PHP to XML or YML

Thu, 19 Dec 2013 16:18:53 +0000

If you need to transfer your schema files do different format you can do this pretty automatically. It is the same when importing PHP annotations and exporting to XML or YML and it is the same for other way around (XML/YML to PHP annotations).

To transfer the project from XML to PHP annotations just do the following

1) Import your project to ORM Designer.

2) Open the module editor on the Files and Export tab, and set data format to Doctrine2 Annotations.

3)Check if you are exporting the annotations to proper folders – ORM Designer will automatically merge the PHP annotations with the PHP file already present in the location.

4)Check if all of your entities have the extension in the attribute export-file-name set properly*. If not you can edit the value directly in the schema.module.xml.

*This attribute is used to preserve the original file structure of your project when you first import it to the ORM Designer. It will have the original filename and the .xml extension. You just need to change it to .php.

5) Export the schema files.

To transfer the schema files to XML or YML just switch the settings and file names.

[Tip] Porting model from one ORM framework to another

Mon, 16 Dec 2013 15:27:15 +0000

Hello Everybody,

If you have project developed in Doctrine, Doctrine2, Propel or CakePHP, and need to transfer it to different framework ORM Designer can help you, but it cannot do it completely automatically. Let me explain how to do this and why:

It is not a problem for ORM Designer to export to one framework the schema definitions imported from another. The output format of the data is handled easily. Problem is with the ORM properties. Each ORM framework uses different set of functions which is covered by various properties. And even the similar function can have different names. These sets can even differ across various versions. The conversion matrix that would properly deal with all the different properties and their syntax across the frameworks is impossible to create.

This means you can transfer your model, all your entities and relations together with the core attributes (names, ids, fields etc.) to different framework, and then you will need to check all entities and fix the ORM properties. Please proceed as follows:

Import your project in the ORM designer
Save the project
Locate the project file (*.ormdesigner2)
Remove all ORM specific properties (defined by ) from the project file
Change the definition of the ORM framework in the project file header. Keywords for the frameworks are propel, doctrine, doctrine2 and cakePHP. For example:
Change this

to
Open the edited project in the ORM Designer
Check all your entities. All ORM properties of the new ORM framework will be automatically generated but will have no values set. If you used some of these properties, you will have to define them manually again.

Note: There is a dirty variant of this method. You can skip removing the ORM specific properties. Then the properties that use same name in both frameworks will be merged. However the properties that have different names, will not be merged and will be unrecognized or may even cause some error. In this case you will have to look for the incompatible properties selectively and remove them.

[Tip] How to set up signed / unsigned property to an association field

Tue, 12 Nov 2013 12:03:29 +0000

When an association is created new field is automatically inserted in owner entity. Basic field properties (type, size and required flag) are automatically copied from inverse side entity primary key. However ORM properties that are specific to each framework are not copied and need to be set up. You can do it manually for every new association or set up a template that will be automatically used for all new associations and entities.

Templates

If you want to ensure that all new entities will have primary keys set as unsigned and all new associations will have the association field set as unsigned add the following templates to the ORM Designer configuration files:

<!-- primary key -->

<template element='field' use-case='create' selector='primary-field'>
    <field 
     name="id" 
     type="integer" 
     required="true" 
     unique="true" 
     primary="true" 
     auto-increment="true">
        <orm-attributes>
            <attribute name="unsigned">true</attribute>
        </orm-attributes>
    </field>    
</template>

<template element='entity' use-case='create'>
    <entity>
        <field 
         name="id" 
         type="integer" 
         size="4" 
         required="true" 
         unique="true" 
         primary="true" 
         auto-increment="true">
            <orm-attributes>
                <attribute name="unsigned">true</attribute>
            </orm-attributes>
        </field>        
    </entity>
</template>

<!-- foreign key -->

<template element='field' use-case='create' selector='association-field'>
    <field name="{entity-inverse#UL}_{field-inverse#UL}">
        <orm-attributes>
            <attribute name="unsigned">true</attribute>
        </orm-attributes> 
    </field>
</template>

<template element='field' use-case='create' selector='many-to-many-field'>
    <field 
     name="{entity-inverse#UL}_{field-inverse#UL}" 
     required="true" 
     primary="true">
        <orm-attributes>
            <attribute name="unsigned">true</attribute>
        </orm-attributes>
    </field>
</template>

Configuration files

It is best to store modified cfg files in the user configuration folder, because the changes made to the application configuration files are removed when you reinstall/update ORM Designer.

You can check our documentation to see which configuration file to use, where are they located and their loading order and how to add the templates to the configuration.

[Tip] How to configure export format and path for ORM schema files

Thu, 18 Jul 2013 12:44:03 +0000

Question received by email.

Depending on your ORM framework you can choose where to export your schema.xml / schema.yml file or where to export xml/yml/php files for each of your entity.

No matter which ORM framework you're using, paths are configured for each module separately. This enables you to split your project to several plugins and export entities to different locations based on your project structure.

To configure export format and path, simply double-click on module (or choose it from the project tree and in context menu choose "Edit"). Now in Module Editor window choose second tab Files and Export

Now in Data Format item you can choose which of available ORM formats you wold like to generate when you perform *Export**.

In Relative export path item you can configure your export path. Each path is relative to your root project file. The absolute path is displayed bellow inside the item Full export path.

In case you're using framework which uses one file for each module definitions (Doctrine1, Propel, ...) you have to enter path including output file name (Plugins\Eshop\Config\schema.xml)
In case you're using framework which uses one file for each entity (Doctrine2), you have to enter path to directory where all files will be stored.

Result file name can also depends on another switches (How to configure file name for Doctrine2).

Hope this tips will help you enjoy ORM Designer. If you have any question about this topic, feel free to discus it bellow!

[Tip] How to configure namespace for Doctrine2 project

Thu, 18 Jul 2013 12:43:40 +0000

Question received by email.

ORM Designer fully supports namespaces in Doctrine2 projects. Each module in ORM Designer can have its own namespace. This namespace is exported to each entity, association and inheritance leading to this entity.

If you want to configure namespace, choose Module and edit namespace property inside the ORM property editor:

Hope this tips will help you enjoy ORM Designer. If you have any question about this topic, feel free to discus it bellow!

[Tip] How to configure exported file names for Doctrine2

Thu, 18 Jul 2013 12:43:06 +0000

Question received by email.

For Symfony2 and Doctrine2 it's necessary to change exported file names from .dcm.yml to .orm.yml. We know about this limitation and we will implement automatical file name resolver in one of following versions.

For now, it's necessary to change file-suffix manually for each module or each entity. The recommended way is to change file name format for whole module:

Simply select your module and in ORM property editor choose ".orm" for file-suffix property.

You can also configure file name for each entity manually by editing export-file-name property in entity ORM property editor:

Hope this tips will help you enjoy ORM Designer. If you have any question about this topic, feel free to discus it bellow!

[Tip] What is the performance of indexes in database?

Wed, 24 Apr 2013 04:58:43 +0000

We can define some indexes for any table in ORM-Designer. What is the performance of indexes? How use it?