Цатегори Арцхивес: СхареПоинт

Како да решите проблеме мистериозне грешке СхареПоинт.

Преглед:

Отклањање грешака је тешко када се развијају прилагођене функционалност за Виндовс СхареПоинт Сервицес 3.0 (ВСС) или Мицрософт Оффице СхареПоинт Сервер (МОСС). The main culprit is that SharePoint normally surfaces very little diagnostic information on the web browser when an error occurs. This blog entry describes how to locate additional system-generated diagnostic information that can often provide that extra bit of detail that one needs in order to identify root causes. This can then lead to solving the problem.

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

Приступ:

СхареПоинт штеди много информација на евиденцију дијагностике у лог фајл у 12 кошница.

The "12 hive" is usually located at "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12". (Нисам сигуран да ли је то могуће 12 кошница да живе било где другде, заправо).

Идеја је да се пронађе тренутну датотеку евиденције, force the error and then quickly open the log file. These log files are characterized by:

  • Copious amounts of information. SharePoint generates a very large amount of diagnostic information and writes it to that log file very quickly. You need to be quick with the fingers to capture it.
  • Multiplicity. SharePoint does not write to a single log file but rather generates multiple log files in sequence.
  • Копирајте и налепите лепо у МС Екцел.

Мој омиљени метод:

  1. Отворите Виндовс Екплорер показује на 12 кошницу резање.
  2. Сортирај приказ за приказивање по датуму измене (прво најновији).
  3. Означите најновији лог фајл.
  4. У прозору веб прегледача, натерати да се деси грешка.
  5. Брзо отворите тренутни лог фајл и копирате његов садржај у МС Екцел.
  6. Пребаци се на крају и анализирају релевантне ставке.

Остале напомене:

Подразумевано, дијагностички дневник налази у 12 кошница логс каталог.

МС Најбоље праксе (Аце од Мике Т. Мицрософта) state that the log files should be saved to a separate hard drive. One does this via central admin. Your system administrator may have done this, у том случају очигледно да је потребно да пронађете датотеку евиденције тамо уместо дефаулт 12 кошница локација).

Овај унос се бави питањима као што су:

  • СхареПоинт тока успело због интерне грешке.
  • (више да се додају током времена)
  • Овај унос је корисно дијагностиковање тока грешке (e.g. "The workflow failed to start due to an internal error").

МОСС: Ефективна увод у организацији

