განახლების: An anonymous poster left a great comment about internal names. Be sure to read it.

როდესაც ვმუშაობთ ღონისძიება მიმღები და სხვა კოდი, რომელიც ეხება ამ SharePoint სია ნივთები მეშვეობით ობიექტის მოდელი, მე ხშირად უშვებენ შეცდომებს, რომ წარმოქმნის ეს შეცდომა at runtime:

შეცდომა და გაშვებული ღონისძიება მიმღები Conchango.xyzzyEventReceiver in 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", 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. მაგალითად, this is wrong:

properties.ListItem["due Date"]

</ბოლო>

გამოწერა ჩემი დღიური.

In order to work around a KPI problem I wrote about here, 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) the end users don’t know any better and 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, which isn’t the end of the world.

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. შედეგად, it’s a piece of cake to keep the parent folder’s 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").SubFolders;
  SPFolder addedFolder = srcFolders.Add(properties.ListItem.ID.ToString());

  SPContentTypeId kpiCT = ახალი SPContentTypeId("0x0120002A666CAA9176DC4AA8CBAA9DC6B4039F");
  addedFolder.Item["Content Type ID"] = kpiCT;
  addedFolder.Item.Update();

To locate the actual Content Type ID, I accessed that content type via site settings and copy/pasted it from the URL as shown:

</ბოლო>

გამოწერა ჩემი დღიური!

მე სიძულვილის ვაღიაროთ ეს, 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

ამ შემთხვევაში, I’m working with a document library and the properties are coming from an ItemAdded event.

შეასრულა ის არის, რომ თქვენ ვერ 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 hive:

შეცდომა და გაშვებული ღონისძიება მიმღები Conchango.xyzzyEventReceiver in 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.

მე შევეცადე ეს გადაწყვეტა მიიღოს ჩემი pdb იქ იმედოვნებს, რომ SharePoint ნახვა 12 hive იმას აჩვენებენ დასტის კვალი, but no luck. I don’t know if it’s possible and if someone does, გთხოვთ ნება მომეცით ვიცი 🙂

I know it’s possible to write your own log messages to the 12 hive. 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:

  ვცდილობთ {
    UpdateEditionDate(თვისებები);
  }
  დაჭერა (გამონაკლისი e)
  {
    სახიფათოა ახალი გამონაკლისი("Dispatcher, UpdateEditionDate(): გამონაკლისი: [" + e.ToString() + "].");
  }

This showed up in the 12 hive thusly:

