Skrive scripts til forretningsprocesforløb

 

Udgivet: januar 2017

Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Med Microsoft Dynamics 365 (online og i det lokale miljø) er der et klientobjekt, du kan bruge til at interagere med forretningsprocesforløb i dine scripts.Xrm.Page.data-navneområdet er udvidet til at omfatte metoder under Xrm.Page.data.process.Xrm.Page.ui-navneområdet er udvidet til at omfatte metoder under Xrm.Page.ui.process.

Dette emne indeholder

Strukturen af forretningsprocesforløb

Handlinger, der kan automatiseres

Hændelser for forretningsprocesforløb

Strukturen af forretningsprocesforløb

Forretningsprocesforløb består af en række faser, der hvert indeholder et antal trin. Kun én fase er den aktive fase. Når du har fuldført de nødvendige trin i hver fase, kan processen gå videre til næste fase, og den bliver den aktive fase. Hvilken fase der er den næste, kan defineres på grundlag af betingelserne i forretningsprocesforløbet, som vist i følgende diagram.

Faser kan knyttes til bestemte relaterede objekter, så en forretningsproces kan strække sig over flere objekter. Forretningsprocessen forbliver uændret og fører brugeren til den ønskede konklusion.

Med start i December 2016 – opdatering til Dynamics 365 (online og det lokale miljø)kan forskellige definitioner af forretningsprocesforløb knyttes til forskellige roller, og forekomsterne kan køre samtidig mod den samme objektpost. Brugerne kan skifte mellem samtidige forretningsprocesforekomster og fortsætte deres arbejde i en aktuel fase i processen.

Flere oplysninger:TechNet: Forretningsprocesforløb

Handlinger, der kan automatiseres

Normalt afhænger fremskridt under forretningsprocessen af input fra brugeren. Som udvikler, kan du udføre de samme handlinger i formularscripts ved hjælp af programmering.

• Rediger processen, når der er mere end én tilgængelig proces for objektet.
  Brug Xrm.Page.data.process.getEnabledProcesses til at hente oplysninger om aktiverede processer, som brugeren kan vælge for objektet. Brug derefter Xrm.Page.data.process.setActiveProcess for at gøre en af de aktiverede procesforekomster til det aktive eller oprette en ny procesforekomst.

• Ændre procesforekomsten for en objektpost
  Brug getProcessInstances til at hente oplysninger om alle procesforekomsterne til en objektpost og setActiveProcessInstance til at angive en procesforekomst som den aktive forekomst.

• Gå til næste fase, når alle nødvendige trin er udført for at gøre den til den aktuelle aktive fase.
  Benyt Xrm.Page.data.process.moveNext.

• Gå til den forrige fase, og gør den til den aktuelle aktive fase.
  Benyt Xrm.Page.data.process.movePrevious.

• Vælg en fase for at få vist status for trinene i fasen.
  Brug Xrm.Page.data.process.getActivePath til at hente oplysninger om de faser, der er fuldført, den aktuelle aktive fase og gyldige faser, der er tilgængelige fra den aktuelle aktive fase. Undersøg de trin, der er inkluderet i denne fase, og sammenlign de tilsvarende formularattributværdier for at afgøre, om de er fuldført.

• Fuldføre et trin
  Trin er fuldført, når de tilsvarende data i formularen er angivet. Du kan bestemme en attribut ved hjælp af metoden getAttribute for trinnet. Dette returnerer det logiske navn for attributten. Brug derefter Xrm.Page.getAttribute til at hente attributten fra Xrm.Page.data.entity.attributes-samlingen, og brug derefter attributmetoden 6881e99b-45e4-4552-8355-2eef296f2cd8#BKMK_setValue til at angive værdien.

• Registrere, om et trin er påkrævet
  Brug trinmetoden isRequired til at bestemme, om der kræves et trin i forretningsprocessen.

• Vise eller skjule styring af forretningsprocesforløb
  Benyt Xrm.Page.ui.process.setDisplayState.

• Gå til en gyldig fuldført fase.
  Brug Xrm.Page.data.process.setActiveStage til at angive en af de gyldige fuldførte faser for det aktuelle objekt.

Der er også nogle ting, du kan gøre som udvikler, som en bruger ikke kan udføre.

• Skjule styring af processen
  Ved hjælp af Xrm.Page.ui.process.setVisible kan du styre, om styringen af forretningsprocesforløbet skal vises.

• Forespørge på procesdefinitionen, herunder faser, der ikke er synlige
  Brug Xrm.Page.data.process.getActiveProcess til at forespørge på definitionen af forretningsprocesforløbet, herunder faser, som ikke måske ses på grund af forgreningslogik i processen.

Hændelser for forretningsprocesforløb

Du kan interagere med enhver hændelse fra formularen med forretningsprocesforløb, men de efterfølgende nye hændelser gør det muligt at køre kode, der er baseret på hændelser kun for styringen af forretningsprocesforløbet.

• Du kan køre kode, når den aktive fase i et forretningsprocesforløb ændres (d88d5f21-6385-443b-91f2-0ec0c16b1324#BKMK_OnStageChange), eller når en fase er valgt (d88d5f21-6385-443b-91f2-0ec0c16b1324#BKMK_OnStageSelected).

• Du kan udføre kode, når statussen for en forekomst af forretningsprocesforløbet ændrer sig (d88d5f21-6385-443b-91f2-0ec0c16b1324#BKMK_OnProcessStatusChange). En forekomst af forretningsprocesforløbet kan have en af følgende statusser: Active, Finished eller Aborted.

Ingen af disse nye hændelser giver en brugergrænseflade til registrering af dine hændelseshandlere. Du skal bruge de metoder, der angives, til at tilføje eller fjerne handlere for disse hændelser i formularens OnLoad-hændelse.Flere oplysninger:f451f339-bcee-4260-9904-abc8c0efa153#BKMK_BPFControl

Se også

Bruge Xrm.Page-objektmodel
Xrm.Page.data.process (klientsidereference)
Eksempel: Xrm.Page.data.process.getEnabledProcesses
Eksempel: Xrm.Page.data.process.getActivePath
f451f339-bcee-4260-9904-abc8c0efa153#BKMK_BPFControl
TechNet: Forretningsprocesforløb

Microsoft Dynamics 365

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret