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

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.

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.

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.

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();

• Valeur renvoyée
  Type :Boolean

  Remarques : si le formulaire utilisé a été mis à niveau depuis une version précédente de Microsoft Dynamics CRM et non pour utiliser des formulaires, le contrôle du flux des processus d'entreprise ne peut pas être affiché.Pour plus d'informations :TechNet : Mise à jour de vos formulaires vers Microsoft Dynamics CRM 2013 ou Microsoft Dynamics CRM Online, automne 2013

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();

• Valeur renvoyée
  Type :Number

  Remarques : Pour obtenir la liste des valeurs possibles, voir Catégorie de phase (processstage_category).

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