UPDATE: An anonymous poster left a great comment about internal names. Be sure to read it.

Kur punon me marrës ngjarje dhe kodin tjetër që referencat artikuj listë SharePoint nëpërmjet modelit objekt, Unë shpesh bëjnë gabime që gjenerojnë këtë gabim në runtime:

Ngarkimin dhe drejtimin Error ngjarje marrës Conchango.xyzzyEventReceiver në xyzzy, Version = 1.0.0.0, Culture = neutral, 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. Megjithatë, one simple explanation is that I’m referencing a field incorrectly. If the name of the field is "Due Date", I must reference it like this in an event receiver:

properties.ListItem["Due Date"]

When I misspell or use the wrong case when referencing the field, SharePoint generates the above mentioned runtime error. Për shembull, this is wrong:

properties.ListItem["due Date"]

</fund>

Abonohen në blogun tim.

Në mënyrë për të punuar rreth një problem KPI Kam shkruar në lidhje me këtu, 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) përdoruesit përfundimtarë nuk e di ndonjë më të mirë dhe 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, cila nuk eshte fundi i botës.

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. Si rezultat, kjo është një copë tortë për të mbajtur dosje prindi meta data in sync with the KPI-driven meta data from the file itself since the plumbing is already in place. This allows me to have my KPI’s and eat them too 🙂

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").Subfolders;
  SPFolder addedFolder = srcFolders.Add(properties.ListItem.ID.ToString());

  SPContentTypeId kpiCT = i ri SPContentTypeId("0x0120002A666CAA9176DC4AA8CBAA9DC6B4039F");
  addedFolder.Item["Content Type ID"] = KpiCT;
  addedFolder.Item.Update();

Për të gjetur aktuale Lloji ID Content, Unë disponim se tipi i përmbajtjes nëpërmjet settings vend dhe kopje / ngjit atë nga URL, siç tregohet:

</fund>

Abonohen në blogun tim!

Unë e urrej të pranoj atë, 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:

privat pavlefshme UpdateParentFolder(SPItemEventProperties Prona të paluajtshme)
{

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


} // UpdateParentFolder

Në këtë rast, I’m working with a document library and the properties are coming from an ItemAdded event.

The trick is that you can’t get the SPFolder of the item directly from the item itself (i.e. properties.ListItem.Folder is null). Në vend të kësaj, go to the list item’s associated File and get the File’s folder.

</fund>

Abonohen në blogun tim!

I’m sure I’m not the first person to come up with this. Megjithatë, I haven’t noticed anyone publish a trick like this since I started paying close attention to the community last July. Kështu, Unë mendova se do të postoj atë këtë tip të shpejtë dhe të lehtë debug.

I’m working on an event receiver that started to generate this error in the 12 zgjua:

Ngarkimin dhe drejtimin Error ngjarje marrës Conchango.xyzzyEventReceiver në xyzzy, Version = 1.0.0.0, Culture = neutral, PublicKeyToken=blahbalhbalh. Additional information is below. : Object reference nuk është caktuar për një shembull të një objekti.

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.

I tried this solution to get my pdb in there with hopes that SharePoint’s 12 hive would show the stack trace, but no luck. I don’t know if it’s possible and if someone does, please let me know 🙂

I know it’s possible to write your own log messages to the 12 zgjua. Frankly, I wanted something a little less scary and quicker to implement.

It occurred to me that I could at least get some basic trace information by catching and re-throwing generic exceptions like this:

  mundohem {
    UpdateEditionDate(Prona të paluajtshme);
  }
  kap (Exception e)
  {
    hedh i ri Exception("Dispatcher, UpdateEditionDate(): Exception: [" + e.ToString() + "].");
  }

This showed up in the 12 hive thusly:

Ngarkimin dhe drejtimin Error ngjarje marrës Conchango.xyzzyEventReceiver në xyzzy, Version = 1.0.0.0, Culture = neutral, PublicKeyToken=blahblahblah. Additional information is below. : Dispatcher, UpdateEditionDate(): Exception: [System.NullReferenceException: Object reference nuk është caktuar për një shembull të një objekti. at Conchango.xyzzyManagementEventReceiver.UpdateEditionDate(Pronat SPItemEventProperties) at Conchango.xyzzyManagementEventReceiver.Dispatcher(Pronat SPItemEventProperties, String eventDescription)].

That gave me all the detail I needed to track down that particular problem and I expect to use it a lot going forward.

</fund>

Abonohen në blogun tim!

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. Bottom line: assign "recursive" për atribut pamje të query.

Skenari im:

