Ажурирање: An anonymous poster left a great comment about internal names. Be sure to read it.

Кога се работи со настанот приемници и други код кој референци SharePoint листа предмети преку објект модел, Јас често се прават грешки, кои произведуваат оваа грешка за време на извршувањето:

Грешка при вчитувањето и трчање настан приемник Conchango.xyzzyEventReceiver во xyzzy, Верзија = 1.0.0.0, Култура = неутрален, PublicKeyToken = 0dc50a750396c3ac. Additional information is below. : Value does not fall within the expected range.

I think this is a fairly generic error that is potentially caused many different ways. Сепак, one simple explanation is that I’m referencing a field incorrectly. If the name of the field is "Due Date", Морам да го референца како оваа во еден настан приемник:

properties.ListItem["Due Date"]

Кога ќе misspell или користат на погрешен случај кога референцирање на полето, SharePoint generates the above mentioned runtime error. На пример, ова е погрешно:

properties.ListItem["due Date"]

</крајот>

Да се ​​претплатите на мојот блог.

Со цел да работат околу проблемот KPI Напишав за тука, I did some testing and discovered that KPI’s work against folders with meta data in the same way that they work against documents or list items. I proved it out by creating a new content type based on the folder content type and then added a few fields. I created some indicators and proved to myself that KPIs work as expected. This was welcome news. It’s not perfect, because the drill-down you get from the KPI against the folders is not exactly what you want. This isn’t too much a drawback in my case because 1) крајните корисници не знаат кој било подобро и 2) the drill-down goes to a folder. They click the folder name and they are at the item. It’s two clicks instead of one, кој не е крај на светот.

This flowed nicely with the work I was doing. I am creating a folder for every document that gets uploaded. This is done via an event receiver. Како резултат на, тоа е по едно парче торта да се задржи папка за meta data in sync with the KPI-driven meta data from the file itself since the plumbing is already in place. Ова ми овозможува да имам KPI и да ги јадам исто така

I modified the event receiver to add the folder and then set this new folder’s content type to my custom KPI-friendly content type. This bit of code did the trick:

 SPFolderCollection srcFolders = targetWeb.GetFolder("Documents").Потпапки;
  SPFolder addedFolder = srcFolders.Add(properties.ListItem.ID.ToString());

  SPContentTypeId kpiCT = нови SPContentTypeId("0x0120002A666CAA9176DC4AA8CBAA9DC6B4039F");
  addedFolder.Item["Content Type ID"] = KpiCT;
  addedFolder.Item.Update();

Да се ​​лоцираат вистинските Типот на содржина проект, Јас посетена дека типот на содржина преку сајт поставувања и копија / таа пејст од URL-то како што е прикажано:

</крајот>

Да се ​​претплатите на мојот блог!

Јас мразам да го признаат тоа, but I struggled with this one all day. My event receiver needs to update a field of its parent folder. This little bit shows how to do it:

приватни поништат UpdateParentFolder(SPItemEventProperties својства)
{

SPFolder thisItemFolder = properties.ListItem.File.ParentFolder;
thisItemFolder.Item["ZZ Approval Status"] = "Good news, сите!";
thisItemFolder.Item.Update();


} // UpdateParentFolder

Во овој случај, Јас работам со еден документ библиотека и особини се доаѓа од ItemAdded настан.

Трикот е во тоа што не можете да добиете на SPFolder на содржина директно од точка сама по себе (i.e. properties.ListItem.Folder е null). Наместо, одат на поврзани датотеката на елемент во листата и да добијат папка на датотеката.

</крајот>

Да се ​​претплатите на мојот блог!

I’m sure I’m not the first person to come up with this. Сепак, I haven’t noticed anyone publish a trick like this since I started paying close attention to the community last July. Така, Мислев дека ќе ја објавите тоа на овој брз и лесен дебагирање врв.

Јас работам на еден настан приемник кој започна да се генерира оваа грешка во 12 кошница:

Грешка при вчитувањето и трчање настан приемник Conchango.xyzzyEventReceiver во xyzzy, Верзија = 1.0.0.0, Култура = неутрален, PublicKeyToken = blahbalhbalh. Additional information is below. : Референца на објект не е поставена на пример на објект.

I didn’t know where I had introduced this bug because I had done too many things in one of my code/deploy/test cycles.

Се обидов ова решение да се добие ми ППБ таму со надеж дека SharePoint е 12 кошница ќе се покаже на стекот, but no luck. I don’t know if it’s possible and if someone does, молам да ме известите 🙂

