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: [more]

Microsoft Windows SharePoint Services je univerzální technologie, která umožňuje organizacím a obchodním jednotkám všech velikostí zvýšit efektivitu obchodních procesů a zlepšit produktivitu týmů. Díky nástrojům pro spolupráci, které uživatelům umožňují zůstat připojeni i za geografickými hranicemi a hranicemi organizace, poskytuje služba Windows SharePoint Services uživatelům přístup k informacím, které potřebují.

http://www.microsoft.com/cze/office/technologies/sharepointtechnology/highlights.mspx

 

V Sharepointu existují knihovny dokumentů specializované pro galerie obrázků/fotek:

Toto rozšíření načítá z této galerie obrázky přes vlastní webservices, která řeší logiku povolení/zákazu přístupu k této galerii obrázku. U každé galerie je možné externí přístup aktivovat v menu Akce:

Menu je dvoustavové, pokud tedy přístup aktivujete, zobrazí se v menu deaktivace (to je realizováno formou CustomAction ve WebControl):

Po povolení přístupu bude galerie ihned dostupná v BlogEngine.NET:

 

V galerii je, už jak titulek tohoto postu napovídá, implementovaný Lightbox 2:

Pokud aktivujete více galerií, jsou zobrazeny na této stránce všechny, seřazeny podle data vytvoření sestupně.

Jednotlivé galerie lze vkládat i do samotného postu, stačí na to jednoduchý zápis přímo do těla postu (je v obrázku, aby se mi také nepřidala galerie):

Stačí tedy copy&paste relativní url adresy k dané SITE.

Není to hezké? 🙂

 

Při inline galerii stále platí, že je použit Lightbox stejně jako na stránce zobrazující všechny galerie, galerie také musí být povolena /bez povolení nebude galerie otevřena/.

Klíčové vlastnosti

  • zobrazuje galerie načítané z Sharepointu
  • skutečná adresa WSS portálu není nikde vidět, obrázky načítá speciální handler
  • obrázky mají primitivní cache na straně BlogEngine v handleru (ten provádí i resizing)
  • zobrazují se pouze explicitně povolené galerie, jiné nejsou dostupné
  • pro zobrazení je použit Lightbox 2
  • demo je na tomto webu
  • dávám k tomu i zdrojové kódy 🙂

Do budoucna bych chtěl přidat i knihovny dokumentů.

Zdrojové kódy

http://www.pavelnovotny.info/public/BlogEngineExtensions.zip

Budete potřebovat Visual Studio 2008 + WSP Builder

Demo

Demo je přímo na tomto webu zde:

http://www.pavelnovotny.info/SharepointExtensions/Gallery.aspx

Ukázka inline galerie je zde:

OFFLINE


Instalace

Nejprve je nutné provést deploy WSP balíčku na Sharepoint server, k tomu jsem připravil dávku „DeploySolutionPackage.cmd“, v té je potřeba změnit akorát url adresu.  Po úspěšné instalaci feature je nutné jí aktivovat na úrovní SITE kolekce:

Hotovo! 🙂 Pokud se teď přesunete do jakékoliv galerie, uvidíte v menu akci pro povolení přístupu z BlogEngine.NET:

Následuje instalace rozšíření do BlogEngine.NET, to je opět jednoduché, stačí kompletní obsah <BlogEngineExtension.zip\BlogEngine> zkopírovat do rootu Vaší aplikace BlogEngine.

Po přihlášení do administrace bude v záložce Extensions nové rozšíření:

Před prvním použitím je nutné toto rozšíření ještě nakonfigurovat, do následující stránky je nutné vložit URL adresu SITE Vašeho Sharepoint portálu.

POZOR: uživatelské jméno ani heslo není nutné vyplňovat, pokud aplikace BlogEngine.NET beží pod účtem uživatele, který má do daného webu přístup. Pokud nemá, počítače například nejsou ve stejné doméně, je nutné specifikovat uživatele ručně /toto řešení je vhodné pouze a jen ve vývojovém prostředí, za každou cenu se vyhněte vyplnění hesla na hostingu !!!/.

I v případě, že máte obě aplikace na stejném severu a nemusíte tedy heslo vyplňovat, důrazně doporučuji použít pro pool nového uživatele, tomu povolit přístup pouze do jednoho webu, určeného pouze pro externí obsah, tedy nikoliv použít uživatele, který může přistupovat do všech webů!!! A i v tomto jednom webu nastavit práva uživatele pouze pro čtení! Nezapomeňte však povolit čtení i na skrytém listu pro konfigurace „/Lists/BlogEngineExtensionLists/AllItems.aspx“

V neposlední řadě si do menu skinu přidejte položku pro zobrazení všech galerii:

<li><a href=“~/SharepointExtensions/Gallery.aspx“ runat=“server“>Galerie</a></li>

 

Kompletní balík včetně zdrojových kódů je zde:

http://www.pavelnovotny.info/public/BlogEngineExtensions.zip

WSS: The site is too large to save as a template. The size of a template cannot exceed 10485760 bytes.

Chyba:

The site is too large to save as a template. The size of a template cannot exceed 10485760 bytes.

Řešení:

Standardně je nastavena maximální velikost šablony SITE/LISTu na 10 MB, v reálném světě je to velice málo a je potřeba nastavit vyšší hodnotu pomocí příkazu:

[more]

stsadm -o setproperty -propertyname max-template-document-size -propertyvalue 104857600

Tento příkaz nastaví maximální velikost templatu na 100MB, maximální nastavitelná hodnota je 500MB.

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)

Zobrazení call stack při chybě

Sharepoint standardně při vzniku exception zobrazuje pouze její message, nikoliv i kompletní call stack, pro zobrazení všech detailů je potřeba modifikovat web.config následovně:

 

<customErrors mode="Off" />

<compilation debug="true">

 a ještě:

<SafeMode MaxControls="200" CallStack="true" DirectFileDependencies="10" TotalFileDependencies="50" AllowPageLevelTrace="false">

nebo ještě lepší způsob je mofikace systémovými prostředky Sharepointu, tedy prostředníctvím objektu SPWebConfigModification:

SPWebApplication webApp = siteCollection.WebApplication;
SPWebConfigModification callStackModification = 
     new SPWebConfigModification("CallStack", "configuration/SharePoint/SafeMode");
callStackModification.Value = "true";
callStackModification.Owner = typeof(Program).FullName;
callStackModification.Sequence = 0;
callStackModification.Type = 
     SPWebConfigModification.SPWebConfigModificationType.EnsureAttribute;
SPWebConfigModification customErrorsModification = 
     new SPWebConfigModification("mode", "configuration/system.web/customErrors");
customErrorsModification.Value = "Off";
customErrorsModification.Owner = typeof(Program).FullName;
customErrorsModification.Sequence = 1;
customErrorsModification.Type = 
     SPWebConfigModification.SPWebConfigModificationType.EnsureAttribute;
SPWebConfigModification debugModification = 
     new SPWebConfigModification("debug", "configuration/system.web/compilation");
debugModification.Value = "true";
debugModification.Owner = typeof(Program).FullName;
debugModification.Sequence = 2;
debugModification.Type = 
     SPWebConfigModification.SPWebConfigModificationType.EnsureAttribute;
webApp.WebConfigModifications.Add(callStackModification);
webApp.WebConfigModifications.Add(customErrorsModification);
webApp.WebConfigModifications.Add(debugModification);
webApp.Farm.Services.GetValue<SPWebService>().ApplyWebConfigModifications();
webApp.Update();