• Të hënën, Unë ngarkoj një dokument dhe të furnizimit me disa të dhëna të meta.
• Javën e ardhshme, 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").
• Ne kemi krijuar një fasadë të shërbimit të internetit që ofron një ndërfaqe QZHB-miqësore në listë në mënyrë që përdoruesit mund të lehtë të gjetur atë dokument e hëna nëpërmjet një kërkim të titullit.
• A BDC data column provides a friendly user interface. (Kjo është pjesë e përpjekjes sime në përdorimin e QZHB për një kolonë Lookup më miqësore).

Përfundimtar QZHB Fasada shërbim përdor një pyetje si kjo për të bërë lookup:

 // U2U mjet i përdorur për të ndihmuar në gjenerimin këtë query CAML.
      oQuery.Query =
        "<Ku>";

      nëse (titleFilter.Length > 0)
        oQuery.Query   =
          "  <Dhe>";

      oQuery.Query   =
        "    <Dhe>" +
        "      <Geq>" +
        "        <FieldRef Name=\"DocumentId\" />" +
        "        <Value Type=\"Text\">" + MinID + "</Vlerë>" +
        "      </Geq>" +
        "      <Leq>" +
        "        <FieldRef Name=\"DocumentId\" />" +
        "        <Value Type=\"Text\">" + maxId + "</Vlerë>" +
        "      </Leq>" +
        "    </Dhe>";

      nëse (titleFilter.Length > 0)
        oQuery.Query   =
          "    <Përmban>" +
          "      <FieldRef Name=\"Title\" />" +
          "      <Value Type=\"Text\">" + titleFilter + "</Vlerë>" +
          "    </Përmban>" +
          "  </Dhe>";
      oQuery.Query   =
        "</Ku>";

Gjatë fazës fillestare të zhvillimit, this worked great. Megjithatë, ne kemi prezantuar dosjet në directory për të zgjidhur disa probleme dhe papritmas, 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, ne kemi krijuar një dosje të bazuar në ID e list item-së dhe pastaj të lëvizë skedarin atje (Kam shkruar në lidhje me atë këtu; ne kemi pasur rezultate të përziera me këtë qasje, por në tërësi, ajo është duke punuar mirë). 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 = i ri SPQuery();

Unë në vend të përdorur një konstruktor që specifikuar një pamje:

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

SPQuery oQuery = i ri SPQuery(oList.Views["All Documents"]);

Kjo zgjidhur problemin dhe kam filluar për të marrë rezultatet e mia.

I then added the CONTAINS operator into the mix and it broke again. It turns out that the CONTAINS operator, aq sa unë mund të them, nuk punojnë me pamje të njëjtën mënyrë si një GEQ thjeshtë / LEQ operators. I did some searching and learned that the query’s ViewAttributes should be set to "Recursive", si në:

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

That solved the problem for CONTAINS. Në të vërtetë, kjo zgjidhur edhe problemin e mia Kërko origjinal dhe në qoftë se unë kam specifikuar atribut rekursive për herë të parë, Unë nuk do të kandidojë në çështjen përsëri.

Fakti që një pikëpamje e bazuar SPQuery punon për disa operatorëve (GEQ/LEQ) dhe jo të tjerët (PËRMBAN), shoqëruar me faktin se KPIs nuk duket për të punuar në të gjitha me dosje që përmbajnë bibliotekat dokument shpie mua të besoj se ka disa çështje SPQuery orthogonality.

Falënderime të veçanta:

• Folks mirë në U2U dhe mjet i tyre query.
• Michael Hoffer madhe "të mësuarit duke vepruar" blog post, Komentet dhe përgjigjet.

</fund>

Abonohen në blogun tim!

UPDATE 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. I përshkruar se në pak më tepër hollësira këtu.

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 (duke përdorur një teknikë të ngjashme me atë që kam shkruar në lidhje këtu). 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" por në vend të kësaj të krijojnë docs në nivel lokal dhe pastaj ngarkoni atyre).

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".

Kjo zakonisht është e thjeshtë për të bërë dhe kam përshkruar diçka shumë si kjo në Beagle SharePoint me shumë të shtëna ekran, nëse ju jeni të interesuar.

Me pak fjalë, Unë e bëri në vijim:

• Create a view on the doc library called "Pending".
• Konfiguro pikëpamjen për të injorojë strukturës dosje.
• Krijo një listë KPI.
• Create an indicator in the list that points to the doc lib and that "Pending" pamje.

This simply does not work. The KPI shows my target (e.g. pesë dokumente urgjente) but always shows the actual number of urgent documents as zero. Paradoxically, në qoftë se ju stërvitje poshtë për detaje, 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".

