Práca s postupmi obchodných procesov pomocou programovania

Tok obchodného procesu vám umožní vytvárať efektívnejší a zjednodušený proces predaja, služieb a ďalších obchodných procesov. Vytvorí vizualizáciu obchodného procesu tak, že do hornej časti formulárov tabuliek umiestni špeciálne ovládacie prvky. Používateľov kompletne prevedieme rôznymi etapami predaja, marketingu alebo službami. Každý proces podporuje viacero etáp a krokov. Môžete pridávať alebo odstraňovať kroky, meniť poradie etáp alebo pridávať nové tabuľky do toku obchodného procesu.

Inštancie rôznych tokov obchodného procesu môžete spúšťať súbežne voči rovnakému riadku tabuľky. Používatelia môžu prepínať medzi inštanciami súbežných obchodných procesov a obnoviť svoju prácu v aktuálnej etape procesu.

Táto téma obsahuje informácie o tom, ako môžete pomocou programovania pracovať s tokmi obchodného procesu.

Požiadavky na tok obchodného procesu

Na toku obchodného procesu sa môžu podieľať vlastné tabuľky a tabuľky, ktoré majú aktualizované formuláre používateľského rozhrania. Aktualizované tabuľky používateľského rozhrania majú vlastnosť IsAIRUpdated nastavenú na hodnotu true.

Ak chcete zapnúť tabuľku pre tok obchodného procesu, nastavte IsBusinessProcessEnabled na hodnotu true.

Definovanie toku obchodného procesu

Na definovanie toku obchodného procesu využite návrhára vizuálu toku obchodného procesu. Ďalšie informácie: Vytvorenie toku obchodného procesu

V predvolenom nastavení je riadok toku obchodného procesu vytvorený v stave Draft.

Definícia toku obchodného procesu je uložená v tabuľke workflow a informácie o etape toku obchodného procesu sú uložené v tabuľke processstage.

Aktivovať tok obchodného procesu

Pred prácou s tokom obchodného procesu ho musíte najprv aktivovať. Na to musíte mať oprávnenie prvActivateBusinessProcessFlow pre tabuľku Workflow. Na nastavenie stavu riadka tabuľky Workflow na Activated použite správu UpdateRequest. Ďalšie informácie: Vykonávanie špecializovaných operácií pomocou aktualizácie

Tabuľka toku obchodného procesu

Po aktivácii definície toku obchodného procesu – zmenou stavu záznamu zodpovedajúceho riadka tabuľky Workflow alebo pomocou návrhára tokov obchodného procesu – sa automaticky vytvorí vlastná tabuľka s nasledujúcim názvom na ukladanie aktivovaných inštancií tokov obchodného procesu: „<activesolutionprefix> _ <uniquename>“, v ktorom je uniquename je odvodený od názvu, ktorý zadáte.

Napríklad, ak ako názov definície toku obchodného procesu zadáte „Môj vlastný tok obchodného procesu“ a pre aktívne riešenia používate predvolené nastavenie vydavateľa (new), názov vlastnej tabuľky vytvorenej na ukladanie inštancií procesu bude „new_mojvlastnytokobchodnehoprocesu“.

Ak hodnota uniquename nie je k dispozícii pre definíciu toku obchodného procesu (ak bol napríklad tok obchodného procesu importovaný ako súčasť riešenia zo staršej verzie), predvolený názov vlastnej tabuľky bude „\<activesolutionprefix>_bpf_<GUID_BPF_Definition>“:

Názov tabuľky toku obchodného procesu môžete načítať pomocou niektorého z nasledujúcich spôsobov:

• Pomocou používateľského rozhrania: Pomocou prispôsobenia používateľského rozhrania môžete vyhľadať tabuľku toku obchodného procesu:

  

• Pomocou webového rozhrania API: Použite nasledujúcu požiadavku:

  Požiadavka

  GET [Organization URI]/api/data/v9.0/workflows?$filter=name eq 'My Custom BPF'&$select=uniquename HTTP/1.1
  

  Response

  {  
  "@odata.context":"[Organization URI]/api/data/v9.0/$metadata#workflows(uniquename)",
  "value":[  
       {  
           "@odata.etag":"W/\"1084677\"",
           "uniquename":"new_mycustombpf",
           "workflowid":"2669927e-8ad6-4f95-8a9a-f1008af6956f"
       }
    ]
  }
  

