Xrm.Page.data.process (référence côté client)

  • Article

 

Date de publication : novembre 2016

S’applique à : Dynamics CRM 2015

Avec Mise à jour de Microsoft Dynamics CRM 2015 et de Microsoft Dynamics CRM Online 2015, l'espace de noms d'Xrm.Page.data.process contient des événements, des méthodes et des objets à faire interagir avec les données du flux des processus d'entreprise dans un formulaire.

Voir Xrm.Page.ui.process (référence côté client) pour connaître les méthodes permettant d'interagir avec le contrôle du flux des processus d'entreprise dans le formulaire.

Méthodes Xrm.Page.data.process

  • Méthodes ActiveProcess
    Utilisez getActiveProcess pour récupérer des informations sur le processus actifs et getActiveProcess pour définir un autre processus en tant que processus actif.

  • Méthodes ActiveStage
    Utilisez getActiveStage pour récupérer des informations sur la phase active et getActiveStage pour définir une phase terminée comme phase active.

    Avec Mise à jour 1 de Microsoft Dynamics CRM Online 2015, vous pouvez utiliser getActiveStage dans une phase au sein d'une autre entité.

  • getActivePath
    Cette méthode visant à obtenir qu'une collection de phases présentes dans le chemin d'accès actif avec les méthodes interagissent avec les phases affichées dans le contrôle de flux des processus d'entreprise.

    Le chemin actif représente les étapes actuellement rendues dans le contrôle du processus en fonction des règles de branchement et des données actuelles de l'enregistrement.

  • getEnabledProcesses
    Cette méthode permet de récupérer de manière asynchrone les flux de processus d'entreprise activés auxquels l'utilisateur peut passer pour une entité.

  • getSelectedStage
    Ajoutée à Mise à jour 1 de Microsoft Dynamics CRM Online 2015, utilisez cette méthode pour accéder à la phase sélectionnée.

  • Méthodes pour gérer des gestionnaires d'événements
    Utilisez les méthodes addOnStageChange, removeOnStageChange, addOnStageSelected et removeOnStageSelected pour ajouter ou supprimer des gestionnaires d'événements pour le contrôle du flux des processus d'entreprise.

  • Méthodes de navigation
    Utilisez moveNext pour passer à la phase suivante et movePrevious à passer à la phase précédente.

    Avec Mise à jour 1 de Microsoft Dynamics CRM Online 2015, vous pouvez utiliser movePrevious dans une phase précédente au sein d'une autre entité.

  • Méthodes de processus
    Utilisez des méthodes de processus pour accéder aux propriétés du processus.

  • Méthodes de la phase
    Utilisez des méthodes de phase pour accéder aux propriétés de la phase dans un flux des processus d'entreprise.

  • Méthodes d'étape
    Utilisez des méthodes d'étape pour accéder aux propriétés de l'étape dans un flux des processus d'entreprise.

Méthodes ActiveProcess

Utilisez getActiveProcess pour récupérer des informations sur le processus actifs et getActiveProcess pour définir un autre processus en tant que processus actif.

getActiveProcess

Renvoie un objet de Process représentant le processus actif.

var activeProcess = Xrm.Page.data.process.getActiveProcess();

  • Valeur renvoyée
    Type : Processus

    Remarques : Voir Méthodes de processus pour les méthodes permettant d'accéder aux propriétés du processus renvoyé.

getActiveProcess

Définissez un Process comme processus actif.

Xrm.Page.data.process.setActiveProcess(processId, callbackFunction);

Paramètres :

  • processId
    Type :String

    Remarques : ID du processus permettant de rendre le processus actif.

  • callbackFunction
    Type :Function

    Remarques : Fonction à appeler lorsque l'opération est terminée. Cette fonction de rappel reçoit l'une des valeurs de chaîne suivantes pour indiquer si l'opération a réussi.

    Valeur

    Description

    success

    L'opération a réussi.

    invalid

    La valeur processId n'est pas valide ou le processus n'est pas activé.

Méthodes ActiveStage

Utilisez getActiveStage pour récupérer des informations sur la phase active et getActiveStage pour définir une phase différente comme phase active.

getActiveStage

Renvoie un objet de Stage représentant la phase active.

var activeStage = Xrm.Page.data.process.getActiveStage();

  • Valeur renvoyée
    Type : Phase

    Remarques : Voir Méthodes de la phase pour les méthodes permettant d'accéder aux propriétés de la phase renvoyée.

getActiveStage

Définissez une phase terminée comme phase active.

Notes

Avec Mise à jour 1 de Microsoft Dynamics CRM Online 2015, vous pouvez utiliser cette méthode dans une phase au sein d'une autre entité.

