รู้เบื้องต้นเกี่ยวกับ UiPath

ภาพรวม UiPath

UiPath เป็นหนึ่งในผู้จำหน่าย Robotic Process Automation (RPA) ชั้นนำ UiPath ประกอบด้วย 3 องค์ประกอบหลัก:

สถาปัตยกรรมคอมโพเนนต์ UiPath

แนวคิดและข้อกำหนดของ UiPath

นี่คือแนวคิดและคำศัพท์พื้นฐานบางอย่างใน UiPath ที่คุณควรทำความคุ้นเคยกับบทช่วยสอนในภายหลัง:

มีแนวคิดอื่นสำหรับการใช้งานขั้นสูงเพิ่มเติมที่จะไม่ใช้ในบทช่วยสอนเช่น:

เริ่มต้นกับ UiPath

ขั้นตอนที่ 1: สมัครใช้งานแพลตฟอร์ม UiPath Cloud

ลงทะเบียนบัญชีที่ https://www.uipath.com/platform-trial มีแผนชุมชนในการเริ่มต้นฟรีเราจึงเลือกชุมชนเพื่อลงทะเบียน

ลงทะเบียนโดยใช้บัญชีโซเชียลหรืออีเมลและเมื่อลงทะเบียนคุณจะถูกนำไปที่แดชบอร์ดที่ https://platform.uipath.com

บริการแสดงถึงการปรับใช้ใน บริษัท บริการเริ่มต้นถูกสร้างขึ้นแล้วเช่น DemoDefault

เลือกชื่อบริการเพื่อเปิดเว็บแอปพลิเคชัน UiPath Orchestrator

ขั้นตอนที่ 2: ติดตั้ง UiPath Studio และ UiPath Robot

ดาวน์โหลดตัวติดตั้ง UiPath Studio (UiPathStudioSetup.exe) จาก Resource Center และติดตั้งบนคอมพิวเตอร์เป้าหมาย ข้อมูลเพิ่มเติมเกี่ยวกับ UiPath Studio สามารถดูได้ที่ UiPath Studio Guide

หลังจากติดตั้ง UiPathStudioSetup.exe ให้เริ่ม UiPath Studio จากเมนู Windows Start และเปิดใช้งาน คุณสามารถเริ่มต้นได้ฟรีโดยเปิดใช้งาน Community Edition

ขั้นตอนที่ 3: เรียกใช้ UiPath Robot และรับชื่อเครื่อง

ในเมนู Windows Start ให้ค้นหา UiPath Robot และเริ่มต้น

คลิกที่ไอคอนเกียร์เพื่อเปิดหน้าต่างการตั้งค่า Orchestrator และคัดลอกชื่อเครื่อง

ขั้นตอนที่ 4: รับรหัสเครื่อง

ย้อนกลับไปใน UiPath Orchestrator สร้างเครื่องใหม่ภายใต้เมนู Machines

IMPORTANT: Make sure that the name matches the Machine Name shown in the UiPath Orchestrator Settings earlier.

ดูเครื่องที่เลือกและคัดลอกหมายเลขเครื่อง

ขั้นตอนที่ 5: เชื่อมต่อหุ่นยนต์ UiPath เข้ากับเครื่อง

ใน UiPath Robot คลิกที่ไอคอนเกียร์เพื่อเปิดหน้าต่างการตั้งค่า Orchestrator