• Používanie organizačnej služby: Použite túto vzorku kódu:

  QueryExpression query = new QueryExpression
  {
      EntityName = "workflow",
      ColumnSet = new ColumnSet("uniquename"),
      Criteria = new FilterExpression
      {
          Conditions =
          {
              new ConditionExpression
              {
                  ColumnName = "name",
                  Operator = ConditionOperator.Equal,
                  Values = { "My Custom BPF" }
              }
          }
      }
  };
  Workflow Bpf = (Workflow)_serviceProxy.RetrieveMultiple(query).Entities[0]; 
  

GET [Organization URI]/api/data/v9.0/EntityDefinitions?$select=SchemaName,LogicalName,DisplayName&$filter=IsBPFEntity eq true HTTP/1.1

Správa zabezpečenia pre toky obchodných procesov

Vlastná tabuľka, ktorá sa automaticky vytvorí pri aktivácii toku obchodného procesu na uchovávanie inštancií toku obchodného procesu, zodpovedá štandardnému modelu zabezpečenia pre ľubovoľnú inú vlastnú tabuľku v Microsoft Dataverse. Z toho vyplýva, že oprávnenia udelené v týchto tabuľkách definujú oprávnenia používateľov v režime runtime pre toky obchodných procesov.

Vlastná tabuľka toku obchodného procesu má rozsah organizácie. Bežné oprávnenia na vytvorenie, načítanie, aktualizáciu a odstránenie v tejto tabuľke definujú oprávnenia, ktorá by používateľ mal na základe svojich priradených rolí. Po vytvorení vlastnej tabuľky toku obchodného procesu k nej majú v predvolenom nastavení prístup iba roly zabezpečenia Správca systému a Prispôsobovač systému. Ďalším požadovaným rolám zabezpečenia musíte oprávnenia k novej tabuľke toku obchodného procesu (napríklad Moje vlastné BPF) explicitne prideliť.

Vytvorenie, načítanie, aktualizácia a odstránenie riadkov tabuľky toku obchodného procesu (inštancií procesu)

Vlastná tabuľka, ktorá sa automaticky vytvorí pri aktivácii definície toku obchodného procesu, uchováva všetky inštancie procesu pre definíciu toku obchodného procesu. Vlastná tabuľka podporuje štandardné programové vytváranie a správu riadkov (inštancií procesu) pomocou rozhrania Web API a koncového bodu CRM 2011.

Pozrime sa na nasledujúci príklad, v ktorom máme tok obchodného procesu medzi tabuľkami Moje vlastné BPF, ktorý obsahuje tri fázy: S1: Obchodný vzťah, S2: Obchodný vzťah a S3: Kontakt.

Načítanie všetkých riadkov (inštancií) pre tabuľku toku obchodného procesu

Ak je názov vášho riadka toku obchodného procesu „nove_mojevlastnebpf“, na načítanie všetkých riadkov (inštancií procesu) pre danú tabuľku toku obchodného procesu použite nasledujúci dotaz:

GET [Organization URI]/api/data/v9.0/new_mycustombpfs HTTP/1.1 

V tomto bode nemusíte dostať žiadne inštancie vo svojej odpovedi, ak žiadne nie sú. Nižšie v tejto téme spustite túto žiadosť po vytvorení inštancie toku obchodného procesu.

Vytvorenie riadka tabuľky toku obchodného procesu (inštancie procesu)

Ak chcete prepnúť do iného toku obchodného procesu pre riadok tabuľky bez použitia používateľského rozhrania, vytvorte riadok tabuľky toku obchodného procesu (inštancie procesu).

Na vytvorenie riadka tabuľky toku obchodného procesu musíte zadať nasledujúce hodnoty:

• Priraďte riadok tabuľky toku obchodného procesu k primárnemu riadku tabuľky nastavením vlastnosti navigácie s jednou dovolenou hodnotou pomocou komentára @odata.bind. Ak chcete zistiť názov vlastnosti navigácie, ktorá smeruje k primárnemu riadku tabuľky pre definíciu toku obchodného procesu, použite dokument CSDL $metadata.