Знам дека е можно да се напишете своја сопствена пораки од дневникот на 12 кошница. Frankly, Сакав нешто малку помалку страшно и побрзо да се имплементираат.

Тоа се случи да ме дека јас барем би можеле да добијат некои основни трага информации од фаќање и ре-фрлање генерички исклучоци како овој:

  обидете {
    UpdateEditionDate(својства);
  }
  фати (Исклучок д)
  {
    фрли нови Исклучок("Dispatcher, UpdateEditionDate(): Исклучок: [" + e.ToString() + "].");
  }

Ова се појавил во 12 кошница thusly:

Грешка при вчитувањето и трчање настан приемник Conchango.xyzzyEventReceiver во xyzzy, Верзија = 1.0.0.0, Култура = неутрален, PublicKeyToken = blahblahblah. Additional information is below. : Диспечер, UpdateEditionDate(): Исклучок: [System.NullReferenceException: Референца на објект не е поставена на пример на објект. at Conchango.xyzzyManagementEventReceiver.UpdateEditionDate(SPItemEventProperties својства) at Conchango.xyzzyManagementEventReceiver.Dispatcher(SPItemEventProperties својства, Стринг eventDescription)].

Кој ми даде сите детали ми требаше да ги пратите во воспоставувањето дека посебен проблем и јас очекувам да го користат многу оди напред.

</крајот>

Да се ​​претплатите на мојот блог!

This past week I was implementing an "evolving" solution for a client that uses BDC and SPQuery and ran into some difficulty using SPQuery against a document library containing folders. Крајна линија: assign "recursive" на погледот атрибут на барањето.

Моето сценарио:

• Во понеделник, Јас испратите документот и снабдување со некои мета податоци.
• На следната недела, I upload a new document. Much of this new document’s meta data is based on the document I uploaded on Monday (which we call the "master document").
• Ние направивме веб сервис фасада која обезбедува ЦРБ-friendly интерфејс на листата, така што корисниците можат лесно да се лоцира кој документ понеделник преку насловот пребарување.
• A BDC data column provides a friendly user interface. (Ова е дел од мојот обид за користење на ЦРБ за повеќе пријателски Пронајди колона).

Конечниот ЦРБ фасада сервис користи за пребарување како ова да го стори пребарување:

 // Користи U2U алатка за да им помогне во генерирање на оваа CAML пребарување.
      oQuery.Query =
        "<Каде>";

      ако (titleFilter.Length > 0)
        oQuery.Query   =
          "  <И>";

      oQuery.Query   =
        "    <И>" +
        "      <Geq>" +
        "        <FieldRef Name=\"DocumentId\" />" +
        "        <Value Type=\"Text\">" + MinID + "</Вредност>" +
        "      </Geq>" +
        "      <Leq>" +
        "        <FieldRef Name=\"DocumentId\" />" +
        "        <Value Type=\"Text\">" + maxId + "</Вредност>" +
        "      </Leq>" +
        "    </И>";

      ако (titleFilter.Length > 0)
        oQuery.Query   =
          "    <Содржи>" +
          "      <FieldRef Name=\"Title\" />" +
          "      <Value Type=\"Text\">" + titleFilter + "</Вредност>" +
          "    </Содржи>" +
          "  </И>";
      oQuery.Query   =
        "</Каде>";

Во текот на почетната фаза на развој, this worked great. Сепак, воведовме папки во директориумот за решавање на некои проблеми и одеднаш, my BDC picker wouldn’t return any results. I tracked this down to the fact that the SPQuery would never return any results. We used folders primarily to allow multiple files with the same name to be uploaded but with different meta data. When the file is uploaded, ние се создаде папка врз основа на проект на елемент во листата и потоа се пресели на датотека таму (Напишав за тоа тука; имавме мешани резултати со овој пристап, но во целина, тоа е работа добро). The user don’t care about folders and in fact, don’t really understand that there are any folders. We have configured all the views on the library to show items without regard to folders.

I hit this problem twice as the technical implementation evolved and solved it differently each time. The first time, I wasn’t using the CONTAINS operator in the query. Without a CONTAINS operator, I was able to solve the problem by specifying the view on the SPQuery’s contructor. Instead of using the default constructor:

SPList oList = web.Lists["Documents"];

SPQuery oQuery = нови SPQuery();

Јас наместо да се користи конструктор дека одреден поглед:

SPList oList = web.Lists["Documents"];

SPQuery oQuery = нови SPQuery(oList.Views["All Documents"]);