กรอก URL ของ Orchestrator (https://platform.uipath.com สำหรับแพลตฟอร์ม UiPath Cloud) และรหัสเครื่องที่คัดลอกในขั้นตอนก่อนหน้าจากนั้นคลิกที่เชื่อมต่อ

Once connected, you should see “Status: Robot unavailable” at the bottom of the window.

Hover over that message, and you should see the reason “Robot is not available.” This message means that the machine connection is valid, so now it’s time to create a robot. If you see a different reason then there might be an error in your configuration so you will want to double check your settings.

ขั้นตอนที่ 6: สร้างหุ่นยนต์

ใน UiPath Orchestrator ใต้เมนู Robots คลิกที่ไอคอนเครื่องหมายบวกที่ด้านบนขวา

เลือก“ หุ่นยนต์มาตรฐานที่ทำงานกับเครื่องมาตรฐานเดียว”

กำหนดหุ่นยนต์ให้กับเครื่องที่สร้างไว้ก่อนหน้านี้

ตั้งค่า“ ชื่อ” และกรอกข้อมูลล็อกอิน Windows จริงสำหรับเครื่องเป้าหมาย (ที่ติดตั้ง UiPath Robot) ภายใต้โดเมน \ ชื่อผู้ใช้และรหัสผ่าน

ขั้นตอนที่ 7: เพิ่มหุ่นยนต์ในสภาพแวดล้อม

ต่อไปเราจะต้องเพิ่มหุ่นยนต์ที่สร้างขึ้นเพื่อสิ่งแวดล้อม เลือกแท็บสภาพแวดล้อมที่ด้านบนของเมนู Robots และเลือกตัวเลือกจัดการ

เลือกหุ่นยนต์ที่สร้างขึ้นก่อนหน้านี้และคลิกอัปเดต

ณ จุดนี้หุ่นยนต์ควรจะเชื่อมต่อกับเครื่องได้สำเร็จ ตรวจสอบการตั้งค่า UiPath Robot Orchestrator และสถานะควรแสดง“ เชื่อมต่อได้รับอนุญาต”

ขั้นตอนที่ 8: เริ่มงาน

ตอนนี้ได้รับการปรับใช้แล้วก็ถึงเวลาที่จะเริ่มงานเพื่อทดสอบ

ภายใต้งานให้คลิกที่ไอคอนเล่นที่ด้านบนขวา

เลือกกระบวนการสาธิตที่มีอยู่แล้วและหุ่นยนต์ก่อนหน้านี้จากนั้นคลิกที่เริ่ม

ใน UiPath Robot มันจะแสดง“ การติดตั้งแพ็คเกจ…” เมื่อติดตั้งแพคเกจแล้วมันจะแสดง“ การประมวลผลเริ่มงาน” ซึ่งหมายถึงกระบวนการเริ่ม ในกระบวนการสาธิตนี้กล่องโต้ตอบสวัสดีป๊อปอัพจะปรากฏขึ้น

หุ่นยนต์เริ่มงานได้สำเร็จ คุณสามารถตรวจสอบหุ่นยนต์และงานในเมนูการตรวจสอบใน UiPath Orchestrator

ขั้นตอนที่ 9: เตรียมความพร้อมสำหรับการรวม UiPath

ในเดือนมิถุนายน 2019 UiPath แนะนำกลไกใหม่สำหรับการใช้ Cloud API มีหลายขั้นตอนที่จำเป็นในการดึงข้อมูลที่จำเป็นสำหรับการรวม:

รับการเข้าถึงและโทเค็น ID

สร้าง Code Challenge และ Code Verifier

ในเว็บเบราว์เซอร์ไปที่ https://repl.it/languages/nodejs และเรียกใช้รหัสต่อไปนี้:

function base64URLEncode(str) {
  return str.toString('base64')
    .replace(/\+/g, '-')
    .replace(/\//g, '_')
    .replace(/=/g, '');
}
 
function sha256(buffer) {
  return crypto.createHash('sha256').update(buffer).digest();
}
 
console.log("Generating challenge and Verifier");
var cryptoResult = crypto.randomBytes(32);
var verifier = base64URLEncode(cryptoResult);
var challenge = base64URLEncode(sha256(verifier));
console.log("Code challenge: " + challenge)
console.log("Code verifier: " + verifier);

จดรหัส code challenge และcode verifier โค้ดผลลัพธ์เช่น

Generating challenge and Verifier
Code challenge: RzYlHiiGzPGgOLaRQJYftZ1mmc3sCbeicZVRftTmC-A
Code verifier: YVMnLczXQgJ9dwzV7MlMWEjGyAia4nXvTZzU4UVrAPE

รับรหัสอนุญาต

แทนที่ code challenge เป็น URL ด้านล่างและไปที่ URL ที่อัปเดตในเบราว์เซอร์

เบราว์เซอร์ควรเปลี่ยนเส้นทางไปที่:

คัดลอก author_code ใน URL

รับโทเค็นรีเฟรช

ใช้เครื่องมือทดสอบ API ใด ๆ (เช่น Postman) ส่งคำขอ POST ถึง

https://account.uipath.com/oauth/token ด้วยเนื้อหาด้านล่างแทนที่ค่าสำหรับ [authorization_code] และ [code_verifier] ตามลำดับ

{
   "grant_type": "authorization_code",
   "code": "[authorization_code]",
   "redirect_uri": "https://account.uipath.com/mobile",
   "code_verifier": "[code verifier]",
   "client_id": "5v7PmPJL6FOGu6RB8I1Y4adLBhIwovQN"
}

คัดลอกค่าของ refresh_token จากการตอบกลับ:

{
   "access_token": "eyJ0eX...",
   "refresh_token": "CBZcOD6vrP2FQ9qa8fuqDdfoEwnVPuR2Kpz-hitbTAIzG",
   "id_token": "eyJ0eX...",
   "scope": "openid profile email offline_access",
   "expires_in": 86400,
   "token_type": "Bearer"
}

รับโทเค็นการเข้าถึงและ ID โดยใช้รีเฟรชโทเค็น

ใช้เครื่องมือทดสอบ API ใด ๆ ส่งคำขอ POST ถึง

https://account.uipath.com/oauth/token ด้วยเนื้อหาด้านล่างแทนที่ค่าสำหรับ [refresh_token] ตามลำดับ

{
   "grant_type": "refresh_token",
   "client_id": "5v7PmPJL6FOGu6RB8I1Y4adLBhIwovQN",
   "refresh_token": "[refresh_token]"
}

คัดลอกค่าสำหรับ access_token และ id_token จากการตอบกลับ

{
   "access_token": "eyJ0eX...",
   "id_token": "eyJ0eX...",
   "scope": "openid profile email offline_access",
   "expires_in": 86400,
   "token_type": "Bearer"
}

รับบัญชี UiPath บริการและตัวระบุกระบวนการ

รับชื่อตรรกะบัญชี

ใช้เครื่องมือทดสอบ API ใด ๆ ส่งคำขอ GET ถึง

https://platform.uipath.com/cloudrpa/api/getAccountsForUser พร้อมส่วนหัวคำขอ

Authorization: Bearer [id_token]

คัดลอกค่าสำหรับ accountLogicalName จากการตอบกลับ:

{
   "userEmail": "demo@domain.com",
   "accounts": [
       {
           "accountName": "Demo",
           "accountLogicalName": "Demo"
       }
   ]
}

รับชื่อตรรกะของอินสแตนซ์ของบริการ

ใช้เครื่องมือทดสอบ API ใด ๆ ส่งคำขอ GET ถึง

https://platform.uipath.com/cloudrpa/api/account/ ชัดaccountLogicalNameเหมือนกัน /getAllServiceInstance พร้อมส่วนหัวคำขอ

Authorization: Bearer [id_token]

คัดลอกค่าสำหรับ serviceInstanceLogicalName จากการตอบกลับ:

[
   {
       "serviceInstanceName": "DemoDefault",
       "serviceInstanceLogicalName": "DemoDefaultzous50676",
       "serviceType": "ORCHESTRATOR",
       "serviceUrl": "https://platform-community.azurewebsites.net"
   }
]

รับรหัสการอนุมัติสำหรับกระบวนการที่ต้องการ

ตอนนี้เราจะต้องดึงรหัสรีลีสซึ่งเป็นตัวระบุเฉพาะสำหรับกระบวนการที่ต้องการ ใช้เครื่องมือทดสอบ API ใด ๆ ส่งคำขอ GET ถึง

https://platform.uipath.com/odata/Releases กับส่วนหัวคำขอ

Authorization: Bearer [access_token]
X-UIPATH-TenantName: [serviceInstanceLogicalName]

คัดลอกค่าสำหรับคีย์จากการตอบกลับ:

{
   "@odata.context": "https://platform.uipath.com/odata/$metadata#Releases",
   "@odata.count": 1,
   "value": [
       {
           "Key": "b27c7363-459c-4520-bae5-660d4a1d3813",
           "ProcessKey": "Demo_Process",
           "ProcessVersion": "1.0.21",
           "IsLatestVersion": false,
           "IsProcessDeleted": false,
           "Description": "Demo Process",
           "Name": "Demo Process",
           "EnvironmentId": 98069,
           "EnvironmentName": "Demo Environment",
           "InputArguments": null,
           "QueueDefinitionId": null,
           "QueueDefinitionName": null,
           "Id": 120897,
           "Arguments": {
               "Input": null,
               "Output": null
           },
           "ProcessSettings": null
       }
   ]
}

ทดสอบ Orchestrator API เพื่อเริ่มงาน

ณ จุดนี้ตรวจสอบให้แน่ใจว่าคุณมีข้อมูลสำคัญต่อไปนี้:

ลองทำการเรียก API เพื่อเริ่มงานสำหรับกระบวนการ

ใช้เครื่องมือทดสอบ API ใด ๆ ส่งคำขอ POST ถึง

https://platform.uipath.com/odata/Jobs/UiPath.Server.Configuration.OData.StartJobs พร้อม 2 ส่วนหัวคำขอ

Authorization: Bearer [access_token]
X-UIPATH-TenantName: [serviceInstanceLogicalName]

และร่างกาย:

{ "startInfo":
  { "ReleaseKey": "[Key]",
    "Strategy": "All",
    "RobotIds": [ ],
    "JobsCount": 0,
    "Source": "Manual"
  }
}

หากประสบความสำเร็จการตอบสนองจะเป็นดังนี้ด้วยสถานะของงานที่แสดงในแอตทริบิวต์ของรัฐ:

{
   "@odata.context": "https://platform.uipath.com/odata/$metadata#Jobs",
   "value": [
       {
           "Key": "e811bd29-26fb-4cc3-af91-7fd6308ca643",
           "StartTime": null,
           "EndTime": null,
           "State": "Pending",
           "Source": "Manual",
           "SourceType": "Manual",
           "BatchExecutionKey": "382e7a96-a5b9-4343-b258-26a80cf87f80",
           "Info": null,
           "CreationTime": "2019-06-12T08:02:03.2595408Z",
           "StartingScheduleId": null,
           "ReleaseName": "Demo Process",
           "Type": "Unattended",
           "InputArguments": null,
           "OutputArguments": null,
           "HostMachineName": null,
           "HasMediaRecorded": false,
           "Id": 10169582
       }
   ]
}

รวม UiPath เข้ากับ Joget

วิธีผสานรวมกับ UiPath

UiPath จัดเตรียม Orchestrator API สำหรับการรวมเข้าด้วยกัน

ฟังก์ชั่นที่ใช้กันมากที่สุดคือ Starting a Job ซึ่งควรเป็นไปตามกรณีการใช้งานส่วนใหญ่ เราจะใช้ฟังก์ชั่นนี้ในการสอนการรวมต่อไปนี้

ออกแบบกระบวนการเพื่อเริ่มงาน UiPath

เนื่องจาก UiPath Orchestrator API เป็น REST API ที่มีข้อมูลในรูปแบบJSONเราจึงสามารถใช้ JogetJSON Toolเพื่อเรียกใช้ API

ก่อนที่เราจะเริ่มตรวจสอบให้แน่ใจว่าคุณมีข้อมูล UiPath ที่สำคัญต่อไปนี้อยู่ในมือ (ได้รับจากบทเรียนการเตรียมการสำหรับการรวม UiPath ก่อนหน้านี้):

ขั้นตอนที่ 1 ออกแบบแอพใหม่

ขั้นแรกให้ออกแบบแอปใหม่โดยคลิกที่ออกแบบแอปใหม่ใน Joget App Center

กรอกค่าที่ต้องการสำหรับ ID แอปและชื่อแอพแล้วคลิกบันทึก

ขั้นตอนที่ 2 ออกแบบกระบวนการใหม่

คลิกที่เมนูกระบวนการจากนั้นคลิกที่ปุ่มออกแบบกระบวนการเพื่อเปิดตัว Process Builder

ออกแบบกระบวนการง่าย ๆ ที่ประกอบด้วย 2 เครื่องมือดังแสดงด้านล่าง

คลิกที่ไอคอนแก้ไขดินสอหลังจากโฮเวอร์เหนือชื่อกระบวนการด้านบน ป้อนชื่อกระบวนการที่เหมาะสมและสร้าง 3 ตัวแปรเวิร์กโฟลว์เพื่อเก็บค่าการตอบสนองจากการเรียก UiPath API:

คลิกที่ปรับใช้

ขั้นตอนที่ 3 กำหนดค่าเครื่องมือแรกเพื่อรับโทเค็นการเข้าถึง UiPath

เมื่อกระบวนการได้รับการปรับใช้ให้ปิดตัวสร้างกระบวนการ ในหน้ามุมมองกระบวนการให้เลือกแท็บเครื่องมือแผนที่เป็นปลั๊กอิน

คลิกที่กำหนดค่าปลั๊กอินสำหรับเครื่องมือแรกและเลือกเครื่องมือ JSON จากนั้นป้อนการกำหนดค่าต่อไปนี้:

ใต้ Store to Workflow Variable ให้จับคู่ตัวแปรเพื่อเก็บโทเค็นในตัวแปรเวิร์กโฟลว์ที่ตรงกันเช่น

คลิกที่ส่งเพื่อบันทึก

ขั้นตอนที่ 4 กำหนดค่าเครื่องมือที่สองเพื่อเริ่มงานโดยใช้โทเค็นการเข้าถึง

คลิกที่ Configure Plugin สำหรับเครื่องมือที่สองและเลือกเครื่องมือ JSON จากนั้นป้อนการกำหนดค่าต่อไปนี้:

ใต้ Store to Workflow Variable ให้จับคู่ตัวแปรสถานะกับแอตทริบิวต์ State ในการตอบสนอง JSON เช่น

แค่นั้นแหละ. กระบวนการ Joget ได้รับการกำหนดค่าให้เรียกใช้ UiPath Orchestrator API เพื่อเริ่มงาน

ขั้นตอน 5. เรียกใช้กระบวนการ

ตอนนี้มาทดสอบกระบวนการกัน คลิกที่ปุ่ม Run Process ที่ด้านบนจากนั้น Run Process อีกครั้งในกล่องโต้ตอบการยืนยัน

เมื่อกระบวนการเริ่มต้นเครื่องมือ 2 ตัวจะทำงานตามที่กำหนดไว้ หากต้องการดูผลลัพธ์ของกระบวนการให้ไปที่การตรวจสอบ -> กระบวนการที่เสร็จสมบูรณ์

เลือกตัวอย่างกระบวนการและคุณจะเห็นเครื่องมือ 2 ตัวดำเนินการ

คลิกที่แต่ละกิจกรรมเพื่อดูค่าของตัวแปรเวิร์กโฟลว์ที่ได้รับผลลัพธ์ของการเรียกใช้ Orchestrator API

หากคุณใช้งาน Joget ในสถานที่และสามารถเข้าถึงบันทึกของระบบคุณจะสามารถเห็นคำขอเครื่องมือและการตอบสนองหากเปิดใช้งานตัวเลือกการแก้ไขข้อบกพร่อง

เอาต์พุตบันทึกตัวอย่าง:

INFO 12 Jun 2019 09:28:38 org.joget.apps.app.lib.JsonTool - POST : https://account.uipath.com/oauth/token
INFO 12 Jun 2019 09:28:38 org.joget.apps.app.lib.JsonTool - Custom JSON Payload : {_ "grant_type": "refresh_token",_ "client_id": "5v7PmPJL6FOGu6RB8I1Y4adLBhIwovQN",_ "refresh_token": "CBZcOD6vrP2FQ9qa8fuqDdfoEwnVPuR2Kpz-hitbTAIzG"_}_
INFO 12 Jun 2019 09:28:39 org.joget.apps.app.lib.JsonTool - https://account.uipath.com/oauth/token returned with status : 200
INFO 12 Jun 2019 09:28:39 org.joget.apps.app.lib.JsonTool - {"access_token":"eyJ0eX...","scope":"openid profile email offline_access","expires_in":86400,"token_type":"Bearer"}
INFO 12 Jun 2019 09:28:39 org.joget.apps.app.lib.JsonTool - POST : https://platform.uipath.com/odata/Jobs/UiPath.Server.Configuration.OData.StartJobs
INFO 12 Jun 2019 09:28:39 org.joget.apps.app.lib.JsonTool - Custom JSON Payload : { "startInfo":_ { "ReleaseKey": "b27c7363-459c-4520-bae5-660d4a1d3813",_ "Strategy": "All",_ "RobotIds": [ ],_ "JobsCount": 0,_ "Source": "Manual" _ } _}_
INFO 12 Jun 2019 09:28:39 org.joget.apps.app.lib.JsonTool - Adding request header Authorization : Bearer eyJ0eX...
INFO 12 Jun 2019 09:28:39 org.joget.apps.app.lib.JsonTool - Adding request header X-UIPATH-TenantName : DemoDefaultzous50676
INFO 12 Jun 2019 09:28:40 org.joget.apps.app.lib.JsonTool - https://platform.uipath.com/odata/Jobs/UiPath.Server.Configuration.OData.StartJobs returned with status : 201
INFO 12 Jun 2019 09:28:40 org.joget.apps.app.lib.JsonTool - {"@odata.context":"https://platform.uipath.com/odata/$metadata#Jobs","value":[{"Key":"aa667a3e-04f9-4013-a8eb-ce701dac8799","StartTime":null,"EndTime":null,"State":"Pending","Source":"Manual","SourceType":"Manual","BatchExecutionKey":"68fa4d0a-0fcc-4d49-ae0d-b6631a7dfc78","Info":null,"CreationTime":"2019-06-12T09:28:12.9207318Z","StartingScheduleId":null,"ReleaseName":"Demo Process","Type":"Unattended","InputArguments":null,"OutputArguments":null,"HostMachineName":null,"HasMediaRecorded":false,"Id":10173064}]}

หากคุณใช้ Joget DX คุณสามารถสตรีมบันทึกได้โดยตรงในเว็บเบราว์เซอร์

กลับไปที่ UiPath Orchestrator และ UiPath Robot คุณจะสามารถตรวจสอบการทำงานของงานได้

ตัวอย่างแอพ Joget

แอปตัวอย่างที่มีกระบวนการนี้สามารถดาวน์โหลดได้ด้านล่าง: