Pavel Novotný

.NET Framework, SharePoint, Dynamics CRM, RC Helicopters, Honda VFR CrossRunner

BlogEngine.NET Extension: zobrazení lightbox galerie obrázků získané z Sharepointu (WSS/MOSS)

Úvodem bych chtěl upozornit, že tento post byl v úplném počátku motivován soutěží MSDN - "Dokážeš to", později při vývoji rozšíření jsem si ale uvědomil, že něco takového jsem vlastně stejně potřeboval a v mém případě /možná trošku už šílenství/, kdy Sharepoint používám i pro domácí účely /výpočty příjmů/nákladů domácnosti, daní, katalogu e-books, diskusím v rámci rodiny, sdílení kontaktů atd), se mi velice hodí, protože mohu takto jednoduše bez opuštění domácího portálu publikovat fotografie na internet = a nejen já, ale i další rodinný příslušníci (ty ale radši mají aktivované schvalovací workflow :). Na různých místech kódu je patrné, že jsem si také připravoval půdu pro publikování dokumentů, to jsem do této verze nestihl = což by ale nemuselo této ukázce možné integrace nijak vadit. Tento post se pokusím napsat tak, aby byl pochopitelný i pro neznalce Sharepointu, ale když tak pište.

O čem je Sharepoint nebudu zdlouhavě popisovat a vypůjčím si z webu MS tento odstavec: Více...

MOSS: nastavení práv pro guest uživatele u publishing site

Aby nemohl anonymní uživatel přistupující k publishing site portálu prohlížet všechny listy, formuláře, položky ve standardních formulářích listů WSS, je potřeba pro příslušnou site nastavit práva pro uživatele guest. Nastavit práva je samozřejmě možné přes administraci, lepším a spolehlivějším řešením je určitě takové nastavení provést při aktivaci feature našeho projektu /omezující lidskou chybu/.

internal static void LockDownViewFormPages(SPWeb web)
{
    RunWithWebCulture(web, delegate
    {
        ConfirmNotCentralAdminWebApp(web);
        SPRoleDefinition byType = web.RoleDefinitions.GetByType(SPRoleType.Guest);
        byType.BasePermissions = SPBasePermissions.BrowseDirectories |
                                 SPBasePermissions.Open |
                                 SPBasePermissions.OpenItems |
                                 SPBasePermissions.ViewPages;
        byType.Update();
    });
}

Takto to lze samozřejmě použít i v "pouhém" WSS pro jiné účely/skupiny uživatelů.

Poznámka: SPBasePermissions.BrowseDirectories je potřeba, jinak nejde zjistit default stránka pomocí "PublishingWeb.DefaultPage"

WSS: Hromadné odstranění záznamů v listu

Pokud jste někdy potřebovali kompletně vyprázdnit list/knihovnu dokumentů, určitě jste rychle narazili, stejně jako já, na neexistenci takové funkce. Samozřejmě je možné mazat jednotlivé záznamy v iteraci, to je ale velice časově nákladná operace, kterou nejde použít ani na desítkách záznamů :( Smazání jednoho záznamu trvá klidně i 500ms, 1000 záznamů by se tedy mazalo 5-10 minut.

Nakonec jsem našel trošku krkolomné řešení, které je však řádově rychlejší než mazání v iteraci. Základem celé akce je složení velkého XML balíku hromadného příkazu pro smazání jednotlivých záznamů v jednom volání. Vtip je v tom, že i když toto řešení také iteruje celým seznamem v listu, property ID je u SPListItem už přednačtena v cache Sharepointu, ten tedy nemusí pro každou iteraci sahat do DB, složení tak může proběhnout rychle. Výsledný balík se už jen předhodí enginu WSS, který jej interně zpracuje. Po ukončení ještě v mém případě volám vyprázdnění koše aktuálně přihlášeného uživatele, to samozřejmě není nutné a může být v některých případech i kontraproduktivní při volání pod "real-life" uživatelem.

Pokud existuje lepší cesta, určitě bych se nechal rád inspirovat :)

private static void BatchListItemsDelete(SPList spList)
{
    StringBuilder sbDelete = new StringBuilder();
    sbDelete.Append("<?xml version=\"1.0\" encoding=\"UTF-8\"?><Batch>");
    string command = "<Method><SetList Scope=\"Request\">" + spList.ID +
        "</SetList><SetVar Name=\"ID\">{0}</SetVar><SetVar Name=\"Cmd\">Delete</SetVar></Method>";

    foreach (SPListItem item in spList.Items)
        sbDelete.Append(string.Format(command, item.ID.ToString()));

    sbDelete.Append("</Batch>");

    spList.ParentWeb.ProcessBatchData(sbDelete.ToString());
    spList.ParentWeb.RecycleBin.DeleteAll(); 
}

Zobrazení aktuálních aktivit Microsoft CRM 4 v Sharepointu + zdrojové kódy

Na tomto příspěvku jsem chtěl demonstrovat jednoduchost a vůbec možnost provázání různých aplikací s Sharepointem. Rozhodl jsem se pro vytvoření webparty, zobrazující aktuálně přiřazené a nesplněné aktivity v Microsoft CRM 4, protože to bude určitě užitečná featura pro spoustu lidí využívajících firemní intranet.