• Priraďte riadok tabuľky toku obchodného procesu k platnej etape špecifikovanej v definícii toku obchodného procesu nastavením vlastnosti navigácie s jednou dovolenou hodnotou pomocou komentára @odata.bind. Ak chcete zistiť názov vlastnosti navigácie (zvyčajne activestageid), ktorá smeruje k riadku etapy pre definíciu toku obchodného procesu, použite dokument CSDL $metadata .

  Okrem toho môžete načítať informácie o všetkých etáp pre definíciu toku obchodného procesu pomocou nasledujúcej požiadavky webového rozhrania API za predpokladu, že ID definície toku obchodného procesu je 2669927e-8ad6-4f95-8a9a-f1008af6956f:

  Požiadavka

  GET [Organization URI]/api/data/v9.0/processstages?$select=stagename&$filter=processid/workflowid eq 2669927e-8ad6-4f95-8a9a-f1008af6956f HTTP/1.1
  

  Response

  {
      "@odata.context": "[Organization URI]/api/data/v9.0/$metadata#processstages(stagename)",
      "value": [
          {
              "@odata.etag": "W/\"858240\"",
              "stagename": "S1",
              "processstageid": "9a9185f5-b75b-4bbb-9c2b-a6626683b99b"
          },
          {
              "@odata.etag": "W/\"858239\"",
              "stagename": "S3",
              "processstageid": "a107e2fd-7543-4c1a-b6b4-b8060ecb1a1a"
          },
          {
              "@odata.etag": "W/\"858238\"",
              "stagename": "S2",
              "processstageid": "19a11fc0-3398-4214-8522-cb2a97f66e4b"
          }
      ]
  }
  

Potom použite nasledujúcu žiadosť na vytvorenie inštancie definície toku obchodného procesu pre riadok konta (ID = a176be9e-9a68-e711-80e7-00155d41e206) a nastavenie aktívnej etapy ako prvej etapy inštancie procesu, S1 (ID =9a9185f5-b75b-4bbb-9c2b-a6626683b99b):

Požiadavka

POST [Organization URI]/api/data/v9.0/new_mycustombpfs HTTP/1.1 
Content-Type: application/json; charset=utf-8 
OData-MaxVersion: 4.0 
OData-Version: 4.0 
Accept: application/json 

{
    "bpf_accountid@odata.bind": "/accounts(a176be9e-9a68-e711-80e7-00155d41e206)",
    "activestageid@odata.bind": "/processstages(9a9185f5-b75b-4bbb-9c2b-a6626683b99b)"    
}

Response

HTTP/1.1 204 No Content
OData-Version: 4.0
OData-EntityId: [Organization URI]/api/data/v9.0/new_mycustombpfs(cc3f721b-026e-e811-80ff-00155d513100)

Všimnite si, že ak chcete vytvoriť inštanciu definície toku obchodného procesu s aktívnou etapou inou ako prvou, musíte vo vašej žiadosti zadať traversedpath. Cesta presunu je reťazec identifikácií etáp procesu oddelený čiarkami, ktoré predstavujú navštívené etapy inštancie toku obchodného procesu. Nasledujúca požiadavka vytvorí inštanciu pre riadok účtu (679b2464-71b5-e711-80f5-00155d513100) a aktívny stupeň nastavený ako druhý stupeň, S2 (ID = 19a11fc0-3398-4214-8522-cb2a97f66e4b).

POST [Organization URI]/api/data/v9.0/new_mycustombpfs HTTP/1.1 
Content-Type: application/json; charset=utf-8 
OData-MaxVersion: 4.0 
OData-Version: 4.0 
Accept: application/json 

{
    "bpf_accountid@odata.bind": "/accounts(679b2464-71b5-e711-80f5-00155d513100)",
    "activestageid@odata.bind": "/processstages(19a11fc0-3398-4214-8522-cb2a97f66e4b)",
    "traversedpath":"9a9185f5-b75b-4bbb-9c2b-a6626683b99b,19a11fc0-3398-4214-8522-cb2a97f66e4b"   
}

Aktualizácia riadka tabuľky toku obchodného procesu (inštancie procesu)

