JMS Serializer Describer Does Not Respect Default Group

[StefanNiederkofler]

Hello everyone,

i'm using the jms/serializer-bundle, fos/rest-bundle and the nelmio/api-doc-bundle.

I have a ManyToOne property with a abstract target entity:

/**
 * @var User
 *
 * @ORM\ManyToOne(targetEntity="UserBundle\Entity\User")
 * @ORM\JoinColumn(name="user_id", referencedColumnName="id")
 */
private $author;

The User Entity has a discrimatorMap which connects different User Types.

use JMS\Serializer\Annotation as Serializer;
/**
 * @ORM\Entity(repositoryClass="UserBundle\Entity\UserRepository")
 * @ORM\Table(name="app_user")
 * @ORM\InheritanceType( "SINGLE_TABLE" )
 * @ORM\DiscriminatorColumn( name = "discr", type = "string" )
 * @ORM\DiscriminatorMap({
 *     "person" = "Person",
 *     "student" = "Student",
 *     "partner" = "Partner"
 * })
 * @Serializer\ExclusionPolicy("none")
 */
abstract class User { ...  }

The serializer works, but in the api doc the author property is missing. Everything is marked correctly for the doc. There are other ManyToOne properties too (but not with abstract class) and they are showed correctly in the doc.

Any ideas what am I doing wrong?

Serialized Data, with author:

Doc without author property:

[StefanNiederkofler]

I am one step further now. I've found out, that when i'm adding the JMS Serializer Type Annotation manualy, the author is written to the documentation. I don't know why this is necessary for the nelmio api doc, but ok.
Now i have a new problem. In the docs all fields of the user are shown, the serializer groups are not respected. The serializer on the other hand makes everything correct again, and only exports the groups I want.
Any ideas on that?

/**
 * @var User
 * 
 * @ORM\ManyToOne(targetEntity="UserBundle\Entity\User")
 * @ORM\JoinColumn(name="user_id", referencedColumnName="id")
 *
 * @Serializer\Type("UserBundle\Entity\User")
 */
protected $author;

In the controller:

 * @SWG\Response(
 *     response=200,
 *     description="News Detail",
 *     @SWG\Schema(
 *         @SWG\Property(
 *             property="entity",
 *             ref=@NelmioModel(type=NewsBundle\Entity\News::class, groups={"Default"})
 *         ),
 *      .....
 *     )
 * )

[GuilhemN]

About your first comment, types must be defined in jms annotations when jms is used (see https://symfony.com/doc/current/bundles/NelmioApiDocBundle/index.html#general-php-objects).

About the other one, I think it's a bug in JMSModelDescriber, we try to avoid passing the default group when describing properties but it disables group verifications when we do so for them.
What do you think @goetas?