Seule une phase terminée de l'entité peut être définie avec cette méthode.

Xrm.Page.data.process.setActiveStage(stageId, callbackFunction);

Paramètres :

  • stageId
    Type :String

    Remarques : ID de la phase terminée de l'entité à définir en tant que phase active.

  • callbackFunction
    Type :Function

    Remarques : fonction facultative à appeler lorsque l'opération est terminée.

    La fonction de rappel se voit transmettre la valeur de chaîne « success » si l'opération réussit.

    Si la valeur stageId représente une phase qui n'est pas valide, la phase ne peut pas devenir active et la fonction de rappel reçoit une valeur de chaîne en indiquant la raison. Les valeurs répertoriées dans le tableau suivant peuvent être renvoyées.

    Valeur

    Raison

    crossEntity

    La phase doit être une phase de l'entité actuelle.

    invalid

    Trois raisons pour lesquelles cette valeur peut être retournée :

    • Le paramètre stageId correspond à une valeur d'ID de phase inexistante.

    • La phase active n'est pas la phase sélectionnée

    • L'enregistrement n'a pas encore été enregistré.

    unreachable

    La phase existe sur un autre chemin.

    dirtyForm

    Cette valeur sera retournée si les données de la page ne sont pas enregistrées.

    Important

    Cette méthode peut uniquement être utilisée lorsque la phase sélectionnée et la phase active sont identiques. Lorsque votre code est initialisé à partir de l'Événement OnStageChange, la phase actuelle est sélectionnée. Lorsque votre code est initialisé à partir de l'Événement OnStageSelected, vous devez utiliser Xrm.Page.data.process.getActiveStage pour vérifier que la phase sélectionnée est également la phase active. Pour tout autre événement de formulaire, il est impossible de déterminer la phase actuellement sélectionnée. Pour de meilleurs résultats, cette méthode ne doit être utilisée que dans le code appelé dans les fonctions initialisées par les événements OnStageChange et OnStageSelected.

getActivePath

Cette méthode visant à obtenir qu'une collection de phases présentes dans le chemin d'accès actif avec les méthodes interagissent avec les phases affichées dans le contrôle de flux des processus d'entreprise.

Le chemin actif représente les étapes actuellement rendues dans le contrôle du processus en fonction des règles de branchement et des données actuelles de l'enregistrement.

var stageCollection = Xrm.Page.data.process.getActivePath();

Exemple :

Voir Exemple : Xrm.Page.data.process.getActivePath pour obtenir un exemple utilisant cette méthode.

  • Valeur renvoyée
    Type : Collection

    Remarks: Collection de toutes les phases terminées, de la phase active actuellement et de l'ensemble prévu des futures phases selon des conditions satisfaisantes dans la règle de branchement. Il peut s'agir d'un sous-ensemble de phases renvoyées avec Xrm.Page.data.process. getActiveProcess, car il ne contient que les phases qui représentent une transition valide de la phase actuelle basée sur le branchement qui s'est produit dans le processus.

getEnabledProcesses

Cette méthode permet de récupérer de manière asynchrone les flux de processus d'entreprise activés auxquels l'utilisateur peut passer pour une entité.

Xrm.Page.data.process.getEnabledProcesses(callbackFunction(enabledProcesses));

  • Paramètre
    Type :Function

    Remarques : La fonction de rappel doit accepter un paramètre contenant un objet avec des propriétés de dictionnaire, où le nom de la propriété est l'ID du flux des processus d'entreprise et la valeur de la propriété est le nom du flux des processus d'entreprise.

    Les processus activés sont filtrés selon les privilèges de l'utilisateur. La liste des processus activés est est identique à celle qu'un utilisateur peut afficher dans l'interface utilisateur s'il souhaite modifier le processus manuellement.

    Exemple :

    Voir Exemple : Xrm.Page.data.process.getEnabledProcesses pour obtenir un exemple utilisant cette méthode.

getSelectedStage

Utilisez cette méthode pour obtenir la phase sélectionnée actuellement.

Xrm.Page.data.process.getSelectedStage()

  • Valeur renvoyée
    Type : Phase

    Phase actuellement sélectionnée.

  • Remarques
    Cette méthode a été ajoutée pour Mise à jour 1 de Microsoft Dynamics CRM Online 2015

    Voir Méthodes de la phase pour connaître les méthodes permettant d'accéder aux propriétés de la phase renvoyée.

Méthodes pour gérer des gestionnaires d'événements

Utilisez ces méthodes pour ajouter ou supprimer des gestionnaires d'événements pour le contrôle du flux des processus d'entreprise.

addOnStageChange