Môžete aktualizovať inštanciu procesu na prejdenie na nasledujúcu alebo predchádzajúcu etapu, opustiť inštanciu procesu, znova aktivovať inštanciu procesu alebo dokončiť inštanciu procesu.

Etapa navigácie

Na inú etapu prejdete, ak aktualizujete riadok inštancie procesu zmenou ID jej aktívnej etapy a podobne aktualizujete aj cestu prenosu. Všimnite si, že počas aktualizácie inštancie toku obchodného procesu sa stačí presunúť na nasledujúcu alebo predchádzajúcu etapu.

Na vykonanie navigácie etapou budete potrebovať ID inštancie toku obchodného procesu, ktorú chcete aktualizovať. Ak chcete načítať všetky inštancie toku obchodného procesu, pozrite si vyššie tému Načítanie všetkých riadkov (inštancií) pre tabuľku toku obchodného procesu.

Za predpokladu, že ID inštancie procesu, ktorú chcete aktualizovať, je dc2ab599-306d-e811-80ff-00155d513100, použite nasledujúcu požiadavku na aktualizáciu aktívnej etapy z S1 na S2:

PATCH [Organization URI]/api/data/v9.0/new_mycustombpfs(dc2ab599-306d-e811-80ff-00155d513100) HTTP/1.1
Content-Type: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0

{
    "activestageid@odata.bind": "/processstages(19a11fc0-3398-4214-8522-cb2a97f66e4b)",
    "traversedpath": "9a9185f5-b75b-4bbb-9c2b-a6626683b99b,19a11fc0-3398-4214-8522-cb2a97f66e4b"
}

Zmena stavu inštancie procesu: prerušenie, aktivovanie, alebo dokončenie

Inštancia procesu môže mať jeden z nasledujúcich stavov: Aktívny, Dokončený alebo Prerušený. Stav sa určuje podľa nasledujúcich stĺpcov v riadku inštancie procesu:

• statecode: Zobrazuje stav inštancie procesu.

  Hodnota	Label
  0	Aktívny
  1	Neaktívny

• statuscode: Zobrazuje informácie o stave inštancie procesu.

  Hodnota	Label
  1	Aktívny
  2	Dokončené
  3	Prerušené

Na prerušenie inštancie procesu vhodne nastavte nasledujúce hodnoty požiadaviek statecode a statuscode:

PATCH [Organization URI]/api/data/v9.0/new_mycustombpfs(dc2ab599-306d-e811-80ff-00155d513100) HTTP/1.1   
Content-Type: application/json   
OData-MaxVersion: 4.0   
OData-Version: 4.0 
  
{ 
    "statecode" : "1", 
    "statuscode": "3" 
}

Podobne, na opätovnú aktiváciu inštancie procesu nahraďte hodnoty statecode a statuscode vo vyššie uvedenom kóde hodnotami 0 a 1.

Nakoniec stav inštancie procesu nastavíte na Dokončený, čo je možné len v poslednej etape inštancie procesu, tak, že nahradíte hodnoty statecode a statuscode vo vyššie uvedenom kóde na 0 a 2.

Navigácia naprieč tabuľkami

Na navigáciu naprieč tabuľkami v tomto príklade musíte nastaviť aktívnu etapu inštancie procesu na poslednú etapu, S3 (ID=a107e2fd-7543-4c1a-b6b4-b8060ecb1a1a), aktualizovať podobne aj cestu presunu a nastaviť cieľový riadok ako primárny riadok tabuľky v súlade s definíciou toku obchodného procesu.

PATCH [Organization URI]/api/data/v9.0/new_mycustombpfs(dc2ab599-306d-e811-80ff-00155d513100) HTTP/1.1   
Content-Type: application/json   
OData-MaxVersion: 4.0   
OData-Version: 4.0 
  
{
    "activestageid@odata.bind": "/processstages(a107e2fd-7543-4c1a-b6b4-b8060ecb1a1a)",
    "traversedpath":"9a9185f5-b75b-4bbb-9c2b-a6626683b99b,19a11fc0-3398-4214-8522-cb2a97f66e4b,a107e2fd-7543-4c1a-b6b4-b8060ecb1a1a",
    "bpf_contactid@odata.bind": "/contacts(0e3f10b0-da33-e811-80fc-00155d513100)"
}

