| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
| <HTML> |
| <HEAD><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> |
| <title>IM Robot</title> |
| <style type="text/css">@import url("../../../../org.eclipse.platform.doc.isv/book.css");</style> |
| <style type="text/css">@import url("../../../../org.eclipse.platform.doc.isv/schema.css");</style> |
| </HEAD> |
| <BODY> |
| <H1 style="text-align:center">IM Robot</H1> |
| <p></p> |
| <h6 class="CaptionFigColumn SchemaHeader">Identifier: </h6>org.eclipse.ecf.presence.bot.imRobot<p></p> |
| <h6 class="CaptionFigColumn SchemaHeader">Since: </h6>1.0.0 milestone 6 |
| <p></p> |
| |
| <h6 class="CaptionFigColumn SchemaHeader">Description: </h6>This extension point allows implementers to define a im bot.<p></p> |
| <h6 class="CaptionFigColumn SchemaHeader">Configuration Markup:</h6> |
| <p></p> |
| <p class="code SchemaDtd"><!ELEMENT <a name="e.extension">extension</a> (<a href="#e.imRobot">imRobot</a>)+></p> |
| <p class="code SchemaDtd"><!ATTLIST extension</p> |
| <p class="code SchemaDtdAttlist">point CDATA #REQUIRED</p> |
| <p class="code SchemaDtdAttlist">id CDATA #IMPLIED</p> |
| <p class="code SchemaDtdAttlist">name CDATA #IMPLIED></p> |
| <p></p> |
| <ul class="ConfigMarkupAttlistDesc"> |
| </ul> |
| <br><p class="code SchemaDtd"><!ELEMENT <a name="e.imRobot">imRobot</a> EMPTY></p> |
| <p class="code SchemaDtd"><!ATTLIST imRobot</p> |
| <p class="code SchemaDtdAttlist">id CDATA #REQUIRED</p> |
| <p class="code SchemaDtdAttlist">containerFactoryName CDATA #REQUIRED</p> |
| <p class="code SchemaDtdAttlist">connectId CDATA #REQUIRED</p> |
| <p class="code SchemaDtdAttlist">name CDATA #IMPLIED</p> |
| <p class="code SchemaDtdAttlist">connectPassword CDATA #IMPLIED></p> |
| <p></p> |
| <p class="ConfigMarkupElementDesc"> |
| The imrobot extension point.</p> |
| <br> |
| <ul class="ConfigMarkupAttlistDesc"> |
| <li><b>id</b> - The required id for the im robot. This must be a unique value relative to all other im robots. For message handlers that are to use this robot, they must provide a imrobotid that matches this value.</li> |
| <li><b>containerFactoryName</b> - The required container factory name. This should be the container factory name for a given protocol. For example, for the built in ECF IRC provider the value is <b>ecf.xmpp.smack</b>.</li> |
| <li><b>connectId</b> - The connect ID for connecting to the given container. For example, for XMPP the expected ID syntax of the connect ID is |
| <pre class="Example"><span class="code SchemaTag"> |
| username@host[:port] |
| |
| for example: slewis@ecf.eclipse.org |
| </span></pre></li> |
| <li><b>name</b> - An optional name for the bot.</li> |
| <li><b>connectPassword</b> - An optional connect password. If a password is required to connect to the given container then an appropriate value must be provided.</li> |
| </ul> |
| <br><h6 class="CaptionFigColumn SchemaHeader">Examples: </h6><pre class="Example"><span class="code SchemaTag"> |
| <extension |
| point=</span><span class="code SchemaCstring">"org.eclipse.ecf.presence.bot.imRobot"</span><span class="code SchemaTag">> |
| <imRobot |
| connectID=</span><span class="code SchemaCstring">"slewis@ecf.eclipse.org"</span><span class="code SchemaTag"> |
| containerFactoryName=</span><span class="code SchemaCstring">"ecf.xmpp.smack"</span><span class="code SchemaTag"> |
| id=</span><span class="code SchemaCstring">"org.eclipse.ecf.presence.imbot.defaultbot"</span><span class="code SchemaTag">/> |
| </imRobot> |
| </extension> |
| </span></pre> |
| |
| Note that to have the imrobot receive im messages and process them, that the immessagehandler should also be defined |
| using the id for the imrobot given above. For example: |
| |
| <pre class="Example"><span class="code SchemaTag"> |
| <extension |
| point=</span><span class="code SchemaCstring">"org.eclipse.ecf.presence.bot.immessagehandler"</span><span class="code SchemaTag">> |
| <handler |
| imrobotid=</span><span class="code SchemaCstring">"org.eclipse.ecf.presence.imbot.defaultbot"</span><span class="code SchemaTag"> |
| class=</span><span class="code SchemaCstring">"org.eclipse.ecf.presence.imbot.DefaultIMMessageHandler"</span><span class="code SchemaTag">> |
| </handler> |
| </extension> |
| </span></pre> |
| <p></p> |
| |
| <h6 class="CaptionFigColumn SchemaHeader">API Information: </h6>See the API information for the immessagehandler. |
| <p></p> |
| |
| <h6 class="CaptionFigColumn SchemaHeader">Supplied Implementation: </h6>No supplied implementation. |
| <p></p> |
| |
| <br> |
| <p class="note SchemaCopyright"> |
| Copyright (c) 2007 IBM Corporation and others. |
| |
| This program and the accompanying materials are made |
| available under the terms of the Eclipse Public License 2.0 |
| which is available at https://www.eclipse.org/legal/epl-2.0/ |
| |
| SPDX-License-Identifier: EPL-2.0 |
| |
| </p> |
| </BODY> |
| </HTML> |
