Utilisation d'une requête dans une classe de contrat de données SysOperation dans Dynamics AX 2012

Publié : 16 février 2025 à 01 h 28 min 00 s UTC

Cet article décrit en détail comment ajouter une requête configurable et filtrable par l'utilisateur à une classe de contrat de données SysOperation dans Dynamics AX 2012 (et Dynamics 365 for Operations)

Cette page a été automatiquement traduite de l'anglais afin de la rendre accessible au plus grand nombre. Malheureusement, la traduction automatique n'est pas encore une technologie au point, des erreurs peuvent donc survenir. Si vous préférez, vous pouvez consulter la version originale en anglais ici :

Using a Query in a SysOperation Data Contract Class in Dynamics AX 2012

Les renseignements contenus dans cet article sont basés sur Dynamics AX 2012 R3. Cela peut être valable ou non pour d'autres versions. (Mise à jour : je peux confirmer que cela fonctionne aussi sur Dynamics 365 pour les opérations)

J'ai toujours tendance à oublier les détails sur la façon de spécifier et d'initialiser une requête dans le cadre SysOperation. Je suppose que la plupart des tâches par lots que j'ai effectuées ne sont pas basées sur des requêtes configurables par l'utilisateur, mais de temps en temps, j'ai besoin de créer une telle tâche par lots, donc cet article est aussi pour ma propre référence.

Tout d'abord, dans la classe de contrat de données, la requête sera stockée sous forme de chaîne. Sa méthode parm doit être décorée avec l'attribut AifQueryTypeAttribute, comme ceci (dans cet exemple, j'ai utilisé la requête SalesUpdate, mais vous pouvez la remplacer par n'importe quelle requête AOT) :

[
    DataMemberAttribute,
    AifQueryTypeAttribute('_packedQuery', queryStr(SalesUpdate))
]
public str parmPackedQuery(str _packedQuery = packedQuery)
{
    ;

    packedQuery = _packedQuery;
    return packedQuery;
}

Si vous voulez que la requête soit décidée par la classe du contrôleur, vous pouvez aussi utiliser une chaîne vide. Dans ce cas, vous devez également implémenter quelques méthodes d'assistance (que vous devriez probablement implémenter de toute façon pour votre propre commodité lorsque vous devez accéder à la requête) :

public Query getQuery()
{
    ;

    return new Query(SysOperationHelper::base64Decode(packedQuery));
}

public void setQuery(Query _query)
{
    ;

    packedQuery = SysOperationHelper::base64Encode(_query.pack());
}

Si vous devez initialiser la requête (par exemple, ajouter des plages), vous devez implémenter une méthode initQuery :

public void initQuery()
{
    Query queryLocal = this.getQuery();
    ;

    // add ranges, etc...

    this.setQuery(queryLocal);
}

Vous devez vous assurer d'appeler cette méthode à partir de la classe du contrôleur.