Przykład: dodatek plug-in ogólnego dostawcy danych tabel wirtualnych

Pokazy

W tym przykładzie przedstawiono minimalną implementację ogólnego wtyczki dostawcy danych tabeli wirtualnej Microsoft Dataverse, DropboxRetrieveMultiplePlugin dla usługi udostępniania plików Dropbox . Używa podejścia "bare metal", tłumacząc QueryExpression przez utworzenie niestandardowej klasy odwiedzającej, DropBoxExpressionVisitor. Zwraca kolekcję plików, które spełniają kryteria wyszukiwania jako EntityCollection.

Wprowadzenie

Aby skompilować ten przykład, należy najpierw zainstalować pakiety NuGet Dropbox.Api i Microsoft.CrmSdk.Data. Będziesz również potrzebować konta Dropbox i podać rzeczywisty token dostępu podczas tworzenia instancji DropboxClient.

Dodaj następujące instrukcje using do kodu:

using Microsoft.Xrm.Sdk;
using Microsoft.Xrm.Sdk.Query;
using Dropbox.Api;
using Dropbox.Api.Files;

Przykładowy kod

public class DropBoxExpressionVisitor : QueryExpressionVisitorBase
{
    public string SearchKeyWords { get; private set; }

    public override QueryExpression Visit(QueryExpression query)
    {
        // Very simple visitor that extracts search keywords
        var filter = query.Criteria;
        if (filter.Conditions.Count > 0)
        {
            foreach (ConditionExpression condition in filter.Conditions)
            {
                if (condition.Operator == ConditionOperator.Like && condition.Values.Count > 0)
                {
                    string exprVal = (string)condition.Values[0];

                    if (exprVal.Length > 2)
                    {
                        this.SearchKeyWords += " " + exprVal.Substring(1, exprVal.Length - 2);
                    }
                }
            }
            return query;
        }
    }
}

public class DropboxRetrieveMultiplePlugin : IPlugin
{
    public void Execute(IServiceProvider serviceProvider)
    {
        var context = (IPluginExecutionContext)serviceProvider.GetService(typeof(IPluginExecutionContext));
        var qe = (QueryExpression)context.InputParameters["Query"];
        if (qe != null)
        {
            var visitor = new DropBoxExpressionVisitor();
            qe.Accept(visitor);
            using (var dbx = new DropboxClient(AccessToken))
            {
                if (visitor.SearchKeyWords != string.Empty)
                {
                    var searchCriteria = new SearchArg(string.Empty, visitor.SearchKeyWords);
                    var task = Task.Run(() => this.SearchFile(dbx, searchCriteria));
                    context.OutputParameters["BusinessEntityCollection"] = task.Result;
                }
            }
        }
    }

    public async Task<EntityCollection> SearchFile(DropboxClient dbx, SearchArg arg)
    {
        EntityCollection ec = new EntityCollection();
        var list = await dbx.Files.SearchAsync(arg);
        foreach (var item in list.Matches)
        {
            if (item.Metadata.IsFile)
            {
                Entity e = new Entity("new_dropbox");
                e.Attributes.Add("new_dropboxid", Guid.NewGuid());
                e.Attributes.Add("new_filename", item.Metadata.AsFile.Name);
                e.Attributes.Add("new_filesize", item.Metadata.AsFile.Size);
                e.Attributes.Add("new_modifiedon", item.Metadata.AsFile.ServerModified);
                ec.Entities.Add(e);
            }
        }
        return ec;
    }
}

Zobacz także

Rozpoczynanie pracy z tabelami wirtualnymi
Zagadnienia dotyczące interfejsu API tabel wirtualnych
Niestandardowi dostawcy danych tabel wirtualnych