{"id":4421,"date":"2017-12-06T11:07:01","date_gmt":"2017-12-06T10:07:01","guid":{"rendered":"https:\/\/sii.pl\/blog\/?p=4421"},"modified":"2022-08-11T16:28:56","modified_gmt":"2022-08-11T14:28:56","slug":"nintex-workflow-user-defined-actions","status":"publish","type":"post","link":"https:\/\/sii.pl\/blog\/nintex-workflow-user-defined-actions\/","title":{"rendered":"Nintex Workflow User Defined Actions"},"content":{"rendered":"

User Defined Actions<\/strong> to zestaw akcji (paczka), realizuj\u0105ca okre\u015blone kroki w procesach Nintex Workflow. Gdyby\u015bmy chcieli znale\u017a\u0107 odniesienie np. w kontek\u015bcie notacji BPMN, mo\u017cemy<\/p>\n

powiedzie\u0107, \u017ce zestaw [UDA] jest podprocesem zwini\u0119tym (Collapsed Sub-Process). Nale\u017cy traktowa\u0107 [UDA] jako podproces w procesie g\u0142\u00f3wnym. W zale\u017cno\u015bci od scenariusza, mo\u017cemy wykorzysta\u0107 pojedyncz\u0105 paczk\u0119 [UDA] w wielu procesach \u2013 pozwala to zoptymalizowa\u0107 ich struktur\u0119 poprzez wyniesienie z\u0142o\u017conej logiki poza procesy g\u0142\u00f3wne.<\/p>\n

<\/p>\n

\"Nintex<\/p>\n

Aby optymalnie wykorzysta\u0107 funkcjonalno\u015b\u0107 paczki [UDA], nale\u017cy przejrze\u0107 zaimplementowane procesy i wybra\u0107 te cz\u0119\u015bci proces\u00f3w, kt\u00f3re mog\u0105 zosta\u0107 zast\u0105pione zestawem [UDA].<\/p>\n

\n

UDAs<\/a> provide the ability to string together a predefined set of multiple workflow actions for workflow designers to use when creating a workflow…<\/p>\n<\/blockquote>\n

Demo<\/h2>\n

Poni\u017cej znajduje si\u0119 przyk\u0142ad budowy i wykorzystania paczki UDA.<\/p>\n

Cel: Udzielenie uprawnie\u0144 u\u017cytkownikowi poprzez dodanie go do okre\u015blonej grupy uprawnie\u0144 poprzez wykorzystanie funkcjonalno\u015bci zestawu User Defined Actions
<\/strong><\/p>\n

    \n
  1. Przechodzimy do g\u0142\u00f3wnej witryny kolekcji witryn (site collection root). Klikamy w prawym g\u00f3rnym rogu strony w ikon\u0119 [Settings<\/strong>]\"\"<\/li>\n
  2. Wybieramy z menu opcj\u0119 [Nintex Workflow<\/strong>]\"Nintex_menu\"<\/li>\n
  3. Na stronie ustawie\u0144 Nintex Workflow klikamy w odno\u015bnik [User Defined Actions (UDAs)<\/strong><\/li>\n
  4. Zostajemy przeniesieni do strony konfiguracji paczek [UDA].<\/li>\n<\/ol>\n

    \"Paczki<\/p>\n

    W g\u00f3rnej sekcji strony dost\u0119pne s\u0105 przyciski pozwalaj\u0105ce na prac\u0119 z paczkami [UDA]. W centralnej sekcji strony znajduje si\u0119 lista paczek.<\/span><\/p>\n

      \n
    1. Klikamy w przycisk [Create<\/strong>] \"\"<\/li>\n
    2. Zostajemy przekierowani do Nintex Workflow Designer-a.<\/li>\n<\/ol>\n

      \"Nintex<\/p>\n

      Designer pozwala na wygodn\u0105 prac\u0119 podczas konfiguracji procesu. Nale\u017cy co pewien czas zapisywa\u0107 efekty swojej pracy.<\/span><\/p>\n

        \n
      1. Rozwijamy opcj\u0119 [UDA Settings<\/strong>]<\/li>\n<\/ol>\n

        \"UDA<\/p>\n

        Do czego s\u0142u\u017c\u0105 poszczeg\u00f3lne opcje?<\/p>\n\n\n

        Funkcja<\/strong><\/th>Przycisk<\/strong><\/th>Opis<\/strong><\/th><\/tr><\/thead>
        UDA Settings<\/strong><\/td>\"\"<\/td>Po klikni\u0119ciu uruchomi si\u0119 okno z opcj\u0105 zdefiniowania nazwy, paczki oraz grupy w kt\u00f3rej zostanie opublikowana paczka [UDA]<\/td><\/tr>
        Variables<\/strong><\/td>\"\"<\/td>Po klikni\u0119ciu uruchomi si\u0119 okno z opcj\u0105 tworzenia, edytowania i usuwania zmiennych paczki [UDA]<\/td><\/tr>
        Parameters<\/strong><\/td>\"\"<\/td>Po klikni\u0119ciu uruchomi si\u0119 okno z opcj\u0105 tworzenia edycji, usuwania parametr\u00f3w wej\u015bciowych i wyj\u015bciowych<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n

        Czym s\u0105 [Parameters<\/strong>] ?<\/span><\/p>\n

        Parameters to zmienne do kt\u00f3rych przekazywane s\u0105 dane wej\u015bciowe z procesu Nintex Workflow i dane wyj\u015bciowe po przetworzeniu przez zestaw [UDA].<\/h3>\n

        <\/p>\n

        input parameter = krzysztof kowalski <\/span>-><\/strong>|UDA<\/strong>| -><\/strong> output parameters = Krzysztof Kowalski<\/span><\/h4>\n

        <\/p>\n

          \n
        1. Aby paczka, nad kt\u00f3r\u0105 pracujemy, dzia\u0142a\u0142a poprawnie musimy stworzy\u0107 nast\u0119puj\u0105ce zmienne i parametry:<\/li>\n<\/ol>\n

          \"Nintex_parametry\"<\/p>\n\n\n

          Przyk\u0142adowe dane<\/th>Rodzaj parametru (Direction) lub zmienna (Variable)<\/th>Typ (Type)<\/th>Wymagalno\u015b\u0107 (Required)<\/th>Nazwa parametru (Name) lub zmiennej (Variable)<\/th>Przeznaczenie<\/th><\/tr><\/thead>
          i:0#.w|domena\\user<\/td>-> Input<\/td>Text<\/td>Required<\/td>User<\/strong><\/td>Login u\u017cytkownika, kt\u00f3remu maj\u0105 zosta\u0107 nadane uprawnienia<\/td><\/tr>
          7<\/td>-> Input<\/td>Text<\/td>Required<\/td>Security group ID<\/strong><\/td>Identyfikator grupy uprawnie\u0144. Identyfikator mo\u017cna pobra\u0107 po przej\u015bciu do grupy uprawnie\u0144. Znajduje si\u0119 on w adresie URL np. (https:\/\/intranet.com\/sites\/demo\/_layouts\/15\/people.aspx?Membership=7)<\/td><\/tr>
          OK<\/td>Output -><\/td>Text<\/td><\/td>Outcome<\/strong><\/td>Wynik operacji dodawania u\u017cytkownika do grupy<\/td><\/tr>
          0x4193DA81F195B9BB8093E2B13A47
          312C17911F41E1F921
          1661E9E97188CC3689E
          A28B4E745A81BBB32E4B225
          8907BD2049D81A6F89
          BB26C65CFD80FE47F0495D,11 Aug 2017 12:07:50 -0000<\/td>          		Variable<\/td>Multiple lines of text<\/td><\/td>varMstrXRequestDigest<\/strong><\/td>Zmienna, do kt\u00f3rej zostanie zapisany token do bezpiecznego wywo\u0142ania us\u0142ug typu POST w ramach sesji. Token wa\u017cny jest przez 30 minut.<\/td><\/tr>
          i:0#.w|domena\\\\user<\/td>Variable<\/td>Text<\/td><\/td>varStrUserLoginName<\/strong><\/td>Zmienna, do kt\u00f3rej zostanie zapisana warto\u015b\u0107 po przetworzeniu przez akcj\u0119 Regular Expression<\/td><\/tr>
          For more information, please read this article: \u2026<\/td>Output -><\/td>Text<\/td><\/td>Errors<\/strong><\/td>S\u0142u\u017cy do zapisu ewentualnych b\u0142\u0119d\u00f3w wyst\u0119puj\u0105cych podczas przetwarzania<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n
            \n
          1. Przy u\u017cyciu przybornika znajduj\u0105cego si\u0119 z lewej strony, dodajemy akcj\u0119 do zestawu [UDA].<\/li>\n<\/ol>\n

            \"\"<\/p>\n

            Poni\u017cej znajduj\u0105 si\u0119 akcje, kt\u00f3re nale\u017cy doda\u0107 do paczki [UDA].<\/p>\n\n\n

            Konfiguracja<\/strong><\/th>Screen<\/strong><\/th><\/tr><\/thead>
            1.      Dodajemy akcj\u0119 typu [Web Request<\/strong>] i przechodzimy do jej konfiguracji
            2.      W adresie URL wpisujemy: {Common:WebUrl}\/_api\/contextinfo<\/strong>
            3.      Wybieramy b\u0105d\u017a wpisujemy nazw\u0119 u\u017cytkownika i has\u0142o:
            a. Username: domena\\user
            b. Password: xxxxxxxxxx
            *Mo\u017cemy zdefiniowa\u0107 konto przy u\u017cyciu kt\u00f3rego zostanie wykonana akcja za pomoc\u0105 sta\u0142ych przep\u0142ywu pracy \u2013 w tym celu nale\u017cy przej\u015b\u0107 do pod adres [_layouts\/15\/NintexWorkflow\/ManageCredentials.aspx?Scope=Web] i doda\u0107 sta\u0142\u0105 typu Credential
            4.      Wybieramy metod\u0119: POST<\/strong>
            5.      W polu Store result in<\/strong> ustawiamy zmienn\u0105: varMstrXRequestDigest<\/strong>
            6.      W sekcji Error handling<\/strong>:
            a. Capture errors<\/strong> ustawiamy na: Yes<\/strong>
            b. Store error text in<\/strong> ustawiamy parametr wychodz\u0105cy: Errors<\/strong>
            7.      Zapisujemy akcj\u0119 klikaj\u0105c Save<\/strong>.<\/td>            		\"\"
            \"\"<\/td><\/tr>
            1.      Dodajemy akcj\u0119 typu[Query XML<\/strong>] i przechodzimy do jej konfiguracji
            2.      W XML Source wybieramy: XML<\/strong>
            3.      W polu XML wpisujemy: {WorkflowVariable:varMstrXRequestDigest}<\/strong>
            4.      W proces using wybieramy: XPath<\/strong>
            5.      W polu Query wpisujemy: \/\/*[local-name()=’FormDigestValue’]<\/strong>
            6.      W polu Store results in<\/strong> wybieramy zmienn\u0105:  varMstrXRequestDigest<\/strong>
            7.      W sekcji Error handling<\/strong>:
            a. Capture errors<\/strong> ustawiamy na: Yes<\/strong>
            b. Store error text in<\/strong> ustawiamy parametr wychodz\u0105cy: Errors<\/strong>
            8.      Zapisujemy akcj\u0119 klikaj\u0105c Save<\/strong>.<\/td>            		\"\"
            \"\"<\/td><\/tr>
            1.      Dodajemy akcj\u0119 typu [Regular expression<\/strong>] i przechodzimy do jej konfiguracji
            2.      W pattern wpisujemy: \\\\<\/strong>
            3.      W Operation<\/strong> wybieramy:
            a. Ignore case<\/strong>
            b. Replace text<\/strong>
            4.      W Replacement text wpisujemy: \\<\/strong>
            5.      W Input text wpisujemy: {WorkflowVariable:User}<\/strong>
            6.      W store result in wybieramy zmienn\u0105: varStrUserLoginName<\/strong>
            7.      Zapisujemy akcj\u0119 klikaj\u0105c Save<\/strong>.<\/td>            		\"\"
            \"\"<\/td><\/tr>
            1.      Dodajemy akcj\u0119 typu [Web Request<\/strong>] i przechodzimy do jej konfiguracji
            2.      W adresie URL wpisujemy: {Common:WebUrl}\/_api\/web\/sitegroups({WorkflowVariable:Security group ID})\/users<\/strong>
            3.      Wybieramy b\u0105d\u017a wpisujemy nazw\u0119 u\u017cytkownika i has\u0142o:
            a. Username: domena\\user
            b. Password: xxxxxxxxxx
            4.      Wybieramy metod\u0119: POST<\/strong>
            5.      W polu Content type<\/strong> wpisujemy: application\/json;odata=verbose<\/strong>
            6.      Klikamy w Add headers<\/strong> i dodajemy nast\u0119puj\u0105ce nag\u0142\u00f3wki przy u\u017cyciu przycisku Add header:
            a. Accept – w polu Name wpisujemy: Accept<\/strong>, w polu Value wpisujemy: application\/json;odata=verbose<\/strong>
            b. X-RequestDigest – w polu Name wpisujemy: X-RequestDigest<\/strong>, w polu Value wpisujemy: {WorkflowVariable:varMstrXRequestDigest}<\/strong>
            7.      W polu Content wpisujemy: { '__metadata’: { 'type’: 'SP.User’ }, 'LoginName’:'{WorkflowVariable:varStrUserLoginName}’ }<\/strong>
            8.      W polu Store result in<\/strong> ustawiamy parametr: Outcome<\/strong>
            9.      W sekcji Error handling<\/strong>:
            a. Capture errors<\/strong> ustawiamy na: Yes<\/strong>
            b. Store error text in<\/strong> ustawiamy parametr wychodz\u0105cy: Errors<\/strong>
            10.      Zapisujemy akcj\u0119, klikaj\u0105c Save<\/strong>.<\/td>            		\"\"
            \"\"<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n
              \n
            1. Po zako\u0144czeniu konfiguracji klikamy w przycisk Publish.<\/strong><\/li>\n
            2. Uzupe\u0142nimy informacj\u0119 o paczce i klikamy Submit. <\/strong><\/li>\n<\/ol>\n

              \"\"<\/p>\n

              Paczka zostaje opublikowana i jest dost\u0119pna do u\u017cycia w ramach proces\u00f3w Nintex Workflow.<\/span><\/p>\n

                \n
              1. Przechodzimy do procesu Nintex Worfklow, dodajemy dost\u0119pn\u0105 opublikowan\u0105 paczk\u0119 [UDA].<\/li>\n<\/ol>\n

                \"\"<\/p>\n

                  \n
                1. Przechodzimy do konfiguracji i ustawiamy parametry wej\u015bciowe i wyj\u015bciowe.<\/li>\n<\/ol>\n

                  \"\"<\/p>\n

                  \u00a0<\/p>\n

                  Po zako\u0144czeniu konfiguracji publikujemy proces Nintex Workflow i sprawdzamy czy zestaw [UDA] dzia\u0142a poprawnie.<\/p>\n

                  Podsumowanie<\/p>\n

                  Funkcjonalno\u015b\u0107 User Defined Actions<\/strong> zwi\u0119ksza elastyczno\u015bci w procesach Nintex Workflow i znacz\u0105co zmniejsza ich z\u0142o\u017cono\u015b\u0107. Wykorzystanie zestaw\u00f3w [UDA] w procesach mo\u017ce przynie\u015b\u0107 bardzo wymierne korzy\u015bci w postaci zmniejszenia nak\u0142adu potrzebnego na wdra\u017cania i zarz\u0105dzania procesami Nintex Workflow.<\/p>\n

                  W kolejnym artykule poruszymy tematyk\u0119 zarz\u0105dzanie zestawami User Defined Actions.<\/p>\n

                  \"\"<\/p>\n

                  \"\"<\/p>\n

                  \u00a0<\/p>\n\n

                  \n \n
                  \n \n
                  \n
                  \n \n\n
                  <\/div>\n <\/div>\n
                  \n \n\n
                  <\/div>\n <\/div>\n
                  \n \n\n
                  <\/div>\n <\/div>\n
                  \n \n\n
                  <\/div>\n <\/div>\n
                  \n \n\n
                  <\/div>\n <\/div>\n <\/div>\n \n
                  \n
                  \n \n\n
                  <\/div>\n <\/div>\n
                  \n \n\n
                  <\/div>\n <\/div>\n
                  \n \n\n
                  <\/div>\n <\/div>\n
                  \n \n\n
                  <\/div>\n <\/div>\n
                  \n \n\n
                  <\/div>\n <\/div>\n <\/div>\n<\/div>\n \n\n
                  \n <\/span>\n <\/div>\n <\/div>\n","protected":false},"excerpt":{"rendered":"

                  User Defined Actions to zestaw akcji (paczka), realizuj\u0105ca okre\u015blone kroki w procesach Nintex Workflow. Gdyby\u015bmy chcieli znale\u017a\u0107 odniesienie np. w … Continued<\/a><\/p>\n","protected":false},"author":138,"featured_media":2741,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_editorskit_title_hidden":false,"_editorskit_reading_time":0,"_editorskit_is_block_options_detached":false,"_editorskit_block_options_position":"{}","inline_featured_image":false,"footnotes":""},"categories":[1314],"tags":[220,351,388,494,495,347],"class_list":["post-4421","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-development-na-twardo","tag-bpm","tag-nintex","tag-process","tag-uda","tag-user-defined-actions","tag-workflows"],"acf":[],"aioseo_notices":[],"republish_history":[],"featured_media_url":"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2016\/05\/nintex.jpg","category_names":["Development na twardo"],"_links":{"self":[{"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/posts\/4421"}],"collection":[{"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/users\/138"}],"replies":[{"embeddable":true,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/comments?post=4421"}],"version-history":[{"count":2,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/posts\/4421\/revisions"}],"predecessor-version":[{"id":15169,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/posts\/4421\/revisions\/15169"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/media\/2741"}],"wp:attachment":[{"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/media?parent=4421"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/categories?post=4421"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/tags?post=4421"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}