آموزش اتصال Power Apps به SharePoint On-Premise

(راهنمای کامل و عملی برای سازمان‌هایی که SharePoint داخلی دارند)

اتصال Power Apps به SharePoint On-Premise یکی از مهم‌ترین موضوعات برای سازمان‌هایی است که نمی‌خواهند داده‌های خود را به فضای ابری منتقل کنند. با این اتصال، می‌توانید فرم‌ها، اپلیکیشن‌ها و فرآیندهای اتوماسیونی بسازید بدون اینکه اطلاعات از شبکه داخلی خارج شود.

پیش‌نیازها

قبل از شروع، باید سه مورد زیر فراهم باشد:

1) در دسترس بودن شیرپوینت On-Premise

• نسخه‌های قابل پشتیبانی:
  SharePoint 2013
  SharePoint 2016
  SharePoint 2019
  SharePoint Subscription Edition

2) راه‌اندازی On-Premises Data Gateway

این بخش مهم‌ترین مرحله است.

Data Gateway رابط بین Power Apps (Cloud) و SharePoint داخلی شماست.
بدون Gateway هیچ اتصالی ممکن نیست.

3) حساب کاربری با دسترسی مناسب

کاربر باید حداقل Read/Write برای لیست‌ها داشته باشد.

مرحله ۱: نصب و راه‌اندازی On-Premises Data Gateway

1.1 دانلود Gateway

به سایت مایکروسافت رفته و Gateway را دانلود کنید:
Search → “Microsoft On-Premises Data Gateway”

1.2 نصب نرم‌افزار روی سرور

بهتر است روی سروری نصب شود که:

• همیشه روشن است

• به شیرپوینت دسترسی دارد

• به اینترنت وصل است (برای ارتباط با Power Apps)

1.3 ورود با حساب Power Platform

در صفحه نصب، با اکانت Power Apps / Office 365 لاگین کنید.

1.4 انتخاب حالت نصب

دو حالت وجود دارد:

• Standard Mode (پیشنهادی – برای سازمان‌ها)

• Personal Mode

حالت Standard را انتخاب کنید.

مرحله ۲: ایجاد Connection از Power Apps به SharePoint On-Premise

2.1 ورود به Power Apps

PowerApps.com → Connections → New Connection

2.2 انتخاب SharePoint

از لیست کانکتورها: SharePoint

2.3 انتخاب نوع اتصال

Connect using On-Premises Data Gateway
مهم: اگر این گزینه را نمی‌بینید یعنی Gateway شما شناخته نشده

.

2.4 وارد کردن آدرس سایت شیرپوینت

در این مرحله URL را وارد می‌کنید:

مثال:

2.5 انتخاب Gateway

Gateway که نصب کردید را انتخاب کنید.

2.6 وارد کردن نوع احراز هویت

سه مدل وجود دارد:

• Windows Authentication

• NTLM

• Kerberos (برای محیط‌های پیشرفته)

معمولاً گزینه Windows بهترین انتخاب است.

مرحله ۳: تست اتصال و انتخاب لیست‌ها

بعد از اتصال:

1. لیست‌های موجود در سایت SharePoint نمایش داده می‌شود

2. لیست موردنظر را انتخاب کنید

3. Power Apps از لیست یک Data Source می‌سازد

برای مثال:

• Employees

• Requests

• Documents

• Tickets

حالا می‌توانید:

• فرم بسازید

• گالری ایجاد کنید

• عملیات CRUD انجام دهید

مرحله ۴: ساخت یک فرم Power Apps متصل به SharePoint On-Prem

4.1 ساخت اپ جدید

Create → App → Canvas

4.2 افزودن data source

Data → Add Data → SharePoint (On-Prem)

4.3 انتخاب لیست

مثلاً:
Employees

Power Apps به‌صورت خودکار یک Gallery و یک Edit Form ایجاد می‌کند.

مشکلات رایج و راه‌حل‌ها

مشکل ۱: Gateway در Power Apps نمایش داده نمی‌شود

راه‌حل: داخل Windows Service بخش
On-Premises Data Gateway Service
وضعیت آن را چک کنید (باید Running باشد).

مشکل ۲: اتصال برقرار می‌شود اما لیست‌ها دیده نمی‌شوند

۹۰٪ مواقع مشکل از Permission است.
باید کاربری که وارد می‌شوید دسترسی به همان سایت را داشته باشد.

مشکل ۳: خطای “Cannot connect using Kerberos”

از احراز هویت Windows یا NTLM استفاده کنید.

مشکل ۴: خطای SSL یا HTTPS

اگر در شبکه داخلی از HTTP استفاده می‌کنید،
Gateway معمولاً مشکلی ندارد.
اگر HTTPS دارید، باید گواهی SSL معتبر باشد.

نکات مهم برای سرعت و امنیت

Gateway را روی سرور قوی نصب کنید
اگر کاربران زیاد دارید، از Load Balancing برای Gateway استفاده کنید
دسترسی‌ها را محدود نگه دارید
در Power Apps تعداد درخواست‌ها به لیست را کم کنید (Delegation)