نحوه استفاده foreach در UiPath(آموزش UiPath- جلسه هشتم)

طراحی ربات Browser در UiPath(آموزش UiPath- جلسه هفتم)

ژانویه 6, 2025

بکار گیری Flow Chart در UiPath(آموزش UiPath- جلسه نهم)

ژانویه 6, 2025

یکی از فعالیت‌های کلیدی و پرکاربرد در اتوماسیون فرآیندهای رباتیک با UiPath، فعالیت For Each است. این ابزار قدرتمند به شما امکان می‌دهد تا وظایف تکراری را به صورت کارآمد انجام دهید و داده‌های مختلف را پردازش کنید. در این مقاله، نحوه استفاده از For Each در UiPath با مثال‌های عملی و نکات مهم بررسی می‌شود.

For Each در UiPath چیست؟

تعریف For Each

For Each یک حلقه کنترلی در UiPath است که برای پیمایش لیست‌ها، آرایه‌ها، دیتا تیبل‌ها و انواع دیگر داده‌های تکرارشونده استفاده می‌شود. با این حلقه می‌توانید هر آیتم موجود در مجموعه داده را پردازش کنید.

چرا از For Each استفاده کنیم؟

کاهش کدنویسی: نیاز به تکرار دستی دستورات را حذف می‌کند.
انعطاف‌پذیری بالا: قابلیت کار با انواع داده‌ها مانند لیست‌ها، آرایه‌ها، دیتا تیبل‌ها و فایل‌های Excel را دارد.
سرعت و دقت بالا: داده‌ها را به صورت خودکار و با دقت بالا پردازش می‌کند.

کاربردهای اصلی For Each در UiPath

1. پردازش لیست‌ها و آرایه‌ها

برای پیمایش و دسترسی به مقادیر ذخیره‌شده در لیست‌ها و آرایه‌ها.

2. کار با دیتا تیبل‌ها

می‌توان هر ردیف از یک جدول داده را پردازش و اطلاعات مورد نظر را استخراج کرد.

3. خواندن فایل‌های Excel

برای پیمایش و پردازش مقادیر ذخیره‌شده در فایل‌های Excel.

4. پردازش ایمیل‌ها

برای پیمایش و خواندن ایمیل‌های دریافتی یا ارسال‌شده.

5. کار با پوشه‌ها و فایل‌ها

برای پردازش فایل‌های موجود در یک پوشه یا پیمایش مسیرها.

نحوه استفاده از For Each در UiPath

1. افزودن فعالیت For Each

از پنل Activities، فعالیت For Each را جستجو کرده و به Workflow اضافه کنید.

2. تنظیم آرگومان‌های ورودی

مجموعه داده‌ای که قصد پیمایش آن را دارید (مانند لیست، آرایه یا دیتا تیبل) در بخش For Each Item in وارد کنید.

3. تعریف عملیات داخل حلقه

دستورات یا فعالیت‌هایی که می‌خواهید برای هر آیتم اجرا شوند را داخل حلقه قرار دهید.

4. خروج از حلقه

در صورت نیاز، از فعالیت Break برای خروج از حلقه استفاده کنید.

مثال‌های عملی استفاده از For Each در UiPath

مثال 1: پردازش لیست اعداد

فرض کنید یک لیست از اعداد داریم و می‌خواهیم مقدار هر عدد را در Console نمایش دهیم:

Input: List(Of Integer) = {1, 2, 3, 4, 5}

For Each Item in List
    Write Line: "Number: " + Item.ToString

مثال 2: خواندن داده‌های Excel

یک فایل Excel شامل اطلاعات کارکنان داریم و می‌خواهیم نام هر کارمند را چاپ کنیم:

1. Read Range: ذخیره داده‌ها در DataTable
2. For Each Row in DataTable:
    Write Line: Row("Name").ToString

مثال 3: پردازش فایل‌های موجود در پوشه

فرض کنید یک پوشه حاوی فایل‌های متنی است و می‌خواهیم نام هر فایل را استخراج کنیم:

1. Assign: FileList = Directory.GetFiles("C:\Files")
2. For Each File in FileList:
    Write Line: Path.GetFileName(File)

نکات مهم در استفاده از For Each

1. انتخاب TypeArgument مناسب

برای هر نوع داده، باید TypeArgument مربوطه را در تنظیمات For Each انتخاب کنید. مثلاً:

برای لیست‌های عددی: System.Int32
برای دیتا تیبل: DataRow

2. استفاده از Break

برای متوقف کردن حلقه در شرایط خاص از فعالیت Break استفاده کنید.

3. مدیریت خطاها

از Try Catch برای مدیریت خطاهای احتمالی داخل حلقه استفاده کنید.

4. بهینه‌سازی حلقه‌ها

برای مجموعه‌های بزرگ، عملیات داخل حلقه را بهینه کنید تا عملکرد بهتری داشته باشید.

5. استفاده از Parallel For Each

برای پردازش همزمان مجموعه داده‌ها از Parallel For Each استفاده کنید.

پرسش‌های متداول

For Each چه تفاوتی با While دارد؟
For Each برای پیمایش مجموعه‌های داده مشخص طراحی شده است، در حالی که While برای اجرای یک حلقه تا زمانی که شرطی برقرار باشد، استفاده می‌شود.

چگونه می‌توان از For Each برای پردازش فایل‌های Excel استفاده کرد؟
ابتدا داده‌ها را با فعالیت Read Range به یک DataTable تبدیل کنید، سپس از For Each Row برای پردازش ردیف‌های آن استفاده کنید.

آیا می‌توان For Each را با فعالیت‌های شرطی ترکیب کرد؟
بله، می‌توانید از If یا Switch داخل حلقه For Each استفاده کنید تا شرط‌های خاصی را اعمال کنید.

Parallel For Each چیست و چه زمانی استفاده می‌شود؟
Parallel For Each یک نسخه پیشرفته از For Each است که وظایف را به صورت همزمان اجرا می‌کند و در پردازش مجموعه‌های بزرگ یا موازی مفید است.

چگونه می‌توان حلقه For Each را متوقف کرد؟
با استفاده از فعالیت Break می‌توانید اجرای حلقه را در شرایط خاص متوقف کنید.

نتیجه‌گیری

فعالیت For Each در UiPath یکی از ابزارهای کلیدی برای پردازش مجموعه‌های داده و انجام وظایف تکراری است. با درک دقیق از نحوه استفاده و کاربردهای این حلقه، می‌توانید فرآیندهای رباتیک خود را سریع‌تر و کارآمدتر طراحی کنید. با ترکیب For Each با سایر ابزارها مانند If، Data Scraping و Excel Automation، امکانات بی‌پایانی برای خودکارسازی فرآیندها در اختیار شما قرار خواهد گرفت.