[方法] コンテンツソースのクロールスケジュールをプログラムで構成する

[アーティクル]
06/15/2015

Microsoft Office SharePoint Server 2007 でのエンタープライズ検索では、検索サービスの共有サービスプロバイダ (SSP) に対して構成するコンテンツソースにより、検索インデックスサービスがクロールするコンテンツを指定します。エンタープライズ検索の管理オブジェクトモデルを使用して、SSP のコンテンツソースコレクションに新しいコンテンツソースを追加できます。詳細については、「[方法] コンテンツソースを追加する」を参照してください。

コンテンツのコンテンツソースを追加することは、作業の一部にすぎません。コンテンツをコンテンツインデックスに含めるには、検索インデックスコンポーネントがコンテンツを実際にクロールすることも必要です。

[ContenSource] クラスの適切なメソッドを呼び出すことで、コンテンツソースのサイト全体のクロールまたは増分クロールを手動で開始したり、クロールの一時停止、再開、停止を行ったりできます。詳細については、「[方法] コンテンツソースのクロールをプログラム的に管理する」を参照してください。

ただし、コンテンツソースのコンテンツを継続して定期的にクロールする必要がある場合は、クロールスケジュールを設定することをお勧めします。これは、エンタープライズ検索管理オブジェクトモデルを使用して行うこともできます。

以下の手順では、次の方法を説明します。

エンタープライズ検索管理オブジェクトモデルを使用するコンソールアプリケーションをセットアップします。
[WeeklySchedule] クラスを使用して、コンテンツソースのサイト全体クロールのスケジュールを構成します。
[DailySchedule] クラスを使用して、コンテンツソースの増分クロールのスケジュールを構成します。

エンタープライズ検索管理オブジェクトモデルを使用するようにアプリケーションをセットアップするには

次の DLL に対する参照をアプリケーションに設定します。
- Microsoft.SharePoint.dll
- Microsoft.Office.Server.dll
- Microsoft.Office.Server.Search.dll
コンソールアプリケーションのクラスファイルで、他の名前空間ディレクティブを含むコードの先頭付近に次の using ステートメントを追加します。
```
using Microsoft.SharePoint;
using Microsoft.Office.Server.Search.Administration;
```

利用状況情報をコンソールウィンドウに書き出す関数を作成します。

private static void Usage()
{
Console.WriteLine("Manage Content Source Crawl Status");
Console.WriteLine("Usage: ManageCrawlStatus.exe <ContentSource>");
Console.WriteLine("<ContentSourceName> - Specify the content source name.");
}

コンソールアプリケーションの Main() 関数で、args[] パラメータ内のアイテム数をチェックするコードを追加します。1 より小さい場合は、コンテンツソースを識別する値が指定されていないことを意味するので、手順 3 で定義した Usage() 関数を呼び出します。
```
if (args.Length < 1 )
{
   Usage();
   return;
}
```

手順 4 のコードに続いて、SSP の検索コンテキストを取得する次のコードを追加します。

/*
Replace <SiteName> with the name of a site using the SSP
*/
string strURL = "http://<SiteName>";
SearchContext context;
using (SPSite site = new SPSite(strURL))
{
    Context = SearchContext.GetContext(site);
}

DailySchedule クラスを使用してクロールスケジュールを作成するには

DailySchedule クラスのインスタンスを作成します。
```
DailySchedule daily = new DailySchedule(context);
```

コンテンツソースのクロールを開始するとき、およびクロールの頻度を指定するには、DailySchedule プロパティを構成します。次に例を示します。

//Indicates the schedule starts on the 15th day of the month.
daily.BeginDay = 15;
//Indicates the schedule starts in January.
daily.BeginMonth = 1;
//Indicates that the schedule starts in 2007.
daily.BeginYear = 2007;
//The next two lines of code indicate that the schedule starts at 2:30 in the morning.
daily.StartHour = 2;
daily.StartMinute = 30;
//Indicates that the content should be crawled every day.
daily.DaysInterval = 1;

SSP の検索サービスに対して構成されているコンテンツソースのコレクションを取得します。
```
Content sspContent = new Content(context);
ContentSourceCollection sspContentSources = sspContent.ContentSources;
```

WeeklySchedule クラスを使用してクロールスケジュールを作成するには

WeeklySchedule クラスのインスタンスを作成します。
```
WeeklySchedule weekly= new WeeklySchedule(context);
```

コンテンツソースのクロールを開始するとき、およびクロールの頻度を指定するには、WeeklySchedule プロパティを構成します。次に例を示します。

//Indicates the schedule starts on the 1st day of the month.
weekly.BeginDay = 1;
//Indicates the schedule starts in January.
weekly.BeginMonth = 1;
//Indicates that the schedule starts in 2007.
weekly.BeginYear = 2007;
//The next two lines of code indicate that the schedule starts at 11:15 at night.
weekly.StartHour = 23;
weekly.StartMinute = 15;
//Indicates that the content should be crawled every week.
weekly.WeeksInterval = 1;