Utilisez cette méthode pour ajouter une fonction en tant que gestionnaire d'événements pour l'Événement OnStageChange, afin qu'il soit appelé lorsque la phase du flux des processus d'entreprise change.

Xrm.Page.data.process.addOnStageChange(handler);

  • Paramètre
    Type : référence de fonction

    Remarks: La fonction est ajoutée en bas du pipeline du gestionnaire d’événements. Le contexte d’exécution est automatiquement défini pour agir comme le premier paramètre transmis au gestionnaire d’événements. Pour plus d'informations, voir Contexte d'exécution (référence côté client).

    Vous devez utiliser une référence à une fonction nommée plutôt qu'à une fonction anonyme s'il se peut que vous souhaitiez supprimer le gestionnaire d'événements ultérieurement.

removeOnStageChange

Utilisez cette méthode pour supprimer une fonction en tant que gestionnaire d'événements de l'Événement OnStageChange.

Xrm.Page.data.process.removeOnStageChange(handler);

  • Paramètre
    Type : référence de fonction

    Remarks: Si une fonction anonyme est définie à l'aide de la méthode addOnStageChange, elle ne peut pas être supprimée avec cette méthode.

addOnStageSelected

Utilisez cette méthode pour ajouter une fonction en tant que gestionnaire d'événements pour l'Événement OnStageSelected, afin qu'il soit appelé lorsqu'une phase du flux des processus d'entreprise est sélectionnée.

Xrm.Page.data.process.addOnStageSelected(handler);

  • Paramètre
    Type : référence de fonction

    Remarks: La fonction est ajoutée en bas du pipeline du gestionnaire d’événements. Le contexte d’exécution est automatiquement défini pour agir comme le premier paramètre transmis au gestionnaire d’événements. Pour plus d'informations, voir Contexte d'exécution (référence côté client).

    Vous devez utiliser une référence à une fonction nommée plutôt qu'à une fonction anonyme s'il se peut que vous souhaitiez supprimer le gestionnaire d'événements ultérieurement.

removeOnStageSelected

Utilisez cette méthode pour supprimer une fonction en tant que gestionnaire d'événements de l'Événement OnStageSelected.

Xrm.Page.data.process.removeOnStageSelected(function reference);

  • Paramètre
    Type : référence de fonction

    Remarks: Si une fonction anonyme est définie à l'aide de la méthode addOnStageSelected, elle ne peut pas être supprimée avec cette méthode.

Méthodes de navigation

Utilisez moveNext pour passer à la phase suivante et movePrevious à passer à la phase précédente. Ces deux méthodes entraînent la survenue de l'Événement OnStageChange.

moveNext

Progresse à la phase suivante.

Xrm.Page.data.process.moveNext(callbackFunction);

  • Paramètre
    Type : Fonction

    Remarques : fonction facultative à appeler lorsque l'opération est terminée. Cette fonction de rappel reçoit l'une des valeurs de chaîne suivantes pour indiquer si l'opération a réussi.

    Valeur

    Description

    success

    L'opération a réussi.

    crossEntity

    La phase suivante concerne une autre entité.

    end

    La phase active est la dernière phase du chemin actif.

    invalid

    L'opération a échoué car la phase sélectionnée n'est pas identique à la phase active.

    dirtyForm

    Cette valeur sera retournée si les données de la page ne sont pas enregistrées.

Important

Cette méthode peut uniquement être utilisée lorsque la phase sélectionnée et la phase active sont identiques. Lorsque votre code est initialisé à partir de l'Événement OnStageChange, la phase actuelle est sélectionnée. Lorsque votre code est initialisé à partir de l'Événement OnStageSelected, vous devez utiliser Xrm.Page.data.process.getActiveStage pour vérifier que la phase sélectionnée est également la phase active. Pour tout autre événement de formulaire, il est impossible de déterminer la phase actuellement sélectionnée. Pour de meilleurs résultats, cette méthode ne doit être utilisée que dans le code appelé dans les fonctions initialisées par les événements OnStageChange et OnStageSelected.

movePrevious

Revient à la phase précédente. Avec Mise à jour 1 de Microsoft Dynamics CRM Online 2015, vous pouvez utiliser movePrevious dans une phase précédente dans une autre entité.

Xrm.Page.data.process.movePrevious(callbackFunction);

  • Paramètre
    Type : Fonction

    Remarques : fonction facultative à appeler lorsque l'opération est terminée. Cette fonction de rappel reçoit l'une des valeurs de chaîne suivantes pour indiquer si l'opération a réussi.

    Valeur

    Description

    success

    L'opération a réussi.

    crossEntity

    La phase précédente concerne une autre entité.

    beginning

    La phase active est la première phase du chemin actif.

    invalid

    L'opération a échoué car la phase sélectionnée n'est pas identique à la phase active.

    dirtyForm

    Cette valeur sera retournée si les données de la page ne sont pas enregistrées.

