exam-sub 1.0.0 → 1.0.2

package/data/rpa.txt

@@ -0,0 +1,279 @@
+================================================================================
+HOW TO USE THIS GUIDE
+================================================================================
+
+This guide explains each of the 12 journal questions in simple, step-by-step language. For every question you will find:
+
+• Goal - what the exercise is testing
+• Activities/Packages Used - the UiPath building blocks you need
+• Steps - a simple numbered procedure you can follow and screenshot
+• Exam Tip - a one-line point worth remembering for viva/exam
+
+Follow the steps inside UiPath Studio (Community Edition is fine) unless a question specifically asks for Orchestrator.
+
+================================================================================
+QUESTION 1: EXPLORING UIPATH STUDIO INTERFACE
+================================================================================
+
+Goal: Get familiar with the main screen of UiPath Studio before building any automation.
+
+Steps:
+1. Open UiPath Studio from the Start menu.
+2. Click New Project -> Process, give it a name like ExploreUI, and click Create.
+3. Studio opens with the Design tab active. Take a screenshot of the Ribbon (the top toolbar with buttons like New, Save, Record, Publish).
+4. On the left side you will see the Activities Panel. Type "message box" in its search bar and take a screenshot.
+5. Drag any activity (e.g., Message Box) onto the design canvas, click on it once. On the right side, the Properties Panel appears showing its settings (like Text, Caption). Screenshot it.
+6. Click Run on the ribbon. At the bottom, the Output Panel shows execution logs and any Write Line messages. Screenshot it.
+
+Exam Tip: Ribbon = tools, Activities Panel = building blocks, Properties Panel = settings of a selected activity, Output Panel = logs/results.
+
+================================================================================
+QUESTION 2: CREATE A BASIC SEQUENCE WORKFLOW (ADD TWO NUMBERS)
+================================================================================
+
+Goal: Build your first working automation — take two numbers, add them, and show the result.
+
+Activities Used: Sequence, Input Dialog, Assign, Message Box
+
+Steps:
+1. Create a new Blank Process named AddTwoNumbers.
+2. Drag a Sequence onto the design canvas.
+3. Inside the sequence, drag an Input Dialog activity.
+   o Set Label = "Enter first number"
+   o Set Result = a new variable num1Text (type String)
+4. Add a second Input Dialog activity.
+   o Set Label = "Enter second number"
+   o Set Result = new variable num2Text (type String)
+5. Add an Assign activity:
+   o Left side: create variable sum (type Int32)
+   o Right side: Convert.ToInt32(num1Text) + Convert.ToInt32(num2Text)
+6. Add a Message Box activity:
+   o Text: "The sum is: " + sum.ToString()
+7. Click Run, enter two numbers when asked, and confirm the message box shows the correct total.
+
+Exam Tip: Input Dialog always returns text (String), so you must convert it to a number before doing math — this is called type conversion.
+
+================================================================================
+QUESTION 3: AUTOMATIC RECORDING (WEB) — RPACHALLENGE.COM
+================================================================================
+
+Goal: Automatically generate a workflow by recording your actions on a website instead of manually dragging activities.
+
+Steps:
+1. Open the site https://rpachallenge.com/ in your browser and note the form fields (First Name, Last Name, Email, etc.).
+2. In UiPath Studio, go to Design -> Recording -> Web.
+3. Studio will ask you to indicate the browser — click on the rpachallenge.com page.
+4. A small recording toolbar appears. Click Record, then:
+   o Click each input box and type the matching value (this is recorded as a Type Into activity).
+   o Click the Submit button (recorded as a Click activity).
+5. Click Save & Exit on the recording toolbar. UiPath automatically inserts an Open Browser activity plus one Type Into/Click activity for every action you performed.
+6. Press Run to replay the recorded steps automatically.
+
+Exam Tip: Web Recording works with UI Explorer/selectors, so it keeps working even if the browser window is resized or moved.
+
+================================================================================
+QUESTION 4: AUTOMATIC RECORDING (DESKTOP) — NOTEPAD
+================================================================================
+
+Goal: Record a desktop (non-browser) automation.
+
+Steps:
+1. Go to Design -> Recording -> Desktop in UiPath Studio.
+2. Open Notepad manually (or let the recorder capture you opening it from the Start menu).
+3. Click Record, then:
+   o Click inside Notepad and type a short message (captured as Type Into).
+   o Press Ctrl+S, type a file name in the Save dialog, and click Save (captured as more Type Into / Click steps).
+4. Click Save & Exit to finish recording — Studio builds the sequence automatically.
+5. Close Notepad and click Run to confirm it reopens Notepad, types the message, and saves the file by itself.
+
+Exam Tip: Desktop Recording uses window titles/selectors, so keep the same application version to avoid "selector not found" errors.
+
+================================================================================
+QUESTION 5: IMAGE AND TEXT AUTOMATION (OCR)
+================================================================================
+
+Goal: Extract text written inside an image using Optical Character Recognition (OCR).
+
+Packages Needed: UiPath.OCR.Activities (install via Manage Packages)
+
+Steps:
+1. Go to Manage Packages -> All Packages, search UiPath.OCR.Activities, and install it.
+2. Add a Get OCR Text activity to your workflow.
+3. In its properties, set:
+   o OCR Engine = Microsoft OCR (built-in, no API key needed)
+   o Image/Path = full path of your image file (e.g., "C:\Images\sample.png")
+   o Text output = new variable extractedText (type String)
+4. Add a Message Box activity with Text = extractedText.
+5. Run the workflow — the text found inside the image will pop up in the message box.
+
+(Alternative: use the Screen Scraping wizard from the Design tab, select "Native/OCR" method, and drag a box over the text you want to capture on screen.)
+
+Exam Tip: OCR is needed only when text is inside a picture/scanned document, not for normal selectable text.
+
+================================================================================
+QUESTION 6: PDF DATA EXTRACTION (FEE RECEIPT)
+================================================================================
+
+Goal: Read a PDF file and pull out one specific value (the Total amount).
+
+Packages Needed: UiPath.PDF.Activities
+
+Steps:
+1. Install the UiPath.PDF package from Manage Packages if not already present.
+2. Drag a Read PDF Text activity.
+   o File Path = path of the fee receipt PDF
+   o Text output = variable pdfText (type String)
+3. Add an Assign activity to pull out the total using Regex:
+   o Variable totalAmount (type String) = System.Text.RegularExpressions.Regex.Match(pdfText, "Total.*$(\d+[,.]?\d*)").Groups(1).Value
+   o (Adjust the pattern slightly to match how "Total" is written in your receipt, e.g. "Total Amount" or "Total: ₹".)
+4. Add a Message Box with Text = "Total Amount: " + totalAmount.
+5. Run and confirm the correct total is displayed.
+
+Exam Tip: Read PDF Text gives you the whole text as one string — Regex (pattern matching) is what lets you pick out just the number you need.
+
+================================================================================
+QUESTION 7: EXCEL AUTOMATION (NAME, AGE)
+================================================================================
+
+Goal: Read rows from an Excel file and show each one in a message box.
+
+Activities Used: Excel Application Scope (or Use Excel File), Read Range, For Each Row, Message Box
+
+Steps:
+1. Prepare an Excel file with two columns: Name and Age, and a few sample rows.
+2. Drag an Excel Application Scope (or the newer Use Excel File) activity and set its Workbook Path to your file.
+3. Inside it, drag a Read Range activity:
+   o Sheet: Sheet1
+   o Output = new variable dtData (type DataTable)
+4. Below (outside the Excel scope is fine), drag a For Each Row activity, set In = dtData.
+5. Inside the loop, add a Message Box:
+   o Text = row("Name").ToString() + " - " + row("Age").ToString()
+6. Run — a message box pops up once for every row in the sheet.
+
+Exam Tip: Read Range with no argument reads the entire used range of the sheet automatically — you don't need to know how many rows exist in advance.
+
+================================================================================
+QUESTION 8: EXPLORE UIPATH ORCHESTRATOR INTERFACE
+================================================================================
+
+Goal: Understand what each part of Orchestrator (the web-based control room for robots) does. No coding — just explore and explain.
+
+Steps:
+1. Go to https://cloud.uipath.com/ and log in (create a free Community account if needed).
+2. Open your tenant and look at these sections, taking a screenshot of each:
+
+--------------------------------------------------------------------------------
+Section       | What It Means
+--------------------------------------------------------------------------------
+Dashboard     | A summary screen showing jobs run, robots available, and alerts
+              | at a glance.
+Tenants       | A logical container that separates different environments/
+              | departments in the same Orchestrator instance.
+Machines      | Represents the physical/virtual computers where robots are 
+              | allowed to run.
+Robots        | The actual robot instances (Attended/Unattended) connected to 
+              | those machines.
+Jobs          | Individual execution runs of a process — you can see if a job 
+              | is Pending, Running, Successful, or Faulted.
+--------------------------------------------------------------------------------
+
+Exam Tip: Remember the hierarchy: Tenant -> Machine -> Robot -> Job (created from a Process).
+
+================================================================================
+QUESTION 9: CREATE AND SCHEDULE A JOB
+================================================================================
+
+Goal: Publish your automation to Orchestrator and make it run automatically at a set time.
+
+Steps:
+1. In UiPath Studio, open any working project and click Publish (top-right).
+2. Choose the Orchestrator Tenant Process Feed and click Publish — this uploads your project as a package.
+3. Log in to Orchestrator -> Processes. Click Add Process, select your uploaded package, and confirm.
+4. Go to Triggers -> Add Trigger:
+   o Trigger type: Time Trigger
+   o Process: select the one you just added
+   o Set the schedule (e.g., "Run daily at 6:00 PM" or "Run once at a specific date/time")
+   o Choose the Robot/Machine to run it on
+5. Click Save. Go to the Jobs tab to confirm the job is listed as Scheduled, and later shows as Successful once it runs.
+
+Exam Tip: A Process is the published package; a Job is one actual run of that process, whether started manually or by a trigger.
+
+================================================================================
+QUESTION 10: PDF RANGE (SPLIT A PDF)
+================================================================================
+
+Goal: Ask the user for a page range and split a PDF into a smaller file containing only those pages.
+
+Packages Needed: UiPath.PDF.Activities (modern activities include Extract Page Range)
+
+Steps:
+1. Add an Input Dialog to ask: "Enter full path of the PDF file" -> variable pdfPath (String).
+2. Add two more Input Dialog activities (or one dialog with two fields) to ask for:
+   o startPage (String -> convert to Int32)
+   o endPage (String -> convert to Int32)
+3. Drag the Extract Page Range activity (search "PDF" in Activities Panel):
+   o Input File = pdfPath
+   o Start Page = Convert.ToInt32(startPage)
+   o End Page = Convert.ToInt32(endPage)
+   o Output File = e.g. "C:\Output\SplitFile.pdf"
+4. Add a Message Box: "PDF split successfully! Saved at: C:\Output\SplitFile.pdf".
+5. Run, enter a valid range (e.g., pages 2 to 4), and check that the new PDF has only those pages.
+
+Exam Tip: Always validate that startPage and endPage are within the total number of pages (you can get this with Get PDF Page Count) to avoid errors.
+
+================================================================================
+QUESTION 11: KEYBOARD EVENTS (CTRL+A, CTRL+C, CTRL+V)
+================================================================================
+
+Goal: Simulate keyboard shortcuts to select, copy, and paste text, then show what was copied.
+
+Activities Used: Send Hotkey, Get From Clipboard, Message Box
+
+Steps:
+1. Open any webpage with a text box (or a Notepad file with some text already typed).
+2. Use Indicate on Screen to select the text field.
+3. Add a Send Hotkey activity targeting that field: Key = Ctrl+A (select all text).
+4. Add another Send Hotkey: Key = Ctrl+C (copy the selected text).
+5. Add a Get From Clipboard activity -> output variable copiedText (String).
+6. Open Notepad (or another field), indicate it, and add a Send Hotkey: Key = Ctrl+V to paste there.
+7. Add a Message Box with Text = copiedText to display what was copied.
+8. Run and confirm the same text appears in the message box and gets pasted correctly.
+
+Exam Tip: Send Hotkey sends key combinations to whichever UI element you indicate — it works the same on a browser field or a desktop app.
+
+================================================================================
+QUESTION 12: DATA SCRAPING (E-COMMERCE WEBSITE)
+================================================================================
+
+Goal: Automatically pull structured data (Product Name, Price, Rating) for at least 10 products from a shopping website into Excel.
+
+Steps:
+1. Open a browser and navigate to any e-commerce listing/search results page (e.g., a search on Amazon or Flipkart) that shows multiple products with name, price, and rating.
+2. In UiPath Studio, go to Design -> Extract Data (the Data Scraping wizard) and click on the page.
+3. Click the first product's name, then click a second product's name — the wizard detects the repeating pattern and highlights all matching products.
+4. Click Extract Correlated Data and repeat the "click first, click second" step for the Price field, then again for the Rating field, so all three columns line up in the same table.
+5. When asked "Extract data for all pages?", choose No if 10 products already fit on one page, or set the number of pages needed.
+6. Finish the wizard — it automatically inserts activities and creates a DataTable variable, e.g. dtProducts.
+7. Add a Write Range activity (inside an Excel/Workbook scope) to write dtProducts into a new file, e.g. Products.xlsx.
+8. Run the workflow and open Products.xlsx to confirm all 10+ rows (Name, Price, Rating) were captured correctly.
+
+Exam Tip: Data Scraping only works well on structured/repeating HTML elements — if the wizard can't detect a pattern, you may need to manually add Get Attribute / Get Text activities inside a loop instead.
+
+================================================================================
+QUICK REFERENCE TABLE (FOR LAST-MINUTE REVISION)
+================================================================================
+
+Question | Key Activity/Feature                 | Package Needed
+---------+-------------------------------------+-----------------------
+1        | Explore Studio panels               | Built-in
+2        | Input Dialog, Assign, Message Box   | Built-in
+3        | Web Recording                       | Built-in
+4        | Desktop Recording                   | Built-in
+5        | Get OCR Text / Screen Scraping      | UiPath.OCR.Activities
+6        | Read PDF Text + Regex               | UiPath.PDF.Activities
+7        | Read Range, For Each Row            | UiPath.Excel.Activities
+8        | Orchestrator navigation             | Orchestrator (cloud)
+9        | Publish + Trigger                   | Orchestrator (cloud)
+10       | Extract Page Range                  | UiPath.PDF.Activities
+11       | Send Hotkey, Get From Clipboard     | Built-in
+12       | Extract Data (Data Scraping wizard) | Built-in + Excel

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "exam-sub",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "A CLI for accessing college subject study materials from the terminal.",
   "bin": {
     "exam-sub": "bin/cli.js"