انواع پارامترهای SharePoint Designer و نحوه استفاده از آنها در فیلتر کردن Data View ها

​

اگر از شیرپوینت دیزاینر استفاده کرده باشید، زمانیکه تصمیم دارید تا بر روی Data View ها فیلتری جهت نمایش اطلاعات داخل Data view ست نمایید، نیاز دارید تا از Filter Criteria استفاده کنید.


اگر از شیرپوینت دیزاینر استفاده کرده باشید، زمانیکه تصمیم دارید تا بر روی Data View ها فیلتری جهت نمایش اطلاعات داخل Data view ست نمایید، نیاز دارید تا از Filter Criteria استفاده کنید. (شکل زیر)

​

Filter Criteria براساس مقادیر فیلدهای لیست انتخابی می تواند تنظیم شود. اما بعضی مواقع ممکن است شما نیاز داشته باشید تا شرط فیلتر مورد نظر را با مقادیر دیگری خارج از مقادیر موجود در فیلدها مقایسه نمایید. در اینصورت شما نیاز به تعریف پارامترها (Parameters) دارید.

​

پارامترها انواع مختلفی دارند که در این پُست به معرفی تعدادی از آنها که کاربردی تر هستند می پردازم.
(انواع پارامترها رو از لیست Parameter Source می توانید انتخاب کنید.)

​

