02 August 2010 HowTo, MetaWeblog Robert Muehsig

imageDieser Blogpost basiert auf Scott Hanselmans "WeeklySourceCode”, wo diese Woche das Thema MetaWebLogAPI dran kam. In dem Blogpost berichtet er, dass MS auch intern zum Verwalten ihrer Seiten den Windows Live Writer nutzen. Das Tool ist absolut praktisch und ist "MetaWebLogAPI” kompatibel. Durch diese API ist es z.B. möglich mit Standard Tools (Word oder den Windows Live Writer) "CMS” Content zu erzeugen.

Was nützt mir das?

Der normale Endanwender mag ein einfachen WYSIWYG Editor haben. Es gibt einige nette Editoren, wie z.B. tinyMCE. Das größte Problem was ich bislang mit solchen Web-basierten Lösungen habe ist, dass der Umgang mit Bildern meistens Arg abenteuerlich gestaltet ist. Der normale User mag es, einfach die Bilder per Copy and Paste ins Word zu verschieben und dort noch ein paar Effekte anzustellen. Wenn man nun selber Webseitenbetreiber ist und seinen Kunden ein "einfaches” Frontend zur Verfügung stellen möchte, der kann die MetaWebLog API implementieren.

Standard Tools

Der große Vorteil ergibt sich durch die netten Clients. Auf der einen Seite gibt es z.B. den Windows Live Writer:

image

Aber auch Word ab der Version 2007:

image

In diesen Tools kann man einfach aus der Zwischenablage Bilder etc. einfügen und entsprechend editieren. Erst beim "Veröffentlichen” werden die Daten zum Server übertragen.

Technischer Hintergrund: XmlRPC

Die MetaWebLog API basiert nicht auf SOAP, sondern auf XML Remote Process Call (RPC). Im Grunde wird dort auch nur XML übertragen. Ein Beispiel von Wikipedia:

<?xml version="1.0"?>
<methodCall>
  <methodName>examples.getStateName</methodName>
  <params>
    <param>
        <value><i4>40</i4></value>
    </param>
  </params>
</methodCall>

Dafür gibt es auch einen .NET Wrapper.

Die MetaWebLog API hat ein festes Set an Methoden. Dafür wurde bereits im Jahre 2008 von Keyvan Nayyeri eine Schnittstelle für ASP.NET.

namespace NotABlog
{
    public interface IMetaWeblog
    {
        #region MetaWeblog API
 
        [XmlRpcMethod("metaWeblog.newPost")]
        string AddPost(string blogid, string username, string password, Post post, bool publish);
 
        [XmlRpcMethod("metaWeblog.editPost")]
        bool UpdatePost(string postid, string username, string password, Post post, bool publish);
 
        [XmlRpcMethod("metaWeblog.getPost")]
        Post GetPost(string postid, string username, string password);
 
        [XmlRpcMethod("metaWeblog.getCategories")]
        CategoryInfo[] GetCategories(string blogid, string username, string password);
 
        [XmlRpcMethod("metaWeblog.getRecentPosts")]
        Post[] GetRecentPosts(string blogid, string username, string password, int numberOfPosts);
 
        [XmlRpcMethod("metaWeblog.newMediaObject")]
        MediaObjectInfo NewMediaObject(string blogid, string username, string password, MediaObject mediaObject);
 
        #endregion
 
        #region Blogger API
 
        [XmlRpcMethod("blogger.deletePost")]
        [return: XmlRpcReturnValue(Description = "Returns true.")]
        bool DeletePost(string key, string postid, string username, string password, bool publish);
 
        [XmlRpcMethod("blogger.getUsersBlogs")]
        BlogInfo[] GetUsersBlogs(string key, string username, string password);
 
        [XmlRpcMethod("blogger.getUserInfo")]
        UserInfo GetUserInfo(string key, string username, string password);
 
        #endregion
    }
}

Diese Schnittstelle hat ScottHa in seinem Demoprojekt implementiert, so z.B. :

string IMetaWeblog.AddPost(string blogid, string username, string password,
    Post post, bool publish)
{
    if (ValidateUser(username, password))
    {
        string id = string.Empty;
        string postFileName;
        if (String.IsNullOrEmpty(post.title))
            postFileName = Guid.NewGuid() + ".html";
        else
            postFileName = post.title + ".html";
 
        File.WriteAllText(Path.Combine(LocalPublishPath, postFileName), post.description);
         
        return postFileName;
    }
    throw new XmlRpcFaultException(0, "User is not valid!");
}

Da ich mich fragte, was mit Bildern geschieht: Diese kommen in der Methode "NewMediaObject” an und können dort als byte Array verarbeitet werden.

Demoprojekt gibts bei ScottHa

Wie bereits gesagt, basiert dieser Post auf dem Post von Scott. Er hat auch sein Demoprojekt veröffentlicht und Daten die ich vom Windows Live Writer oder Word abschicke kommen auch bei den entsprechenden Methoden an.


Written by Robert Muehsig

Software Developer - from Saxony, Germany - working on primedocs.io. Microsoft MVP & Web Geek.
Other Projects: KnowYourStack.com | ExpensiveMeeting | EinKofferVollerReisen.de