Important

Cette méthode peut uniquement être utilisée lorsque la phase sélectionnée et la phase active sont identiques. Lorsque votre code est initialisé à partir de l'Événement OnStageChange, la phase actuelle est sélectionnée. Lorsque votre code est initialisé à partir de l'Événement OnStageSelected, vous devez utiliser Xrm.Page.data.process.getActiveStage pour vérifier que la phase sélectionnée est également la phase active. Pour tout autre événement de formulaire, il est impossible de déterminer la phase actuellement sélectionnée. Pour de meilleurs résultats, cette méthode ne doit être utilisée que dans le code appelé dans les fonctions initialisées par les événements OnStageChange et OnStageSelected.

Notes

Avec Mise à jour 1 de Microsoft Dynamics CRM Online 2015, vous pouvez utiliser cette méthode pour revenir à une phase pour une autre entité.

Méthodes de processus

Un processus contient les données d'un flux des processus d'entreprise. Utilisez les méthodes de processus pour accéder aux propriétés du processus.

getId

Renvoie l'identificateur unique du processus.

var processId = procObj.getId();
  • Valeur renvoyée
    Type :String

Remarques La valeur représente la chaîne d'une valeur du GUID.

getName

Renvoie le nom du processus

var processName = procObj.getName();
  • Valeur renvoyée
    Type :String

getStages

Renvoie une collection de phases au processus

var stageCollection = procObj.getStages();

  • Valeur renvoyée
    Type : Collection

    Voir Méthodes de la phase pour connaître les méthodes permettant d'accéder aux propriétés des phases renvoyées.

isRendered

Renvoie « true » si le processus est affiché, sinon « false »

var processRendered = procObj.isRendered();

Méthodes de la phase

Une phase contient les données d'une phase du flux des processus d'entreprise. Utilisez les méthodes pour accéder aux propriétés de la phase.

getCategory

Renvoie un objet avec une méthode getValue qui renvoie la valeur entière de la catégorie du flux des processus d'entreprise.

var stageCategoryNumber = stageObj.getCategory().getValue();

getEntityName

Renvoie le nom logique de l'entité à laquelle la phase est associée.

var stageEntityName = stageObj.getEntityName();
  • Valeur renvoyée
    Type :String

getId

Renvoie l'identificateur unique de la phase.

var stageId = stageObj.getId();
  • Valeur renvoyée
    Type :String

getName

Renvoie le nom de la phase.

var stageName = stageObj.getName();
  • Valeur renvoyée
    Type :String

getStatus

Renvoie le statut de la phase

var stageStatus = stageObj.getStatus();

  • Valeur renvoyée
    Type :String

    Remarques : Cette méthode renvoie active ou inactive.

getSteps

Renvoie une collection d'étapes de la phase.

var stepsCollection = stageObj.getSteps();

  • Valeur renvoyée
    Type :Array

    Voir Méthodes d'étape pour connaître les méthodes permettant d'accéder aux valeurs de propriété de l'étape.

Méthodes d'étape

Une étape contient les données d'une étape du flux des processus d'entreprise. Utilisez les méthodes pour accéder aux propriétés de l'étape.

getAttribute

Renvoie le nom logique de l'attribut à laquelle l'étape est associée.

var stepAttributeName = stepObj.getAttribute();

  • Valeur renvoyée
    Type :String

    Remarques : Certaines étapes ne contient aucune valeur d'attribut.

getName

Renvoie le nom de l'étape.

var stepName = stepObj.getName();
  • Valeur renvoyée
    Type :String

isRequired

Renvoie si l'étape est requise dans le flux des processus d'entreprise.

var stepIsRequired = stepObj.isRequired();

  • Valeur renvoyée
    Type :Boolean

    Remarques : Renvoie true si l'étape est marquée comme requise dans l'éditeur de flux des processus d'entreprise ; sinon, false. Il n'existe aucune connexion entre cette valeur et les valeurs que vous pouvez modifier dans les méthodes RequiredLevel de l'attribut Xrm.Page.data.entity.

Voir aussi

Écriture d'événements pour les flux de processus d'entreprise
Xrm.Page.ui.process (référence côté client)
Référence par programmation côté client
Référence rapide des scripts de formulaires
Écrire du code pour les formulaires Microsoft Dynamics CRM 2015
Utiliser le modèle d’objet Xrm.Page
Exemple : Xrm.Page.data.process.getEnabledProcesses
Exemple : Xrm.Page.data.process.getActivePath

© 2017 Microsoft. Tous droits réservés. Copyright