1- پارامتر از نوع Control :
با انتخاب این پارامتر شما می توانید یک کنترل ( (TextBox,DropDownList,..از صفحه ای که Data view شما در آن قرار دارد را به پارامتر نسبت دهید. این کنترلها براساس ID آنها که شما در صفحه .aspx اضافه کرده اید مشخص می شوند. به عنوان مثال شما یک کنترل TextBox با ID=”TxtName” در صفحه دارید که تصمیم دارید تا فیلتر Data View رو بر اساس مقدار داخل این TextBox ست نمایید. در اینصورت در زمان runtime، صفحه ابتدا مقدار این TextBox را می گیرد و سپس Data View را براساس این مقدار فیلتر می نماید. حال شما باید از Parameter Source گزینه Control رو انتخاب نمایید و در قسمت Control ID ، ID مربوط به آن کنترل را وارد کنید . (شکل زیر)

​

پس از اینکار شما باید در پنجره Filter Criteria مقدار Value رو بر روی Param1 ست نمایید.
2- پارامتر از نوع Cookie :
ممکن است شما قصد داشته باشید تا مقدار پارامتر رو از یک Cookie بخونید و در فیلتر Data View از مقایسه مقدار اون با مقدار یکی از فیلدهای Data View فیلتر رو انجام بدید. اگر شما توسط DLL یا JavaScript کوکی ای رو برای صفحه مورد نظر ایجاد کرده باشید، در این قسمت می توانید نام Cookie رو در قسمت Cookie Name وارد نمایید.
(در مورد استفاده از کوکی ها به صورت جاوا اسکریپتی و کد C# در شیرپوینت، در آینده مطالبی را در وبلاگم خواهم نوشت)

​

3- پارامتر از نوع Query String :
یکی از پر کاربردترین پارامترها می باشد که با استفاده از آن می توانید یک مقدار را از Query String ست شده در Url صفحه بخونید و در فیلتر Data View از آن استفاده کنید.
فرض کنید در صفحه قبل از صفحه فعلی، مقداری را به URL صفحه فعلی ارسال کرده اید و در این صفحه تصمیم دارید تا از آن مقدار ارسال شده از صفحه قبل، جهت فیلتر Data View استفاده نمایید. به عنوان مثال من در صفحه Test.aspx توسط متدی مقدار ID را با عدد 5 به صفحه Test2.aspx و به صورت زیر ارسال کرده ام :
http://MyWebSite.com/Test2.aspx?ID=5
حال تصمیم دارم تا از مقدار این ID برای فیلتر Data View در صفحه Test2.aspx استفاده کنم. برای اینکار نیاز دارم تا عدد 5 رو از URL ارسال شده از صفحه قبل بخونم و فیلتر رو انجام بدم. برای اینکار یک پارامتر از نوع Query String ایجاد می کنم و مقدار Query String Variable آنرا به صورت ID وارد می کنم.(شکل زیر)

​

اکنون پس از OK کردن پنجره به بخش Filter Criteria مراجعه و فیلتر رو به صورت زیر برای Data View تنظیم می کنم :

​

حال هر زمان که URL صفحه با مقادیر مختلف برای ID وارد صفحه شامل Data View شود، Data View به صورت خودکار مقدار موجود در ID رو توسط پارامتر Query String از URL صفحه خونده و فیلتر شما رو اعمال می کند!
4- پارامتر از نوع Server Variable :
یکی دیگر از پارامترهای مهم جهت فیلتر کردن Data View ها پارامتر از نوع Server Variable می باشد. این پارامتر هم مانند سایر پارامترها عمل می کند، با این تفاوت که مقادیری که برای آن تنظیم می کنید باید از مقادیر معتبر و تعریف شده در IIS سرور باشد. تعدادی از این مقادیر که کاربرد بیشتری دارند در جدول زیر آورده شده اند : (برای دریافت اطلاعات بیشتر در مورد انواع Server Variable ها به این آدرس مراجعه کنید.)
[TABLE]
[TR]
[TD]

Descriptions​

[/TD]
[TD] Variable
[/TD]
[/TR]
[TR]
[TD] Returns the raw authenticated user name
[/TD]
[TD] AUTH_USER
[/TD]
[/TR]
[TR]
[TD] Returns the server address on which the request came in
[/TD]
[TD] LOCAL_ADDR
[/TD]
[/TR]
[TR]
[TD] Returns the Windows account that the user is logged into
[/TD]
[TD] LOGON_USER
[/TD]
[/TR]
[TR]
[TD] Returns the base portion of the URL
[/TD]
[TD] URL
[/TD]
[/TR]
[TR]
[TD] The authentication method that the server uses to validate users
[/TD]
[TD] AUTH_TYPE
[/TD]
[/TR]
[TR]
[TD] Returns the raw, encoded URL, for example, "/vdir/default.asp?querystring"
[/TD]
[TD] HTTP_URL
[/TD]
[/TR]
[TR]
[TD] The server's host name, DNS alias, or IP address as it would appear in self-referencing URLs
[/TD]
[TD] SERVER_NAME
[/TD]
[/TR]
[/TABLE]

[TABLE]
[TR]
[TD]

Descriptions​

[/TD]
[TD] Variable
[/TD]
[/TR]
[TR]
[TD] Returns the raw authenticated user name
[/TD]
[TD] AUTH_USER
[/TD]
[/TR]
[TR]
[TD] Returns the server address on which the request came in
[/TD]
[TD] LOCAL_ADDR
[/TD]
[/TR]
[TR]
[TD] Returns the Windows account that the user is logged into
[/TD]
[TD] LOGON_USER
[/TD]
[/TR]
[TR]
[TD] Returns the base portion of the URL
[/TD]
[TD] URL
[/TD]
[/TR]
[TR]
[TD] The authentication method that the server uses to validate users
[/TD]
[TD] AUTH_TYPE
[/TD]
[/TR]
[TR]
[TD] Returns the raw, encoded URL, for example, "/vdir/default.asp?querystring"
[/TD]
[TD] HTTP_URL
[/TD]
[/TR]
[TR]
[TD] The server's host name, DNS alias, or IP address as it would appear in self-referencing URLs
[/TD]
[TD] SERVER_NAME
[/TD]
[/TR]
[/TABLE]

به عنوان مثال شما می توانید با انتخاب ServerVariable از نوع LOGON_USER نام کاربریِ شخصی که وارد صفحه شده است را دریافت کنید و جهت فیلتر کردن Data View به عنوان پارامتر از آن استفاده نمایید.(شکل زیر)

​

به نقل از pspcommunity.org ، نویسنده آرش آقاجانی