Odstránenie riadka tabuľky toku obchodného procesu (inštancie procesu)

Použite nasledujúcu požiadavku webového rozhrania API:

Požiadavka

DELETE [Organization URI]/api/data/v9.0/new_mycustombpfs(dc2ab599-306d-e811-80ff-00155d513100) HTTP/1.1

Response

Ak riadok existuje, zobrazí sa vám normálna odpoveď so stavom 204, že odstránenie bolo úspešné. Ak sa tabuľka nenájde, zobrazí sa vám odpoveď so stavom 404.

Použitie správ RetrieveProcessInstances a RetrieveActivePath

Použite správu RetrieveProcessInstances (RetrieveActivePath Function alebo RetrieveProcessInstancesRequest) na načítanie všetkých inštancií toku obchodného procesu pre riadok tabuľky v rámci všetkých definícií toku obchodného procesu. Inštancie toku obchodného procesu vrátené pre tabuľku sú zoradené podľa stĺpca modifiedon pre inštanciu. Napríklad naposledy upravená inštancia toku obchodného procesu bude prvý riadok vo vrátenej kolekcii. Naposledy upravená inštancia toku obchodného procesu je aktívna v používateľskom rozhraní pre riadok tabuľky.

Každý riadok toku obchodného procesu vrátený pre riadok tabuľky po použití správy RetrieveProcessInstances ukladá ID aktívnej etapy v stĺpci processstageid, ktorý možno použiť na vyhľadanie aktívnej etapy a potom prejdenie na predchádzajúcu alebo nasledujúcu etapu. Na to najprv budete musieť nájsť aktívnu cestu k inštancii toku obchodného procesu a etapy, ktoré sú v inštancii k dispozícii pomocou správy RetrieveActivePath (RetrieveActivePath Function alebo RetrieveActivePathRequest).

Keď budete mať aktívnu etapu a informácie o aktívnej ceste pre inštanciu toku obchodného procesu, môžete tieto informácie použiť a prejsť na predchádzajúcu alebo nasledujúcu etapu aktívnej cesty. Navigácia smerom dopredu musí byť vykonaná v poradí, t. j. iba vpred do ďalšej fázy aktívnej cesty.

Kompletnú ukážku, ako vzorový kód ukazuje používanie týchto dvoch spôsobov, a navigácie medzi etapami pomocou služby organizácie, nájdete v téme Ukážka: práca s tokmi obchodného procesu.

Použitie toku obchodného procesu pri vytváraní riadka tabuľky

Táto časť poskytuje informácie o predvolenom správaní pri automatickom použití tokov obchodného procesu v nových riadkoch tabuľky vytvorených v Dataverse, a o tom, ako môžete ho prepísať a aplikovať tok obchodného procesu podľa vášho výberu pre nové riadky tabuľky.

Pre tabuľku, ktorá obsahuje viaceré pre ňu definované toky obchodného procesu, systém podľa predvoleného nastavenia aplikuje tok obchodného procesu na nový riadok tabuľky pomocou nasledujúcej logiky viacerých krokov:

1. Identifikujte všetky toky obchodného procesu vzťahujúce sa na nový riadok tabuľky na základe stĺpca Workflow.PrimaryEntity riadkov definícií toku obchodného procesu.
2. Identifikujte definície toku obchodného procesu, ku ktorým má aktuálny používateľ prístup. Informácie o zadávaní a spravovaní prístupu k toku obchodného procesu nájdete vyššie – Správa zabezpečenia pre toky obchodného procesu.
   