Kjo duket për mua se edhe pse ju specifikoni një pamje të, the KPI doesn’t honor the "show all items without folders" vendosjen dhe në vend të, kufizohet në dosjen rrënjë.

Nëse unë jam gabim, ju lutem të më bjerë një linjë apo të lënë një koment.

</fund>

Abonohen në blogun tim!

I was working on a feature last week that would add some event receivers to a specific list instance. (Unë blogged një grimë në lidhje me atë receiver lista këtu).

Duke përdorur command line, Unë mund të instaloj funksion me asnjë gabim (por shih më poshtë për gabimin e fshehur). When I tried to deploy the feature on the site, MOSS complained of a "FileNotFoundException" gabim. This blog entry describes how I solved it.

Ky është gabim që MOSS tregoi mua në shfletuesin e internetit:

Feature ‘b2cb42e3-4f0a-4380-aaba-1ef9cd526f20’ could not be installed because the loading of event receiver assembly "xyzzyFeatureReceiver_0" dështuar: System.IO.FileNotFoundException: Could not load file or assembly ‘xyzzyFeatureReceiver_0’ ose njëri prej varësi të saj. Sistemi nuk mund të gjeni skedarin e specifikuar. File name: ‘xyzzyFeatureReceiver_0’ at System.Reflection.Assembly.nLoad(AssemblyName filename, Codi batë String, AssemblySecurity Dëshmi, Kuvendi locationHint, StackCrawlMark& rafte tokës, Boolean throwOnFileNotFound, ForIntrospection Boolean) at System.Reflection.Assembly.InternalLoad(AssemblyName assemblyRef, AssemblySecurity Dëshmi, StackCrawlMark& rafte tokës, ForIntrospection Boolean) at System.Reflection.Assembly.InternalLoad(String assemblyString, AssemblySecurity Dëshmi, StackCrawlMark& rafte tokës, ForIntrospection Boolean) at System.Reflection.Assembly.Load(String assemblyString) at Microsoft.SharePoint.Administration.SPFeatureDefinition.get_ReceiverObject() WRN: Kuvendi logging detyrues është fikur. Për të mundësuar dështim kuvendit prerjeve lidhin, përcaktuar vlerën e regjistrit [HKLM Software Microsoft Fusion!EnableLog] (DWORD) në 1. Shënim: Ka disa performanca dënimi shoqëruar me dështim prerjet e lidhnin kuvendit. Për të aktivizuar këtë funksion off, hiqni vlerën e regjistrit [HKLM Software Microsoft Fusion!EnableLog]. Troubleshoot çështje me Windows SharePoint Services.

Unë e di se si për të qëllimisht shkaktojnë atë gabim: don’t install the assembly in the GAC. Por, 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% rehat duke bërë që për shkak gjithmonë kam menduar se gacutil ekzistuar për një arsye … so I tried that. It made no difference.

Unë kontrolloi dhe gjeti Internets këtë post: http://forums.microsoft.com/MSDN/ShowPost.aspx?PostID=2243677&SiteID=1

Poster ka ndodhur të jetë duke përdorur pak njëjtën rrënjë të kodit (nga libri Inside UK nga kjo listë) so that was a hopeful sign. Megjithatë, Sugjerimi i kuvendit ujdisje me një [asamble: ] 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.

Tjetër, I went to the trouble of enabling the "assembly bind failure log" (ndjekur udhëzimet dobishme dhe të sakta të parashikuara) 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. Por … ajo nuk do të kërkoni për atë në 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" për funksion b2cb42e3-4f0a-4380-aaba-1ef9cd526f20: System.ArgumentNullException: Vlera nuk mund të jetë null. Emri Parametri: lloj at System.Activator.CreateInstance(Lloji Lloji, Boolean jopublike) at System.Activator.CreateInstance(Lloji Lloji) at Microsoft.SharePoint.Administration.SPFeatureDefinition.get_ReceiverObject() Troubleshoot çështje me Windows SharePoint Services.

Koha për një udhëtim të fundit në Internets!

Këtë herë kam gjetur, parashikueshme të mjaftueshme, that MOSS issues this error because the assembly is not in GAC.

Unë dua të dal nga diçka pozitive për këtë dhe të përpiqen për të ndjehen pak krenare që kam krijuar I arratisur nga kuvendet MSIL, but it’s not working. I’m just plain annoyed. I find myself muttering "chicken or the egg" nën frymën time.

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" por nuk mund të gjeni një).

