Программное редактирование контента Sharepoint Wiki - PullRequest
7 голосов
/ 07 января 2009

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

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

Ответы [ 2 ]

7 голосов
/ 27 января 2011

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

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

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

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

Я использую сервис копирования, как в первой ссылке, для создания и обновления вики-страниц. В 2010 году вы можете использовать службу списков для обновления, но не для добавления. Я использую сервис 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. Это круто!

3 голосов
/ 07 января 2009

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

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

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

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

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

Добро пожаловать на сайт PullRequest, где вы можете задавать вопросы и получать ответы от других членов сообщества.
...