შეცდომა და გაშვებული ღონისძიება მიმღები Conchango.xyzzyEventReceiver in xyzzy, მობილური = 1.0.0.0, კულტურის = ნეიტრალური, PublicKeyToken=blahblahblah. Additional information is below. : Dispatcher, UpdateEditionDate(): გამონაკლისი: [System.NullReferenceException: ობიექტის მითითება არ არის, რომ მაგალითად ობიექტი. at Conchango.xyzzyManagementEventReceiver.UpdateEditionDate(SPItemEventProperties თვისებები) at Conchango.xyzzyManagementEventReceiver.Dispatcher(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.

</ბოლო>

გამოწერა ჩემი დღიური!

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" to view ატრიბუტია შეკითხვის.

ჩემი სცენარი:

• ორშაბათს, ავტვირთო დოკუმენტი და მიაწოდოს ზოგიერთი მეტა მონაცემები.
• The following week, 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").
• We’ve created a web service façade that provides a BDC-friendly interface to the list so that users can easily locate that Monday document via a title search.
• A BDC data column provides a friendly user interface. (This is part of my attempt at using BDC for a more friendly Lookup column).

The final BDC façade service uses a query like this to do the lookup:

 // Used U2U tool to assist in generating this CAML query.
      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  =
        "</სად>";

During the initial stage of development, this worked great. თუმცა, we introduced folders into the directory to solve some problems and suddenly, 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, we create a folder based on the list item’s ID and then move the file there (I wrote about that აქ; we’ve had mixed results with this approach but on the whole, it’s working well). 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();

I instead used a constructor that specified a view:

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

SPQuery oQuery = ახალი SPQuery(oList.Views["All Documents"]);

That solved the problem and I started to get my results.

I then added the CONTAINS operator into the mix and it broke again. It turns out that the CONTAINS operator, so far as I can tell, does not work with the view the same way as the a simpler GEQ / LEQ operators. I did some searching and learned that the query’s ViewAttributes should be set to "Recursive", , როგორც in:

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

That solved the problem for CONTAINS. სინამდვილეში, this also solved my original search problem and if I had specified the recursive attribute the first time, I would not have run into the issue again.

The fact that a view-based SPQuery works for some operators (GEQ/LEQ) and not others (CONTAINS), coupled with the fact that KPIs don’t seem to work at all with folder-containing document libraries leads me to believe that SPQuery has some orthogonality issues.

Special Thanks:

• The good folks at U2U and their query tool.
• Michael Hoffer’s great "learning by doing" blog post, comments and responses.

</ბოლო>

გამოწერა ჩემი დღიური!

განახლების 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 described that in a little more detail here.

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 (using a technique similar to what I wrote about აქ). 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" but instead create the docs locally and then upload them).

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

This is usually simple to do and I described something very much like this at the SharePoint Beagle with lots of screen shots if you’re interested.

In a nutshell, I did the following:

• Create a view on the doc library called "Pending".
• Configure the view to ignore folder structure.
• Create a KPI List.
• 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. five urgent documents) but always shows the actual number of urgent documents as zero. Paradoxically, if you drill down to the details, 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".

It appears to me that even though you specify a view, the KPI doesn’t honor the "show all items without folders" setting and instead, confines itself to the root folder.

If I’m wrong, please drop me a line or leave a comment.

</ბოლო>

გამოწერა ჩემი დღიური!

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" error. This blog entry describes how I solved it.

ეს არის შეცდომა, რომ MOSS აჩვენა ჩემთან ბრაუზერში:

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 Fusion!EnableLog] (DWORD) to 1. შენიშვნა: არსებობს გარკვეული წარმოდგენა საჯარიმო ასოცირდება ასამბლეის სავალდებულოა მარცხი ხე. გახდეს ამ ფუნქციის off, ამოიღონ რეესტრის ღირებულება [HKLM Software Microsoft Fusion!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: ღირებულება არ შეიძლება იყოს null. პარამეტრის სახელი: ტიპის at System.Activator.CreateInstance(გაცნობის ტიპის, ლოგიკური nonPublic) 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.

მე მინდა რაღაც პოზიტიური აქედან და ცდილობენ გრძნობენ ცოტა ვამაყობთ, რომ მე შექმნა გაქცეული of 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" error. ამჯერად, მე მივიღე ეს 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:

 საჯარო override ცნოს ItemAdded(SPItemEventProperties თვისებები)
        {
            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.

ეს არის უფრო სასარგებლო ვერსია, რომ იგივეს შვება, but assigns the name of the file to "Title":

 საჯარო override ცნოს ItemAdded(SPItemEventProperties თვისებები)
        {
            DisableEventFiring();

            // მიანიჭეთ ტიტული ამ ელემენტის სახელით ფაილი თვით.
 // შენიშვნა: ეს დავალება უნდა მოხდეს, სანამ ცვლილებები ფაილი თვით.
 // მოვუწოდებთ განახლება() on SPFile ჩანს გაუქმების ქონების
 // გარკვეული.  Updates to "Title" ვერ მოხერხდა, სანამ, რომ ცვლილება (და განახლება() მოვუწოდებთ)
 // იყო გადაინაცვლა ცვლილება ფაილი სახელი.
            properties.ListItem["Title"] = Properties.ListItem.File.Name;

            properties.ListItem.Update();

            SPFile f = properties.ListItem.File;

            // მიიღეთ გაგრძელების ფაილი.  ჩვენ გვჭირდება, რომ მოგვიანებით.
 სიმებიანი spfileExt = ახალი ფაილის სტატისტიკა(f.Name).გაფართოება;

            // Rename the file to the list item's ID and use the file extension to keep
 // that part of it intact.
            f.MoveTo(properties.ListItem.ParentList.RootFolder.Url +
                "/" + properties.ListItem["ID"] + spfileExt);

            // Commit the move.
            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;#Miami

იმისათვის რომ ადამიანის მეგობრული ღირებულება, გამოყენება XSL substring-შემდეგ, როგორც ნაჩვენებია:

<XSL:value-of select="substring-after(@ Real_x005F_x0020_Estate_x005F_x0020_Location,'#')"></XSL:ღირებულების შესახებ>

გამოყენება ამ ტექნიკით, როცა ვმუშაობთ lookup ღირებულებების XSL გარდაქმნას და უნდა მიიღოს ადამიანის მეგობრული ღირებულება.

<ბოლოს />

განახლების: Jeremy Thake არ blogged შესახებ და ამით გარკვეული კოდი console განაცხადის რომელიც აჩვენებს შიდა სახელები.

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 სოლომონის წაკითხვა შესვლის on შეცვლის 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,წამების;</CommonViewfields>

</ბოლო>