Дека се реши проблемот и јас почнав да се добие моите резултати.

I then added the CONTAINS operator into the mix and it broke again. It turns out that the CONTAINS operator, толку колку што можам да кажам, не работи со поглед на ист начин како и поедноставно GEQ / LEQ operators. I did some searching and learned that the query’s ViewAttributes should be set to "Recursive", како и во:

oQuery.ViewAttributes = "Scope=\"Recursive\"";

That solved the problem for CONTAINS. Всушност, ова исто така реши мојот оригинален пребарување проблемот и ако имав наведени на рекурзивен атрибут прв пат, Јас не би се кандидира во прашање повторно.

Фактот дека цел-базирани SPQuery работи за некои оператори (GEQ/LEQ) а други не (СОДРЖИ), заедно со фактот дека KPIs се чини, не да работат на сите со папка содржат документ библиотеки ме тера да верувам дека SPQuery има некои orthogonality прашања.

Посебна благодарност:

• Добрата луѓе во U2U и нивната алатка за пребарување.
• Мајкл Hoffer е одлично "учење преку правење" блог пост, коментари и одговори.

</крајот>

Да се ​​претплатите на мојот блог!

Ажурирање 02/29/08: I solved this problem by creating a folder and then assigning a content type to the folder which has the meta data I need for the KPIs. Јас опишани дека во малку повеќе детали тука.

We have implemented a technical solution where users upload documents to a document library. An event receiver creates a directory and moves the file to that directory (користење на техника слична на она што сум го напишала за тука). We’ve successfully navigated around the potential issues caused by event receivers that rename uploaded files (mainly because users never start their document by clicking on "New" но наместо тоа, се создаде документи на локално ниво и потоа да ги испратите).

The meta data for these documents includes a Yes/No site column called "Urgent" and another site column called "Status". We need to meet a business requirement that shows the percentage of "Urgent" documents whose status is "Pending".

Ова е обично едноставно да се направи и јас опишани нешто многу слично како оваа на Бигл SharePoint со многу снимки на екранот, ако сте заинтересирани.

Во мало, Го направив следниве:

• Create a view on the doc library called "Pending".
• Конфигурирате цел да се игнорираат структурата на папката.
• Креирај Листа KPI.
• Create an indicator in the list that points to the doc lib and that "Pending" видите.

This simply does not work. The KPI shows my target (e.g. пет помали итни документи) but always shows the actual number of urgent documents as zero. Paradoxically, ако разбивка на детали, it shows the five urgent documents in the list. I created a very simple scenario with two documents, one in a folder and one not. Here is the screen shot:

The above screen shot clearly shows there are two documents in the view but the "value" is one. The "CamlSchema" with blank document Id is in the root folder and the other is in a folder named "84".

Се чини да ми дека иако ќе се определи во поглед, the KPI doesn’t honor the "show all items without folders" поставување и наместо, се ограничува до коренот папка.

Ако грешам, Ве молиме ме капка линија или оставете коментар.

</крајот>

Да се ​​претплатите на мојот блог!

I was working on a feature last week that would add some event receivers to a specific list instance. (Јас Blogged малку за таа листа приемник овде).

Користење на командната линија, Можев да го инсталирате функција без грешка (но видете подолу за скриени грешка). When I tried to deploy the feature on the site, MOSS complained of a "FileNotFoundException" грешка. This blog entry describes how I solved it.

Ова е грешка Мос Покажавме дека сме во веб прелистувачот:

Feature ‘b2cb42e3-4f0a-4380-aaba-1ef9cd526f20’ could not be installed because the loading of event receiver assembly "xyzzyFeatureReceiver_0" не: System.IO.FileNotFoundException: Could not load file or assembly ‘xyzzyFeatureReceiver_0’ или една од нејзините зависности. Системот не можат да најдат Наведената датотека. Името на датотеката: ‘xyzzyFeatureReceiver_0’ at System.Reflection.Assembly.nLoad(AssemblyName Име, Стринг codebase, Докази assemblySecurity, Собранието locationHint, StackCrawlMark& магацинот почвата, Булова throwOnFileNotFound, Булова forIntrospection) at System.Reflection.Assembly.InternalLoad(AssemblyName assemblyRef, Докази assemblySecurity, StackCrawlMark& магацинот почвата, Булова forIntrospection) at System.Reflection.Assembly.InternalLoad(Стринг assemblyString, Докази assemblySecurity, StackCrawlMark& магацинот почвата, Булова forIntrospection) at System.Reflection.Assembly.Load(Стринг assemblyString) at Microsoft.SharePoint.Administration.SPFeatureDefinition.get_ReceiverObject() WRN: Собранието обврзувачки сеча е исклучен. Да им се овозможи собранието се врзуваат неуспех сеча, поставите на вредноста во регистарот [HKLM Software Microsoft топење!EnableLog] (DWORD) да 1. Имајте на ум: Има некои перформанси казна поврзан со собранието се врзуваат неуспех сеча. За да го вклучите оваа функција исклучите, отстранете ја вредноста во регистарот [HKLM Software Microsoft топење!EnableLog]. Смена на проблеми со Windows SharePoint Services.