新しいスケジュールを使用するようにコンテンツソースを構成するには

args[0] パラメータで指定されている値を取得し、SSP のコンテンツソースコレクションにその名前のコンテンツソースが含まれることを確認します。
```
string strContentSourceName = args[0];
if(sspContentSources.Exists(strContentSourceName) )
{
   <…>
}
else 
{
   Console.WriteLine("Content source does not exist.");
}
```
指定されている名前のコンテンツソースを取得し、FullCrawlSchedule プロパティおよび IncrementalCrawlSchedule プロパティに新しいスケジュールを設定します。
```
ContentSource cs = sspContentSources[strContentSourceName];
cs.IncrementalCrawlSchedule = daily;
cs.FullCrawlSchedule = weekly;
cs.Update();
```

例

以下に、このトピックで説明したサンプルコンソールアプリケーションの完全なコードを示します。

前提条件

共有サービスプロバイダが既に作成されていることを確認します。

プロジェクト参照

このサンプルを実行する前に、コンソールアプリケーションコードプロジェクトに以下のプロジェクト参照を追加します。

Microsoft.SharePoint
Microsoft.Office.Server
Microsoft.Office.Server.Search

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.SharePoint;
using Microsoft.Office.Server.Search.Administration;

namespace ManageCrawlStatus
{
    class Program
    {
        static void Main(string[] args)
        {
            try
            {
                if (args.Length < 1)
                {
                    Usage();
                    return;
                }
                /*
                    Replace <SiteName> with the name of a site using the Shared Services Provider
                */
                string strURL = "http://<SiteName>";
                SearchContext context;
                using (SPSite site = new SPSite(strURL))
                {
                    Context = SearchContext.GetContext(site);
                }

                DailySchedule daily = new DailySchedule(context);
                //Indicates the schedule starts on the 15th day of the month.
                daily.BeginDay = 15;
                //Indicates the schedule starts in January.
                daily.BeginMonth = 1;
                //Indicates that the schedule starts in 2007.
                daily.BeginYear = 2007;
                //The next two lines of code indicate that the schedule starts at 2:30 in the morning.
                daily.StartHour = 2;
                daily.StartMinute = 30;
                //Indicates that the content should be crawled every day.
                daily.DaysInterval = 1;
                WeeklySchedule weekly = new WeeklySchedule(context);
                //Indicates the schedule starts on the 1st day of the month.
                weekly.BeginDay = 1;
                //Indicates the schedule starts in January.
                weekly.BeginMonth = 1;
                //Indicates that the schedule starts in 2007.
                weekly.BeginYear = 2007;
                //The next two lines of code indicate that the schedule starts at 11:15 at night.
                weekly.StartHour = 23;
                weekly.StartMinute = 15;
                //Indicates that the content should be crawled every week.
                weekly.WeeksInterval = 1;

                string strContentSourceName = args[0];
                Content sspContent = new Content(context);
                ContentSourceCollection sspContentSources = sspContent.ContentSources;

                if (sspContentSources.Exists(strContentSourceName))
                {
                    ContentSource cs = sspContentSources[strContentSourceName];
                    cs.IncrementalCrawlSchedule = daily;
                    cs.FullCrawlSchedule = weekly;
                    cs.Update();
                }
                else
                {
                    Console.WriteLine("Content source does not exist.");
                }
            }

            catch (Exception e)
            {
                e.ToString();
            }
        }

        private static void Usage()
        {
            Console.WriteLine("Configure Crawl Schedule");
            Console.WriteLine("Usage: ConfigureCrawlSchedule.exe <ContentSourceName>");
            Console.WriteLine("<ContentSourceName> - Specify the content source name.");
        }
    }
}

次の方法で共有

[方法] コンテンツソースのクロールスケジュールをプログラムで構成する

エンタープライズ検索管理オブジェクトモデルを使用するようにアプリケーションをセットアップするには

DailySchedule クラスを使用してクロールスケジュールを作成するには

WeeklySchedule クラスを使用してクロールスケジュールを作成するには

新しいスケジュールを使用するようにコンテンツソースを構成するには

例

前提条件

プロジェクト参照

See Also

タスク

概念

その他のリソース

次の方法で共有

[方法] コンテンツ ソースのクロール スケジュールをプログラムで構成する

エンタープライズ検索管理オブジェクト モデルを使用するようにアプリケーションをセットアップするには

DailySchedule クラスを使用してクロール スケジュールを作成するには

WeeklySchedule クラスを使用してクロール スケジュールを作成するには

新しいスケジュールを使用するようにコンテンツ ソースを構成するには

例

前提条件

プロジェクト参照

See Also

タスク

概念

その他のリソース

[方法] コンテンツソースのクロールスケジュールをプログラムで構成する

エンタープライズ検索管理オブジェクトモデルを使用するようにアプリケーションをセットアップするには

DailySchedule クラスを使用してクロールスケジュールを作成するには

WeeklySchedule クラスを使用してクロールスケジュールを作成するには

新しいスケジュールを使用するようにコンテンツソースを構成するには