Add third-party links via the XML configuration file 

You can extend the Profiles business card by adding links to applications from another vendor.


Before starting

To edit configuration files, use the wsadmin client. See Starting the wsadmin client for information about how to start the wsadmin command-line tool.


About this task

You can specify links to services acquired from another vendor in the <WAS_HOME>\profiles\<WAS_Profile>\config\cells\<Host_name>\LotusConnections-config \LotusConnections-config.xml file. The service reference must have a person_card_service_url_pattern attribute and a person_card_service_name_js_eval attribute. Without these attributes, the service link does not display in the inline or pop-up business cards.

To extend the Profiles business card...


Procedure

  1. From the dmgr host:

    If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.

  2. Check out the IBM Connections configuration files:

      LCConfigService.checkOutConfig("<working_directory>","<cell_name>")

      where:

      • <working_directory> is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.

          AIX and Linux only: The directory must grant write permissions or the command does not run successfully.

      • <cell_name> is the name of the WAS cell hosting the IBM Connections application. This argument is case-sensitive, so type it with care. To obtain the cell name:print AdminControl.getCell()

      For example:

      • AIX or Linux:LCConfigService.checkOutConfig("/opt/temp","foo01Cell01")

      • Microsoft Windows:LCConfigService.checkOutConfig("c:/temp","foo01Cell01")

  • Open the LotusConnections-config.xml file, and modify it to include the following attributes:

      Table 1. Third-party service reference attributes
      Attribute Description
      person_card_service_url_pattern Represents the URL pattern that is used when users click the service link. The ampersand character (&) must be expressed using the actual character in the pattern. This attribute takes a string value.

      The following parameters inside the URL pattern are placeholders. When the business card is rendered at runtime, the parameters are replaced by the real values.

      • {email}. The profile user's email address.

      • {userid}. The profile user's user ID.

      • {uid}. The profile user's UID.

      • {displayName}. The profile user's full name.

      • {workPhoneNumber}. The profile user's work telephone number.

      person_card_service_name_js_eval Represents a JavaScriptâ„¢ statement that is used by the framework to generate the text displayed in the business card for the given service.

      This attribute takes a string value.

      You can add a resource string as the value for this attribute. The resource string must include "generalrs." before the resource bundle key. See Add custom strings for widgets and other specified scenarios for information about how to add resource strings to the business card.

      For example:

      <sloc:serviceReference serviceName="googleService"
        href="http://www.google.com"   enabled="true"
        ssl_href="http://www.google.com"   ssl_enabled="false"
        person_card_service_url_pattern="/search?hl=en&amp;q={email}&amp;btnG=Google+Search"
        person_card_service_name_js_eval="'Google Me'"/>
       
      <sloc:serviceReference serviceName="quickr"
        href="http://quickrdomino.tap.ibm.com/servlet"   enabled="true"
        ssl_href="https://quickrdomino.tap.ibm.com/servlet"   ssl_enabled="true"
        person_card_service_url_pattern="/QuickrEntry?email={email}"
        person_card_service_name_js_eval="generalrs.label_personcard_quickrlink"/>
       
      <sloc:serviceReference serviceName="communities"
        href="http://wd40.lotus.com/communities"   enabled="true"
        ssl_href="https://wd40.lotus.com/communities"   ssl_enabled="true"
        person_card_service_url_pattern="/service/html/allcommunities?email={email}"
        person_card_service_name_js_eval="generalrs.label_personcard_communitieslink"/>
       
      <sloc:serviceReference serviceName="profiles"
        href="http://wd40.lotus.com/profiles"   enabled="true"
        ssl_href="http://wd40.lotus.com/profiles"   ssl_enabled="true"
      person_card_service_url_pattern="/html/simpleSearch.do?searchFor={email}&amp;searchBy=email"
        person_card_service_name_js_eval="generalrs.label_personcard_profilelink"/>

  • Edit the service-location.xsd file to define the service names used.

      For example:

      <xsd:simpleType name="serviceNames">
          <xsd:restriction base="xsd:string">
            <xsd:enumeration value="activities" />
            <xsd:enumeration value="blogs" />
            <xsd:enumeration value="communities" />
            <xsd:enumeration value="directory" />
            <xsd:enumeration value="dogear" />
            <xsd:enumeration value="personTag" />
            <xsd:enumeration value="presenceAwareness" />
            <xsd:enumeration value="profiles" />
            <xsd:enumeration value="sametimeLinks" />
            <xsd:enumeration value="homepage" />
            <xsd:enumeration value="googleService" />
           <xsd:enumeration value="quickr" />
          </xsd:..>
        </xsd:..>

  • After making changes, check the configuration files back in, and do so during the same wsadmin session in which you checked them out for the changes to take effect. See Apply common configuration property changes for information about how to save and apply your changes.


    Parent topic

    Customize the Profiles business card


    Related tasks


    Apply common configuration property changes
    Add custom strings for widgets and other specified scenarios


       

     

    });

    +

    Search Tips   |   Advanced Search