Знам како да намерно да предизвика оваа грешка: don’t install the assembly in the GAC. Но, it was in the GAC. I normally install assemblies into the GAC by dragging them into the c:\windows\assembly folder using windows explorer. I’ve never felt 100% удобно прави тоа, бидејќи јас секогаш мислев дека gacutil постои причина … so I tried that. It made no difference.

Барав на Internets и го најде овој пост: http://forums.microsoft.com/MSDN/ShowPost.aspx?PostID=2243677&SiteID=1

На постерот се случи да биде со користење на ист корен малку на кодот (од внатре WSS книга од оваа листа) so that was a hopeful sign. Сепак, на предлог на украсување на собранието со [собранието: ] directive didn’t make sense to me. I tried it anyway and I was right. It made no difference.

Then I noticed that my class definition was not public. I made it public and that made no difference.

Следна, I went to the trouble of enabling the "assembly bind failure log" (по корисни и точни инструкции) and this is where things started to get interesting. That log shows me that the runtime is searching everywhere on that server for my assembly. It even appears to be searching for it in my medicine cabinet. Но … тоа нема да го бара за него во GAC.

I put on my winter jacket and go searching the Internets again and find that someone has had this problem too. The lengthy discussion in that posting peters off into nothing and I can’t find a solution.

I move my assembly into one of the places the log claims it’s searching and I make a little more progress. I’m rewarded with a new error in the browser when I try to activate the feature:

Failed to create feature receiver object from assembly "xyzzyFeatureReceiver_0", type "Conchango.xyzzyFeatureReceiver" за функција b2cb42e3-4f0a-4380-aaba-1ef9cd526f20: System.ArgumentNullException: Вредност не може да биде нула. Името на параметарот: тип at System.Activator.CreateInstance(Тип тип, Булова се јавни) at System.Activator.CreateInstance(Тип тип) at Microsoft.SharePoint.Administration.SPFeatureDefinition.get_ReceiverObject() Смена на проблеми со Windows SharePoint Services.

Време за една последна посета на на Internets!

Овој пат јас да дознаете, очекувано доволно, that MOSS issues this error because the assembly is not in GAC.

Сакам да добијам нешто позитивно од ова и обидете се да се чувствувам малку горд што сум ги создал Бегалецот од MSIL собранија, but it’s not working. I’m just plain annoyed. I find myself muttering "chicken or the egg" под мојот здив.

I finally decide to punt. I create an entirely new project and copy/paste the code from the incredible-cloaked-from-the-GAC-assembly non-working project over to this new project. (I look for a build flag called something like "hide from assembly binding if installed in the GAC" но не може да најде еден).

Јас го инсталирате функција и активирање на тоа и … таа работи! Така, по сето она што, I had to basically ‘reboot’ my project. Ова е уште една причина зошто мразам компјутери.

I did learn something useful from this. I had been installing features using the stsadm command line all day long and been using the "-force" option out of habit. Поради некоја причина, I did not use the -force option when I installed the new project. Овој пат, Јас не, всушност,, truly forget to copy this new project’s assembly into the GAC. Како резултат на, I received that "FielNotFoundException" грешка. Овој пат, Земав од stsadm, not when I tried to activate the feature via the web browser. Така, -force actually plays two roles. It allows you to re-install an existing feature. It also allows you to install a buggy feature that cannot work at runtime by suppressing the error. It probably says as much in the help somewhere but I never noticed it.

</крајот>

Ажурирање: This works but there are significant limitations which are described in the comments. This may still be useful in some cirumstances.

Ажурирање 2: Во мојот тековниот проект, users always upload documents. Како резултат на, I don’t run into a problem where MS Word is running and thinks that the file was renamed on it. I did run into a problem, "the file was modified by someone else" and solved this via a simple semaphore type flag. Users need to change a meta data field from its default value to something else. The itemupdated() приемник изгледа за е валидна вредност таму пред всушност извршување на преименување и оттогаш, I have not had any problems. Your mileage may vary.

