PSPCommunity.org ورود | ثبت نام | كمك

آرش آقاجانی (Arash Aghajani)

Technical Persian Blog Focus on Microsoft SharePoint Products and Technologies

اخبار

بيشترين بازديد شده

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

اگر از شیرپوینت دیزاینر استفاده کرده باشید، زمانیکه تصمیم دارید تا بر روی 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 ها به این آدرس مراجعه کنید.)

Descriptions

Variable

Returns the raw authenticated user name

AUTH_USER

Returns the server address on which the request came in

LOCAL_ADDR

Returns the Windows account that the user is logged into

LOGON_USER

Returns the base portion of the URL

URL

The authentication method that the server uses to validate users

AUTH_TYPE

Returns the raw, encoded URL, for example, "/vdir/default.asp?querystring"

HTTP_URL

The server's host name, DNS alias, or IP address as it would appear in self-referencing URLs

SERVER_NAME

Descriptions

Variable

Returns the raw authenticated user name

AUTH_USER

Returns the server address on which the request came in

LOCAL_ADDR

Returns the Windows account that the user is logged into

LOGON_USER

Returns the base portion of the URL

URL

The authentication method that the server uses to validate users

AUTH_TYPE

Returns the raw, encoded URL, for example, "/vdir/default.asp?querystring"

HTTP_URL

The server's host name, DNS alias, or IP address as it would appear in self-referencing URLs

SERVER_NAME

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

 

امیدوارم مطالب فوق برای شما مفید باشد.

اگر سوالی داشتید حتماً در بخش نظرات مطرح کنید.

شاد و موفق باشید... Wink

 

 
Posted: Monday, February 16, 2009 2:18 PM توسط Arash

نظرات

Emad گفته:

مفيد بود. سپاس از تلاش شما!

# July 26, 2009 10:41 PM

حامد چهزه ساز گفته:

با تشکر از مطلب خوب شما

متاسفانه در صفحه من textbox نمی تواند مقدار خود را نگه داشته و برای فیلتر به dataview بفرستد.

من این مشکل را در dropdown ندارم.

لطفا مرا راهنمایی کنید که مشکل چیست.

ممنون

# October 4, 2009 12:23 PM
نظرات افراد ناشناس غير فعال مي باشد