Kam instaluar dhe aktivizuar atë funksion dhe … ajo punon! Kështu, pas të gjitha që, I had to basically ‘reboot’ my project. Kjo është një tjetër arsye pse unë e urrej kompjutera.

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. Për disa arsye, I did not use the -force option when I installed the new project. Këtë herë, Unë e bëri në fakt, truly forget to copy this new project’s assembly into the GAC. Si rezultat, I received that "FielNotFoundException" gabim. Këtë herë, Kam marrë atë nga stsadm, not when I tried to activate the feature via the web browser. Kështu, -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.

</fund>

UPDATE: This works but there are significant limitations which are described in the comments. This may still be useful in some cirumstances.

UPDATE 2: Në projektin tim aktual, users always upload documents. Si rezultat, 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() marrës duket për një vlerë të vlefshme atje para se të vërtetë kryerjen e riemërtoj dhe që atëherë, 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()" metodë. Në vend të kësaj, ne përdorim "MoveTo(…)". Here is a minimal bit of code to accomplish this:

 publik shkel pavlefshme ItemAdded(SPItemEventProperties Prona të paluajtshme)
        {
            SPFile f = 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.

Ky është një version më i dobishëm që e bën të njëjtën gjë, but assigns the name of the file to "Title":

 publik shkel pavlefshme ItemAdded(SPItemEventProperties Prona të paluajtshme)
        {
            DisableEventFiring();

            // Cakto titullin e këtij zëri në emër të vetë dosjes.
 // SHËNIM: Kjo detyrë duhet të bëhet para se të modifikojë file vetë.
 // Thirrja përditësim() në SPFile duket të zhvlerësojë pronat në
 // disa ndjenja.  Updates to "Title" arriti deri në atë ndryshim (dhe perditesimi() thirrje)
 // u zhvendos në frontin e ndryshimit të emrit të file.
            properties.ListItem["Title"] = Properties.ListItem.File.Name;

            properties.ListItem.Update();

            SPFile f = properties.ListItem.File;

            // Get zgjatjen e dosjes.  Ne kemi nevojë që më vonë.
 varg spfileExt = i ri FileInfo(f.Name).Zgjatje;

            // Rename file me ID e list item-së dhe të përdorni të file extension për të mbajtur
 // se një pjesë e saj e paprekur.
            f.MoveTo(properties.ListItem.ParentList.RootFolder.Url +
                "/" + properties.ListItem["ID"] + spfileExt);

            // Commit lëvizje.
            f.Update();

            EnableEventFiring();
        }

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

That column is of type "lookup".

Unë kam modifikuar <CommonViewFields> dhe ItemStyle.xsl për të treguar në kolonën e.

A simple <XSL:vlera-e përzgjedhur =…> kthehet mbrapa një vlerë të brendshëm që përfshin të dhënat rendor pozicion, si:

1;#Miami

Për të marrë vlerën e njeriut-miqësore, përdorur XSL substring-pas, siç tregohet:

<XSL:value-of select="substring-after(@ Real_x005F_x0020_Estate_x005F_x0020_Location,'#')"></XSL:vlera-e>

Përdoreni këtë teknikë sa herë që ju jeni duke punuar me vlerat lookup në XSL transformon dhe kanë nevojë për të marrë vlerën e njeriut-miqësore.

<Fundi />

UPDATE: Jeremy Thake ka blogged në lidhje me këtë dhe vënë disa Kodi për një aplikim konsol që tregon emrat e brendshme.

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", Unë supozohet se emri kolona për të përdorur në <CommonViewFields> is "Due_x0020_Date".

I gabuar!

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

Si e kam gjetur atë? I re-read Heather Blog entry Salomonit mbi modifikimin CQWP to show additional columns of data. She describes this process at step #13. Trust it. It’s correct. At least, 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" emër, Doja të shtoni një tjetër fushë për të <CommonViewFields>. Using the Solomon technique, I was getting a column name like "XYZ_x0020_Project_x0020_Due_x00".

Mendova për veten time, 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.

Bonus tip: Kur isha duke punuar me CQWP, në qoftë se unë shtoi një emër të keq të brendshëm për <CommonViewFields>, the CQWP would tell me that the query had returned no results. Por, në qoftë se unë shtoi një lloj të dhënave për emrin në terren, 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, por kur unë u përpoq për të shfaqur vlerën e saj, I would always get a blank.

Kjo nuk ka maskë gabimin:

<CommonViewFields>Due_x0020_Date;</CommonViewfields>

Kjo ka maskë gabimin:

<CommonViewFields>Due_x0020_Date,DateTime;</CommonViewfields>

</fund>