diff --git a/.DS_Store b/.DS_Store index c758d0b..15aba52 100644 Binary files a/.DS_Store and b/.DS_Store differ diff --git a/.vscode/settings.json b/.vscode/settings.json new file mode 100644 index 0000000..f4c4e6a --- /dev/null +++ b/.vscode/settings.json @@ -0,0 +1,5 @@ +{ + "cSpell.words": [ + "Tuter" + ] +} \ No newline at end of file diff --git a/AutomationEngine.html b/AutomationEngine.html index b31cd17..6b13bae 100644 --- a/AutomationEngine.html +++ b/AutomationEngine.html @@ -1,349 +1,287 @@ - - - - - - - -AutomationEngine - - - +.token.bold { + font-weight: bold; +} + +.token.italic { + font-style: italic; +} - - +/* JSON */ +.language-json .token.property { + color: #183691; +} -

Automation Engine - Workshop in a box

+.language-markup .token.tag .token.punctuation { + color: #333; +} -

Exercise 1 Automation Center

+/* CSS */ +code.language-css, +.language-css .token.function { + color: #0086b3; +} -

Exercise 2 Document Intelligence

+/* YAML */ +.language-yaml .token.atrule { + color: #63a35c; +} -

Exercise 3 Integration Hub

+code.language-yaml { + color: #183691; +} -

Exercise 4 RPA Hub

+/* Ruby */ +.language-ruby .token.function { + color: #333; +} +/* Markdown */ +.language-markdown .token.url { + color: #795da3; +} +/* Makefile */ +.language-makefile .token.symbol { + color: #795da3; +} +.language-makefile .token.variable { + color: #183691; +} - +.language-makefile .token.builtin { + color: #0086b3; +} + +/* Bash */ +.language-bash .token.keyword { + color: #0086b3; +} + +/* highlight */ +pre[data-line] { + position: relative; + padding: 1em 0 1em 3em; +} +pre[data-line] .line-highlight-wrapper { + position: absolute; + top: 0; + left: 0; + background-color: transparent; + display: block; + width: 100%; +} + +pre[data-line] .line-highlight { + position: absolute; + left: 0; + right: 0; + padding: inherit 0; + margin-top: 1em; + background: hsla(24, 20%, 50%,.08); + background: linear-gradient(to right, hsla(24, 20%, 50%,.1) 70%, hsla(24, 20%, 50%,0)); + pointer-events: none; + line-height: inherit; + white-space: pre; +} + +pre[data-line] .line-highlight:before, +pre[data-line] .line-highlight[data-end]:after { + content: attr(data-start); + position: absolute; + top: .4em; + left: .6em; + min-width: 1em; + padding: 0 .5em; + background-color: hsla(24, 20%, 50%,.4); + color: hsl(24, 20%, 95%); + font: bold 65%/1.5 sans-serif; + text-align: center; + vertical-align: .3em; + border-radius: 999px; + text-shadow: none; + box-shadow: 0 1px white; +} - +pre[data-line] .line-highlight[data-end]:after { + content: attr(data-end); + top: auto; + bottom: .4em; +}html body{font-family:"Helvetica Neue",Helvetica,"Segoe UI",Arial,freesans,sans-serif;font-size:16px;line-height:1.6;color:#333;background-color:#fff;overflow:initial;box-sizing:border-box;word-wrap:break-word}html body>:first-child{margin-top:0}html body h1,html body h2,html body h3,html body h4,html body h5,html body h6{line-height:1.2;margin-top:1em;margin-bottom:16px;color:#000}html body h1{font-size:2.25em;font-weight:300;padding-bottom:.3em}html body h2{font-size:1.75em;font-weight:400;padding-bottom:.3em}html body h3{font-size:1.5em;font-weight:500}html body h4{font-size:1.25em;font-weight:600}html body h5{font-size:1.1em;font-weight:600}html body h6{font-size:1em;font-weight:600}html body h1,html body h2,html body h3,html body h4,html body h5{font-weight:600}html body h5{font-size:1em}html body h6{color:#5c5c5c}html body strong{color:#000}html body del{color:#5c5c5c}html body a:not([href]){color:inherit;text-decoration:none}html body a{color:#08c;text-decoration:none}html body a:hover{color:#00a3f5;text-decoration:none}html body img{max-width:100%}html body>p{margin-top:0;margin-bottom:16px;word-wrap:break-word}html body>ul,html body>ol{margin-bottom:16px}html body ul,html body ol{padding-left:2em}html body ul.no-list,html body ol.no-list{padding:0;list-style-type:none}html body ul ul,html body ul ol,html body ol ol,html body ol ul{margin-top:0;margin-bottom:0}html body li{margin-bottom:0}html body li.task-list-item{list-style:none}html body li>p{margin-top:0;margin-bottom:0}html body .task-list-item-checkbox{margin:0 .2em .25em -1.8em;vertical-align:middle}html body .task-list-item-checkbox:hover{cursor:pointer}html body blockquote{margin:16px 0;font-size:inherit;padding:0 15px;color:#5c5c5c;background-color:#f0f0f0;border-left:4px solid #d6d6d6}html body blockquote>:first-child{margin-top:0}html body blockquote>:last-child{margin-bottom:0}html body hr{height:4px;margin:32px 0;background-color:#d6d6d6;border:0 none}html body table{margin:10px 0 15px 0;border-collapse:collapse;border-spacing:0;display:block;width:100%;overflow:auto;word-break:normal;word-break:keep-all}html body table th{font-weight:bold;color:#000}html body table td,html body table th{border:1px solid #d6d6d6;padding:6px 13px}html body dl{padding:0}html body dl dt{padding:0;margin-top:16px;font-size:1em;font-style:italic;font-weight:bold}html body dl dd{padding:0 16px;margin-bottom:16px}html body code{font-family:Menlo,Monaco,Consolas,'Courier New',monospace;font-size:.85em !important;color:#000;background-color:#f0f0f0;border-radius:3px;padding:.2em 0}html body code::before,html body code::after{letter-spacing:-0.2em;content:"\00a0"}html body pre>code{padding:0;margin:0;font-size:.85em !important;word-break:normal;white-space:pre;background:transparent;border:0}html body .highlight{margin-bottom:16px}html body .highlight pre,html body pre{padding:1em;overflow:auto;font-size:.85em !important;line-height:1.45;border:#d6d6d6;border-radius:3px}html body .highlight pre{margin-bottom:0;word-break:normal}html body pre code,html body pre tt{display:inline;max-width:initial;padding:0;margin:0;overflow:initial;line-height:inherit;word-wrap:normal;background-color:transparent;border:0}html body pre code:before,html body pre tt:before,html body pre code:after,html body pre tt:after{content:normal}html body p,html body blockquote,html body ul,html body ol,html body dl,html body pre{margin-top:0;margin-bottom:16px}html body kbd{color:#000;border:1px solid #d6d6d6;border-bottom:2px solid #c7c7c7;padding:2px 4px;background-color:#f0f0f0;border-radius:3px}@media print{html body{background-color:#fff}html body h1,html body h2,html body h3,html body h4,html body h5,html body h6{color:#000;page-break-after:avoid}html body blockquote{color:#5c5c5c}html body pre{page-break-inside:avoid}html body table{display:table}html body img{display:block;max-width:100%;max-height:100%}html body pre,html body code{word-wrap:break-word;white-space:pre}}.markdown-preview{width:100%;height:100%;box-sizing:border-box}.markdown-preview .pagebreak,.markdown-preview .newpage{page-break-before:always}.markdown-preview pre.line-numbers{position:relative;padding-left:3.8em;counter-reset:linenumber}.markdown-preview pre.line-numbers>code{position:relative}.markdown-preview pre.line-numbers .line-numbers-rows{position:absolute;pointer-events:none;top:1em;font-size:100%;left:0;width:3em;letter-spacing:-1px;border-right:1px solid #999;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none}.markdown-preview pre.line-numbers .line-numbers-rows>span{pointer-events:none;display:block;counter-increment:linenumber}.markdown-preview pre.line-numbers .line-numbers-rows>span:before{content:counter(linenumber);color:#999;display:block;padding-right:.8em;text-align:right}.markdown-preview .mathjax-exps .MathJax_Display{text-align:center !important}.markdown-preview:not([for="preview"]) .code-chunk .btn-group{display:none}.markdown-preview:not([for="preview"]) .code-chunk .status{display:none}.markdown-preview:not([for="preview"]) .code-chunk .output-div{margin-bottom:16px}.markdown-preview .md-toc{padding:0}.markdown-preview .md-toc .md-toc-link-wrapper .md-toc-link{display:inline;padding:.25rem 0}.markdown-preview .md-toc .md-toc-link-wrapper .md-toc-link p,.markdown-preview .md-toc .md-toc-link-wrapper .md-toc-link div{display:inline}.markdown-preview .md-toc .md-toc-link-wrapper.highlighted .md-toc-link{font-weight:800}.scrollbar-style::-webkit-scrollbar{width:8px}.scrollbar-style::-webkit-scrollbar-track{border-radius:10px;background-color:transparent}.scrollbar-style::-webkit-scrollbar-thumb{border-radius:5px;background-color:rgba(150,150,150,0.66);border:4px solid rgba(150,150,150,0.66);background-clip:content-box}html body[for="html-export"]:not([data-presentation-mode]){position:relative;width:100%;height:100%;top:0;left:0;margin:0;padding:0;overflow:auto}html body[for="html-export"]:not([data-presentation-mode]) .markdown-preview{position:relative;top:0}@media screen and (min-width:914px){html body[for="html-export"]:not([data-presentation-mode]) .markdown-preview{padding:2em calc(50% - 457px + 2em)}}@media screen and (max-width:914px){html body[for="html-export"]:not([data-presentation-mode]) .markdown-preview{padding:2em}}@media screen and (max-width:450px){html body[for="html-export"]:not([data-presentation-mode]) .markdown-preview{font-size:14px !important;padding:1em}}@media print{html body[for="html-export"]:not([data-presentation-mode]) #sidebar-toc-btn{display:none}}html body[for="html-export"]:not([data-presentation-mode]) #sidebar-toc-btn{position:fixed;bottom:8px;left:8px;font-size:28px;cursor:pointer;color:inherit;z-index:99;width:32px;text-align:center;opacity:.4}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] #sidebar-toc-btn{opacity:1}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc{position:fixed;top:0;left:0;width:300px;height:100%;padding:32px 0 48px 0;font-size:14px;box-shadow:0 0 4px rgba(150,150,150,0.33);box-sizing:border-box;overflow:auto;background-color:inherit}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc::-webkit-scrollbar{width:8px}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc::-webkit-scrollbar-track{border-radius:10px;background-color:transparent}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc::-webkit-scrollbar-thumb{border-radius:5px;background-color:rgba(150,150,150,0.66);border:4px solid rgba(150,150,150,0.66);background-clip:content-box}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc a{text-decoration:none}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc .md-toc{padding:0 16px}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc .md-toc .md-toc-link-wrapper .md-toc-link{display:inline;padding:.25rem 0}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc .md-toc .md-toc-link-wrapper .md-toc-link p,html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc .md-toc .md-toc-link-wrapper .md-toc-link div{display:inline}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc .md-toc .md-toc-link-wrapper.highlighted .md-toc-link{font-weight:800}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .markdown-preview{left:300px;width:calc(100% - 300px);padding:2em calc(50% - 457px - 300px/2);margin:0;box-sizing:border-box}@media screen and (max-width:1274px){html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .markdown-preview{padding:2em}}@media screen and (max-width:450px){html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .markdown-preview{width:100%}}html body[for="html-export"]:not([data-presentation-mode]):not([html-show-sidebar-toc]) .markdown-preview{left:50%;transform:translateX(-50%)}html body[for="html-export"]:not([data-presentation-mode]):not([html-show-sidebar-toc]) .md-sidebar-toc{display:none} +/* Please visit the URL below for more information: */ +/* https://shd101wyy.github.io/markdown-preview-enhanced/#/customize-css */ + + + + +
+

Automation Engine - Workshop in a box

+ +

Exercise 1 Automation Center

+ +

Exercise 2 Document Intelligence

+ +

Exercise 3 Integration Hub

+ +

Exercise 4 RPA Hub

+ + +
+ + + + + + + + + + + + \ No newline at end of file diff --git a/AutomationEngine.md b/AutomationEngine.md index 84a8d42..56919e7 100644 --- a/AutomationEngine.md +++ b/AutomationEngine.md @@ -1,9 +1,9 @@ # Automation Engine - Workshop in a box -## [Exercise 1 Automation Center](https://htmlpreview.github.io/?https://github.com/quentincloudsnow/automationcenter/blob/master/AutomationCenter.html) +## [Exercise 1 Automation Center](https://htmlpreview.github.io/?https://github.com/erietveld/automationcenter/blob/master/AutomationCenter.html) -## [Exercise 2 Document Intelligence](https://htmlpreview.github.io/?https://github.com/quentincloudsnow/quentin/main/blob/DocIntel.html) +## [Exercise 2 Document Intelligence](https://htmlpreview.github.io/?https://github.com/erietveld/quentin/blob/main/DocIntel.html) -## [Exercise 3 Integration Hub](https://htmlpreview.github.io/?https://github.com/quentincloudsnow/quentin/main/blob/IntegrationHub.html) +## [Exercise 3 Integration Hub](https://htmlpreview.github.io/?https://github.com/erietveld/quentin/blob/main/IntegrationHub.html) -## [Exercise 4 RPA Hub](https://htmlpreview.github.io/?https://github.com/quentincloudsnow/Robert/master/blob/RPA%20Exercise.html) \ No newline at end of file +## [Exercise 4 RPA Hub](https://htmlpreview.github.io/?https://github.com/erietveld/Robert/blob/master/RPA%20Exercise.html) \ No newline at end of file diff --git a/DocIntel.html b/DocIntel.html index f6a6512..277b847 100644 --- a/DocIntel.html +++ b/DocIntel.html @@ -1,367 +1,292 @@ - - - - - - - -DocIntel - - - +.token.doctype, +.token.punctuation, +.token.variable, +.token.macro.property { + color: #333; +} - +.token.operator, +.token.important, +.token.keyword, +.token.rule, +.token.builtin { + color: #a71d5d; +} - +.token.string, +.token.url, +.token.regex, +.token.attr-value { + color: #183691; +} -

Document Intelligence

+.token.property, +.token.number, +.token.boolean, +.token.entity, +.token.atrule, +.token.constant, +.token.symbol, +.token.command, +.token.code { + color: #0086b3; +} -

Introduction

+.token.tag, +.token.selector, +.token.prolog { + color: #63a35c; +} -

Document Intelligence is a machine learning (ML) solution that provides assistance to quickly and accurately extract information from documents to the Now Platform® enabling you to quickly process highly variable documents that change over time.

+.token.function, +.token.namespace, +.token.pseudo-element, +.token.class, +.token.class-name, +.token.pseudo-class, +.token.id, +.token.url-reference .token.variable, +.token.attr-name { + color: #795da3; +} -

Many organizations today use simple optical character recognition (OCR) solutions to extract data from documents that requires significant manual configuration, and also often requires manual changes as the documents evolve. Document Intelligence extends beyond the simple OCR by using ML to identify, understand, and extract text and data from documents. This enables you to accurately automate document processing and accurately extract information from documents, even when the documents have varied text, data, and templates.

+.token.entity { + cursor: help; +} -

We added this capability on the platform so the data extraction from documents can easily be done but also for our customer to be able to do this from within their own Workflows on the platform. A lot of processes still involve digital documents, this can be a useful capability as organisation are progressing on their hyperautomation journey.

+.token.title, +.token.title .token.punctuation { + font-weight: bold; + color: #1d3e81; +} -

Goal

+.token.list { + color: #ed6a43; +} -

In this exercise we are going over a use case of a fictitious organization called ACME. ACME is growing very fast and hiring a lot of new employees. The HR team has submitted an Automation request in Automation Center to automate the Onboarding process of new hire. ACME's Automation COE has agreed to automate that process and use Document Intelligence to add some automation. One step of this process is called Setup Direct Deposit. We are going to focus for this exercise on this part. The current process is manual and done via email. Payroll Operation team request the employee to submit a VOID Check via email, then upon reception of that email Payroll manually extracts the banking information from the VOID Check and has to perform data entry operations with that data to setup the direct deposit for the new employee. In this exercise we are going to review how this the data extraction can be automated, and in the following exercise we will see how we can automate the Data Validation and Data Entry for this data using Integration Hub and RPA Hub.

+.token.inserted { + background-color: #eaffea; + color: #55a532; +} -
    -

  1. Log in to your instance as Admin

    +.token.deleted { + background-color: #ffecec; + color: #bd2c00; +} -

    We are going to Impersonate as Abel Tuter, for our use case, Abel Tuter is a new hire will submit his VOID Check using a Record Producer in ServiceNow. This step will allow you to review the document for which we want to extract information, but also it shows an example of how you can submit document to Document Intelligence.

    +.token.bold { + font-weight: bold; +} -
    -

    Document Intelligence can grab documents from attachment on any records. Documents can be submitted to DocIntel via a workflow too.

    -
    2. -

  2. Once logged-in to your instance as Admin, click on the Favorites (1) then click on Download the VOID Cheque here (2) :

    +.token.italic { + font-style: italic; +} -

    Relative

    3. -

  3. The download of the of file should start automatically. In your Download folder locate the file name void cheque Abel Tuer.jpg and open it so we can review the information we want to extract from it.

    -

    This this an example of VOID Check that payroll will use to extract the banking information of the new hire. On the VOID Check there are meaningful information that they usually extract manually:

    +/* JSON */ +.language-json .token.property { + color: #183691; +} -

    Relative

    +.language-markup .token.tag .token.punctuation { + color: #333; +} + +/* CSS */ +code.language-css, +.language-css .token.function { + color: #0086b3; +} + +/* YAML */ +.language-yaml .token.atrule { + color: #63a35c; +} + +code.language-yaml { + color: #183691; +} + +/* Ruby */ +.language-ruby .token.function { + color: #333; +} + +/* Markdown */ +.language-markdown .token.url { + color: #795da3; +} + +/* Makefile */ +.language-makefile .token.symbol { + color: #795da3; +} + +.language-makefile .token.variable { + color: #183691; +} + +.language-makefile .token.builtin { + color: #0086b3; +} + +/* Bash */ +.language-bash .token.keyword { + color: #0086b3; +} + +/* highlight */ +pre[data-line] { + position: relative; + padding: 1em 0 1em 3em; +} +pre[data-line] .line-highlight-wrapper { + position: absolute; + top: 0; + left: 0; + background-color: transparent; + display: block; + width: 100%; +} + +pre[data-line] .line-highlight { + position: absolute; + left: 0; + right: 0; + padding: inherit 0; + margin-top: 1em; + background: hsla(24, 20%, 50%,.08); + background: linear-gradient(to right, hsla(24, 20%, 50%,.1) 70%, hsla(24, 20%, 50%,0)); + pointer-events: none; + line-height: inherit; + white-space: pre; +} + +pre[data-line] .line-highlight:before, +pre[data-line] .line-highlight[data-end]:after { + content: attr(data-start); + position: absolute; + top: .4em; + left: .6em; + min-width: 1em; + padding: 0 .5em; + background-color: hsla(24, 20%, 50%,.4); + color: hsl(24, 20%, 95%); + font: bold 65%/1.5 sans-serif; + text-align: center; + vertical-align: .3em; + border-radius: 999px; + text-shadow: none; + box-shadow: 0 1px white; +} +pre[data-line] .line-highlight[data-end]:after { + content: attr(data-end); + top: auto; + bottom: .4em; +}html body{font-family:"Helvetica Neue",Helvetica,"Segoe UI",Arial,freesans,sans-serif;font-size:16px;line-height:1.6;color:#333;background-color:#fff;overflow:initial;box-sizing:border-box;word-wrap:break-word}html body>:first-child{margin-top:0}html body h1,html body h2,html body h3,html body h4,html body h5,html body h6{line-height:1.2;margin-top:1em;margin-bottom:16px;color:#000}html body h1{font-size:2.25em;font-weight:300;padding-bottom:.3em}html body h2{font-size:1.75em;font-weight:400;padding-bottom:.3em}html body h3{font-size:1.5em;font-weight:500}html body h4{font-size:1.25em;font-weight:600}html body h5{font-size:1.1em;font-weight:600}html body h6{font-size:1em;font-weight:600}html body h1,html body h2,html body h3,html body h4,html body h5{font-weight:600}html body h5{font-size:1em}html body h6{color:#5c5c5c}html body strong{color:#000}html body del{color:#5c5c5c}html body a:not([href]){color:inherit;text-decoration:none}html body a{color:#08c;text-decoration:none}html body a:hover{color:#00a3f5;text-decoration:none}html body img{max-width:100%}html body>p{margin-top:0;margin-bottom:16px;word-wrap:break-word}html body>ul,html body>ol{margin-bottom:16px}html body ul,html body ol{padding-left:2em}html body ul.no-list,html body ol.no-list{padding:0;list-style-type:none}html body ul ul,html body ul ol,html body ol ol,html body ol ul{margin-top:0;margin-bottom:0}html body li{margin-bottom:0}html body li.task-list-item{list-style:none}html body li>p{margin-top:0;margin-bottom:0}html body .task-list-item-checkbox{margin:0 .2em .25em -1.8em;vertical-align:middle}html body .task-list-item-checkbox:hover{cursor:pointer}html body blockquote{margin:16px 0;font-size:inherit;padding:0 15px;color:#5c5c5c;background-color:#f0f0f0;border-left:4px solid #d6d6d6}html body blockquote>:first-child{margin-top:0}html body blockquote>:last-child{margin-bottom:0}html body hr{height:4px;margin:32px 0;background-color:#d6d6d6;border:0 none}html body table{margin:10px 0 15px 0;border-collapse:collapse;border-spacing:0;display:block;width:100%;overflow:auto;word-break:normal;word-break:keep-all}html body table th{font-weight:bold;color:#000}html body table td,html body table th{border:1px solid #d6d6d6;padding:6px 13px}html body dl{padding:0}html body dl dt{padding:0;margin-top:16px;font-size:1em;font-style:italic;font-weight:bold}html body dl dd{padding:0 16px;margin-bottom:16px}html body code{font-family:Menlo,Monaco,Consolas,'Courier New',monospace;font-size:.85em !important;color:#000;background-color:#f0f0f0;border-radius:3px;padding:.2em 0}html body code::before,html body code::after{letter-spacing:-0.2em;content:"\00a0"}html body pre>code{padding:0;margin:0;font-size:.85em !important;word-break:normal;white-space:pre;background:transparent;border:0}html body .highlight{margin-bottom:16px}html body .highlight pre,html body pre{padding:1em;overflow:auto;font-size:.85em !important;line-height:1.45;border:#d6d6d6;border-radius:3px}html body .highlight pre{margin-bottom:0;word-break:normal}html body pre code,html body pre tt{display:inline;max-width:initial;padding:0;margin:0;overflow:initial;line-height:inherit;word-wrap:normal;background-color:transparent;border:0}html body pre code:before,html body pre tt:before,html body pre code:after,html body pre tt:after{content:normal}html body p,html body blockquote,html body ul,html body ol,html body dl,html body pre{margin-top:0;margin-bottom:16px}html body kbd{color:#000;border:1px solid #d6d6d6;border-bottom:2px solid #c7c7c7;padding:2px 4px;background-color:#f0f0f0;border-radius:3px}@media print{html body{background-color:#fff}html body h1,html body h2,html body h3,html body h4,html body h5,html body h6{color:#000;page-break-after:avoid}html body blockquote{color:#5c5c5c}html body pre{page-break-inside:avoid}html body table{display:table}html body img{display:block;max-width:100%;max-height:100%}html body pre,html body code{word-wrap:break-word;white-space:pre}}.markdown-preview{width:100%;height:100%;box-sizing:border-box}.markdown-preview .pagebreak,.markdown-preview .newpage{page-break-before:always}.markdown-preview pre.line-numbers{position:relative;padding-left:3.8em;counter-reset:linenumber}.markdown-preview pre.line-numbers>code{position:relative}.markdown-preview pre.line-numbers .line-numbers-rows{position:absolute;pointer-events:none;top:1em;font-size:100%;left:0;width:3em;letter-spacing:-1px;border-right:1px solid #999;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none}.markdown-preview pre.line-numbers .line-numbers-rows>span{pointer-events:none;display:block;counter-increment:linenumber}.markdown-preview pre.line-numbers .line-numbers-rows>span:before{content:counter(linenumber);color:#999;display:block;padding-right:.8em;text-align:right}.markdown-preview .mathjax-exps .MathJax_Display{text-align:center !important}.markdown-preview:not([for="preview"]) .code-chunk .btn-group{display:none}.markdown-preview:not([for="preview"]) .code-chunk .status{display:none}.markdown-preview:not([for="preview"]) .code-chunk .output-div{margin-bottom:16px}.markdown-preview .md-toc{padding:0}.markdown-preview .md-toc .md-toc-link-wrapper .md-toc-link{display:inline;padding:.25rem 0}.markdown-preview .md-toc .md-toc-link-wrapper .md-toc-link p,.markdown-preview .md-toc .md-toc-link-wrapper .md-toc-link div{display:inline}.markdown-preview .md-toc .md-toc-link-wrapper.highlighted .md-toc-link{font-weight:800}.scrollbar-style::-webkit-scrollbar{width:8px}.scrollbar-style::-webkit-scrollbar-track{border-radius:10px;background-color:transparent}.scrollbar-style::-webkit-scrollbar-thumb{border-radius:5px;background-color:rgba(150,150,150,0.66);border:4px solid rgba(150,150,150,0.66);background-clip:content-box}html body[for="html-export"]:not([data-presentation-mode]){position:relative;width:100%;height:100%;top:0;left:0;margin:0;padding:0;overflow:auto}html body[for="html-export"]:not([data-presentation-mode]) .markdown-preview{position:relative;top:0}@media screen and (min-width:914px){html body[for="html-export"]:not([data-presentation-mode]) .markdown-preview{padding:2em calc(50% - 457px + 2em)}}@media screen and (max-width:914px){html body[for="html-export"]:not([data-presentation-mode]) .markdown-preview{padding:2em}}@media screen and (max-width:450px){html body[for="html-export"]:not([data-presentation-mode]) .markdown-preview{font-size:14px !important;padding:1em}}@media print{html body[for="html-export"]:not([data-presentation-mode]) #sidebar-toc-btn{display:none}}html body[for="html-export"]:not([data-presentation-mode]) #sidebar-toc-btn{position:fixed;bottom:8px;left:8px;font-size:28px;cursor:pointer;color:inherit;z-index:99;width:32px;text-align:center;opacity:.4}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] #sidebar-toc-btn{opacity:1}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc{position:fixed;top:0;left:0;width:300px;height:100%;padding:32px 0 48px 0;font-size:14px;box-shadow:0 0 4px rgba(150,150,150,0.33);box-sizing:border-box;overflow:auto;background-color:inherit}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc::-webkit-scrollbar{width:8px}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc::-webkit-scrollbar-track{border-radius:10px;background-color:transparent}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc::-webkit-scrollbar-thumb{border-radius:5px;background-color:rgba(150,150,150,0.66);border:4px solid rgba(150,150,150,0.66);background-clip:content-box}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc a{text-decoration:none}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc .md-toc{padding:0 16px}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc .md-toc .md-toc-link-wrapper .md-toc-link{display:inline;padding:.25rem 0}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc .md-toc .md-toc-link-wrapper .md-toc-link p,html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc .md-toc .md-toc-link-wrapper .md-toc-link div{display:inline}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc .md-toc .md-toc-link-wrapper.highlighted .md-toc-link{font-weight:800}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .markdown-preview{left:300px;width:calc(100% - 300px);padding:2em calc(50% - 457px - 300px/2);margin:0;box-sizing:border-box}@media screen and (max-width:1274px){html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .markdown-preview{padding:2em}}@media screen and (max-width:450px){html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .markdown-preview{width:100%}}html body[for="html-export"]:not([data-presentation-mode]):not([html-show-sidebar-toc]) .markdown-preview{left:50%;transform:translateX(-50%)}html body[for="html-export"]:not([data-presentation-mode]):not([html-show-sidebar-toc]) .md-sidebar-toc{display:none} +/* Please visit the URL below for more information: */ +/* https://shd101wyy.github.io/markdown-preview-enhanced/#/customize-css */ + + + + +
    +

    Document Intelligence

    + +

    Introduction

    + +

    Document Intelligence is a machine learning (ML) solution that provides assistance to quickly and accurately extract information from documents to the Now Platform® enabling you to quickly process highly variable documents that change over time.

    +

    Many organizations today use simple optical character recognition (OCR) solutions to extract data from documents that requires significant manual configuration, and also often requires manual changes as the documents evolve. Document Intelligence extends beyond the simple OCR by using ML to identify, understand, and extract text and data from documents. This enables you to accurately automate document processing and accurately extract information from documents, even when the documents have varied text, data, and templates.

    +

    We added this capability on the platform so the data extraction from documents can easily be done but also for our customer to be able to do this from within their own Workflows on the platform. A lot of processes still involve digital documents, this can be a useful capability as organisation are progressing on their hyperautomation journey.

    +

    Goal

    + +

    In this exercise we are going over a use case of a fictitious organization called ACME. ACME is growing very fast and hiring a lot of new employees. The HR team has submitted an Automation request in Automation Center to automate the Onboarding process of new hire. ACME's Automation COE has agreed to automate that process and use Document Intelligence to add some automation. One step of this process is called Setup Direct Deposit. We are going to focus for this exercise on this part. The current process is manual and done via email. Payroll Operation team request the employee to submit a VOID Check via email, then upon reception of that email Payroll manually extracts the banking information from the VOID Check and has to perform data entry operations with that data to setup the direct deposit for the new employee. In this exercise we are going to review how this the data extraction can be automated, and in the following exercise we will see how we can automate the Data Validation and Data Entry for this data using Integration Hub and RPA Hub.

    +
      +
    1. +

      Log in to your instance as Admin

      +

      We are going to Impersonate as Abel Tuter, for our use case, Abel Tuter is a new hire will submit his VOID Check using a Record Producer in ServiceNow. This step will allow you to review the document for which we want to extract information, but also it shows an example of how you can submit document to Document Intelligence.

      +
      +

      Document Intelligence can grab documents from attachment on any records. Documents can be submitted to DocIntel via a workflow too.

      +
      +
      2. +
    2. +

      Once logged-in to your instance as Admin, click on the Favorites (1) then click on Download the VOID Cheque here (2) :

      +

      Relative

      +
      3. +
    3. +

      The download of the of file should start automatically. In your Download folder locate the file name void cheque Abel Tuer.jpg and open it so we can review the information we want to extract from it.

      +

      This this an example of VOID Check that payroll will use to extract the banking information of the new hire. On the VOID Check there are meaningful information that they usually extract manually:

      +

      Relative

      @@ -369,7 +294,6 @@

      Goal

      - @@ -389,144 +313,163 @@

      Goal

      Value
      1. Routing Number
      -

      Later in the exercise we will review how we have configured and trained Document Intelligence to extract those informations.

      -
      4. -

    4. In order to show you how we can submit documents to DocIntel we are going to impersonate as ***Abel Tuter and submit the VOID Check like an new hire would do.

      5. -

    5. Click on the profile picture on the top right corner (1), then click Impersonate user:

      - -

      Relative

      6. -

    6. In the Impersonate user screen, type Abel Tuter in search box (1), then click on Abel Tuter (2) and finally click Impersonate user (3)

      - -

      Relative

      7. -

    7. Once impersonated as Abel Tuter, click Favorites (1) then click Setup Direct Deposit (2)

      - + +
      8. +
    8. +

      In order to show you how we can submit documents to DocIntel we are going to impersonate as ***Abel Tuter and submit the VOID Check like an new hire would do.

      +
      9. +
    9. +

      Click on the profile picture on the top right corner (1), then click Impersonate user:

      +

      Relative

      +
      10. +
    10. +

      In the Impersonate user screen, type Abel Tuter in search box (1), then click on Abel Tuter (2) and finally click Impersonate user (3)

      +

      Relative

      +
      11. +
    11. +

      Once impersonated as Abel Tuter, click Favorites (1) then click Setup Direct Deposit (2)

      Relative

      -

      This is just a shortcut to open the Recored Producer that we have created for new hires to submit their VOID Check.

      -
      12. -

    12. Once the Setup Direct Deposit record producer is opened, click Add attachments (1), select the file void cheque Abel Tuter.jpg from your download folder then click submit (2)

      - -

      Relative

      13. -

    13. Notice a banking record was created, record number BAN0001001. For our use case this would trigger Document Intelligence to process the file that is attached to the record to perform the data extraction.

      14. -

    14. Now we are going to end the impersonation for Abel Tuter and inspect what is happening in the back-end and how Document Intelligence was configured.

      15. -

    15. Click on Abel Tuter's profile picture (1) then click End impersonation (2)

      - -

      Relative

      16. -

    16. Click All (1) then type ml_solution.list (2) then press Enter:

      - + +
      17. +
    17. +

      Once the Setup Direct Deposit record producer is opened, click Add attachments (1), select the file void cheque Abel Tuter.jpg from your download folder then click submit (2)

      +

      Relative

      +
      18. +
    18. +

      Notice a banking record was created, record number BAN0001001. For our use case this would trigger Document Intelligence to process the file that is attached to the record to perform the data extraction.

      +
      19. +
    19. +

      Now we are going to end the impersonation for Abel Tuter and inspect what is happening in the back-end and how Document Intelligence was configured.

      +
      20. +
    20. +

      Click on Abel Tuter's profile picture (1) then click End impersonation (2)

      +

      Relative

      +
      21. +
    21. +

      Click All (1) then type ml_solution.list (2) then press Enter:

      Relative

      -

      Note: This is where you can see Document Intelligence sending jobs to our Machine Learning shared infrastructure (Nagini) to process documents (OCR Task, Training the model and retreive the predicted values). We just want to show here what is happening in the back-end. It can be useful for the ServiceNow Admin or Document Intelligence admin to look at this table to see how long it takes to process the Document intelligence tasks. Since Document Intelligence uses a shared Machine Learning infrastructure, it can takes from few seconds to minutes to process depending of the workload on the Nagini cluster.

      -
      22. -

    22. You should see a table and records as shown in the example below. Other ServiceNow products write on that table, for example Predictive Intelligence.

      - -

      Relative

      23. -

    23. We are going to view what we have configured on the instance in order for Document Intelligence to extract the information we need from that VOID Check. Click on All (1) then type Document intelligence in the filter navigator (2) and finally click Task Definititions:

      - + +
      24. +
    24. +

      You should see a table and records as shown in the example below. Other ServiceNow products write on that table, for example Predictive Intelligence.

      +

      Relative

      +
      25. +
    25. +

      We are going to view what we have configured on the instance in order for Document Intelligence to extract the information we need from that VOID Check. Click on All (1) then type Document intelligence in the filter navigator (2) and finally click Task Definititions:

      Relative

      -

      The task definition is where you tell to Document Intelligence about a new type of document you need to process.

      -
      26. -

    26. Click on the Void check - Task Definition record to open it:

      - -

      Relative

      27. -

    27. Lets review the Task Definition for our use case (Extracting data from VOID checks), that screen Task Definition is basically the only configuration screen needed to get started with the product.

      - + +
      28. +
    28. +

      Click on the Void check - Task Definition record to open it:

      +

      Relative

      +
      29. +
    29. +

      Lets review the Task Definition for our use case (Extracting data from VOID checks), that screen Task Definition is basically the only configuration screen needed to get started with the product.

      Notice the field Target table (1) . this is where we tell Document Intelligence for which table we are going to use the values extracted from the document.

      - -

      Notice the option Enable Straight Through Processing (2), you can enable that option so AI automatically extracts the data for all fields, if the confidence threshold for all fields is above the Straight Through Processing Threshold defined in the task definition. Fields do not need to be reviewed, otherwise you can have an agent that would review the values extracted, after values are reviewed the Machine Learning model associated to that Task Definition is re-trained automatically. DocIntel becomes more confident over time, as it processes more and more documents.

      - +
      +
      +

      Notice the option Enable Straight Through Processing (2), you can enable that option so AI automatically extracts the data for all fields, if the confidence threshold for all fields is above the Straight Through Processing Threshold defined in the task definition. Fields do not need to be reviewed, otherwise you can have an agent that would review the values extracted, after values are reviewed the Machine Learning model associated to that Task Definition is re-trained automatically. DocIntel becomes more confident over time, as it processes more and more documents.

      +
      +

      Notice the tab Keys (3), this is where we have defined the elements we want to extract the document.

      - -

      Relative

      30. -

    30. Under the Keys tab, click Account Holder (2) to open that Key:

      - +

      Relative

      +
      31. +
    31. +

      Under the Keys tab, click Account Holder (2) to open that Key:

      Relative

      -

      When you need Document Intelligence to extract certain elements from a document, you create new keys on the Task Definition.

      -
      32. -

    32. Notice the Display Name field (1), this is the name for the new key, then the Type field (2), it can be Text or True/Fasle (for check box on forms for example). What you define on the Target Field field (3) is the field on which you want to store the value extracted by Document Intelligence on a record. Target Table (4) is the name of the table that contain the records you need to update with the value extracted (It's also the table that contains the records with the document attached that Document Intelligence will process):

      - -

      Relative

      33. -

    33. Click the back button on the Key record to return to the task definition screen

      - -

      Relative

      34. -

    34. From the Task Definition screen, click on the Tasks tab (1).

      - + +
      35. +
    35. +

      Notice the Display Name field (1), this is the name for the new key, then the Type field (2), it can be Text or True/Fasle (for check box on forms for example). What you define on the Target Field field (3) is the field on which you want to store the value extracted by Document Intelligence on a record. Target Table (4) is the name of the table that contain the records you need to update with the value extracted (It's also the table that contains the records with the document attached that Document Intelligence will process):

      +

      Relative

      +
      36. +
    36. +

      Click the back button on the Key record to return to the task definition screen

      +

      Relative

      +
      37. +
    37. +

      From the Task Definition screen, click on the Tasks tab (1).

      Every time you need DocIntel to process a document, you need to create a task. And request to DocIntel to process that task. The creation of the task (and trigger) can be automated via workflow. we will cover that shortly.

      -

      Locate the Task named Void check - Process task (2), then notice the value true (3) on the Is Straight Through Processed column. It means that automatically extracted the data for all fields (without any human intervention). Notice on the column Source Record (4). For that task Document Intelligent has processed the attachment from that banking record BAN0001032 and has populated the fields defined with the keys we have reviewed in the previous step.

      -

      Click on the Void check - Process task task (2) to open it

      - -

      Relative

      38. -

    38. Once the task screen is open, notice the Extracted Values (1), those are the values that Document Intelligence has extracted from the VOID Check automatically. +

      Relative

      +
      39. +
    39. +

      Once the task screen is open, notice the Extracted Values (1), those are the values that Document Intelligence has extracted from the VOID Check automatically.
      Click on the Show In Doctintel button (2) to open the file in DocIntel:

      - -

      Relative

      40. -

    40. Agents usually open a document in Document Intelligence to review and validate the extracted value or to map extracted values to the keys (to train the model). The first time you submit a task associated to a new Task Definition, DocIntel won't know which values go to which key. The Machine Learning model needs to be trained. We do this by clicking on the key field (1) and selecting the correct value. The sytem indicates on the screen from where the value is coming from in the document (2).

      - +

      Relative

      +
      41. +
    41. +

      Agents usually open a document in Document Intelligence to review and validate the extracted value or to map extracted values to the keys (to train the model). The first time you submit a task associated to a new Task Definition, DocIntel won't know which values go to which key. The Machine Learning model needs to be trained. We do this by clicking on the key field (1) and selecting the correct value. The sytem indicates on the screen from where the value is coming from in the document (2).

      Relative

      -

      Notice the percentage number (73%) next to Abel Tuter under the Account Holder field (1). This is the confidence score for the prediction. The confidence score increases as you train the model with more document (usually 4 to 5 documents is enough to reach high number). On the Task definition you can configure the Straight Through processing threshold. this correspond to the predicition confidence score value for which you want to extract the values and map them to the fields without a manual review from an agent.

      - -

      Click the Submit button. By clicking the submit button the model is trained with those new inputs. In this Lab environment we do not have access to our Machine Learning component it won't do anything. You can now close that Tab.

      42. -

    42. Remember, we have submitted a VOID Check as Abel Tuter, you might wonder how the Bank Record with the attachment was picked up automatically by DocIntel. Let's review what was configured to do this.

      43. -

    43. Return to the Task Definition that was created for that use case. Click on All (1) then type Document intelligence in the filter navigator (2) and finally click Task Definititions:

      - -

      Relative

      44. -

    44. Click on the Void check - Task Definition record to open it:

      - -

      Relative

      45. -

    45. Once the Task definition is opened, Click on the Integration Setups Tab and open the record Void check - Process task (1)

      - +

      Click the Submit button. By clicking the submit button the model is trained with those new inputs. In this Lab environment we do not have access to our Machine Learning component it won't do anything. You can now close that Tab.

      +
      46. +
    46. +

      Remember, we have submitted a VOID Check as Abel Tuter, you might wonder how the Bank Record with the attachment was picked up automatically by DocIntel. Let's review what was configured to do this.

      +
      47. +
    47. +

      Return to the Task Definition that was created for that use case. Click on All (1) then type Document intelligence in the filter navigator (2) and finally click Task Definititions:

      +

      Relative

      +
      48. +
    48. +

      Click on the Void check - Task Definition record to open it:

      +

      Relative

      +
      49. +
    49. +

      Once the Task definition is opened, Click on the Integration Setups Tab and open the record Void check - Process task (1)

      -

      This is where you go to configure DocIntel to Process tasks automatically when records are created or updated with attachment on the defined Target Table. +

      This is where you go to configure DocIntel to Process tasks automatically when records are created or updated with attachment on the defined Target Table.
      The first record Void Check - Process task (1), is where we have configured DocIntel to process a task based on our own condition (It uses a workflow). the second record void check- extract values is where we enable the workflow that is going to take the extracted values and assign them to the target fields that we have mapped when we have defined the Keys. Both of those workflows are created automatically by DocIntel but you can create your own if you need to perform additional steps.

      - -

      Relative

      50. -

    50. Under Conditions (1) This is where you configure the conditions for DocIntel to process specific records (pick up an attachment from specific records that match that condition).

      - +

      Relative

      +
      51. +
    51. +

      Under Conditions (1) This is where you configure the conditions for DocIntel to process specific records (pick up an attachment from specific records that match that condition).

      Notice the option Create flow (2). If selected, DocIntel will automatically create the flows that will be used to create the DocIntel tasks and Process them.

      - -

      Trigger (3) and Flow Conditions (4) are automatically created, this what you will see if you open the specifc Flow in Flow Designer, it correspond the the Flow trigger and flow condition in flow designer.

      - -

      Relative

      52. -

    52. We have reviewed all the configurations that was done for that particular use case. Lets review the outcome of that automated data extraction from DocIntel.

      - +

      Trigger (3) and Flow Conditions (4) are automatically created, this what you will see if you open the specifc Flow in Flow Designer, it correspond the the Flow trigger and flow condition in flow designer.

      +

      Relative

      +
      53. +
    53. +

      We have reviewed all the configurations that was done for that particular use case. Lets review the outcome of that automated data extraction from DocIntel.

      Click on Favorites (1) then bank account table (2)

      -

      Relative

      -

      When we origininally submitted the VOID Check as Abel Tuter a bank record was automatically created. Then based on the configuration of DocIntel, a DocIntel task was created automatically to process the attachment (VOID Check), extract the data then update the field Account Number, Bank Name, Routing Number, Account Holder. In this Lab environment we cannot process documents since we do not have access to our shared ML Infrastructure from those instances but we are showing on this screen below the end result with data we have preloaded on the lab instance so you can see what it would look like in real life...

      -

      Relative

      -
      -

      This is a lab exercise, in real life we would not show any sensitive information like those banking information. We have created a custom table just for that exercise and securing the data is not the focus of that lab. We have different encryptions capabilities on the platform if we wanted to secure that data :-)

      -
      54. +

      This is a lab exercise, in real life we would not show any sensitive information like those banking information. We have created a custom table just for that exercise and securing the data is not the focus of that lab. We have different encryptions capabilities on the platform if we wanted to secure that data 😃

      + +
    -

    In the following exercice (IntegrationHub we see how to build a spoke to integrate ServiceNow to an external API that will use those extracted information from DocIntel.

    - -

    Conclusion

    - -

    In this Document Intelligence lab, we have covered how Document Intelligence can be configured to extract information from structured or semi-structed documents. We have seen how you can use those extracted values from within a workflow. In the following exercice, we are covering how to build a flow and integration using IntegrationHub to perform data validation (with the data extracted via DocIntel). You will learn how to build a spoke to integrate ServiceNow to an external system via API.

    - - - - - - - +

    Conclusion

    + +

    In this Document Intelligence lab, we have covered how Document Intelligence can be configured to extract information from structured or semi-structed documents. We have seen how you can use those extracted values from within a workflow. In the following exercice, we are covering how to build a flow and integration using IntegrationHub to perform data validation (with the data extracted via DocIntel). You will learn how to build a spoke to integrate ServiceNow to an external system via API.

    + +
    + + + + + + + + + + + + \ No newline at end of file diff --git a/DocIntel.md b/DocIntel.md index b96b5a3..25beee7 100644 --- a/DocIntel.md +++ b/DocIntel.md @@ -10,7 +10,7 @@ We added this capability on the platform so the data extraction from documents c ## Goal -In this exercise we are going over a use case of a fictitious organization called **ACME**. ACME is growing very fast and hiring a lot of new employees. The HR team has submitted an Automation request in Automation Center to automate the Onboarding process of new hire. ACME's Automation COE has agreed to automate that process and use Document Intelligence to add some automation. One step of this process is called **Setup Direct Deposit**. We are going to focus for this exercise on this part. The current process is manual and done via email. Payroll Operation team request the employee to submit a **VOID Check** via email, then upon reception of that email Payroll manually extracts the banking information from the VOID Check and has to perform data entry operations with that data to setup the direct deposit for the new employee. In this exercise we are going to review how this the data extraction can be automated, and in the following exercise we will see how we can automate the Data Validation and Data Entry for this data using Integration Hub and RPA Hub. +In this exercise we are going over a use case of a fictitious organization called **ACME**. ACME is growing very fast and hiring a lot of new employees. The HR team has submitted an Automation request in Automation Center to automate the Onboarding process of new hire. ACME's Automation COE has agreed to automate that process and use Document Intelligence to add some automation. One step of this process is called **Setup Direct Deposit**. We are going to focus for this exercise on this part. The current process is manual and done via email. Payroll Operation team request the employee to submit a **VOID Check** via email, then upon reception of that email Payroll manually extracts the banking information from the VOID Check and has to perform data entry operations with that data to setup the direct deposit for the new employee. In this exercise we are going to review how this data extraction can be automated, and in the following exercise we will see how we can automate the Data Validation and Data Entry for this data using Integration Hub and RPA Hub. 1. Log in to your instance as **Admin** @@ -22,9 +22,9 @@ In this exercise we are going over a use case of a fictitious organization calle ![Relative](images/2022-09-09_09-47-1.png) -1. The download of the of file should start automatically. In your Download folder locate the file name **void cheque Abel Tuer.jpg** and open it so we can review the information we want to extract from it. +1. The download of the of file should start automatically. In your Download folder locate the file name **void cheque Abel Tuter.jpg** and open it so we can review the information we want to extract from it. - This this an example of VOID Check that payroll will use to extract the banking information of the new hire. On the VOID Check there are meaningful information that they usually extract manually: + This this an example of VOID Check that payroll will use to extract the banking information of the new hire. On the VOID Check there is meaningful information that they usually extract manually: ![Relative](images/2022-09-09_09-51-53.png) @@ -35,7 +35,7 @@ In this exercise we are going over a use case of a fictitious organization calle | 3. Account holder | Abel Tuter | | 4. Bank Name | JPMorgan | - > Later in the exercise we will review how we have configured and trained **Document Intelligence** to extract those informations. + > Later in the exercise we will review how we have configured and trained **Document Intelligence** to extract that information. 1. In order to show you how we can submit documents to DocIntel we are going to impersonate as *****Abel Tuter** and submit the VOID Check like an new hire would do. @@ -52,7 +52,7 @@ In this exercise we are going over a use case of a fictitious organization calle ![Relative](images/2022-09-09_10-06-14.png) - > This is just a shortcut to open the Recored Producer that we have created for new hires to submit their VOID Check. + > This is just a shortcut to open the Record Producer that we have created for new hires to submit their VOID Check. 1. Once the **Setup Direct Deposit** record producer is opened, click **Add attachments** (1), select the file **void cheque Abel Tuter.jpg** from your download folder then click **submit** (2) ![Relative](images/2022-09-09_10-10-23.png) @@ -69,13 +69,13 @@ In this exercise we are going over a use case of a fictitious organization calle ![Relative](images/2022-09-09_13-36-53.png) - >Note: This is where you can see Document Intelligence sending jobs to our Machine Learning shared infrastructure (Nagini) to process documents (OCR Task, Training the model and retreive the predicted values). We just want to show here what is happening in the back-end. It can be useful for the ServiceNow Admin or Document Intelligence admin to look at this table to see how long it takes to process the Document intelligence tasks. Since Document Intelligence uses a shared Machine Learning infrastructure, it can takes from few seconds to minutes to process depending of the workload on the Nagini cluster. + >Note: This is where you can see Document Intelligence sending jobs to our Machine Learning shared infrastructure (Nagini) to process documents (OCR Task, Training the model and retrieve the predicted values). We just want to show here what is happening in the back-end. It can be useful for the ServiceNow Admin or Document Intelligence admin to look at this table to see how long it takes to process the Document intelligence tasks. Since Document Intelligence uses a shared Machine Learning infrastructure, it can takes from few seconds to minutes to process depending of the workload on the Nagini cluster. -1. You should see a table and records as shown in the example below. Other ServiceNow products write on that table, for example **Predictive Intelligence**. +1. You should see a table and records as shown in the example below. Other ServiceNow products write to that table, for example **Predictive Intelligence**. ![Relative](images/2022-09-09_10-28-02.png) -1. We are going to view what we have configured on the instance in order for Document Intelligence to extract the information we need from that VOID Check. Click on **All** (1) then type **Document intelligence** in the filter navigator (2) and finally click **Task Definititions**: +1. We are going to view what we have configured on the instance in order for Document Intelligence to extract the information we need from that VOID Check. Click on **All** (1) then type **Document intelligence** in the filter navigator (2) and finally click **Task Definitions**: ![Relative](images/2022-09-09_10-35-25.png) @@ -85,7 +85,7 @@ In this exercise we are going over a use case of a fictitious organization calle ![Relative](images/2022-09-09_10-40-22.png) -1. Lets review the **Task Definition** for our use case (Extracting data from VOID checks), that screen **Task Definition** is basically the only configuration screen needed to get started with the product. +1. Let's review the **Task Definition** for our use case (Extracting data from VOID checks), that screen **Task Definition** is basically the only configuration screen needed to get started with the product. >Notice the field **Target table** (1) . this is where we tell Document Intelligence for which table we are going to use the values extracted from the document. @@ -101,7 +101,7 @@ In this exercise we are going over a use case of a fictitious organization calle > When you need Document Intelligence to extract certain elements from a document, you create new keys on the Task Definition. -1. Notice the **Display Name** field (1), this is the name for the new key, then the **Type** field (2), it can be Text or True/Fasle (for check box on forms for example). What you define on the **Target Field** field (3) is the field on which you want to store the value extracted by **Document Intelligence** on a record. **Target Table** (4) is the name of the table that contain the records you need to update with the value extracted (It's also the table that contains the records with the document attached that Document Intelligence will process): +1. Notice the **Display Name** field (1), this is the name for the new key, then the **Type** field (2), it can be Text or True/False (for check box on forms for example). What you define on the **Target Field** field (3) is the field on which you want to store the value extracted by **Document Intelligence** on a record. **Target Table** (4) is the name of the table that contain the records you need to update with the value extracted (It's also the table that contains the records with the document attached that Document Intelligence will process): ![Relative](images/2022-09-09_12-14-51.png) @@ -120,22 +120,22 @@ In this exercise we are going over a use case of a fictitious organization calle ![Relative](images/2022-09-09_12-26-01.png) 1. Once the task screen is open, notice the **Extracted Values** (1), those are the values that Document Intelligence has extracted from the VOID Check automatically. -Click on the **Show In Doctintel** button (2) to open the file in DocIntel: +Click on the **Show In DocIntel** button (2) to open the file in DocIntel: ![Relative](images/2022-09-09_12-35-30.png) -1. Agents usually open a document in Document Intelligence to review and validate the extracted value or to map extracted values to the keys (to train the model). The first time you submit a task associated to a new **Task Definition**, DocIntel won't know which values go to which key. The Machine Learning model needs to be trained. We do this by clicking on the key field (1) and selecting the correct value. The sytem indicates on the screen from where the value is coming from in the document (2). +1. Agents usually open a document in Document Intelligence to review and validate the extracted value or to map extracted values to the keys (to train the model). The first time you submit a task associated to a new **Task Definition**, DocIntel won't know which values go to which key. The Machine Learning model needs to be trained. We do this by clicking on the key field (1) and selecting the correct value. The system indicates on the screen from where the value is coming from in the document (2). ![Relative](images/2022-09-09_12-39-30.png) - Notice the percentage number (73%) next to **Abel Tuter** under the **Account Holder** field (1). This is the confidence score for the prediction. The confidence score increases as you train the model with more document (usually 4 to 5 documents is enough to reach high number). On the Task definition you can configure the **Straight Through processing threshold**. this correspond to the predicition confidence score value for which you want to extract the values and map them to the fields without a manual review from an agent. + Notice the percentage number (73%) next to **Abel Tuter** under the **Account Holder** field (1). This is the confidence score for the prediction. The confidence score increases as you train the model with more document (usually 4 to 5 documents is enough to reach high number). On the Task definition you can configure the **Straight Through processing threshold**. this correspond to the prediction confidence score value for which you want to extract the values and map them to the fields without a manual review from an agent. Click the **Submit** button. By clicking the submit button the model is trained with those new inputs. In this Lab environment we do not have access to our Machine Learning component it won't do anything. You can now close that Tab. 1. Remember, we have submitted a VOID Check as **Abel Tuter**, you might wonder how the Bank Record with the attachment was picked up automatically by DocIntel. Let's review what was configured to do this. -1. Return to the Task Definition that was created for that use case. Click on **All** (1) then type **Document intelligence** in the filter navigator (2) and finally click **Task Definititions**: +1. Return to the Task Definition that was created for that use case. Click on **All** (1) then type **Document intelligence** in the filter navigator (2) and finally click **Task Definitions**: ![Relative](images/2022-09-09_10-35-25.png) @@ -155,25 +155,25 @@ Click on the **Show In Doctintel** button (2) to open the file in DocIntel: Notice the option **Create flow** (2). If selected, DocIntel will automatically create the flows that will be used to create the DocIntel tasks and Process them. - **Trigger** (3) and **Flow Conditions** (4) are automatically created, this what you will see if you open the specifc Flow in Flow Designer, it correspond the the Flow trigger and flow condition in flow designer. + **Trigger** (3) and **Flow Conditions** (4) are automatically created, this what you will see if you open the specific Flow in Flow Designer, it correspond the the Flow trigger and flow condition in flow designer. ![Relative](images/2022-09-09_13-07-55.png) -1. We have reviewed all the configurations that was done for that particular use case. Lets review the outcome of that automated data extraction from DocIntel. +1. We have reviewed all the configurations that was done for that particular use case. Let's review the outcome of that automated data extraction from DocIntel. Click on **Favorites** (1) then **bank account table** (2) ![Relative](images/2022-09-09_13-15-45.png) - When we origininally submitted the VOID Check as **Abel Tuter** a bank record was automatically created. Then based on the configuration of DocIntel, a DocIntel task was created automatically to process the attachment (VOID Check), extract the data then update the field Account Number, Bank Name, Routing Number, Account Holder. In this Lab environment we cannot process documents since we do not have access to our shared ML Infrastructure from those instances but we are showing on this screen below the end result with data we have preloaded on the lab instance so you can see what it would look like in real life... + When we originally submitted the VOID Check as **Abel Tuter** a bank record was automatically created. Then based on the configuration of DocIntel, a DocIntel task was created automatically to process the attachment (VOID Check), extract the data then update the field Account Number, Bank Name, Routing Number, Account Holder. In this Lab environment we cannot process documents since we do not have access to our shared ML Infrastructure from those instances but we are showing on this screen below the end result with data we have preloaded on the lab instance so you can see what it would look like in real life... ![Relative](images/2022-09-09_13-20-03.png) > This is a lab exercise, in real life we would not show any sensitive information like those banking information. We have created a custom table just for that exercise and securing the data is not the focus of that lab. We have different encryptions capabilities on the platform if we wanted to secure that data :-) -In the following exercice (IntegrationHub we see how to build a spoke to integrate ServiceNow to an external API that will use those extracted information from DocIntel. +In the following exercise (IntegrationHub we see how to build a spoke to integrate ServiceNow to an external API that will use those extracted information from DocIntel. ## Conclusion -In this **Document Intelligence** lab, we have covered how Document Intelligence can be configured to extract information from structured or semi-structed documents. We have seen how you can use those extracted values from within a workflow. In the following exercice, we are covering how to build a flow and integration using IntegrationHub to perform data validation (with the data extracted via DocIntel). You will learn how to build a spoke to integrate ServiceNow to an external system via API. +In this **Document Intelligence** lab, we have covered how Document Intelligence can be configured to extract information from structured or semi-structed documents. We have seen how you can use those extracted values from within a workflow. In the following exercise, we are covering how to build a flow and integration using IntegrationHub to perform data validation (with the data extracted via DocIntel). You will learn how to build a spoke to integrate ServiceNow to an external system via API. diff --git a/IntegrationHub.html b/IntegrationHub.html index 4096e9f..4372ee6 100644 --- a/IntegrationHub.html +++ b/IntegrationHub.html @@ -1,388 +1,312 @@ - - - - - - - -IntegrationHub - - - +.token.doctype, +.token.punctuation, +.token.variable, +.token.macro.property { + color: #333; +} - +.token.operator, +.token.important, +.token.keyword, +.token.rule, +.token.builtin { + color: #a71d5d; +} - +.token.string, +.token.url, +.token.regex, +.token.attr-value { + color: #183691; +} -

    Special note: Please do not use Google Chrome to do this lab. MAC users please use Safari, Windows users please use Firefox if possible (or Edge). Certain recent versions of Chrome cause unexpected behaviors due to unwanted characters that represent Byte order mark (BOM) in Flow Designer. This is a known issue and was fixed by a patch that is not installed on those lab instances, sorry for the inconvenience), for reference KB1182247

    +.token.property, +.token.number, +.token.boolean, +.token.entity, +.token.atrule, +.token.constant, +.token.symbol, +.token.command, +.token.code { + color: #0086b3; +} -

    Integration Hub exercise

    +.token.tag, +.token.selector, +.token.prolog { + color: #63a35c; +} -

    Introduction

    +.token.function, +.token.namespace, +.token.pseudo-element, +.token.class, +.token.class-name, +.token.pseudo-class, +.token.id, +.token.url-reference .token.variable, +.token.attr-name { + color: #795da3; +} -

    Integration Hub enables execution of third-party APIs as a part of a flow when a specific event occurs in ServiceNow. These integrations, referred to as spokes, are easy to configure and enable you to quickly add powerful actions without the need to write a script. For example, you can post a message and incident details in a Slack channel when a high priority incident is created.

    +.token.entity { + cursor: help; +} -

    Goal

    +.token.title, +.token.title .token.punctuation { + font-weight: bold; + color: #1d3e81; +} -

    In this exercise you will learn how to create a Spoke in Integration Hub. You will learn how to connect a ServiceNow Workflow to a remote API. For our use case we want to use Integration Hub to validate some data against an API. In the previous exercise we have seen how to extract data from document using our Intelligent Document Processing capability (Document Intelligence). In the previous exercise we see how we can extract Banking information from a VOID Check automatically using DocIntel. In this exercise we see how we validate the Routing Number extracted from a VOID Check by building an Integration Hub spoke action that is going to take this Routing Number information and pass it to an external API. This 3rd party API returns additional banking information that can be useful to setup the direct deposit for this new employee, or simply validate that the data extracted is correct. This is just an example to show how easily you can connect ServiceNow to external system via API by creating your own Spoke. We see how to build an integration to an API with having to write a single line of code.

    +.token.list { + color: #ed6a43; +} -

    Getting Familiar with an API

    +.token.inserted { + background-color: #eaffea; + color: #55a532; +} -

    When you need to create an integration from ServiceNow to an external system via API, it is important to familiarize yourself with the API that you are going to call from ServiceNow first. In the following steps we are going to take a look at that API so we can understand how it works and create our own spoke for it:

    +.token.deleted { + background-color: #ffecec; + color: #bd2c00; +} -
      -

    1. Inspect the Routing Number API.

      +.token.bold { + font-weight: bold; +} -

      Open a browser and navigate to https://www.routingnumbers.info/api/data.html to test out the API and analyze what this API can return.

      +.token.italic { + font-style: italic; +} -

      On the Routing Number Type 021000021 (1) then Click Get Bank Data (2)

      -

      Relative

      +/* JSON */ +.language-json .token.property { + color: #183691; +} -
      -

      The number we provide as input to the API must be a valid routing number, typically this routing number is found on a VOID Check

      -
      +.language-markup .token.tag .token.punctuation { + color: #333; +} -

      Under Results you can see the information that this API returns

      +/* CSS */ +code.language-css, +.language-css .token.function { + color: #0086b3; +} -
      -

      From a workflow in ServiceNow, you might want to make a call to this API to collect additional information from the Routing Number. For this you can create your own spoke.

      -
      +/* YAML */ +.language-yaml .token.atrule { + color: #63a35c; +} -

      Relative

      +code.language-yaml { + color: #183691; +} -

      In the next step of this exercise we will leverage that API from ServiceNow, custom IntegrationHub spoke action so we can make those API calls directly from a Workflow in ServiceNow and retrieve the API Response from this third party application.

      2. -
    +/* Ruby */ +.language-ruby .token.function { + color: #333; +} -

    Creating the spoke action for that Routing Number API

    +/* Markdown */ +.language-markdown .token.url { + color: #795da3; +} -
      -
    1. Log in to your instance
      2. -

    2. Click the All tab (1), then type Flow Designer (2), and finally click Flow Designer (3)

      +/* Makefile */ +.language-makefile .token.symbol { + color: #795da3; +} + +.language-makefile .token.variable { + color: #183691; +} + +.language-makefile .token.builtin { + color: #0086b3; +} + +/* Bash */ +.language-bash .token.keyword { + color: #0086b3; +} -

      Relative

      3. -

    3. Click on New (1) then Action (2)

      +/* highlight */ +pre[data-line] { + position: relative; + padding: 1em 0 1em 3em; +} +pre[data-line] .line-highlight-wrapper { + position: absolute; + top: 0; + left: 0; + background-color: transparent; + display: block; + width: 100%; +} -

      Relative

      4. -

    4. Fill in the Action properties form with those informations:

      +pre[data-line] .line-highlight { + position: absolute; + left: 0; + right: 0; + padding: inherit 0; + margin-top: 1em; + background: hsla(24, 20%, 50%,.08); + background: linear-gradient(to right, hsla(24, 20%, 50%,.1) 70%, hsla(24, 20%, 50%,0)); + pointer-events: none; + line-height: inherit; + white-space: pre; +} + +pre[data-line] .line-highlight:before, +pre[data-line] .line-highlight[data-end]:after { + content: attr(data-start); + position: absolute; + top: .4em; + left: .6em; + min-width: 1em; + padding: 0 .5em; + background-color: hsla(24, 20%, 50%,.4); + color: hsl(24, 20%, 95%); + font: bold 65%/1.5 sans-serif; + text-align: center; + vertical-align: .3em; + border-radius: 999px; + text-shadow: none; + box-shadow: 0 1px white; +} + +pre[data-line] .line-highlight[data-end]:after { + content: attr(data-end); + top: auto; + bottom: .4em; +}html body{font-family:"Helvetica Neue",Helvetica,"Segoe UI",Arial,freesans,sans-serif;font-size:16px;line-height:1.6;color:#333;background-color:#fff;overflow:initial;box-sizing:border-box;word-wrap:break-word}html body>:first-child{margin-top:0}html body h1,html body h2,html body h3,html body h4,html body h5,html body h6{line-height:1.2;margin-top:1em;margin-bottom:16px;color:#000}html body h1{font-size:2.25em;font-weight:300;padding-bottom:.3em}html body h2{font-size:1.75em;font-weight:400;padding-bottom:.3em}html body h3{font-size:1.5em;font-weight:500}html body h4{font-size:1.25em;font-weight:600}html body h5{font-size:1.1em;font-weight:600}html body h6{font-size:1em;font-weight:600}html body h1,html body h2,html body h3,html body h4,html body h5{font-weight:600}html body h5{font-size:1em}html body h6{color:#5c5c5c}html body strong{color:#000}html body del{color:#5c5c5c}html body a:not([href]){color:inherit;text-decoration:none}html body a{color:#08c;text-decoration:none}html body a:hover{color:#00a3f5;text-decoration:none}html body img{max-width:100%}html body>p{margin-top:0;margin-bottom:16px;word-wrap:break-word}html body>ul,html body>ol{margin-bottom:16px}html body ul,html body ol{padding-left:2em}html body ul.no-list,html body ol.no-list{padding:0;list-style-type:none}html body ul ul,html body ul ol,html body ol ol,html body ol ul{margin-top:0;margin-bottom:0}html body li{margin-bottom:0}html body li.task-list-item{list-style:none}html body li>p{margin-top:0;margin-bottom:0}html body .task-list-item-checkbox{margin:0 .2em .25em -1.8em;vertical-align:middle}html body .task-list-item-checkbox:hover{cursor:pointer}html body blockquote{margin:16px 0;font-size:inherit;padding:0 15px;color:#5c5c5c;background-color:#f0f0f0;border-left:4px solid #d6d6d6}html body blockquote>:first-child{margin-top:0}html body blockquote>:last-child{margin-bottom:0}html body hr{height:4px;margin:32px 0;background-color:#d6d6d6;border:0 none}html body table{margin:10px 0 15px 0;border-collapse:collapse;border-spacing:0;display:block;width:100%;overflow:auto;word-break:normal;word-break:keep-all}html body table th{font-weight:bold;color:#000}html body table td,html body table th{border:1px solid #d6d6d6;padding:6px 13px}html body dl{padding:0}html body dl dt{padding:0;margin-top:16px;font-size:1em;font-style:italic;font-weight:bold}html body dl dd{padding:0 16px;margin-bottom:16px}html body code{font-family:Menlo,Monaco,Consolas,'Courier New',monospace;font-size:.85em !important;color:#000;background-color:#f0f0f0;border-radius:3px;padding:.2em 0}html body code::before,html body code::after{letter-spacing:-0.2em;content:"\00a0"}html body pre>code{padding:0;margin:0;font-size:.85em !important;word-break:normal;white-space:pre;background:transparent;border:0}html body .highlight{margin-bottom:16px}html body .highlight pre,html body pre{padding:1em;overflow:auto;font-size:.85em !important;line-height:1.45;border:#d6d6d6;border-radius:3px}html body .highlight pre{margin-bottom:0;word-break:normal}html body pre code,html body pre tt{display:inline;max-width:initial;padding:0;margin:0;overflow:initial;line-height:inherit;word-wrap:normal;background-color:transparent;border:0}html body pre code:before,html body pre tt:before,html body pre code:after,html body pre tt:after{content:normal}html body p,html body blockquote,html body ul,html body ol,html body dl,html body pre{margin-top:0;margin-bottom:16px}html body kbd{color:#000;border:1px solid #d6d6d6;border-bottom:2px solid #c7c7c7;padding:2px 4px;background-color:#f0f0f0;border-radius:3px}@media print{html body{background-color:#fff}html body h1,html body h2,html body h3,html body h4,html body h5,html body h6{color:#000;page-break-after:avoid}html body blockquote{color:#5c5c5c}html body pre{page-break-inside:avoid}html body table{display:table}html body img{display:block;max-width:100%;max-height:100%}html body pre,html body code{word-wrap:break-word;white-space:pre}}.markdown-preview{width:100%;height:100%;box-sizing:border-box}.markdown-preview .pagebreak,.markdown-preview .newpage{page-break-before:always}.markdown-preview pre.line-numbers{position:relative;padding-left:3.8em;counter-reset:linenumber}.markdown-preview pre.line-numbers>code{position:relative}.markdown-preview pre.line-numbers .line-numbers-rows{position:absolute;pointer-events:none;top:1em;font-size:100%;left:0;width:3em;letter-spacing:-1px;border-right:1px solid #999;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none}.markdown-preview pre.line-numbers .line-numbers-rows>span{pointer-events:none;display:block;counter-increment:linenumber}.markdown-preview pre.line-numbers .line-numbers-rows>span:before{content:counter(linenumber);color:#999;display:block;padding-right:.8em;text-align:right}.markdown-preview .mathjax-exps .MathJax_Display{text-align:center !important}.markdown-preview:not([for="preview"]) .code-chunk .btn-group{display:none}.markdown-preview:not([for="preview"]) .code-chunk .status{display:none}.markdown-preview:not([for="preview"]) .code-chunk .output-div{margin-bottom:16px}.markdown-preview .md-toc{padding:0}.markdown-preview .md-toc .md-toc-link-wrapper .md-toc-link{display:inline;padding:.25rem 0}.markdown-preview .md-toc .md-toc-link-wrapper .md-toc-link p,.markdown-preview .md-toc .md-toc-link-wrapper .md-toc-link div{display:inline}.markdown-preview .md-toc .md-toc-link-wrapper.highlighted .md-toc-link{font-weight:800}.scrollbar-style::-webkit-scrollbar{width:8px}.scrollbar-style::-webkit-scrollbar-track{border-radius:10px;background-color:transparent}.scrollbar-style::-webkit-scrollbar-thumb{border-radius:5px;background-color:rgba(150,150,150,0.66);border:4px solid rgba(150,150,150,0.66);background-clip:content-box}html body[for="html-export"]:not([data-presentation-mode]){position:relative;width:100%;height:100%;top:0;left:0;margin:0;padding:0;overflow:auto}html body[for="html-export"]:not([data-presentation-mode]) .markdown-preview{position:relative;top:0}@media screen and (min-width:914px){html body[for="html-export"]:not([data-presentation-mode]) .markdown-preview{padding:2em calc(50% - 457px + 2em)}}@media screen and (max-width:914px){html body[for="html-export"]:not([data-presentation-mode]) .markdown-preview{padding:2em}}@media screen and (max-width:450px){html body[for="html-export"]:not([data-presentation-mode]) .markdown-preview{font-size:14px !important;padding:1em}}@media print{html body[for="html-export"]:not([data-presentation-mode]) #sidebar-toc-btn{display:none}}html body[for="html-export"]:not([data-presentation-mode]) #sidebar-toc-btn{position:fixed;bottom:8px;left:8px;font-size:28px;cursor:pointer;color:inherit;z-index:99;width:32px;text-align:center;opacity:.4}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] #sidebar-toc-btn{opacity:1}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc{position:fixed;top:0;left:0;width:300px;height:100%;padding:32px 0 48px 0;font-size:14px;box-shadow:0 0 4px rgba(150,150,150,0.33);box-sizing:border-box;overflow:auto;background-color:inherit}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc::-webkit-scrollbar{width:8px}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc::-webkit-scrollbar-track{border-radius:10px;background-color:transparent}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc::-webkit-scrollbar-thumb{border-radius:5px;background-color:rgba(150,150,150,0.66);border:4px solid rgba(150,150,150,0.66);background-clip:content-box}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc a{text-decoration:none}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc .md-toc{padding:0 16px}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc .md-toc .md-toc-link-wrapper .md-toc-link{display:inline;padding:.25rem 0}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc .md-toc .md-toc-link-wrapper .md-toc-link p,html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc .md-toc .md-toc-link-wrapper .md-toc-link div{display:inline}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc .md-toc .md-toc-link-wrapper.highlighted .md-toc-link{font-weight:800}html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .markdown-preview{left:300px;width:calc(100% - 300px);padding:2em calc(50% - 457px - 300px/2);margin:0;box-sizing:border-box}@media screen and (max-width:1274px){html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .markdown-preview{padding:2em}}@media screen and (max-width:450px){html body[for="html-export"]:not([data-presentation-mode])[html-show-sidebar-toc] .markdown-preview{width:100%}}html body[for="html-export"]:not([data-presentation-mode]):not([html-show-sidebar-toc]) .markdown-preview{left:50%;transform:translateX(-50%)}html body[for="html-export"]:not([data-presentation-mode]):not([html-show-sidebar-toc]) .md-sidebar-toc{display:none} +/* Please visit the URL below for more information: */ +/* https://shd101wyy.github.io/markdown-preview-enhanced/#/customize-css */ + + + + +
      +

      Special note: Please do not use Google Chrome to do this lab. MAC users please use Safari, Windows users please use Firefox if possible (or Edge). Certain recent versions of Chrome cause unexpected behaviors due to unwanted characters that represent Byte order mark (BOM) in Flow Designer. This is a known issue and was fixed by a patch that is not installed on those lab instances, sorry for the inconvenience), for reference KB1182247

      +

      Integration Hub exercise

      + +

      Introduction

      + +

      Integration Hub enables execution of third-party APIs as a part of a flow when a specific event occurs in ServiceNow. These integrations, referred to as spokes, are easy to configure and enable you to quickly add powerful actions without the need to write a script. For example, you can post a message and incident details in a Slack channel when a high priority incident is created.

      +

      Goal

      +

      In this exercise you will learn how to create a Spoke in Integration Hub. You will learn how to connect a ServiceNow Workflow to a remote API. For our use case we want to use Integration Hub to validate some data against an API. In the previous exercise we have seen how to extract Banking information from documents using our Intelligent Document Processing capability (Document Intelligence).

      +

      In this exercise we see how we validate the Routing Number extracted from a VOID Check by building an Integration Hub spoke action that is going to take this Routing Number information and pass it to an external API. This 3rd party API returns additional banking information that can be useful to setup the direct deposit for this new employee, or simply validate that the data extracted is correct. This is just an example to show how easily you can connect ServiceNow to external system via API by creating your own Spoke. We see how to build an integration to an API with having to write a single line of code.

      +

      Getting Familiar with an API

      + +

      When you need to create an integration from ServiceNow to an external system via API, it is important to familiarize yourself with the API that you are going to call from ServiceNow first. In the following steps we are going to take a look at that API so we can understand how it works and create our own spoke for it:

      +
        +
      1. +

        Inspect the Routing Number API.

        +

        Open a browser and navigate to https://www.routingnumbers.info/api/data.html to test out the API and analyze what this API can return.

        +

        On the Routing Number Type 021000021 (1) then Click Get Bank Data (2)

        +

        Relative

        +
        +

        The number we provide as input to the API must be a valid routing number, typically this routing number is found on a VOID Check

        +
        +

        Under Results you can see the information that this API returns

        +
        +

        From a workflow in ServiceNow, you might want to make a call to this API to collect additional information from the Routing Number. For this you can create your own spoke.

        +
        +

        Relative

        +

        In the next step of this exercise we will leverage that API from ServiceNow, custom IntegrationHub spoke action so we can make those API calls directly from a Workflow in ServiceNow and retrieve the API Response from this third party application.

        +
        2. +
      +

      Creating the spoke action for that Routing Number API

      + +
        +
      1. +

        Log in to your instance

        +
        2. +
      2. +

        Click the All tab (1), then type Flow Designer (2), and finally click Flow Designer (3)

        +

        Relative

        +
        3. +
      3. +

        Click on New (1) then Action (2)

        +

        Relative

        +
        4. +
      4. +

        Fill in the Action properties form with following information:

        @@ -390,7 +314,6 @@

        Creating the spoke action for that Routing Number API

        - @@ -422,66 +345,54 @@

        Creating the spoke action for that Routing Number API

        Value
        ActionName
        -

        Relative

        - -

        Then click Submit.

        5. -

      5. Add an Input to the action.

        - +

        Then click Submit.

        +
        6. +
      6. +

        Add an Input to the action.

        Click Create Input

        -

        Relative

        -

        Under Action Input You should see a new input line as shown in this screenshot below:

        -

        Relative

        -

        Under the Label column, double-click variable to rename the label and type the value Routing Number then click variable on the next column Name, the Name should be automatically filled in with routing_number.

        -

        Make the input Mandatory (1) and click Save (2)

        -

        Relative

        -

        We have created an input for our custom action, when someone uses our action from a workflow they will have to pass a value in that input. This value is used as a parameter when we make the API call to the remote application.

        - -
          -
        1. Under Inputs, click on the + sign to add a step to our action:
          2. -
        - -

        Relative

        7. -

      7. In the new window, type REST in the search box (1), then select the REST component (2):

        - +
        8. +
      8. +

        Under Inputs, click on the + sign to add a step to our action:

        +

        Relative

        +
        9. +
      9. +

        In the new window, type REST in the search box (1), then select the REST component (2):

        Relative

        -

        Most of the spokes that ServiceNow customers or even ServiceNow build are using this REST Step. It is an easy way to configure ServiceNow to make REST API Calls to 3rd Party APIs without coding. ServiceNow provide Integration step for other protocols such as SSH, Powershell, Webservices etc.

        -
        10. -

      10. Under Connection Details On the Connection field, select Define Connection Inline (1) then on the Base URL field type the url https://www.routingnumbers.info

        - + +
        11. +
      11. +

        Under Connection Details On the Connection field, select Define Connection Inline (1) then on the Base URL field type the url https://www.routingnumbers.info

        Relative

        -
        -

        For this exercise we do not use any credentials, this third party API doe not require authentication but most 3rd party API would require credentials to authenticate with it.Credentials can be configured in ServiceNow, and you would select the right Credential Alia to use under the Connection Details +

        For this exercise we do not use any credentials, this third party API doe not require authentication but most 3rd party API would require credentials to authenticate with it.Credentials can be configured in ServiceNow, and you would select the right Credential Alias to use under the Connection Details
        In production scenario, information such as Base URL (End point)c and Credentials would be configured on the instance under Connections & Credentials.

        -
        12. -

      12. Scroll down to show the Request Details form

        - -

        On the Resource Path field type /api/data.json?rn= + +

        13. +
      13. +

        Scroll down to show the Request Details form

        +

        On the Resource Path field type /api/data.json?rn=
        then drag and drop the Routing Number from the Data pill as shown below:

        -

        Relative

        -

        In that step we are passing dynamically the value from the input we created earlier to the API.

        - -

        API Requests often time take specific Query Parameters and Headers, usually the information needed can be found in the API documentation of the third party application. For that particular example we need to pass two Headers parameters.

        14. -

      14. Scroll down to show the Headers section, and click the + sign as shown below to add a new Header Name and Value:

        - +

        API Requests often time take specific Query Parameters and Headers, usually the information needed can be found in the API documentation of the third party application. For that particular example we need to pass two Headers parameters.

        +
        15. +
      15. +

        Scroll down to show the Headers section, and click the + sign as shown below to add a new Header Name and Value:

        Relative

        - @@ -489,7 +400,6 @@

        Creating the spoke action for that Routing Number API

        - @@ -497,9 +407,7 @@

        Creating the spoke action for that Routing Number API

        Value
        Content-Type
        - -

        Repeat that step to add the folling Name and Value

        - +

        Repeat that step to add the following Name and Value

        @@ -507,7 +415,6 @@

        Creating the spoke action for that Routing Number API

        - @@ -515,81 +422,87 @@

        Creating the spoke action for that Routing Number API

        Value
        User-Agent
        -

        It should looks as shown below:

        - -

        Relative

        16. -

      16. On the upper right hand side, click Save (1) then test (2).

        - -

        Relative

        17. -

      17. Enter the Routing Number: 021000021 (1) then Click Run test (2):

        - +

        Relative

        +
        18. +
      18. +

        On the upper right hand side, click Save (1) then test (2).

        +

        Relative

        +
        19. +
      19. +

        Enter the Routing Number: 021000021 (1) then Click Run test (2):

        Relative

        -

        After few second the test has finished running, click on the text Your Test has finished running. View the Action execution detail:

        -

        Relative

        - -

        We can now inspect the response from the API

        20. -

      20. Expand the Steps Section

        - -

        Relative

        21. -

      21. Scroll down until you see the Response Body (1) under the Step Output Data, then click on the value (2)

        - +

        We can now inspect the response from the API

        +
        22. +
      22. +

        Expand the Steps Section

        +

        Relative

        +
        23. +
      23. +

        Scroll down until you see the Response Body (1) under the Step Output Data, then click on the value (2)

        Relative

        - -

        This will open the content of the response_body output, this is the response coming from the API. Most APIs return a response in the same format (JSON Payload), it contains the information that we want to use from our Workflow.

        - +

        This will open the content of the response_body output, this is the response coming from the API. Most APIs return a response in the same format (JSON Payload), it contains the information that we want to use from our Workflow.

        -

        The benefit of Flow Designer and Integration Hub is that we can parse a JSON Payload without having to script anything (most solutions on the market require some kind of codind to do this), before we had Integration Hub on the platform we had to use some json.parse function in Javascript to be able to extract information from a JSON Payload. We made it easy for anyone to build an integration with no code.

        -
        24. -

      24. Copy the code from the Viewing response_body window:

        - +

        The benefit of Flow Designer and Integration Hub is that we can parse a JSON Payload without having to script anything (most solutions on the market require some kind of coding to do this), before we had Integration Hub on the platform we had to use some json.parse function in Javascript to be able to extract information from a JSON Payload. We made it easy for anyone to build an integration with no code.

        + +
        25. +
      25. +

        Copy the code from the Viewing response_body window:

        -

        Save in a text file or notepad or make sure to keep the content in your clipboard (Copy/paste) as we are going to need it when we configure the JSON Parse step, we will use this content.

        +

        Save in a text file or notepad or make sure to keep the content in your clipboard (Copy/paste) as we are going to need it when we configure the JSON Parse step.

        -

        Relative

        -

        At this stage we have created the REST API Call to the 3rd Party Routing Number API, now we need to add a step to be able to parse the response from the API to retrieve the value we need.

        -
        26. -

      26. Under Rest Step click the + sign to add a new step:

        - -

        Relative

        27. -

      27. In the search box, type JSON Parser (1), then select JSON Parser (2) to add that step to your action:

        - + +

        After copying the JSON close the response window.

        +
        28. +
      28. +

        Under Rest Step click the + sign to add a new step:

        +

        Relative

        +
        29. +
      29. +

        In the search box, type JSON Parser (1), then select JSON Parser (2) to add that step to your action:

        Relative

        -

        You should have the JSON Parser step under the REST step as shown:

        -

        Relative

        -
        -

        The first step (REST Step) makes the call to the remote REST API, then the second step (JSON Parser step) will parse the response from that API and extract the information we need.

        -
        30. -

      30. Drag and drop the Response Body from the Data pill to the Source data field on the JSON Parser step as shown below

        - -

        Relative

        31. -

      31. Past the JSON Payload (1) (from your clipboard or text file) , then click Generate Target:

        - -

        Relative

        32. -

      32. The JSON Parser step generates for you the objects (instead of having to script like with most of solution out there) that have the information coming from the API Response. No need to code anything! +

        The first step (REST Step) makes the call to the remote REST API, then the second step (JSON Parser step) will parse the response from that API and extract the information we need.

        + +
        33. +
      33. +

        Drag and drop the Response Body from the Data pill to the Source data field on the JSON Parser step as shown below

        +

        Relative

        +
        34. +
      34. +

        Past the JSON Payload (1) (from your clipboard or text file) , then click Generate Target:

        +

        Relative

        +
        35. +
      35. +

        The JSON Parser step generates for you the objects (instead of having to script like with most of solution out there) that have the information coming from the API Response. No need to code anything!
        Under Target (1) expand the root object

        - -

        Relative

        36. -

      36. Now we are going create the output variable on our spoke action so anyone who use that spoke action oin their workflow can retrieve the different values from the API. -We are going to map those Object from previous step to new Output variable.

        37. -

      37. Click Outputs:

        - -

        Relative

        38. -

      38. Then click Create Output:

        - -

        Relative

        39. -

      39. On the Label column Double click variable (1) and type office_code then double click variable on the Name column and type office_code: -Relative

        40. -

      40. Then continue to Create Output with the following Label and Name:

        - +

        Relative

        +
        41. +
      41. +

        Now we are going create the output variable on our spoke action so anyone who use that spoke action oin their workflow can retrieve the different values from the API.
        +We are going to map those Object from previous step to new Output variable.

        +
        42. +
      42. +

        Click Outputs:

        +

        Relative

        +
        43. +
      43. +

        Then click Create Output:

        +

        Relative

        +
        44. +
      44. +

        On the Label column Double click variable (1) and type office_code then double click variable on the Name column and type office_code:
        +Relative

        +
        45. +
      45. +

        Then continue to Create Output with the following Label and Name:

        @@ -597,7 +510,6 @@

        Creating the spoke action for that Routing Number API

        - @@ -628,23 +540,27 @@

        Creating the spoke action for that Routing Number API

        -
        Name
        zip routing_number
        46. -

      46. Verify that you have created the Ouputs as shown below:

        - -

        Relative

        47. -

      47. Now that we have created the output we can map the Objects from the JSON Parser step to those Action Outputs. That way we are taking the data from the API response and assigning the values to our outputs (Variables) so anyone who use that action in a flow can use the data coming from the API in any steps of their flow.

        48. -

      48. Click Exit Edit Mode

        - -

        Relative

        49. -

      49. Locate on the right hand side (Data pill) the Jason Parser Step section then under root, you see the objects coming from the API Response (JSON payload). We need to assign those variable to the Action Outputs we just created in the previous step.

        - -

        Relative

        50. -

      50. Drag and Drop those variables from the JSON Parser step to the Action Output variable as shown:

        - + +
        51. +
      51. +

        Verify that you have created the Outputs as shown below:

        +

        Relative

        +
        52. +
      52. +

        Now that we have created the output we can map the Objects from the JSON Parser step to those Action Outputs. That way we are taking the data from the API response and assigning the values to our outputs (Variables) so anyone who use that action in a flow can use the data coming from the API in any steps of their flow.

        +
        53. +
      53. +

        Click Exit Edit Mode

        +

        Relative

        +
        54. +
      54. +

        Locate on the right hand side (Data pill) the Jason Parser Step section then under root, you see the objects coming from the API Response (JSON payload). We need to assign those variable to the Action Outputs we just created in the previous step.

        +

        Relative

        +
        55. +
      55. +

        Drag and Drop those variables from the JSON Parser step to the Action Output variable as shown:

        Relative

        -

        Repeat that step for the following objects:

        - @@ -652,7 +568,6 @@

        Creating the spoke action for that Routing Number API

        - @@ -683,121 +598,148 @@

        Creating the spoke action for that Routing Number API

        -
        Action Output
        zip routing_number
        56. -

      56. Once you are done mapping the variables from the JSON Parser Step to the Action Outputs, click Save and review the Action Output screen to make sure it looks the same as the picture below:

        - -

        Relative

        57. -

      57. Now it's time to test our new Action again to make sure the value extracted from the API response are correctly passed to our newly created Action Output. Click Test:

        - -

        Relative

        58. -

      58. Enter the Routing Number 021000021 (1) then click Test (2):

        - + +
        59. +
      59. +

        Once you are done mapping the variables from the JSON Parser Step to the Action Outputs, click Save and review the Action Output screen to make sure it looks the same as the picture below:

        +

        Relative

        +
        60. +
      60. +

        Now it's time to test our new Action again to make sure the value extracted from the API response are correctly passed to our newly created Action Output. Click Test:

        +

        Relative

        +
        61. +
      61. +

        Enter the Routing Number 021000021 (1) then click Test (2):

        Relative

        - -

        After few second you should see the text Your Test has finished running, View the Action execution details. click on that text to inspect the execution detail and see if our newly Action Ouputs contain values assigned to them:

        - -

        Relative

        62. -

      62. The Execution Details screen opens, scroll down until you see the Output Data section.

        - -

        Congratulation! you have created a new API integration, you are capturing data from the API response and assigning those to variables that can be reused from within any workflows that use that new Action!

        - -

        Relative

        63. -

      63. We have basically created a reusable building block (Spoke action). For builders to be able to use it from within their workflows, you need to publish it to make it available. +

        After few second you should see the text Your Test has finished running, View the Action execution details. click on that text to inspect the execution detail and see if our newly Action Outputs contain values assigned to them:

        +

        Relative

        +
        64. +
      64. +

        The Execution Details screen opens, scroll down until you see the Output Data section.

        +

        Congratulation! you have created a new API integration, you are capturing data from the API response and assigning those to variables that can be reused from within any workflows that use that new Action!

        +

        Relative

        +
        65. +
      65. +

        We have basically created a reusable building block (Spoke action). For builders to be able to use it from within their workflows, you need to publish it to make it available.
        Close the Operation Execution Details tab(s):

        - -

        Relative

        66. -

      66. Click the Publish button from your Validate Banking Information Action screen:

        - -

        Relative

        67. -

      67. Click Publish again from this Validation screen:

        - -

        Relative

        68. +

        Relative

        + +
      68. +

        Click the Publish button from your Validate Banking Information Action screen:

        +

        Relative

        +
        69. +
      69. +

        Click Publish again from this Validation screen:

        +

        Relative

        +
      - -

      Creating a subflow and adding the spoke action

      +

      Creating a subflow and adding the spoke action

        -

      1. Now we are going to create a simple subflow so you can see how builders can use your new spoke action

        - +
      2. +

        Now we are going to create a simple subflow so you can see how builders can use your new spoke action

        Click on the Home icon to return to the main screen of Flow Designer

        - -

        Relative

        3. -

      3. Click New (1) then Subflow (2):

        - -

        Relative

        4. -

      4. On the Subflow Properties screen enter the Subflow Name Verify Routing Number (1), then select the Application Direct Deposit and finally click Submit (3)

        - -

        Relative

        5. -

      5. We need to create an input for our subflow so a routing number can be passed from a workflow that will use that subflow. Click on the Select to create the inputs & outputs of your subflow:

        - -

        Relative

        6. -

      6. Under the Inputs section, click the + sign (1), then enter the label routingnumber (2) and name routing number (3), make the input Mandatory (4), and finally click the expand icon (5).

        - -

        Relative

        7. -

      7. on the Default value field, type the number 021000021 (1) , then click Save (2)

        - +

        Relative

        +
        8. +
      8. +

        Click New (1) then Subflow (2):

        +

        Relative

        +
        9. +
      9. +

        On the Subflow Properties screen enter the Subflow Name Verify Routing Number (1), then select the Application Direct Deposit and finally click Submit (3)

        +

        Relative

        +
        10. +
      10. +

        We need to create an input for our subflow so a routing number can be passed from a workflow that will use that subflow. Click on the Select to create the inputs & outputs of your subflow:

        +

        Relative

        +
        11. +
      11. +

        Under the Inputs section, click the + sign (1), then enter the label routingnumber (2) and name routing number (3), make the input Mandatory (4), and finally click the expand icon (5).

        +

        Relative

        +
        12. +
      12. +

        on the Default value field, type the number 021000021 (1) , then click Save (2)

        Relative

        -

        We set a default value just so we do not have to type it again and again when we test the subflow.

        -
        13. -

      13. Scroll down to the Outputs section, then click the + sign twice (1) to add two new output variables, and replace the variable value (2) and (3) with the value message, and the variable (4) and (5) with the value bankname, and finally click Done (6)

        - -

        Relative

        14. -

      14. Now we can add our new spoke action to the subflow. Under Actions click + Add an Action, Flow Logic, or Subflow

        - -

        Relative

        15. -

      15. Then click Action

        - -

        Relative

        16. -

      16. in the search box type Direct Deposit (1) then under Installed Spokes click Direct Deposit (2) then click the action Validate banking Information (3) to add it to your subflow:

        - -

        Relative

        17. -

      17. From the Data Pill, under Subflow Inputs, grab the routingnumber variable and drop it to the Routing Number field on our Validate Banking Information action and click Done:

        - + +
        18. +
      18. +

        Scroll down to the Outputs section, then click the + sign twice (1) to add two new output variables, and replace the variable value (2) and (3) with the value message, and the variable (4) and (5) with the value bankname, and finally click Done (6)

        +

        Relative

        +
        19. +
      19. +

        Now we can add our new spoke action to the subflow. Under Actions click + Add an Action, Flow Logic, or Subflow

        +

        Relative

        +
        20. +
      20. +

        Then click Action

        +

        Relative

        +
        21. +
      21. +

        in the search box type Direct Deposit (1) then under Installed Spokes click Direct Deposit (2) then click the action Validate banking Information (3) to add it to your subflow:

        +

        Relative

        +
        22. +
      22. +

        From the Data Pill, under Subflow Inputs, grab the routingnumber variable and drop it to the Routing Number field on our Validate Banking Information action and click Done:

        Relative

        -

        This is just a simple example on how to add a custom spoke action to a subflow, under that step you could add any logic you want based on your use case.

        -
        23. -

      23. Notice in the data pill on the right hand side, the variable that we have available to use in our subflow, those are the output variable we have created earlier when we built the Spoke Action. Now we are going to map those to our Subflow Outputs. For this we use a Flow logic step that is available to us.

        24. -

      24. Under Under the Validate Banking Information action, click + Add an Action, Flow Logic, or Subflow:

        - -

        Relative

        25. -

      25. Click Flow Logic (1) then Assign Subflow Outputs (2):

        - -

        Relative

        26. -

      26. Click the + sign (1) twice to add two Subflow output assignments, then expand the list (2) on the first line of the table, and select message (3):

        - -

        Relative

        27. -

      27. Drag from the Data Pill the Message variable and drop it to the Data field under the Assign Subflow outputs steps. For the second field under Assign Subflow Outputs, select the Name bankname, then drag the variable customer_name from the Data pill and drop it under the Data field and click Doneas shown:

        - + +
        28. +
      28. +

        Notice in the data pill on the right hand side, the variable that we have available to use in our subflow, those are the output variable we have created earlier when we built the Spoke Action. Now we are going to map those to our Subflow Outputs. For this we use a Flow logic step that is available to us.

        +
        29. +
      29. +

        Under the Validate Banking Information action, click + Add an Action, Flow Logic, or Subflow:

        +

        Relative

        +
        30. +
      30. +

        Click Flow Logic (1) then Assign Subflow Outputs (2):

        +

        Relative

        +
        31. +
      31. +

        Click the + sign (1) twice to add two Subflow output assignments, then expand the list (2) on the first line of the table, and select message (3):

        +

        Relative

        +
        32. +
      32. +

        Drag from the Data Pill the Message variable and drop it to the Data field under the Assign Subflow outputs steps. For the second field under Assign Subflow Outputs, select the Name bankname, then drag the variable customer_name from the Data pill and drop it under the Data field and click Done as shown:

        Relative

        - -

        Congratulation, you have now created a reusable Subflow that leverage your custom action, this Subflow returns two values. The Message coming from the API response (return code) and the Bank Name associated to the routing number provided as an input. This example shows how you can use your custom action in a subflow and how you can select only the information you need from that action and expose the retrieved values as Subflow outputs. This makes those values available for any buiders who will use this subflow in their own Flow.

        33. -

      33. Click Save and then click Test.

        34. -

      34. Click Run Test

        - +

        Congratulation, you have now created a reusable Subflow that leverage your custom action, this Subflow returns two values. The Message coming from the API response (return code) and the Bank Name associated to the routing number provided as an input. This example shows how you can use your custom action in a subflow and how you can select only the information you need from that action and expose the retrieved values as Subflow outputs. This makes those values available for any builders who will use this subflow in their own Flow.

        +
        35. +
      35. +

        Click Save and then click Test.

        +
        36. +
      36. +

        Click Run Test

        Do no put any value in the Routing Number field, remember, we have set a default value, so the Subflow will use the default value.

        - -

        Relative

        37. -

      37. When the flow has finished runing, click on Your test has finiesh running. View the Subflow execution details.:

        - -

        Relative

        38. -

      38. On the execution detail screen, expand the Subflow Inputs & Outputs section (1) and inspect the subflow input routingnumber (2) and Subflow outputs bankname and message (3)

        - -

        Relative

        39. +

        Relative

        + +
      39. +

        When the flow has finished running, click on Your test has finished running. View the Subflow execution details.:

        +

        Relative

        +
        40. +
      40. +

        On the execution detail screen, expand the Subflow Inputs & Outputs section (1) and inspect the subflow input routingnumber (2) and Subflow outputs bankname and message (3)

        +

        Relative

        +
      - -

      Conclusion

      +

      Conclusion

      You have now completed the Integration Hub exercise. We have seen how to create a new API integration by creating a new Spoke Action and using the REST and JSON Parser steps, then how to publish that spoke action to be able to use it in a subflow.

      - - - - - - +
      + + + + + + + + + + + + \ No newline at end of file diff --git a/IntegrationHub.md b/IntegrationHub.md index a7653cf..b7ce5cb 100644 --- a/IntegrationHub.md +++ b/IntegrationHub.md @@ -9,7 +9,9 @@ Integration Hub enables execution of third-party APIs as a part of a flow when a ## Goal -In this exercise you will learn how to create a Spoke in Integration Hub. You will learn how to connect a ServiceNow Workflow to a remote API. For our use case we want to use Integration Hub to validate some data against an API. In the previous exercise we have seen how to extract data from document using our Intelligent Document Processing capability (**Document Intelligence**). In the previous exercise we see how we can extract Banking information from a VOID Check automatically using DocIntel. In this exercise we see how we validate the **Routing Number** extracted from a VOID Check by building an Integration Hub spoke action that is going to take this Routing Number information and pass it to an external API. This 3rd party API returns additional banking information that can be useful to setup the direct deposit for this new employee, or simply validate that the data extracted is correct. This is just an example to show how easily you can connect ServiceNow to external system via API by creating your own Spoke. We see how to build an integration to an API with having to write a single line of code. +In this exercise you will learn how to create a Spoke in Integration Hub. You will learn how to connect a ServiceNow Workflow to a remote API. For our use case we want to use Integration Hub to validate some data against an API. In the previous exercise we have seen how to extract Banking information from documents using our Intelligent Document Processing capability (**Document Intelligence**). + +In this exercise we see how we validate the **Routing Number** extracted from a VOID Check by building an Integration Hub spoke action that is going to take this Routing Number information and pass it to an external API. This 3rd party API returns additional banking information that can be useful to setup the direct deposit for this new employee, or simply validate that the data extracted is correct. This is just an example to show how easily you can connect ServiceNow to external system via API by creating your own Spoke. We see how to build an integration to an API with having to write a single line of code. @@ -19,7 +21,7 @@ When you need to create an integration from ServiceNow to an external system via 1. Inspect the Routing Number API. - Open a browser and navigate to https://www.routingnumbers.info/api/data.html to test out the API and analyze what this API can return. + Open a browser and navigate to [[https://www.routingnumbers.info/api/data.html]] to test out the API and analyze what this API can return. On the **Routing Number** Type 021000021 (1) then Click **Get Bank Data** (2) @@ -48,7 +50,7 @@ When you need to create an integration from ServiceNow to an external system via ![Relative](images/2022-09-06_13-22-19.png) -1. Fill in the **Action properties** form with those informations: +1. Fill in the **Action properties** form with following information: | Field | Value | |-------|-------| @@ -96,7 +98,7 @@ When you need to create an integration from ServiceNow to an external system via ![Relative](images/2022-09-06_14-32-45.png) - > For this exercise we do not use any credentials, this third party API doe not require authentication but most 3rd party API would require credentials to authenticate with it.Credentials can be configured in ServiceNow, and you would select the right **Credential Alia** to use under the **Connection Details** + > For this exercise we do not use any credentials, this third party API doe not require authentication but most 3rd party API would require credentials to authenticate with it.Credentials can be configured in ServiceNow, and you would select the right **Credential Alias** to use under the **Connection Details** In production scenario, information such as **Base URL** (End point)c and **Credentials** would be configured on the instance under **Connections & Credentials**. 1. Scroll down to show the **Request Details** form @@ -120,7 +122,7 @@ When you need to create an integration from ServiceNow to an external system via |-------|-------| | Content-Type | application/json | - Repeat that step to add the folling **Name** and **Value** + Repeat that step to add the following **Name** and **Value** | Name| Value | |-------|-------| @@ -159,15 +161,16 @@ When you need to create an integration from ServiceNow to an external system via This will open the content of the **response_body** output, this is the response coming from the API. Most APIs return a response in the same format (JSON Payload), it contains the information that we want to use from our Workflow. - > The benefit of Flow Designer and Integration Hub is that we can parse a JSON Payload without having to script anything (most solutions on the market require some kind of codind to do this), before we had Integration Hub on the platform we had to use some json.parse function in Javascript to be able to extract information from a JSON Payload. We made it easy for anyone to build an integration with no code. + > The benefit of Flow Designer and Integration Hub is that we can parse a JSON Payload without having to script anything (most solutions on the market require some kind of coding to do this), before we had Integration Hub on the platform we had to use some json.parse function in Javascript to be able to extract information from a JSON Payload. We made it easy for anyone to build an integration with no code. 1. Copy the code from the **Viewing response_body** window: - > Save in a text file or notepad or make sure to keep the content in your clipboard (Copy/paste) as we are going to need it when we configure the JSON Parse step, we will use this content. + > Save in a text file or notepad or make sure to keep the content in your clipboard (Copy/paste) as we are going to need it when we configure the JSON Parse step. ![Relative](images/2022-09-06_15-40-15.png) > At this stage we have created the REST API Call to the 3rd Party Routing Number API, now we need to add a step to be able to parse the response from the API to retrieve the value we need. + After copying the JSON close the response window. 1. Under **Rest Step** click the **+** sign to add a new step: @@ -223,7 +226,7 @@ When you need to create an integration from ServiceNow to an external system via | address | address | | routing_number | routing_number | -1. Verify that you have created the Ouputs as shown below: +1. Verify that you have created the Outputs as shown below: ![Relative](images/2022-09-06_17-27-41.png) @@ -266,7 +269,7 @@ When you need to create an integration from ServiceNow to an external system via ![Relative](images/2022-09-07_07-53-49.png) - After few second you should see the text **Your Test has finished running, View the Action execution details**. click on that text to inspect the execution detail and see if our newly Action Ouputs contain values assigned to them: + After few second you should see the text **Your Test has finished running, View the Action execution details**. click on that text to inspect the execution detail and see if our newly Action Outputs contain values assigned to them: ![Relative](images/2022-09-07_07-55-53.png) @@ -344,7 +347,7 @@ Close the Operation Execution Details tab(s): 1. Notice in the data pill on the right hand side, the variable that we have available to use in our subflow, those are the output variable we have created earlier when we built the Spoke Action. Now we are going to map those to our Subflow Outputs. For this we use a **Flow logic step** that is available to us. -1. Under Under the **Validate Banking Information** action, click **+ Add an Action, Flow Logic, or Subflow**: +1. Under the **Validate Banking Information** action, click **+ Add an Action, Flow Logic, or Subflow**: ![Relative](images/2022-09-07_08-57-20.png) @@ -355,11 +358,11 @@ Close the Operation Execution Details tab(s): ![Relative](images/2022-09-07_09-00-21.png) -1. Drag from the Data Pill the **Message** variable and drop it to the **Data field** under the **Assign Subflow outputs** steps. For the second field under **Assign Subflow Outputs**, select the Name **bankname**, then drag the variable **customer_name** from the Data pill and drop it under the Data field and click **Done**as shown: +1. Drag from the Data Pill the **Message** variable and drop it to the **Data field** under the **Assign Subflow outputs** steps. For the second field under **Assign Subflow Outputs**, select the Name **bankname**, then drag the variable **customer_name** from the Data pill and drop it under the Data field and click **Done** as shown: ![Relative](images/2022-09-07_09-05-26.gif) - Congratulation, you have now created a reusable Subflow that leverage your custom action, this Subflow returns two values. The Message coming from the API response (return code) and the Bank Name associated to the routing number provided as an input. This example shows how you can use your custom action in a subflow and how you can select only the information you need from that action and expose the retrieved values as Subflow outputs. This makes those values available for any buiders who will use this subflow in their own Flow. + Congratulation, you have now created a reusable Subflow that leverage your custom action, this Subflow returns two values. The Message coming from the API response (return code) and the Bank Name associated to the routing number provided as an input. This example shows how you can use your custom action in a subflow and how you can select only the information you need from that action and expose the retrieved values as Subflow outputs. This makes those values available for any builders who will use this subflow in their own Flow. 1. Click **Save** and then click **Test**. @@ -368,7 +371,7 @@ Close the Operation Execution Details tab(s): ![Relative](images/2022-09-07_09-13-20.png) -1. When the flow has finished runing, click on **Your test has finiesh running. View the Subflow execution details.**: +1. When the flow has finished running, click on **Your test has finished running. View the Subflow execution details.**: ![Relative](images/2022-09-07_09-15-17.png) diff --git a/Lab.html b/Lab.html new file mode 100644 index 0000000..203e908 --- /dev/null +++ b/Lab.html @@ -0,0 +1,293 @@ + + Lab + + + + + + + + + + + + + + + + +
      +

      Lab Instances

      + +

      https://clabs.link/aew-may-4307

      + +

      Reservation code: see slides.

      + +

      Automation Engine - Workshop in a box

      + +

      Exercise 1 Automation Center

      + +

      Exercise 2 Document Intelligence

      + +

      Exercise 3 Integration Hub

      + +

      Exercise 4 RPA Hub

      + + +
      + + + + + + + + + + + + \ No newline at end of file diff --git a/Lab.md b/Lab.md new file mode 100644 index 0000000..5a8345b --- /dev/null +++ b/Lab.md @@ -0,0 +1,13 @@ +# Lab Instances +## https://clabs.link/aew-may-4307 +## Reservation code: see slides. + +# Automation Engine - Workshop in a box + +## [Exercise 1 Automation Center](https://htmlpreview.github.io/?https://github.com/erietveld/automationcenter/blob/master/AutomationCenter.html) + +## [Exercise 2 Document Intelligence](https://htmlpreview.github.io/?https://github.com/erietveld/quentin/blob/main/DocIntel.html) + +## [Exercise 3 Integration Hub](https://htmlpreview.github.io/?https://github.com/erietveld/quentin/blob/main/IntegrationHub.html) + +## [Exercise 4 RPA Hub](https://htmlpreview.github.io/?https://github.com/erietveld/Robert/blob/master/RPA%20Exercise.html) \ No newline at end of file