3. Na všetky definície toku obchodného procesu v systéme sa vzťahuje globálne poradie pre tabuľku. Poradie toku obchodného procesu je uložené v stĺpci Workflow.ProcessOrder. Definície toku obchodného procesu pre tabuľku sú zoradené podľa tohto poradia a vyberie sa tá s najnižšou hodnotou.
4. Nakoniec, ak sa riadok tabuľky vytvorí z podnikovej aplikácie (modulu aplikácie), automaticky sa použije ešte jedna úroveň filtrovania na vybratie toku obchodného procesu pre nový riadok tabuľky. Pri práci v tejto aplikácii majú používatelia prístup len k relevantným tabuľkám, tokom obchodného procesu, zobrazeniam a formulárom, ku ktorým majú prístup na základe rolí zabezpečenia priradených k tejto podnikovej aplikácii.
   • Ak podniková aplikácia neobsahuje žiadne toky obchodného procesu, použije sa tok obchodného procesu tak, ako je to vysvetlené až do kroku č. 3.
   • Ak má podniková aplikácií jeden alebo viac tokov obchodného procesu, budú použité len tie. V tomto prípade používateľ pracuje v rámci podnikovej aplikácie a toky obchodného procesu z kroku č. 3 sa filtrujú na tie, ktoré sú súčasťou aplikácie, v module aplikácie a sú zoradené podľa poradia tokov.
   • Ak nie je v obchodnej aplikácii žiadny tok obchodného procesu k dispozícii pre tabuľku alebo k nim používateľ nemá prístup, tak sa nepoužije pre nový riadok tabuľky žiadny tok obchodného procesu.

Predvolené logické kroky tokov obchodného procesu získavané automaticky môžete prepísať na nové riadky tabuľky. Na to nastavte pri vytváraní nového riadka tabuľky stĺpec ProcessId tabuľky na jednu z nasledujúcich hodnôt:

• Nastavením hodnoty na Guid.Empty preskočíte nastavenie toku obchodného procesu pre nové riadky tabuľky. Môžete tak chcieť urobiť, ak hromadne vytvárate riadky tabuľky, ale nechcete, aby sa použil tok obchodného procesu.
• Nastavte ju na konkrétnu tabuľku toku obchodného procesu (ako odkaz na tabuľku). V tomto prípade bude systém používať špecifikovaný tok obchodného procesu namiesto predvoleného.

Ak pri vytváraní nového riadka tabuľky nenastavíte hodnotu pre stĺpec ProcessId, systém bude používať predvolené nastavenie, ako bolo vysvetlené vyššie.

Staré stĺpce súvisiace s procesmi v tabuľkách

Staršie stĺpce súvisiace s procesmi (ako napríklad ProcessId, StageId a TraversedPath) pri tabuľkách zapnutých pre toky obchodného procesu sú už zastarané. Používanie týchto stĺpcov pre cieľové riadky tabuľky nezaručuje konzistentnosť stavu toku obchodného procesu a nie je podporovaným scenárom. Odporúča sa používať stĺpce tabuľky toku obchodného procesu popísané vyššie v časti Vytvorenie, načítanie, aktualizácia a odstránenie riadkov tabuľky toku obchodného procesu záznamy entity (inštancií procesu)

Jedinou výnimkou je úprava stĺpca ProcessId programovaním počas vytvárania riadka tabuľky, keď sa predvolená aplikácia toku obchodného procesu prepíše na nový riadok, ako je to vysvetlené v predchádzajúcej časti: Použitie toku obchodného procesu pri vytváraní riadka tabuľky.

Podpora pre programovanie pre toky obchodného procesu na strane klienta

Na strane klienta je objekt, ktorý možno použiť na prácu s tokmi obchodného procesu v skriptoch formulára. Toky obchodného procesu spúšťajú udalosti na strane klienta zakaždým, keď sa proces aplikuje na riadok, mení etapa alebo sa mení stav procesu na Active, Finished alebo Aborted. Ďalšie informácie: formContext.data.process (odkaz na klientske rozhranie API)

Maximálny počet procesov, etáp a krokov

Predvolená tabuľka maximálneho počtu aktivovaných tokov obchodného procesu pre každú tabuľku je 10. Môžete zadať inú hodnotu s použitím stĺpca Organization.MaximumActiveBusinessProcessFlowsAllowedPerEntity. Avšak, ak je hodnota väčšia ako 10, môžete spozorovať spomalenie výkonu vášho systému pri prepínaní medzi procesmi alebo otváraní riadka s priradeným tokom obchodného procesu. Zvlášť si to všimnete, ak procesy siahajú do viacerých tabuliek.

Tieto nastavenia nie sú prispôsobiteľné:

• Maximálny počet tabuliek na každú entitu v procese je 30.

• Maximálny počet krokov v každej etape je 30.

• Maximálny počet tabuliek v rámci toku obchodného procesu je 5.