<!-- $XConsortium: ch05.sgm /main/5 1996/08/25 15:13:45 rws $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->

<chapter id="RDMAP.BIntg.div.1">
<title id="RDMAP.BIntg.mkr.1">Basic Application Integration</title>
<para>Basic application integration is a set of highly recommended tasks you
should perform. These tasks <emphasis>do not</emphasis> require modification
of the source code for your application.</para>
<informaltable id="RDMAP.BIntg.itbl.1" frame="All">
<tgroup cols="1">
<colspec colname="1" colwidth="4.0 in">
<tbody>
<row rowsep="1">
<entry><para><!--Original XRef content: 'Basic Integration Features41'--><xref
role="JumpText" linkend="RDMAP.BIntg.mkr.2"></para></entry></row>
<row rowsep="1">
<entry><para><!--Original XRef content: 'Organization of Basic Integration
Information42'--><xref role="JumpText" linkend="RDMAP.BIntg.mkr.3"></para></entry>
</row>
<row rowsep="1">
<entry><para><!--Original XRef content: 'Basic Integration Tasks43'--><xref
role="JumpText" linkend="RDMAP.BIntg.mkr.4"></para></entry></row></tbody>
</tgroup></informaltable>
<para>Basic integration does not involve extensive use of the desktop application
program interface (API). Therefore, it does not provide other interaction
with the desktop, such as drag and drop, session management, ToolTalk messaging,
and programmatic access to the actions and data types database.</para>
<sect1 id="RDMAP.BIntg.div.2">
<title id="RDMAP.BIntg.mkr.2">Basic Integration Features</title>
<para>Basic application integration provides these features for end users:
</para>
<itemizedlist remap="Bullet1"><listitem><para>A graphical way to locate and
start your application on the desktop.</para>
<para>Your application will provide a desktop <symbol role="Variable">registration
package</symbol>, and your installation script will automatically register
your application.</para>
<para>Registration creates an application group at the top level of Application
Manager. The application group contains an icon the user double-clicks to
start the application.</para>
</listitem><listitem><para>The ability to recognize and manipulate your application's
data files.</para>
<para>Your application will provide data types for its data files.</para>
<para>Data typing configures data files to use a unique icon in File Manager
to help users identify them. The data files also have meaningful desktop
behavior. Two examples are:</para>
<itemizedlist remap="Bullet2"><listitem><para>The user can start your application
by double-clicking a data file.</para>
</listitem><listitem><para>Dropping a data file on a desktop printer drop
zone prints the file using the appropriate print command.</para>
</listitem></itemizedlist>
</listitem><listitem><para>Easy font and color selection using Style Manager.
</para>
<para>Your application will change interface fonts and background, foreground,
and shadow colors dynamically.</para>
<para>The desktop defines general interface font and color resources that
are used if no corresponding application-specific resources exist.</para>
</listitem></itemizedlist>
<para>Basic integration provides these advantages to system administrators:
</para>
<itemizedlist remap="Bullet1"><listitem><para>Easy installation and registration.
</para>
<para>Upon installation, the application is automatically registered. The
system administrator has little or no additional work to do.</para>
</listitem><listitem><para>Easy ongoing administration.</para>
<para>All the desktop's configuration files are gathered in one location.
Furthermore, the application can easily be unregistered if, for example,
the system administrator wants to update it or to move it to a different
application server.</para>
</listitem></itemizedlist>
</sect1>
<sect1 id="RDMAP.BIntg.div.3">
<title id="RDMAP.BIntg.mkr.3">Organization of Basic Integration Information</title>
<para>Most of the tasks involved in basic integration are also performed by
system administrators who are integrating an existing application into the
desktop. Therefore, most basic integration documentation is located in the <emphasis>Advanced User's and System Administrator's Guide</emphasis>.</para>
<para>The <emphasis>Programmer's Guide</emphasis> contains a chapter on basic
integration. Where appropriate, the chapter refers you to the information
contained in the <emphasis>Advanced User's and System Administrator's Guide</emphasis>. It also contains additional information specific to application
programmers.</para>
</sect1>
<sect1 id="RDMAP.BIntg.div.4">
<title id="RDMAP.BIntg.mkr.4">Basic Integration Tasks</title>
<para>These are the general tasks involved in basic integration:</para>
<itemizedlist remap="Bullet1"><listitem><para>Modify any application resources
that set fonts and colors. This allows users to change the application's
interface fonts and colors using Style Manager.</para>
<para>See the section on modifying font and color resources in the <emphasis>Advanced User's and System Administrator's Guide</emphasis>.</para>
</listitem><listitem><para>Provide printing for your application's data files.
</para>
<para>See the <emphasis>Programmer's Guide</emphasis> basic integration chapter
for details.</para>
<para>Some types of printing integration require that you modify your application
code. They are optional, and are discussed in the <emphasis>Programmer's
Guide</emphasis> basic integration chapter because they are closely related
to basic integration tasks.</para>
</listitem><listitem><para>Create the registration package for your application.
</para>
<para>See this documentation:</para>
<itemizedlist remap="Bullet2"><listitem><para><emphasis>Programmer`s Guide</emphasis> basic integration chapter</para>
</listitem><listitem><para><emphasis>Advanced User's and System Administrator's
Guide</emphasis></para>
</listitem></itemizedlist>
</listitem><listitem><para>Modify your application's installation script to
install the registration package files and perform the registration procedure.
</para>
<para>See this documentation:</para>
<itemizedlist remap="Bullet2"><listitem><para><emphasis>Programmer's Guide</emphasis> basic integration chapter</para>
</listitem><listitem><para>The section on registering the application using <command>dtappintegrate</command> in the <emphasis>Advanced User's and System Administrator's
Guide</emphasis></para>
</listitem></itemizedlist>
</listitem></itemizedlist>
<programlisting></programlisting>
</sect1>
</chapter>
<!--fickle 1.14 mif-to-docbook 1.7 01/02/96 04:30:53-->
<?Pub Caret>
<?Pub *0000007986>
