Программное редактирование контента Sharepoint Wiki

Question

Я хочу редактировать контент Sharepoint Wiki программным способом. Одним из преимуществ будет автоматическое добавление индексов в среду Wiki.

Кто-нибудь был в состоянии сделать это? Язык не имеет значения, но поиск сценария решения.

Answer 1

Вики SharePoint - это просто особый тип библиотеки документов. Есть только несколько странностей, с которыми я сталкиваюсь, пытаясь сделать это.

Вики-страница SharePoint состоит из файла шаблона и элемента списка. При просмотре страницы поля из элемента списка вставляются в файл шаблона. Таким образом, чтобы обновить страницу вики, вам просто нужно обновить правильные поля в элементе списка. (Между прочим, это также означает, что вы не можете получить исходный шаблон, как вы могли бы получить файл в обычной библиотеке документов. Пока что я нашел единственный способ получить сам шаблон - загрузить его через SharePoint Designer.)

Кроме того, SharePoint автоматически отображает содержимое вики при программном доступе к элементу списка. Поэтому я так и не смог получить контент, который содержал, например, "[[My Link Name]]" - вместо этого SharePoint всегда возвращал отображаемый HTML, например:

<A class=ms-wikilink href="/MyWikiLibrary/MyLinkName.aspx">My Link Name</A>

Немного поработав с регулярными выражениями, вы сможете преобразовать это обратно в оригинальный контент вики.

Answer 2

Да. Я развернул свой собственный API Metaweblog, который программно управляет вики-страницами в Sharepoint 2010 и 2007.

Мои источники:

• http://sites.google.com/site/sharepointwikiuploader/
• http://blogs.msdn.com/b/dwinter/archive/2008/06/28/migrating-wiki-pages-remotely-part-01.aspx (части 1 - 6)

Сервисный код для SP 2010 и 2007 в значительной степени идентичен, но есть несколько предостережений:

• В 2010 году не нужно беспокоиться об управлении разметкой вики-ссылок (например, [[brackets]]).
• В 2007 году разметка вики конвертировалась по вашему запросу, поэтому вы должны повторно преобразовать ее в разметку вики, прежде чем отправлять обратно. При повторной публикации вы не можете использовать UpdateListItems, вы должны использовать службу копирования. Это потому, что UpdateListItems будет избегать любой вики-разметки, эффективно делая ваши усилия бесполезными.
• В нашей среде мы требуем заполнить RecordType перед регистрацией. Может быть, это стандарт? Если вы не установите это поле, ваша страница останется за вами. Итак, у меня есть условие, которое устанавливает это поле для SP2007.
• В 2010 году SP добавляет кучу разметки в необработанное значение WikiField, и, если оно отсутствует, оно может испортить макеты. Я просто вставляю его вокруг значения, которое публикует WLW, а затем убираю его при получении. Увидеть ниже.

Я использую сервис копирования, как в первой ссылке, чтобы создавать и обновлять вики-страницы. В 2010 году вы можете использовать сервис Lists для обновления, но не для добавления. Я использую сервис Imaging для автоматической загрузки изображений в библиотеку изображений.

Вот функция для замены "ms-wikilinks" на вики-разметку:

Примечание: я использую HTMLAgilityPack в случае, если возвращенная разметка искажена. Вы можете использовать Regex, чтобы сделать это тоже. Я также использую библиотеку Microsoft Anti-XSS 4.1 для очистки разметки.

Примечание 2: моя функция UrlDecode не зависит от System.Web, взятой отсюда.