I have a client requirement to change the name of files uploaded to a specific document library to conform with a particular naming convention. The API does not provide a "rename()" метод. Наместо, ние ги користиме "MoveTo(…)". Here is a minimal bit of code to accomplish this:

 јавноста избегне поништат ItemAdded(SPItemEventProperties својства)
        {
            Spfile ѓ = properties.ListItem.File;

            f.MoveTo(properties.ListItem.ParentList.RootFolder.Url + "/xyzzy.doc");
            f.Update();

        }

The only tricky bit is the "properties.ListItem.ParentList.RootFolder.Url". The MoveTo() method requires a URL. That mashed up string points me to the root folder of my current document library. This allows me to avoid any hard coding in my event receiver.

Ова е многу повеќе корисни верзија која го прави истото, but assigns the name of the file to "Title":

 јавноста избегне поништат ItemAdded(SPItemEventProperties својства)
        {
            DisableEventFiring();

            // Му ја додели титулата на оваа точка до името на датотеката се.
 // ЗАБЕЛЕШКА: Оваа задача мора да се случи пред ние менувате самата датотека.
 // Повикувајќи ажурирање() на spfile чини да се поништи имот во
 // извесна смисла.  Updates to "Title" не успеа до таа промена (и ажурирање() јавете се)
 // беа преместени во предниот дел на промена на името на датотеката.
            properties.ListItem["Title"] = Properties.ListItem.File.Name;

            properties.ListItem.Update();

            Spfile ѓ = properties.ListItem.File;

            // Добие продолжување на датотеката.  Ние треба дека подоцна.
 низа spfileExt = нови FileInfo(f.Name).Продолжување;

            // Преименувајте ја датотеката за да проект на елемент во листата и користи ја наставката да се задржи
 // дека дел од неа непроменети.
            f.MoveTo(properties.ListItem.ParentList.RootFolder.Url +
                "/" + properties.ListItem["ID"] + spfileExt);

            // Извршат во движење.
            f.Update();

            EnableEventFiring();
        }

I have a column name in a content type named "Real Estate Location".

That column is of type "lookup".

Имам пат е изменета <CommonViewFields> и ItemStyle.xsl да се покаже на колоната.

Едноставен <XSL:вредност на одберете =…> се враќа назад внатрешна вредност, која вклучува реден позиција на податоци, како што се:

1;#Мајами

За да се добие човек-пријателски вредност, го користите XSL подниза-по, како што е прикажано:

<XSL:value-of select="substring-after(@ Real_x005F_x0020_Estate_x005F_x0020_Location,'#')"></XSL:вредност на>

Use this technique whenever you are working with lookup values in XSL transforms and need to get the human-friendly value.

<крај />

Ажурирање: Jeremy Thake го блогираа за ова и да постават некои код за конзола апликација што покажува внатрешна имиња.

I was trying to get a content query web part to display a due date from a task and because the screen label is "Due Date", Јас претпоставува дека името на колоната за употреба во <CommonViewFields> is "Due_x0020_Date".

Погрешно!

The real column name in this case was "DueDate".

Како не сум го најдете? I re-read Heather Блог Соломон влез на менување CQWP to show additional columns of data. She describes this process at step #13. Trust it. It’s correct. Најмалку, it was correct for me. I did not trust it at first for another column with a much longer name.

I say "Trust it" because I did not trust it and probably wasted near two hours butting my head up against a wall. After I resolved the "DueDate" име, Сакав да додадете друга област да <CommonViewFields>. Using the Solomon technique, I was getting a column name like "XYZ_x0020_Project_x0020_Due_x00".

Јас помислив, that’s clearly a truncated name. I went ahead and un-truncated it with no success. I finally used the seemingly truncated name and it worked.

Бонус совет: Кога работев со CQWP, ако Јас додадов лоша внатрешна име <CommonViewFields>, the CQWP would tell me that the query had returned no results. Но, ако Јас додадов тип на податоци на име на поле, it would return a result. Adding the data type actually masked a problem since I was referencing a non-existent field. I could add it, но кога се обидов да се прикаже својата вредност, I would always get a blank.

Тоа не се маскираат грешка:

<CommonViewFields>Due_x0020_Date;</CommonViewfields>

Ова се маскираат грешка:

<CommonViewFields>Due_x0020_Date,DateTime;</CommonViewfields>

</крајот>