(this entry cross posted between http://paulgalvin.spaces.live.com/blog/ и http://blogs.conchango.com)

Године објаве на овом сајту су моје и не представљају ставове Цонцханго је, стратегије или мишљења.

Преглед:

Овај чланак описује неке основне информације о великим (3,000 корисници) Мицрософт Оффице СхареПоинт Сервер (МОСС) rollout and what we did to get the project rolling in such a way that the client is happy and firmly down a path that ends with full adoption of the MOSS feature set. As of the writing of the entry, we are approximately 50% complete with the first phase of the project. As things progress, I’ll update this entry and/or write new entries.

In this specific case, the company had already installed SharePoint Portal Server 2003. The IT group installed the product in a sort of "let’s see if anyone cares" fashion. It was quickly adopted by many business users and became quite popular in the enterprise at large. Као што можете замислити, this was not the best rollout strategy (which the client readily admits) and when MOSS arrived on the scene, the client resolved to "do it right" and hired us to help them.

One of the central questions facing us when we started implementing this project was: How do we introduce MOSS to this client? Given that the client already had experience with SharePoint, we wondered — do we need to do "differential" training or do we start from the ground up? After working with key users, we determined that treating this as a green field project made more sense.

That decision gave a starting point but still left us with the major requirement of figuring out a good strategy for rolling MOSS out to the enterprise. MOSS is such a big animal … it includes content management, document management, тражи, security, audience targeting, project management, "fabulous forty" шаблони, тока, business data connector, итд. Couple this with the fact that it’s a large organization that can truly make use of virtually every major MOSS feature and you have the makings of a great project with an enterprise reach and many good things happening.

We’re confronted with this issue time and time again … MOSS has an enterprise reach with its enterprise feature-set, yet even somewhat sophisticated clients have a hard time mentally absorbing those features, let alone incorporating an appreciable fraction of them into their daily routine.

I don’t have a magic solution to the problem. I instead address just the very first steps that we’ve taken with the client to lead them down the path to successful long-term adoption.

Scope:

As much as I wanted the team to craft a project plan that included such milestones as "PoepleSoft Integration via BDC Completed", "New Cross-Departmental Product Launch Workflow Complete" and "Executive Management KPI’s Accepted", I had to settle for something less. This is not to say that "less" is bad. Заправо, the "less" that we decided for the initial rollout was miles ahead of where they were before we started. У нашем случају, the "less" turned into:

  • Simple document management using document libraries, version control and content types.
  • Effective search based on content types and customized advance search (via managed properties, XSLT to produce pretty results, итд).

In addition to the above enterprise-wide features (meaning that they were to be rolled out to all departments and users), we added the following singleton in-scope mini-projects:

  • Proof of concept BDC integration.
  • Multi-step and multi-branch workflow process created via SPD.
  • Complex InfoPath form.
  • Surfacing KPI’s for some business process (probably HR talent acquisition in our case, though that may change).

The scope here is not 100% accurate but representative of our approach and sufficient for my purpose here, which is to explain what I consider to be an "effective" introduction of MOSS that will set the client firmly down the golden path to full MOSS adoption.

I won’t write much more about the singleton in this entry. I do want to point out that these are part of our over-arching strategy. The idea is to implement the core document management and search features to all users yet provide highly functional, high visible and highly representative examples of other core MOSS features which are simply beyond the ability of most users to absorb at this early stage. Међутим, they will be "out there" and one hopes that other business units will know of or learn about them and want those features for themselves, leading to greater adoption. These singleton success stories also serve to provide our sales team "ammunition" for successfully winning second, third and n-phase projects.

What Did We Introduce and Why?

Having settled on document management and search as a baseline enterprise-wide requirement, we needed to start gathering details. As a practical matter, this revolved around understanding their documents and that ultimately mapped to understanding content types.

I’ve found it’s difficult to explain content types without visual aides. More technical folk can walk away from a discussion about content types when CT’s are described in database terms. "A CT is similar to a database table, it has columns and columns are defined in terms of data types, but CT data types include more than simple integer/date, but also "choice" and "lookup" and the like." We can talk about "extending" типова садржаја, much like one can inherit functionality from a base class in object oriented languages. However this is obviously not helpful for the transportation department admin person who has no technical background. I.e., nearly everyone that matters in a MOSS rollout.

Using a white board is iffy. I’ve presented the idea of a content type and drawn brilliant (or so they seem) pictures of content types and what they do for you in terms of search and how they can be expanded, итд. На крају, it does feel like some light bulbs have turned on, but the resulting white board picture is a mess.

This led us to our current and so far most effective landing place: a MOSS sandbox site configured to show these features.

Using the sandbox site, we demonstrate:

  • Content types:
    • Creating a CT with multiple data types (текст, датум, choice, boolean, lookup, итд).
    • Extending a CT by creating a new CT based on a parent.
    • Searching for documents using CT metadata.
  • Библиотеке докумената:
    • Associating a single CT with a library.
    • What happens when we upload a document to that library?
    • Associating multiple CT’s with a doc library.
    • What happens when we upload a document to that library?
    • Filtering and sorting via column headings in a doc lib.
    • Document library views:
      • Sorting
      • Grouping
      • "Quick entry" (data sheet view)
      • "Untagged data" (to assist with migration to MOSS from other content sources; more on this below).

The Sandbox Site:

We designed our sandbox site to be a permanent feature in the development environment to be used for training purposes long after we finish the project and included several artifacts as described:

Типови садржаја:

We defined the following content types: Invoice, Purchase Order, Services Invoice.

We selected Invoice and Purchase order because they are more or less universally under
stood entities. Everyone in business understands that an invoice is a demand for payment to a customer for an amount issued on a certain датум to be paid as per some payment terms. This leads to a natural definition of a CT which we called "Training Invoice" (to distinguish it from any other kind of invoice). The purchase order is similarly easily defined. We also created a "Training Services Invoice" by creating a new CT based upon the "Training Invoice" CT and added just one column, "services rendered".

With the above, we can now demonstrate some key features of CT’s without getting bogged down trying to explain an abstract concept first; everyone already understands what we mean by "invoice" and "purchase order" and are instead able to focus on mechanics of the CT itself.

Custom Lists:

CT with columns of type "lookup" point to a custom list or document library. We use this extensively and for the sandbox, we created one supporting custom list that contains customers. We picked customers because it’s an easy concept to understand and easy to demonstrate. The Invoice CT has a column, "customer" that is defined of type "lookup" that points at this list.

We created a similar custom list to manage "vendors" for the "Purchase Order" ЦТ.

Библиотеке докумената:

We created two document libraries: "Invoices" and "Mixed Documents".

We configured the invoices document library to manage only documents of CT type "Invoice".

We configured the "Mixed Documents" library to manage all three CT’s.

Create several views that show sorting, filtering, data sheet and grouping.

Претражи:

We defined two new managed properties and mapped them to Invoice Number and Customer.

We created a new customized advance search site and modified it to enable users to search for "invoices" using those two mapped properties.

Modify the XSLT so that the invoice and customer number, when present, appear in an HTML table in a bright color. The objective here is to demonstrate that such formatting is possible.

Putting it all together:

We arrange for key users to participate in a demo.

We follow this simple script:

  1. Describe the meaning and purpose of a CT, using invoices and purchase orders as examples.
  2. Show the invoice CT definition while simultaneously assuring them that they don’t need to use those screens themselves, just pick up the concepts.
  3. Go to the invoices document library.
  4. Upload a document.
  5. Demonstrate that the customer drop-down is really sourced from a custom list.
  6. Add a new customer to the customer list and then update the recently uploaded invoice’s meta data with the newly created customer.
  7. Switch to the "mixed documents" library and upload a document. Explain how the system prompts for a document type.
  8. Go back to invoices document library and show how clicking on a column name changes sort order.
  9. Demonstrate column-level filtering.
  10. Show different views that demonstrate multi-level sorting, filtering and grouping.
  11. Show the data sheet view.
  12. Explain the purpose of a "untagged documents" прегледати.
  13. Switch to the customized advanced search.
  14. До сада, the recently uploaded document should have been crawled and indexed, so perform a search that demonstrates ability to locate that invoice via the mapped property.
  15. We demonstrate the difference between searching via mapped properties vs. just a text search.

У овом тренутку, we are more or less done with the demo. It seems to take about 30 на 45 записник, depending on how many questions people ask.

We then send them back to their desks with "homework". This consists of a simple excel spreadsheet where we ask them to define for us what they think they need in terms of CT’s, both at a high level (just name and business purpose) as well as columns and type of data they would store in the column. We don’t ask them to define column data types in MOSS terms, but business terms.

In Summary:

We’ve created a sandbox environment that we can use to demonstrate some core MOSS features whose appeal are enterprise-wide.

We have modeled easily understood and common business entities so that users can focus on MOSS and not get bogged down on the entities / examples themselves.

Business users walk away from theses sessions with "homework" in the form of excel documents which they are now competent to fill out and use for designing their own first-cut content types.

Коначно, as we perform demos over time, the client’s team members themselves become more able to carry forward, do the demo’s themselves and generally free up the rest of us up to work on more complex issues, such as global taxonomy, complex workflows, BDC and the like.

МОСС: Функционална Пример - Цустом Тип података

Пословни сценарио:

Целом предузећу имплементација маховина за производне компаније са 30+ сајтови и неколико одељења корпоративне десетина.

Пословни циљ:

Упркос мноштву пословних група (одељења, Локације, итд), одређени подаци треба да се одржава на глобалном нивоу. На пример, ауторитативан господар списак свих физичких локација предузећа (e.g. производни објекти, warehouse locations, sales offices) should be maintained in a central location.

Technical Problem:

The enterprise taxonomy was implemented using multiple site collections. We would have liked to create the authoritative list of physical locations in a custom WSS list. Онда, when we needed to have a column in a content type (or a column added to a list or doc library) that contained corporate locations, we would create a column using the "lookup" datatype and point to this master list.

Unfortunately, lookup datatypes must access a source list "locally" meaning that our authoritative list cannot span site collections.

Техничко решење:

Implement a new custom data type implemented based on SPField and represented as a DropDownList in the UI whose ListItems populate from the master WSS list.

We created a new site collection called "http://localhost/EnterpriseData". There, we created a custom list named "Corporate Locations". This list just uses the standard "Title" field to contain the list of actual corporate locations.

One follows several discrete steps to create a custom data type in WSS. They are:

  1. Define a class which inherits from SPField (one may inherit from other fields if required).

Here is the code for that:

јавност класа XYZZYCorporateLocationField : SPFieldText
{
јавност XYZZYCorporateLocationField
(SPFieldCollection fields, ниска typeName, ниска displayName)
: base(fields, typeName, displayName) { }

јавност XYZZYCorporateLocationField
(SPFieldCollection fields, ниска displayName)
: base(fields, displayName) { }

јавност заменити BaseFieldControl FieldRenderingControl
{
get
{
BaseFieldControl control = нови XYZZYCorporateLocationFieldControl();
control.FieldName = ово.InternalName;
повратак control;
} //get
} // fieldrenderingcontrol

јавност заменити ниска GetValidatedString(објекат вредност)
{
ако (ово.Required || value.ToString().Једнако(String.Empty))
{
бацити нови SPFieldValidationException ("Department is not assigned.");
}
повратак base.GetValidatedString(вредност);
} // getvalidatedstring

} // XYZZYCorporateLocation

  1. Define another class that inherits from the base field control, као у:

јавност класа XYZZYCorporateLocationFieldControl : BaseFieldControl
{
заштићен DropDownList XYZZYCorporateLocationSelector;

заштићен заменити ниска DefaultTemplateName
{
get
{
повратак "XYZZYCorporateLocationFieldControl";
}
} // DefaultTemplateName

јавност заменити објекат Вредност
{
get
{
EnsureChildControls();
повратак ово.XYZZYCorporateLocationSelector.SelectedValue;
} // get
сет
{
EnsureChildControls();
ово.XYZZYCorporateLocationSelector.SelectedValue = (ниска)ово.ItemFieldValue;
} // сет
} // override object Value

заштићен заменити воид CreateChildControls()
{

ако (ово.Field == null || ово.ControlMode == SPControlMode.Display)
повратак;

base.CreateChildControls();

ово.XYZZYCorporateLocationSelector =
(DropDownList)TemplateContainer.FindControl("XYZZYCorporateLocationSelector");

ако (ово.XYZZYCorporateLocationSelector == null)
бацити нови Изузетак("ERROR: Cannot load .ASCX file!");

ако (!ово.Page.IsPostBack)
{

коришћење (СПСите site = нови СПСите("http://localhost/enterprisedata"))
{
коришћење (СПВеб web = site.OpenWeb())
{

СПЛист currentList = web.Lists["Corporate Locations"];

фореацх (Пљунути XYZZYCorporateLocation у currentList.Items)
{
ако (XYZZYCorporateLocation["Title"] == null) наставити;

ниска theTitle;
theTitle = XYZZYCorporateLocation["Title"].ТоСтринг();

ово.XYZZYCorporateLocationSelector.Items.Add
(нови ListItem(theTitle, theTitle));

} // фореацх

} // using spweb web = site.openweb()
} // using spsite site = new spsite("http://localhost/enterprisedata")

} // if not a postback

} // CreateChildControls

} // XYZZYCorporateLocationFieldControl

The above code basically implements the logic for populating the DropDownList with values from the WSS custom list located at http://localhost/enterprisedata and named "Corporate Departments".

I defined both classes in a single .cs file, compiled it and put it into the GAC (strong required, наравно).

  1. Implement a control template (.ascx) као што је приказано:

<%@ Control Language="C#" Inherits="Microsoft.SharePoint.Portal.ServerAdmin.CreateSiteCollectionPanel1,Microsoft.SharePoint.Portal,Version=12.0.0.0,Culture=neutral,ПублицКеиТокен = 71е9бце111е9429ц" compilationMode="Always" %>
<%
@ Регистар Tagprefix="wssawc" Namespace="Microsoft.SharePoint.WebControls" Assembly="Microsoft.SharePoint, Верзија = 12.0.0.0, Култура = неутрална, ПублицКеиТокен = 71е9бце111е9429ц" %> <%@ Регистар Tagprefix="SharePoint" Namespace="Microsoft.SharePoint.WebControls" Assembly="Microsoft.SharePoint, Верзија = 12.0.0.0, Култура = неутрална, ПублицКеиТокен = 71е9бце111е9429ц" %>
<СхареПоинт:RenderingTemplate ИД="XYZZYCorporateLocationFieldControl" runat="server">
<Шаблон>
<аспида:DropDownList ИД="XYZZYCorporateLocationSelector" runat="server" />
</Шаблон>
</
СхареПоинт:RenderingTemplate>

The above is saved into c:\program files\common files\microsoft shared\web server extensions\12\controltemplates.

  1. Коначно, we create an XML file to save into the …..\12\XML directory. This is CAML that defines our custom data type and for my example, looks like this:

<?КСМЛ верзија="1.0" кодирање="УТФ-8" ?>
<
FieldTypes>
<
FieldType>
<
Field Име="ТипеНаме">CorporateLocations</Field>
<
Field Име="ParentType">Текст</Field>
<
Field Име="TypeDisplayName">Corporate Locations</Field>
<
Field Име="TypeShortDescription">All XYZZY Corporate locations including manufacturing or other facilities.</Field>
<
Field Име="UserCreatable">TRUE</Field>
<
Field Име="ShowInListCreate">TRUE</Field>
<
Field Име="ShowInDocumentLibraryCreate">TRUE</Field>
<
Field Име="ShowInSurveyCreate">TRUE</Field>
<
Field Име="ShowInColumnTemplateCreate">TRUE</Field>
<
Field Име="FieldTypeClass">Conchango.XYZZYCorporateLocationField, XYZZYCorporateLocationField, Версион = 1.0.0.0, Култура = неутрална, PublicKeyToken=b0b19e85410990c4</Field>
<
RenderPattern Име="DisplayPattern">
<
Switch>
<
Expr>
<
Column />
</
Expr>

<Case Вредност=""/>

<Уобичајено>
<
HTML>
<![ЦДАТА[
<span style="color:Red"><Б>]]>
</
HTML>

<
Column SubColumnNumber="0" HTMLEncode="TRUE"/>

<HTML><![ЦДАТА[</Б></распон>]]></HTML>

</
Уобичајено>
</
Switch>

</
RenderPattern>
</
FieldType>
</
FieldTypes>
This XML file adds the custom data type to the WSS "library" and matches it up against the GAC’d assembly.

After moving all these bits into place, iisreset on the server and it should all start working nicely.

МОСС: Ажурирање прилагођене листе

Постоји много добрих примера ажурирање прилагођене листе преко СДК. Ево још један.

Пословни проблем: ИнфоПатх образац је дизајниран тако да омогућава корисницима да уђу на мрежи дописа куповину. ПО требовање бројеви треба да буду засновани на традиционалним редослед целобројне вредности и израчунава аутоматски.

Пословна решења: Креирање прилагођене листе МОСС садржи две колоне: "ControlField" and "ControlValue". Вредност колона садржи следећу куповину Требовање број. Note that the generic "control" конвенција за именовање предвиђа будуће контроле поља која се могу користити по потреби.

Техничко решење: Написана апликација приступити ИнфоПатх клијента. Веб сервис враћа следеће куповине требовање број и исправке вредности из листе.

Научене лекције:

  • Када додајете ове веб сервиса као извор података за ИнфоПатх обрасцу, Било ми је потребно да га претворите у УДК и чувајте их у везу за пренос података библиотеке.
  • Такође сам пронашао да је неопходно да се омогући унакрсно домена скрипти преко централне административне услуге // Апликација за управљање // образац конфигурације сервера.
  • Први пут је покушао образац за приступ веб сервис, потребно је време, а повремено, Тиме би се. Ја запетља подешавања у облику конфигурације сервера да се прошири и временски период и параметре који се чинило да помогне.

Код:

коришћење Систем;
коришћење System.Web;
коришћење System.Web.Services;
коришћење System.Web.Services.Protocols;
коришћење Microsoft.SharePoint;
коришћење System.Configuration;

[Вебсервице(Namespace = "http://ввв.цонцханго.цом/")]
[ВебСервицеБиндинг(ConformsTo = ВсиПрофилес.БасицПрофиле1_1)]
јавност класа ПоСервице : System.Web.Services.Вебсервице
{
јавност ПоСервице () {

//Uncomment the following line if using designed components
//ИнитиализеЦомпонент();
}

/// <резиме>
/// Obtain the next PO number from the sharepoint po number control list.
/// Increment the PO number in that list.
/// </резиме>
/// <повраћај></повраћај>
[ВебМетход]
јавност ниска GetNextPoNumber()
{
ниска СпПоЦонтролСитеНаме; // Name of the actual MOSS site that hosts the PO Control list.
ниска СпПоЦонтролЛистНаме; // Name of the actual MOSS list containing the Po control.

SpPoControlSiteName = ЦонфигуратионСеттингс.АппСеттингс["PoControlListHostingSite"].ТоСтринг();
SpPoControlListName = ЦонфигуратионСеттингс.АппСеттингс["PoControlList"].ТоСтринг();

ниска nextPoReqNumber = "xyzzy";

коришћење (СПСите site = нови СПСите(СпПоЦонтролСитеНаме))
{
коришћење (СПВеб web = site.OpenWeb())
{

СПЛист currentList = web.Lists[СпПоЦонтролЛистНаме];

фореацх (Пљунути цонтролИтем у currentList.Items)
{

ако (((ниска)цонтролИтем["ControlField"]).Једнако("NextPoNumber"))
{
nextPoReqNumber = (ниска)цонтролИтем["ControlValue"];

инт int_nextPoReqNumber;
int_nextPoReqNumber = Претворити.ТоИнт32(нектПоРекНумбер);

int_nextPoReqNumber ;

цонтролИтем["ControlValue"] = int_nextPoReqNumber;
controlItem.Update();
}

} // Locating, reading and updating the PO number in the list.


} // using spweb web = site.openweb()
} // using spsite site = new spsite("http://localhost/mizuho")

повратак нектПоРекНумбер;

}
}