os:activity element

Article
2017-08-15

Contains all of the functionality of an Accelerator.

Usage

<os:activity
  category = "sCategory">
  child elements
</os:activity>

Attributes

Attribute	Type	Required	Description
category	sCategory	Yes	Specifies a category for the activity. The following values are examples: Add Add a bookmark, or comment using a social network. Blog Copy selected content to a blog. Define Look up a word's definition. Map Locate address on a map. Translate Translate a word or document.

category

sCategory

Yes

Specifies a category for the activity. The following values are examples:

Add

Add a bookmark, or comment using a social network.

Blog

Copy selected content to a blog.

Define

Look up a word's definition.

Map

Locate address on a map.

Translate

Translate a word or document.

Child elements

Element
os:activityAction

Child element sequence

os:activityAction+

Parent elements

Element
os:openServiceDescription

Remarks

Each os:activity element specifies a category attribute that describes a type of functionality. Accelerators are organized by category so that users can quickly access the type of operation that they want. The user determines the default Accelerator for a given category value when the Accelerator is installed.

If your Accelerator doesn't fit a recommended category, you can define your own. The category should be a verb that the user can recognize and not be tied to a specific brand or application. Additionally, because the value of the category attribute is used by Manage Add-ons to organize Accelerators in groups, it should be human-readable and capitalized appropriately.

Examples

The following Accelerator allows the user to quickly send important document details to a blogging service.

<?xml version="1.0" encoding="utf-8" ?> 
<openServiceDescription
    xmlns="https://www.microsoft.com/schemas/openservicedescription/1.0">
  <homepageUrl>http://example.com/</homepageUrl> 
  <display>
    <name>Blog with MyBlogs</name> 
    <icon>http://example.com/favicon.ico</icon>
  </display>
  <activity category="Blog">
    <activityAction context="selection">
      <execute method="get" action="http://www.example.com/BlogIt.aspx">
        <parameter name="title" value="{documentTitle}" /> 
        <parameter name="SourceURL" value="{documentUrl}" /> 
        <parameter name="description" value="{selection}" type="html" /> 
      </execute>
    </activityAction>
    <activityAction context="document">
      <execute method="get" action="http://www.example.com/BlogIt.aspx">
        <parameter name="title" value="{documentTitle}" /> 
        <parameter name="SourceURL" value="{documentUrl}" />
      </execute>
    </activityAction>
    <activityAction context="link">
      <execute method="get" action="http://www.example.com/BlogIt.aspx">
        <parameter name="title" value="{linkTitle}" /> 
        <parameter name="SourceURL" value="{link}" />
      </execute>
    </activityAction>
  </activity>
</openServiceDescription>

Element information

Minimum supported system	Windows XP with SP2
Can be empty	No

Share via