Takto vypadá výsledný webpart (po kliknutí na daný předmět aktivity se otevře přímo v editačním okně CRM):

 



Takto jsou zobrazeny aktivity v CRM:

Zdrojové kódy i WSP balíček je přiložen na konci tohoto postu.

Načítání aktivit z CRM serveru probíhá přes webservice, url adresa webové služby je vždy ve formátu:

http://server:port/MSCRMServices/2007/CrmService.asmx

Pokud používáte Visual Studio 2008, je potřeba vygenerovat klientský wrapper až v "Advance" dialogu jako na následujícím screenshotu:

 

Aby bylo možné rozlišit aktuálně používanou organizaci zavedenou v CRM, je potřeba ještě provést nastavení objektu CrmAuthenticationToken jako na následujícím příkladu:

public static CrmService GetCrmService(string crmServerUrl, string organizationName)
        {
            if (string.IsNullOrEmpty(crmServerUrl)) throw new ArgumentNullException("crmServerUrl");
            if (string.IsNullOrEmpty(organizationName)) throw new ArgumentNullException("organizationName");

            CrmSdk.CrmAuthenticationToken token = new CrmSdk.CrmAuthenticationToken();
            token.OrganizationName = organizationName;

            CrmService service = new CrmService();
            UriBuilder builder = new UriBuilder(crmServerUrl);
            builder.Path = "//MSCRMServices//2007//CrmService.asmx";
            service.Url = builder.Uri.ToString();
            
            service.Credentials = System.Net.CredentialCache.DefaultCredentials;
            service.CrmAuthenticationTokenValue = token;

            return service;
        }

 

Aby jsme mohli vyhledat svoje aktivity, je nejprve nutné zjistit identifikátor přihlášeného uživatele:

WhoAmIRequest request = new WhoAmIRequest();
WhoAmIResponse response = (WhoAmIResponse)service.Execute(request);
Guid userId = response.UserId;

Pak už jen stačí vyhledat aktivity s přiřazeným vlastníkem na sebe sama a nastaveným status kódem - open nebo scheduled.

private static BusinessEntityCollection GetAssignedActivities(CrmService crmService, Guid userId)
        {
            // budeme nacitat aktivity prirazene prihlasenemu uzivateli
            ConditionExpression condition = new ConditionExpression();
            condition.AttributeName = "ownerid";
            condition.Operator = ConditionOperator.Equal;
            condition.Values = new object[] { userId };

            // potrebujeme pouze otevrene aktivity
            ConditionExpression condition2 = new ConditionExpression();
            condition2.AttributeName = "statecode";
            condition2.Operator = ConditionOperator.Equal;
            condition2.Values = new object[] { (int)ActivityPointerState.Open };
            ConditionExpression condition3 = new ConditionExpression();
            condition3.AttributeName = "statecode";
            condition3.Operator = ConditionOperator.Equal;
            condition3.Values = new object[] { (int)ActivityPointerState.Scheduled };

            FilterExpression filterState = new FilterExpression();
            filterState.FilterOperator = LogicalOperator.Or;
            filterState.Conditions = new ConditionExpression[] { condition2, condition3 };

            FilterExpression filterRequired = new FilterExpression();
            filterRequired.FilterOperator = LogicalOperator.And;
            filterRequired.Conditions = new ConditionExpression[] { condition };

            FilterExpression filter = new FilterExpression();
            filter.FilterOperator = LogicalOperator.And;
            filter.Filters = new FilterExpression[] { filterRequired, filterState };

            // seradime podle konce aktivity
            OrderExpression order = new OrderExpression();
            order.AttributeName = "scheduledstart";
            order.OrderType = OrderType.Ascending;
            
            // vytvoreni vyhledavaciho dotazu - potrebujeme vsechny aktivity
            QueryExpression query = new QueryExpression();
            query.EntityName = EntityName.activitypointer.ToString();
            query.ColumnSet = new AllColumns();
            query.Criteria = filter;
            query.Orders = new OrderExpression[] { order };

            // vykonani samotneho dotazu
            return crmService.RetrieveMultiple(query);
        }

 

 Následně již stačí vyrenderovat všechny položky do HTML. Prosté, ale dobré :)


Instalace feature:

cd C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\BIN

stsadm -o addsolution -filename crm4connector.wsp

stsadm -o deploysolution -name crm4connector.wsp -immediate -allcontenturls -allowGacDeployment -allowCasPolicies

následně aktivujte feature ve správě webu:

 

Přidejte feature "Activities in CRM" na libovolnou stránku:

 

V nastavení feature je nutné ještě nastavit url adresu serveru s Microsoft CRM 4 a název organizační jednotky: 

(níže je také možné upravit obecné texty podle potřeby - podle aktuálně používaném jazyku)

 

Hotovo, po potvrzení by se měl zobrazit seznam aktivit aktuálně přihlášeného uživatele. Pokud je něco špatně, budete upozorněni:

Ke stažení:

sources.zip (272,14 kb)

bin.zip (244,01 kb)