/// <summary>
/// Sharepoint 2007 is mean and converts [[wiki links]] once the page is saved in the Sharepoint editor.
/// Luckily, each link is decorated with class="ms-wikilink" and follows some conventions.
/// </summary>
/// <param name="html"></param>
/// <returns></returns>
private static string ConvertAnchorsToWikiLinks(this string html)
{
    HtmlDocument htmlDoc = new HtmlDocument();

    htmlDoc.LoadHtml(html);

    var anchorTags = (from d in htmlDoc.DocumentNode.Descendants()
                      where d.Attributes.Contains("class") && d.Attributes["class"].Value == "ms-wikilink"
                      select d).ToList();

    foreach (var anchor in anchorTags)
    {
        // Two kinds of links
        // [[Direct Link]]
        // [[Wiki Page Name|Display Name]]
        var wikiPageFromLink = UrlDecode(anchor.Attributes["href"].Value.Split('/').LastOrDefault().Replace(".aspx", ""));
        var wikiPageFromText = anchor.InnerText;

        HtmlNode textNode = null;

        if (wikiPageFromLink == wikiPageFromText)
        {
            // Simple link
            textNode = HtmlTextNode.CreateNode("[[" + wikiPageFromText + "]]");
        }
        else
        {
            // Substituted link
            textNode = HtmlTextNode.CreateNode(String.Format("[[{0}|{1}]]", wikiPageFromLink, wikiPageFromText));
        }

        if (textNode != null)
        {
           anchor.ParentNode.ReplaceChild(textNode, anchor);
        }
    }

    return htmlDoc.DocumentNode.InnerHtml;
}

Функция для удаления HTML-кода SharePoint:

/// <summary>
/// Gets editable HTML for a wiki page from a SharePoint HTML fragment.
/// </summary>
/// <param name="html"></param>
/// <returns></returns>
public static string GetHtmlEditableContent(string html)
{
    HtmlDocument htmlDoc = new HtmlDocument();

    htmlDoc.LoadHtml(html);

    HtmlNode divNode = (from d in htmlDoc.DocumentNode.Descendants()
                        where d.Attributes.Contains("class") && d.Attributes["class"].Value == "ms-rte-layoutszone-inner"
                        select d).FirstOrDefault();
    HtmlNode divNode2 = (from d in htmlDoc.DocumentNode.Descendants()
                         where d.Attributes.Contains("class") && d.Attributes["class"].Value.StartsWith("ExternalClass")
                         select d).FirstOrDefault();

    if (divNode != null)
    {
        // SP 2010
        return divNode.InnerHtml;
    }
    else if (divNode2 != null)
    {
        // SP 2007 or something else
        return divNode2.InnerHtml.ConvertAnchorsToWikiLinks();
    }
    else
    {
        return null;
    }
}

И, наконец, функция, которая добавляет эту разметку обратно:

/// <summary>
/// Inserts SharePoint's wrapping HTML around wiki page content. Stupid!
/// </summary>
/// <param name="html"></param>
/// <returns></returns>
public static string InsertSharepointHtmlWrapper(string html, SharePointVersion spVersion)
{
    // No weird wrapper HTML for 2007
    if (spVersion == SharePointVersion.SP2007)
        return Microsoft.Security.Application.Sanitizer.GetSafeHtmlFragment(html);

    HtmlDocument htmlDoc = new HtmlDocument();

    htmlDoc.LoadHtml(@"<table id='layoutsTable' style='width:100%'>
                            <tbody>
                                <tr>
                                    <td>
                                        <div class='ms-rte-layoutszone-outer' style='width:99.9%'>
                                            <div class='ms-rte-layoutszone-inner' style='min-height:60px;word-wrap:break-word'>
                                            </div>
                                        </div>
                                    </td>
                                </tr>
                            </tbody>
                        </table>
                        <span id='layoutsData' style='display:none'>false,false,1</span>");

    HtmlNode divNode = (from d in htmlDoc.DocumentNode.Descendants()
                        where d.Attributes.Contains("class") && d.Attributes["class"].Value == "ms-rte-layoutszone-inner"
                        select d).FirstOrDefault();

    divNode.InnerHtml = Microsoft.Security.Application.Sanitizer.GetSafeHtmlFragment(html);

    return htmlDoc.DocumentNode.InnerHtml;
}

Это прекрасно работает.

• Страницы по-прежнему сохраняют последнего измененного и правильного пользователя
• Страницы сохранят всю свою историю
• Страницы проще в управлении

Я думаю о публикации своего API, это не очень много кода, я думаю, что это очень полезно для тех из нас, кто хочет лучше управлять нашими вики-сайтами Sharepoint. С WLW я получаю автоматическую загрузку изображений, лучшую поддержку редактирования HTML и поддержку плагинов, таких как PreCode Snippet. Это круто!