Menambahkan deskriptor filter ke metode Finder

Pendeskripsi filter memungkinkan konsumen model meneruskan nilai ke metode sebelum dijalankan. Untuk informasi selengkapnya, lihat Mendesain model konektivitas data bisnis.

Salah satu skenario umum adalah bahwa pengguna di SharePoint ingin mengambil instans jenis konten eksternal yang cocok dengan beberapa kriteria. Anda dapat mendukung skenario ini dengan menambahkan pendeskripsi filter ke metode Finder.

Untuk menambahkan pendeskripsi filter ke metode Finder

1. Pada jendela Detail Metode BDC, perluas node metode Finder, perluas node Parameter, lalu tambahkan parameter input. Untuk informasi selengkapnya, lihat Petunjuk: Menambahkan parameter ke metode.

2. Di jendela Detail Metode, pilih pendeskripsi jenis parameter.

3. Pada bilah menu, pilih Tampilkan> Jendela Properti.

4. Di jendela Properti, atur properti Nama Jenis ke tipe data yang sesuai untuk filter.

   Misalnya, filter mungkin menggunakan tanggal pesanan untuk membatasi jumlah pesanan penjualan yang dikembalikan oleh metode. Untuk mendukung filter tersebut, properti Nama Jenis dari pendeskripsi jenis harus diatur ke System.DateTime.

5. Di jendela Detail Metode, perluas node Deskriptor Filter.

6. Pada daftar Tambahkan Pendeskripsi Filter, pilih Buat Pendeskripsi Filter.

   Pendeskripsi filter baru muncul di bawah node Pendeskripsi Filter.

7. Pada bilah menu, pilih Tampilkan> Jendela Properti.

8. Di jendela Properti, pilih properti Jenis.

9. Dalam daftar yang muncul untuk properti Jenis, pilih pola pemfilteran yang Anda inginkan.

   Misalnya, untuk membuat filter yang menggunakan tanggal pesanan untuk membatasi jumlah pesanan penjualan yang dikembalikan dalam metode Finder, pilih Perbandingan. Filter Perbandingan memastikan bahwa metode pencari hanya mengembalikan instans yang memenuhi kondisi tertentu. Untuk informasi selengkapnya tentang setiap pola pemfilteran, lihat Jenis Filter yang Didukung oleh BDC.

10. Di jendela Properti, pilih properti Pendeskripsi Jenis Terkait.

11. Dalam daftar yang muncul untuk properti Pendeskripsi Tipe Terkait, pilih pendeskripsi jenis yang Anda buat sebelumnya dalam prosedur ini. Ini berkaitan dengan filter ke parameter input metode Finder.

12. Tambahkan kode ke metode Finder yang mengembalikan data. Anda bisa menggunakan parameter input sebagai kondisi dalam kueri pilihan.

    Contoh berikut mengembalikan pesanan penjualan yang memiliki tanggal pesanan yang ditentukan.

    Catatan

    Ganti nilai bidang ServerName dengan nama server Anda.

    C#

    public static IEnumerable<SalesOrderHeader> ReadList(DateTime OrderDateParam)
    {
        const string ServerName = "MySQLServerName";
        AdventureWorksDataContext dataContext = new AdventureWorksDataContext
              ("Data Source=" + ServerName + ";" +
               "Initial Catalog=AdventureWorks;Integrated Security=True");
    
        DateTime NoValuePassedIn = Convert.ToDateTime("1/1/1900 12:00:00 AM");
        DateTime DefaultDateTime = Convert.ToDateTime("2001-09-01 00:00:00.000");
    
        // If the user does not provide a value for the filter.
        if (OrderDateParam == NoValuePassedIn)
        {
            // Use a default date time value.
            OrderDateParam = DefaultDateTime;
        }
    
        IEnumerable<SalesOrderHeader> SalesOrderHeader =
            from salesOrderHeaders in dataContext.SalesOrderHeaders
            where salesOrderHeaders.OrderDate == OrderDateParam
            select salesOrderHeaders;
        return SalesOrderHeader;
    }
    

    VB

    Public Shared Function ReadList(ByVal OrderDateParam As DateTime) As IEnumerable(Of SalesOrderHeader)
        Const ServerName As String = "MySQLServerName"
        Dim dataContext As AdventureWorksDataContext = _
            New AdventureWorksDataContext("Data Source=" & ServerName & _
                ";Initial Catalog=AdventureWorks;Integrated Security=True")
    
        Dim NoValuePassedIn As DateTime = Convert.ToDateTime("1/1/1900 12:00:00 AM")
        Dim DefaultDateTime As DateTime = Convert.ToDateTime("2001-09-01 00:00:00.000")
    
        ' If the user does not provide a value for the filter.
        If OrderDateParam = NoValuePassedIn Then
            ' Use a default date time value.
            OrderDateParam = DefaultDateTime
        End If
    
        Dim SalesOrderHeader As IEnumerable(Of SalesOrderHeader) = _
            From SalesOrderHeaders In dataContext.SalesOrderHeaders _
            Where SalesOrderHeaders.OrderDate = OrderDateParam _
            Select SalesOrderHeaders
        Return SalesOrderHeader
    End Function
    

Konten terkait

• Cara: Menambahkan metode Finder
• Cara: Menambahkan metode Finder tertentu
• Petunjuk: Menambahkan parameter ke metode
• Cara: Menentukan pendeskripsi tipe parameter
• Mendesain model konektivitas data bisnis
• Mengintegrasikan data bisnis ke SharePoint