1744 lines
95 KiB
Plaintext
1744 lines
95 KiB
Plaintext
<!-- $XConsortium: ch10.sgm /main/11 1996/12/21 18:56:41 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="SAG.CrAct.div.1">
|
|
<title id="SAG.CrAct.mkr.1"><indexterm><primary>Actions</primary><secondary>cré</secondary></indexterm><indexterm><primary>ation manuelle</primary>
|
|
</indexterm>Création manuelle d'actions</title>
|
|
<para>Une action peut être définie de deux façons:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>à l'aide de l'utilitaire “Créer action”
|
|
</para>
|
|
</listitem>
|
|
<listitem><para>en créant manuellement une définition d'action
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>Pour créer une action manuellement, vous devez éditer
|
|
un fichier de base de données; le présent chapitre explique
|
|
comment effectuer cette opération.</para>
|
|
<informaltable id="SAG.CrAct.itbl.1" frame="All">
|
|
<tgroup cols="1" colsep="1" rowsep="1">
|
|
<colspec colwidth="4.77in">
|
|
<tbody>
|
|
<row>
|
|
<entry align="left" valign="top"><para><!--Original XRef content: 'Pourquoi
|
|
créer manuellement une action166'--><xref role="JumpText" linkend="SAG.CrAct.mkr.2"></para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><!--Original XRef content: 'Création
|
|
manuelle d'une action: étapes principales167'--><xref role="JumpText" linkend="SAG.CrAct.mkr.4"></para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><!--Original XRef content: 'Création
|
|
de la chaîne d'exécution d'une action COMMAND177'--><xref role="JumpText"
|
|
linkend="SAG.CrAct.mkr.13"></para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><!--Original XRef content: 'Support
|
|
de fenêtrage et émulateurs de terminal pour les actions COMMAND184'--><xref
|
|
role="JumpText" linkend="SAG.CrAct.mkr.24"></para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><!--Original XRef content: 'Restriction
|
|
des actions à certains arguments186'--><xref role="JumpText" linkend="SAG.CrAct.mkr.29"></para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><!--Original XRef content: 'Création
|
|
d'actions exécutant des applications sur des systèmes éloignés189'--><xref
|
|
role="JumpText" linkend="SAG.CrAct.mkr.32"></para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><!--Original XRef content: 'Utilisation
|
|
de variables dans les définitions d'actions et de types de données190'--><xref
|
|
role="JumpText" linkend="SAG.CrAct.mkr.34"></para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><!--Original XRef content: 'Exécution
|
|
d'actions à partir de la ligne de commande192'--><xref role="JumpText" linkend="SAG.CrAct.mkr.37"></para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><!--Original XRef content: 'Création
|
|
d'actions internationalisées193'--><xref role="JumpText" linkend="SAG.CrAct.mkr.39"></para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><!--Original XRef content: 'Création
|
|
d'actions pour les applications ToolTalk195'--><xref role="JumpText" linkend="SAG.CrAct.mkr.40"></para></entry>
|
|
</row></tbody></tgroup></informaltable>
|
|
<sect1 id="SAG.CrAct.div.2">
|
|
<title>Voir aussi</title>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>Pour plus de détails sur les actions, reportez-vous
|
|
au <!--Original XRef content: 'chapitre 8,
|
|
”Introduction aux actions et aux types de données”'--><xref role="ChapNumAndTitle"
|
|
linkend="SAG.IntAc.mkr.1">.</para>
|
|
</listitem>
|
|
<listitem><para>Pour savoir comment utiliser “Créer action”,
|
|
reportez-vous au <!--Original XRef content: 'chapitre 9,
|
|
”Création d'actions et de types de donnés à l'aide de Créer action”'-->.
|
|
</para>
|
|
</listitem>
|
|
<listitem><para>Pour plus de détails sur les définitions d'actions,
|
|
consultez la page de manuel <filename>dtactionfile(4)</filename>.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</sect1>
|
|
<sect1 id="SAG.CrAct.div.3">
|
|
<title id="SAG.CrAct.mkr.2">Pourquoi créer manuellement une action</title>
|
|
<para><indexterm><primary>Actions</primary><secondary>types</secondary></indexterm>Il
|
|
existe trois principaux types d'action:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para><command>COMMAND</command></para>
|
|
</listitem>
|
|
<listitem><para><command>MAP</command></para>
|
|
</listitem>
|
|
<listitem><para><filename>TT_MSG</filename></para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para id="SAG.CrAct.mkr.3">L'utilitaire “Créer action” permet
|
|
uniquement de créer certains types d'actions <command>COMMAND</command>
|
|
et <command>MAP</command>. Toutes les actions <filename>TT_MSG</filename>
|
|
doivent être créées manuellement.</para>
|
|
<para>Pour plus de détails, reportez-vous à la section <!--Original
|
|
XRef content: '”Limites de Créer action”, page 150'--><xref
|
|
role="SecTitleAndPageNum" linkend="SAG.dtCrA.mkr.3">.</para>
|
|
<sect2 id="SAG.CrAct.div.4">
|
|
<title><indexterm><primary>Actions</primary><secondary>COMMAND</secondary>
|
|
</indexterm>Actions de type COMMAND</title>
|
|
<para>Ces actions permettent d'exécuter une commande de lancement d'application
|
|
ou d'utilitaire, de lancer un script shell ou d'exécuter une commande
|
|
du système d'exploitation. La définition de l'action indique
|
|
la commande à exécuter (zone <filename>EXEC_STRING</filename>).
|
|
</para>
|
|
<para>“Créer action” s'applique aux types les plus courants
|
|
d'actions de commande. Cependant, certaines d'entre elles doivent être
|
|
créées manuellement, par exemple dans les cas suivants:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>lorsque l'action comporte plusieurs arguments de fichier,
|
|
et qu'une invite différente est utilisée pour chacun d'eux</para>
|
|
</listitem>
|
|
<listitem><para>lorsque l'action en appelle une autre</para>
|
|
</listitem>
|
|
<listitem><para>lorsqu'elle définit des comportements distincts pour
|
|
différents arguments de fichiers</para>
|
|
</listitem>
|
|
<listitem><para>lorsqu'elle doit s'exécuter sur un système éloigné,
|
|
différent de celui sur lequel elle est définie</para>
|
|
</listitem>
|
|
<listitem><para>lorsqu'elle doit pouvoir être exécutée
|
|
par un utilisateur différent (elle peut par exemple inviter l'entrée
|
|
du mot de passe de root à un moment spécifique de l'exécution,
|
|
puis continuer de s'exécuter en tant que root)</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</sect2>
|
|
<sect2 id="SAG.CrAct.div.5">
|
|
<title><indexterm><primary>Actions</primary><secondary>MAP</secondary></indexterm>Actions
|
|
de type MAP<indexterm><primary>Actions</primary><secondary>MAP</secondary>
|
|
</indexterm></title>
|
|
<para>Ces actions n'indiquent pas directement de commande ou de message ToolTalk
|
|
; elles sont mises en correspondance avec d'autres actions.</para>
|
|
<para>Cette méthode permet de spécifier plusieurs noms pour
|
|
une même action. Par exemple, l'action de commande intégrée
|
|
Editeur d'icônes permet de lancer le programme correspondant. La base
|
|
de données contient également une action “Ouvrir”,
|
|
ne s'appliquant qu'aux fichiers bitmaps et pixmaps (caractéristique
|
|
indiquée dans la zone <filename>ARG_TYPE</filename> de la définition
|
|
de l'action), mise en correspondance avec l'action “Editeur d'icônes”.
|
|
Ainsi, l'utilisateur peut lancer l'Editeur d'icônes en sélectionnant
|
|
un fichier bitmap ou pixmap dans le Gestionnaire de fichiers, et en choisissant
|
|
“Ouvrir” sur le menu “Sélectionné(s)”.
|
|
</para>
|
|
<para>A l'aide de “Créer action”, seules les actions “Ouvrir”
|
|
et “Imprimer” peuvent être mises en correspondance; toutes
|
|
les autres actions doivent l'être manuellement.</para>
|
|
</sect2>
|
|
<sect2 id="SAG.CrAct.div.6">
|
|
<title><indexterm><primary>Actions</primary><secondary>TT_MSG</secondary>
|
|
</indexterm>Actions de type TT_MSG (message ToolTalk)</title>
|
|
<para>Ces actions permettent d'envoyer des messages ToolTalk; elle doivent
|
|
être créées manuellement.</para>
|
|
</sect2>
|
|
</sect1>
|
|
<sect1 id="SAG.CrAct.div.7">
|
|
<title id="SAG.CrAct.mkr.4">Création manuelle d'une action: étapes
|
|
principales<indexterm><primary>Actions</primary><secondary>création
|
|
manuelle</secondary></indexterm></title>
|
|
<para>La présente section explique comment créer un fichier
|
|
de configuration pour une définition d'action.</para>
|
|
<sect2 id="SAG.CrAct.div.8">
|
|
<title id="SAG.CrAct.mkr.5">Fichiers de configuration d'action<indexterm>
|
|
<primary>Actions</primary><secondary>fichiers de configuration</secondary>
|
|
</indexterm><indexterm><primary>Fichiers</primary><secondary>configuration</secondary></indexterm></title>
|
|
<para>Les fichiers de configuration contenant des définitions d'actions
|
|
doivent respecter les règles suivantes.</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>Leur nom doit adopter le format <symbol role="Variable">nom</symbol><filename>.dt</filename>.</para>
|
|
</listitem>
|
|
<listitem><para><indexterm><primary>Chemin de recherche</primary><secondary>actions</secondary></indexterm>Les fichiers doivent se trouver dans le chemin
|
|
de recherche de la base de données des actions et des types de données.
|
|
Les chemins de recherche par défaut sont les suivants:</para>
|
|
<informaltable>
|
|
<tgroup cols="2" colsep="0" rowsep="0">
|
|
<colspec colwidth="174*">
|
|
<colspec colwidth="354*">
|
|
<tbody>
|
|
<row>
|
|
<entry align="left" valign="top"><para>Actions personnelles</para></entry>
|
|
<entry align="left" valign="top"><para><symbol role="Variable">Rép_personnel</symbol><filename>/.dt/types</filename></para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para>Actions système</para></entry>
|
|
<entry align="left" valign="top"><para><filename>/etc/dt/appconfig/types/</filename><symbol role="Variable">langue</symbol></para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para>Actions intégrées</para></entry>
|
|
<entry align="left" valign="top"><para><filename>/usr/dt/appconfig/types/</filename><symbol role="Variable">langue</symbol>. Il est préférable
|
|
de ne pas utiliser ce répertoire.</para></entry></row></tbody></tgroup>
|
|
</informaltable>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>Pour plus de détails sur la modification du chemin de recherche
|
|
des actions et des types de données, reportez-vous à la section <!--Original
|
|
XRef content: '”Définition de la valeur d'un chemin de recherche”,
|
|
page 123'--><xref role="SecTitleAndPageNum" linkend="SAG.Datab.mkr.6">.
|
|
</para>
|
|
</sect2>
|
|
<sect2 id="SAG.CrAct.div.9" role="Procedure">
|
|
<title id="SAG.CrAct.mkr.6">Procédure<indexterm><primary>Actions</primary>
|
|
<secondary>création manuelle</secondary></indexterm></title>
|
|
<orderedlist>
|
|
<listitem><para>Ouvrez un fichier de base de données existant ou créez-en
|
|
un nouveau. Reportez-vous à la section précédente, <!--Original
|
|
XRef content: '”Fichiers de configuration d'action'--><xref role="SectionTitle"
|
|
linkend="SAG.CrAct.mkr.5">.</para>
|
|
</listitem>
|
|
<listitem><para>Créez la définition de l'action en utilisant
|
|
la syntaxe:</para>
|
|
<programlisting remap="CodeIndent1">ACTION nom_action
|
|
{
|
|
TYPE type_action zone_action
|
|
…
|
|
}</programlisting>
|
|
<para>où:</para>
|
|
<informaltable>
|
|
<tgroup cols="2" colsep="0" rowsep="0">
|
|
<colspec colwidth="192*">
|
|
<colspec colwidth="336*">
|
|
<tbody>
|
|
<row>
|
|
<entry align="left" valign="top"><para><symbol>nom_action</symbol></para><indexterm>
|
|
<primary>Actions</primary><secondary>nom</secondary></indexterm></entry>
|
|
<entry align="left" valign="top"><para>Nom utilisé pour appeler l'action.
|
|
</para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><symbol>type_action</symbol></para><indexterm>
|
|
<primary>Actions</primary><secondary>types</secondary></indexterm></entry>
|
|
<entry align="left" valign="top"><para><command>COMMAND</command> (défaut), <command>MAP</command> ou <filename>TT_MSG.</filename></para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><symbol>zone_action</symbol></para><indexterm>
|
|
<primary>Actions</primary><secondary>types</secondary></indexterm><indexterm>
|
|
<primary>Actions</primary><secondary>types</secondary></indexterm></entry>
|
|
<entry align="left" valign="top"><para>Une ou plusieurs des zones requises
|
|
ou facultatives pour ce type d'action. Elles se composent d'un mot clé
|
|
et d'une valeur.</para><para>La plupart des zones d'action sont décrites
|
|
dans ce chapitre. Pour plus de détails, consultez la page de manuel
|
|
dtactionfile(4).</para></entry></row></tbody></tgroup></informaltable>
|
|
</listitem>
|
|
<listitem><para>Enregistrez le fichier.</para>
|
|
</listitem>
|
|
<listitem><para>Pour associer des icônes particulières à
|
|
l'action, créez-les. Par défaut, les icônes se trouvent
|
|
dans les répertoires suivants:</para>
|
|
<itemizedlist remap="Bullet2">
|
|
<listitem><para>icônes personnelles: <symbol role="Variable">Rép_Personnel</symbol><filename>/.dt/icons</filename></para>
|
|
</listitem>
|
|
<listitem><para>icônes système: <filename>/etc/dt/appconfig/icons/</filename><symbol role="Variable">langue (la langue</symbol> par défaut
|
|
est C).</para>
|
|
<para>Pour plus de détails, reportez-vous à la section <!--Original
|
|
XRef content: '”Définition d'une icône d'action”, page 173'--><xref
|
|
role="SecTitleAndPageNum" linkend="SAG.FrPC.mkr.12">.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</listitem>
|
|
<listitem><para>Cliquez deux fois sur “Recharger actions” dans
|
|
le groupe d'applications Outils_Bureau.</para>
|
|
</listitem>
|
|
<listitem><para>Créez un fichier d'action, pour qu'une icône
|
|
représentant l'action soit ajoutée dans le Gestionnaire de fichiers
|
|
ou d'applications. Si l'action est destinée à lancer une application,
|
|
l'icône est appelée<indexterm><primary>Icône d'application</primary></indexterm> <emphasis>icône d'application</emphasis>.</para>
|
|
<para>Pour créer le fichier d'action, créez un fichier exécutable
|
|
portant le même nom que l'action, dans n'importe quel répertoire
|
|
auquel vous avez accès en écriture. Vous pouvez créer
|
|
autant de fichiers d'action que nécessaire.</para>
|
|
</listitem>
|
|
</orderedlist>
|
|
</sect2>
|
|
<sect2 id="sag.cract.div.10">
|
|
<title id="sag.cract.mkr.7">Exemple d'action COMMAND<indexterm><primary>Actions</primary><secondary>exemple d'action COMMAND</secondary></indexterm></title>
|
|
<para>Les étapes suivantes créent une action personnelle permettant
|
|
de lancer une application de télécopie sur un système
|
|
éloigné appelé Serveur_AppA. La commande de lancement
|
|
de cette application est la suivante:</para>
|
|
<programlisting>/usr/fax/bin/faxcompose [<symbol role="Variable">nom_fichier</symbol>]</programlisting>
|
|
<orderedlist>
|
|
<listitem><para>Créez le fichier <symbol role="Variable">Rép_personnel</symbol><filename>/.dt/types/Télécopie.dt</filename>.</para>
|
|
</listitem>
|
|
<listitem><para>Entrez la définition d'action suivante dans le fichier
|
|
:</para>
|
|
<para remap="CodeIndent1"><programlisting>ACTION Compo_télécopie
|
|
{
|
|
TYPE COMMAND
|
|
ICON fax
|
|
WINDOW_TYPE NO_STDIO
|
|
EXEC_STRING /usr/fax/bin/faxcompose -c %Arg_1%
|
|
EXEC_HOST Serveur_AppA
|
|
DESCRIPTION Lance le programme de composition des télécopies.
|
|
)</programlisting></para>
|
|
<para>Les zones <filename>WINDOW_TYPE</filename> et <filename>EXEC_STRING</filename> décrivent le comportement de l'action.</para>
|
|
<informaltable>
|
|
<tgroup cols="2" colsep="0" rowsep="0">
|
|
<colspec colwidth="160*">
|
|
<colspec colwidth="368*">
|
|
<tbody>
|
|
<row>
|
|
<entry align="left" valign="top"><para><filename>WINDOW_TYPE</filename></para></entry>
|
|
<entry align="left" valign="top"><para>Le mot clé <filename>NO_STDIO</filename> indique que l'action ne doit pas nécessairement être
|
|
exécutée dans une fenêtre d'émulation de terminal.
|
|
</para><para>Pour plus de détails, reportez-vous à la section
|
|
<!--Original XRef content: '”Difinition du support de fenjtrage&ldq--><!--uor;,
|
|
page 185'--><xref role="SecTitleAndPageNum" linkend="sag.cract.mkr.25">.
|
|
</para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><filename>EXEC_STRING</filename></para></entry>
|
|
<entry align="left" valign="top"><para>La syntaxe <filename>%Arg_1%</filename>
|
|
indique qu'un fichier peut être posé sur l'action. Lorsque l'utilisateur
|
|
clique deux fois sur l'icône d'action, une fenêtre de composition
|
|
de télécopie vide s'affiche.</para><para>Pour plus de détails,
|
|
reportez-vous à la section <!--Original XRef content: '”Criation
|
|
de la channe d'exicution d'un--><!--e action COMMAND”, page 177'--><xref
|
|
role="SecTitleAndPageNum" linkend="sag.cract.mkr.13">.</para></entry></row>
|
|
</tbody></tgroup></informaltable>
|
|
</listitem>
|
|
<listitem><para>Sauvegardez le fichier.</para>
|
|
</listitem>
|
|
<listitem><para>À l'aide de l'Editeur d'icônes, créez
|
|
les icônes suivantes dans le répertoire auquel <symbol role="Variable">Rép_personnel</symbol><filename>/.dt/icons</filename>:</para>
|
|
<itemizedlist>
|
|
<listitem><para><filename>Télecopie.m.pm</filename> (32 x 32 pixels)
|
|
</para>
|
|
</listitem>
|
|
<listitem><para><filename>Télecopie.t.pm</filename> (16 x 16 pixels)
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</listitem>
|
|
<listitem><para>Cliquez deux fois sur Recharger actions dans le groupe d'applications
|
|
Outils_Bureau.</para>
|
|
</listitem>
|
|
<listitem><para>Créez un fichier exécutable appelé <filename>Compo_télécopie</filename> dans un répertoire auquel
|
|
vous avez accès en écriture (votre répertoire personnel,
|
|
par exemple).</para>
|
|
</listitem>
|
|
</orderedlist>
|
|
</sect2>
|
|
<sect2 id="SAG.CrAct.div.11">
|
|
<title id="SAG.CrAct.mkr.8">Exemple d'action MAP<indexterm><primary>Actions</primary><secondary>exemple d'action MAP</secondary></indexterm></title>
|
|
<para>Supposons que vous créez la plupart des fichiers que vous télécopiez
|
|
à l'aide de l'Editeur de texte et qu'ils ont le type de données
|
|
TEXTFILE (leur extension est <filename>.txt</filename>).</para>
|
|
<para>La procédure ci-après permet d'ajouter une option Télécopier
|
|
au menu Sélectionné(s) associé à ce type de données.
|
|
</para>
|
|
<orderedlist>
|
|
<listitem><para>Ouvrez le fichier <symbol role="Variable">Rép_personnel</symbol><filename>/.dt/types/Télécopie.dt</filename> que vous
|
|
avez créé précédemment.</para>
|
|
</listitem>
|
|
<listitem><para>Ajoutez-y la définition d'action <command>MAP</command>
|
|
suivante:</para>
|
|
<programlisting>ACTION Télécopier
|
|
{
|
|
ARG_TYPE TEXTFILE
|
|
TYPE MAP
|
|
MAP_ACTION Compo_télécopie
|
|
}</programlisting>
|
|
</listitem>
|
|
<listitem><para>Sauvegardez le fichier.</para>
|
|
</listitem>
|
|
<listitem><para>Copiez la définition des attributs du type de données
|
|
TEXTFILE de<filename>/usr/dt/appconfig/types/</filename><symbol role="Variable">langue</symbol><filename>/dtpad.dt</filename> dans un nouveau fichier, <symbol role="Variable">Rép_personnel</symbol><filename>/.dt/types/fich_texte.dt</filename>. Ajoutez l'action Télécopier à la zone <command>ACTIONS</command>.</para>
|
|
<para remap="CodeIndent1"><programlisting>DATA_ATTRIBUTES TEXTFILE
|
|
{
|
|
ACTIONS Ouvrir,Imprimer,Télécopier
|
|
ICON Dtpenpd
|
|
…
|
|
}</programlisting></para>
|
|
</listitem>
|
|
<listitem><para>Enregistrez le fichier.</para>
|
|
</listitem>
|
|
<listitem><para>Ouvrez le Gestionnaire d'applications et cliquez deux fois
|
|
sur Recharger applications, dans le groupe d'applications <structname>Outils_Bureau</structname>.</para>
|
|
</listitem>
|
|
</orderedlist>
|
|
</sect2>
|
|
<sect2 id="SAG.CrAct.div.12" role="Procedure">
|
|
<title id="SAG.CrAct.mkr.9">Rechargement de la base de données des actions
|
|
et des types de données<indexterm><primary>Types de données</primary><secondary>rechargement</secondary></indexterm><indexterm><primary>Types de données</primary><secondary>Recharger actions</secondary>
|
|
</indexterm><indexterm><primary>Actions</primary><secondary>rechargement</secondary></indexterm><indexterm><primary>Base de données</primary>
|
|
<secondary>rechargement des actions</secondary></indexterm><indexterm><primary>Actions</primary><secondary>Recharger actions</secondary></indexterm><indexterm>
|
|
<primary>Base de données</primary><secondary>rechargement</secondary>
|
|
</indexterm><indexterm><primary>Actions</primary><secondary>Recharger actions</secondary></indexterm></title>
|
|
<para>Pour que les nouvelles définitions d'action ou les actions modifiées
|
|
entrent en vigueur, le Bureau doit relire la base de données.</para>
|
|
<itemizedlist>
|
|
<listitem><para>Ouvrez le groupe d'applications <structname>Outils_Bureau</structname> et cliquez deux fois sur Recharger actions.</para>
|
|
</listitem>
|
|
<listitem><para><symbol role="Variable">Ou</symbol> lancez la commande:</para>
|
|
<para remap="CodeIndent1"><command>dtaction ReloadActions</command></para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para><indexterm><primary>Actions</primary><secondary>Recharger actions</secondary>
|
|
</indexterm>ReloadActions est le nom de l'action correspondant à l'icône
|
|
Recharger actions.</para>
|
|
<para>La base de données est également relue lorsque l'utilisateur
|
|
:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>se connecte</para>
|
|
</listitem>
|
|
<listitem><para>relance le Gestionnaire de l'espace de travail</para>
|
|
</listitem>
|
|
<listitem><para>enregistre une action dans la fenêtre Créer action
|
|
à l'aide de l'option Sauvegarder du menu Fichier</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</sect2>
|
|
<sect2 id="SAG.CrAct.div.13">
|
|
<title><indexterm><primary>Icône d'action</primary><secondary>création</secondary></indexterm><indexterm><primary>Icône d'application</primary>
|
|
<secondary>création</secondary></indexterm><indexterm><primary>Fichier</primary><secondary>d'action</secondary><tertiary>création</tertiary>
|
|
</indexterm>Création d'un fichier (icône) d'action<indexterm>
|
|
<primary>Actions</primary><secondary>fichiers, voir Fichier d'action</secondary>
|
|
</indexterm><indexterm><primary>Icône d'action</primary></indexterm><indexterm>
|
|
<primary>Icônes</primary><secondary>action</secondary></indexterm><indexterm>
|
|
<primary>Actions</primary><secondary>icônes</secondary></indexterm></title>
|
|
<para>Un<indexterm><primary>Fichier</primary><secondary>action</secondary>
|
|
</indexterm> <emphasis>fichier d'action</emphasis> permet de créer une
|
|
représentation visuelle d'une action dans le Gestionnaire de fichiers
|
|
ou d'applications.</para>
|
|
<figure>
|
|
<title><emphasis>Fichiers d'action</emphasis> (ou <emphasis>icônes d'action</emphasis> ou encore <emphasis>icônes d'application</emphasis>) dans
|
|
le Gestionnaire d'applications</title>
|
|
<graphic id="SAG.CrAct.grph.1" entityref="SAG.CrAct.fig.1"></graphic>
|
|
</figure>
|
|
<para>Les icônes de fichiers d'action représentant des actions,
|
|
elles sont parfois appelées <emphasis><indexterm><primary>Icône
|
|
d'action</primary></indexterm>icônes d'action</emphasis>. Si les actions
|
|
associées permettent de lancer une application, ces icônes sont
|
|
appelées <emphasis>icônes d'application</emphasis>.</para>
|
|
<para>Lorsque vous cliquez deux fois sur une icône d'action, l'action
|
|
correspondante est lancée. Une icône d'action peut également
|
|
être une zone de pose.</para>
|
|
<sect3 id="SAG.CrAct.div.14" role="Procedure">
|
|
<title>Procédure</title>
|
|
<itemizedlist>
|
|
<listitem><para>Créez un fichier exécutable portant le même
|
|
nom que<indexterm><primary>Actions</primary><secondary>nom</secondary></indexterm> l'action;
|
|
son contenu n'a pas d'importance.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>Par exemple, dans le cas d'une action définie comme suit:</para>
|
|
<programlisting>ACTION Mon_application
|
|
{
|
|
EXEC_STRING Ma -file %Arg_1%
|
|
DESCRIPTION Lance Mon_application.
|
|
ICON Mapp
|
|
}</programlisting>
|
|
<para>Le fichier d'action est un fichier exécutable appelé <filename>Mon_application</filename>. Dans les Gestionnaires de fichiers et d'applications,
|
|
ce fichier utilise l'icône <filename>Mapp.</filename><symbol role="Variable">taille</symbol><filename>.</filename><symbol role="Variable">type</symbol>.
|
|
Lorsque vous cliquez deux fois sur cette icône, la chaîne d'exécution
|
|
de l'action est lancée. Lorsque vous demandez l'aide sur l'élément
|
|
de l'action,<indexterm><primary>Aide</primary><secondary>fichier d'action</secondary></indexterm><indexterm><primary>Zone</primary><secondary>DESCRIPTION</secondary></indexterm> le contenu de la zone <command>DESCRIPTION</command>
|
|
s'affiche.</para>
|
|
</sect3>
|
|
<sect3 id="SAG.CrAct.div.15">
|
|
<title><indexterm><primary>Actions</primary><secondary>libellés</secondary>
|
|
</indexterm><indexterm><primary>Libellés</primary><secondary>actions</secondary></indexterm>Libellés d'actions</title>
|
|
<para>Si la zone <command>LABEL</command> figure dans une définition
|
|
d'action, sa valeur sera utilisée comme libellé du fichier d'action
|
|
dans les Gestionnaires de fichiers et d'applications, à la place du
|
|
nom du fichier (<symbol role="Variable">nom_action</symbol>). Par exemple,
|
|
si la définition d'action comporte les zones suivantes:</para>
|
|
<programlisting>ACTION Mon_application
|
|
{
|
|
LABEL Mon application
|
|
…
|
|
}</programlisting>
|
|
<para>Le libellé de l'icône d'action sera “Mon application”.
|
|
</para>
|
|
</sect3>
|
|
</sect2>
|
|
<sect2 id="SAG.CrAct.div.16">
|
|
<title id="SAG.CrAct.mkr.10">Définition d'une icône d'action<indexterm>
|
|
<primary>Actions</primary><secondary>icônes</secondary></indexterm><indexterm>
|
|
<primary>Icônes</primary><secondary>actions</secondary></indexterm></title>
|
|
<para>Pour indiquer l'image à utiliser pour les icônes d'une
|
|
action dans les Gestionnaires de fichiers et d'applications, complétez
|
|
la zone <command>ICON</command>.</para>
|
|
<para>Si vous ne spécifiez pas d'icône, le système utilise<indexterm>
|
|
<primary>Actions</primary><secondary>icône par défaut</secondary>
|
|
</indexterm> les fichiers d'icônes d'action par défaut situés
|
|
dans le répertoire <filename>/usr/dt/appconfig/icons/</filename><symbol role="Variable">langue</symbol><filename>/Dtactn.*</filename>.</para>
|
|
<figure>
|
|
<title>Icône d'action par défaut</title>
|
|
<graphic id="SAG.CrAct.grph.2" entityref="SAG.CrAct.fig.2"></graphic>
|
|
</figure>
|
|
<para>Pour modifier l'icône d'action, utilisez la ressource suivante
|
|
:<indexterm><primary>Ressources</primary><secondary>actionIcon</secondary>
|
|
</indexterm></para>
|
|
<programlisting>*actionIcon: <symbol role="Variable">nom_fichier_icône</symbol></programlisting>
|
|
<para>où <symbol role="Variable">nom_fichier_icône</symbol> peut
|
|
être un nom de base ou un chemin d'accès absolu.</para>
|
|
<para>La zone <command>ICON</command> peut prendre l'une des valeurs ci-dessous.<indexterm>
|
|
<primary>Zone</primary><secondary>ICON</secondary><tertiary>valeurs</tertiary>
|
|
</indexterm></para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>Un nom de base de fichier.</para>
|
|
<para>Il<indexterm><primary>Nom de base</primary></indexterm> s'agit du nom
|
|
du fichier contenant l'image, sans les extensions indiquant la taille de cette
|
|
dernière (<command>m</command> et <command>t</command>) et son type
|
|
(<command>bm</command> et <command>pm</command>). Par exemple, le nom de base
|
|
des fichiers <filename>IcôneJeu.m.pm</filename> et <filename>IcôneJeu.t.pm</filename> est <filename>IcôneJeu</filename>.</para>
|
|
<para>Si vous indiquez un nom de base, les fichiers d'icône doivent
|
|
se trouver dans un répertoire du chemin de recherche des icônes
|
|
:</para>
|
|
<itemizedlist remap="Bullet2">
|
|
<listitem><para>icônes personnelles: <symbol role="Variable">Rép_Personnel</symbol><command>/.dt/icons</command></para>
|
|
</listitem>
|
|
<listitem><para>icônes système: <filename>/etc/dt/appconfig/icons/</filename><symbol role="Variable">langue</symbol></para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</listitem>
|
|
<listitem><para>Un chemin d'accès absolu, comprenant le nom complet
|
|
du fichier.</para>
|
|
<para>Utilisez le chemin absolu uniquement si le fichier d'icône ne
|
|
figure pas dans le chemin de recherche des icônes. Par exemple, dans
|
|
le cas du fichier <filename>IcôneJeu.m.pm</filename>, situé dans
|
|
le répertoire <filename>/doc/projets</filename> (ne se trouvant pas
|
|
dans le chemin de recherche des icônes), la valeur de la zone <command>ICON</command> doit être <filename>/doc/projets/IcôneJeu.m.pm</filename>.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>Le <!--Original XRef content: 'Tableau 10‐1'--><xref role="CodeOrFigureOrTable"
|
|
linkend="SAG.CrAct.mkr.11"> indique les différentes tailles d'icônes
|
|
et les noms de fichiers correspondants.</para>
|
|
<table id="SAG.CrAct.tbl.1" frame="Topbot">
|
|
<title id="SAG.CrAct.mkr.11">Nom et taille des icônes d'action</title>
|
|
<tgroup cols="3" colsep="0" rowsep="0">
|
|
<colspec colwidth="1.49in">
|
|
<colspec colwidth="1.77in">
|
|
<colspec colwidth="1.75in">
|
|
<thead>
|
|
<row><entry align="left" valign="bottom"><para><literal>Taille en pixels</literal></para></entry>
|
|
<entry align="left" valign="bottom"><para><literal>Nom du bitmap</literal></para></entry>
|
|
<entry align="left" valign="bottom"><para><literal>Nom du pixmap</literal></para></entry>
|
|
</row></thead>
|
|
<tbody>
|
|
<row>
|
|
<entry align="left" valign="top"><para>48 x 48</para></entry>
|
|
<entry align="left" valign="top"><para><symbol role="Variable">nom</symbol><filename>.l.bm</filename></para></entry>
|
|
<entry align="left" valign="top"><para><symbol role="Variable">nom</symbol><filename>.l.pm</filename></para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para>32 x 32</para></entry>
|
|
<entry align="left" valign="top"><para><symbol role="Variable">nom</symbol><filename>.m.bm</filename></para></entry>
|
|
<entry align="left" valign="top"><para><symbol role="Variable">nom</symbol><filename>.m.pm</filename></para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para>16 x 16</para></entry>
|
|
<entry align="left" valign="top"><para><symbol role="Variable">nom</symbol><filename>.t.bm</filename></para></entry>
|
|
<entry align="left" valign="top"><para><symbol role="Variable">nom</symbol><filename>.t.pm</filename></para></entry></row></tbody></tgroup></table>
|
|
</sect2>
|
|
<sect2 id="SAG.CrAct.div.17" role="Procedure">
|
|
<title>Modification d'une définition d'action existante<indexterm>
|
|
<primary>Actions</primary><secondary>modification</secondary></indexterm></title>
|
|
<para>Toutes les actions installées sur le système peuvent être
|
|
modifiées, y compris les actions intégrées.</para>
|
|
<note>
|
|
<para>Toute modification de la base de données des actions intégrées
|
|
doit être effectuée avec prudence, en veillant à ne pas
|
|
compromettre la compatibilité des actions intégrées avec
|
|
les applications du Bureau.</para>
|
|
</note>
|
|
<orderedlist>
|
|
<listitem><para>Localisez la définition de l'action à modifier.
|
|
</para>
|
|
<para>Les emplacements par défaut des définitions d'action sont
|
|
les suivants:</para>
|
|
<itemizedlist remap="Bullet2">
|
|
<listitem><para>actions intégrées: <filename>/usr/dt/appconfig/types/</filename><symbol role="Variable">langue</symbol></para>
|
|
</listitem>
|
|
<listitem><para>actions système: <filename>/etc/dt/appconfig/types/</filename><symbol role="Variable">langue</symbol></para>
|
|
</listitem>
|
|
<listitem><para>actions personnelles: <symbol role="Variable">Rép_personnel</symbol><filename>/.dt/types</filename></para>
|
|
<para><indexterm><primary><$nopage>Actions</primary><secondary>chemin de
|
|
recherche, voir Chemin de recherche de base de données</secondary>
|
|
</indexterm>Il est possible que des emplacements supplémentaires soient
|
|
disponibles sur votre système. Pour en afficher la liste, entrez la
|
|
commande suivante:</para>
|
|
<para remap="CodeIndent1"><command><indexterm><primary>dtsearchpath</primary>
|
|
</indexterm>dtsearchpath -v</command></para>
|
|
<para>Votre système utilise les répertoires indiqués
|
|
par<indexterm><primary>Variables</primary><secondary>DTDATABASESEARCHPATH</secondary></indexterm> la variable <systemitem>DTDATABASESEARCHPATH</systemitem>.
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</listitem>
|
|
<listitem><para>S'il y a lieu, copiez la définition d'action dans un
|
|
fichier (nouveau ou existant) de l'un des répertoires suivants:</para>
|
|
<itemizedlist remap="Bullet2">
|
|
<listitem><para>actions système: <filename>/etc/dt/appconfig/types/</filename><symbol role="Variable">langue</symbol></para>
|
|
</listitem>
|
|
<listitem><para>actions personnelles: <symbol role="Variable">Rép_personnel</symbol><filename>/.dt/types</filename></para>
|
|
<para>Les fichiers situés dans <filename>/usr/dt/appconfig/types/</filename><symbol role="Variable">langue</symbol> ne pouvant pas être modifiés,
|
|
vous devez copier les actions intégrées.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</listitem>
|
|
<listitem><para>Effectuez les modifications voulues. Une fois cette opération
|
|
terminée, enregistrez le fichier.</para>
|
|
</listitem>
|
|
<listitem><para>Cliquez deux fois sur Recharger actions dans le groupe d'applications
|
|
Outils_Bureau.</para>
|
|
</listitem>
|
|
</orderedlist>
|
|
</sect2>
|
|
<sect2 id="SAG.CrAct.div.18">
|
|
<title id="SAG.CrAct.mkr.12">Priorité des définitions d'action<indexterm>
|
|
<primary>Actions</primary><secondary>règles de priorité</secondary>
|
|
</indexterm></title>
|
|
<para>Lorsque l'utilisateur lance une action, le système recherche
|
|
une entrée correspondante dans la base de données. Lorsqu'il
|
|
existe plusieurs occurrences, des règles de priorité sont appliquées
|
|
pour sélectionner l'action à utiliser.</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>La priorité est déterminée par l'emplacement
|
|
de la définition d'action, si aucune autre règle n'est définie.
|
|
La liste suivante indique les répertoires d'actions, dans un ordre
|
|
de priorité décroissant:</para>
|
|
<itemizedlist remap="Bullet2">
|
|
<listitem><para>actions personnelles (<symbol role="Variable">Rép_personnel</symbol><filename>/.dt/types</filename>)</para>
|
|
</listitem>
|
|
<listitem><para>actions système locales (<filename>/etc/dt/appconfig/types/</filename><symbol role="Variable">langue</symbol>)</para>
|
|
</listitem>
|
|
<listitem><para>actions système éloignées ( <symbol role="Variable">nom_hôte</symbol>:<filename>/etc/dt/appconfig/types/</filename><symbol role="Variable">langue</symbol>). Les systèmes hôtes éloignés
|
|
recherchés sont ceux définis dans le chemin de recherche des
|
|
applications</para>
|
|
</listitem>
|
|
<listitem><para>actions intégrées (<filename>/usr/dt/appconfig/types/</filename><symbol role="Variable">langue</symbol>.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</listitem>
|
|
<listitem><para>A l'intérieur d'un répertoire, les fichiers <filename>*.dt</filename> sont lus dans l'ordre alphabétique.</para>
|
|
</listitem>
|
|
<listitem><para>Les actions faisant l'objet d'une restriction <filename>(ARG_CLASS</filename>, <filename><indexterm><primary>Zone</primary><secondary>ARG_TYPE</secondary></indexterm>ARG_TYPE</filename>, <filename><indexterm><primary>Zone</primary><secondary>ARG_MODE</secondary></indexterm>ARG_MODE</filename>
|
|
ou <filename><indexterm><primary>Zone</primary><secondary>ARG_COUNT</secondary>
|
|
</indexterm>ARG_COUNT)</filename> sont prioritaires par rapport aux autres.
|
|
La valeur par défaut de ces zones est <filename>*</filename>.</para>
|
|
<para>Lorsque plusieurs restrictions s'appliquent, l'ordre (décroissant)
|
|
de priorité est le suivant:</para>
|
|
<itemizedlist remap="Bullet2">
|
|
<listitem><para><filename>ARG_CLASS</filename></para>
|
|
</listitem>
|
|
<listitem><para><filename>ARG_TYPE</filename></para>
|
|
</listitem>
|
|
<listitem><para><filename>ARG_MODE</filename></para>
|
|
</listitem>
|
|
<listitem><para><filename>ARG_COUNT</filename></para>
|
|
<para>Si plusieurs restrictions <filename>ARG_COUNT</filename> existent, l'ordre
|
|
(décroissant) de priorité est le suivant:</para>
|
|
</listitem>
|
|
<listitem><para>Valeur entière <symbol role="Variable">n</symbol></para>
|
|
</listitem>
|
|
<listitem><para><n</para>
|
|
</listitem>
|
|
<listitem><para>>n</para>
|
|
</listitem>
|
|
<listitem><para>*</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>Par exemple, dans le cas de la définition d'action (partielle)
|
|
suivante:</para>
|
|
<programlisting>ACTION Editer_graphiques
|
|
# Editer_graphiques-1
|
|
{
|
|
ARG_TYPE XWD
|
|
…
|
|
}
|
|
|
|
ACTION Editer_graphiques
|
|
# Editer_graphiques-2
|
|
{
|
|
ARG_COUNT 0
|
|
…
|
|
}
|
|
|
|
ACTION Editer_graphiques
|
|
# Editer_graphiques-3
|
|
{
|
|
ARG_TYPE *
|
|
…
|
|
}</programlisting>
|
|
<para>Lorsque vous cliquez deux fois sur l'icône d'action Editer_graphiques,
|
|
l'action Editer_graphiques-2 est lancée. En effet, aucun argument n'ayant
|
|
été indiqué, <filename>ARG_COUNT 0</filename> est prioritaire.
|
|
Lorsqu'un argument (fichier de type XWD) est spécifié, Editer_graphiques-1
|
|
est lancée car la zone <filename>ARG_TYPE</filename> est définie
|
|
(sa valeur est XWD). Editer_graphiques-3 est utilisée pour tous les
|
|
autres arguments (fichiers).</para>
|
|
</sect2>
|
|
</sect1>
|
|
<sect1 id="SAG.CrAct.div.19">
|
|
<title id="SAG.CrAct.mkr.13">Création de la chaîne d'exécution
|
|
d'une action COMMAND<indexterm><primary>Actions</primary><secondary>chaîne
|
|
d'exécution</secondary></indexterm><indexterm><primary>Actions</primary>
|
|
<secondary>ligne de commande</secondary></indexterm><indexterm><primary>Chaîne d'exécution</primary></indexterm><indexterm><primary>Actions</primary><secondary>chaîne d'exécution</secondary></indexterm><indexterm>
|
|
<primary>Actions</primary><secondary>COMMAND</secondary></indexterm><indexterm>
|
|
<primary><$nopage>Zone</primary><secondary>EXEC_STRING, Voir Chaîne
|
|
d'exécution</secondary></indexterm></title>
|
|
<para>Les deux zones requises pour une action de type <command><indexterm>
|
|
<primary>Actions</primary><secondary>COMMAND</secondary></indexterm>COMMAND</command> sont <command>ACTION</command> et <command>EXEC_STRING</command>.
|
|
</para>
|
|
<programlisting>ACTION nom_action
|
|
{
|
|
EXEC_STRING chaîne_exécution
|
|
}</programlisting>
|
|
<para>La chaîne d'exécution est la partie essentielle d'une définition
|
|
d'action <command>COMMAND</command>; sa syntaxe est identique à celle
|
|
de la ligne de commande entrée dans une fenêtre d'émulation
|
|
de terminal. Elle contient cependant des éléments supplémentaires
|
|
destinés au traitement des arguments (chaînes et fichiers).
|
|
</para>
|
|
<sect2 id="SAG.CrAct.div.20">
|
|
<title><indexterm><primary>Chaîne d'exécution</primary><secondary>généralités</secondary></indexterm>Fonctions générales
|
|
des chaînes d'exécution</title>
|
|
<para>Une chaîne d'exécution peut contenir:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>des arguments (fichiers ou autres)</para>
|
|
</listitem>
|
|
<listitem><para>une syntaxe de shell</para>
|
|
</listitem>
|
|
<listitem><para>des chemins d'accès absolus ou des noms de fichiers
|
|
exécutables</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<sect3 id="SAG.CrAct.div.21">
|
|
<title>Arguments d'action<indexterm><primary>Actions</primary><secondary>arguments</secondary></indexterm><indexterm><primary>Arguments</primary>
|
|
<secondary>actions</secondary></indexterm></title>
|
|
<para>Un argument est une donnée nécessaire à l'exécution
|
|
d'une application ou d'une commande. Par exemple, la ligne de commande ci-après
|
|
permet d'ouvrir un fichier dans une fenêtre de l'Editeur de texte.</para>
|
|
<para><command>dtpad</command> <symbol role="Variable">nom_fichier</symbol></para>
|
|
<para>Dans cette commande, <symbol role="Variable">nom_fichier</symbol> est
|
|
un fichier indiqué comme argument de la commande <command>dtpad</command>.
|
|
</para>
|
|
<para>Tout comme les applications et les commandes, les actions peuvent être
|
|
associées à des arguments. Les deux types d'arguments disponibles
|
|
pour les actions <command>COMMAND</command> sont les suivants:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>fichiers</para>
|
|
</listitem>
|
|
<listitem><para>chaînes</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</sect3>
|
|
<sect3 id="SAG.CrAct.div.22">
|
|
<title>Utilisation des shells dans les chaînes d'exécution<indexterm>
|
|
<primary>Chaîne d'exécution</primary><secondary>syntaxe de shell</secondary></indexterm><indexterm><primary>Shell</primary><secondary>syntaxe</secondary></indexterm></title>
|
|
<para>Bien que la chaîne s'exécute directement, sans passer par
|
|
un shell, vous pouvez en indiquer un dans sa syntaxe.</para>
|
|
<para>Par exemple:</para>
|
|
<programlisting>EXEC_STRING \
|
|
/bin/sh -c \
|
|
'tar -tvf %(File)Arg_1% 2>&1 | \${PAGER:-more};\
|
|
echo "\\n*** Sélectionnez Fermer pour sortir ***”'</programlisting>
|
|
</sect3>
|
|
<sect3 id="SAG.CrAct.div.23">
|
|
<title>Nom ou chemin d'accès absolu du fichier exécutable<indexterm>
|
|
<primary>Chaîne d'exécution</primary><secondary>fichier exécutable</secondary></indexterm></title>
|
|
<para>Si votre application est installée dans un répertoire
|
|
figurant dans la variable<indexterm><primary>Variables</primary><secondary>PATH</secondary></indexterm> PATH, vous pouvez indiquer uniquement le nom du
|
|
fichier exécutable. Sinon, vous devez utiliser<indexterm><primary>Chaîne d'exécution</primary><secondary>chemin d'accès
|
|
absolu</secondary></indexterm> son chemin d'accès absolu.</para>
|
|
</sect3>
|
|
</sect2>
|
|
<sect2 id="SAG.CrAct.div.24">
|
|
<title id="SAG.CrAct.mkr.14">Création d'une action sans arguments<indexterm>
|
|
<primary>Chaîne d'exéction</primary><secondary>sans arguments</secondary></indexterm><indexterm><primary>Actions</primary><secondary>sans arguments</secondary></indexterm><indexterm><primary>Actions</primary>
|
|
<secondary>sans données</secondary></indexterm></title>
|
|
<para>Dans la zone <filename>EXEC_STRING</filename>, utilisez la syntaxe permettant
|
|
de lancer l'application à partir de la ligne de commande.</para>
|
|
<sect3 id="SAG.CrAct.div.25">
|
|
<title>Exemples</title>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>La chaîne d'exécution suivante fait partie d'une
|
|
action permettant de lancer le client X <command>xcutsel</command>:</para>
|
|
<para remap="CodeIndent1"><programlisting>EXEC_STRING xcutsel</programlisting></para>
|
|
</listitem>
|
|
<listitem><para>La chaîne suivante permet de lancer le client <command>xclock</command> en indiquant une horloge numérique; la ligne de commande
|
|
comporte une option mais aucun argument n'est requis:</para>
|
|
<para remap="CodeIndent1"><programlisting>EXEC_STRING xclock -digital</programlisting></para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</sect3>
|
|
</sect2>
|
|
<sect2 id="SAG.CrAct.div.26">
|
|
<title id="SAG.CrAct.mkr.15">Création d'une action prenant en charge
|
|
la pose de fichiers<indexterm><primary>Chaîne d'exécution</primary>
|
|
<secondary>fichiers posés</secondary></indexterm><indexterm><primary>Actions</primary><secondary>prise en charge de fichiers posés</secondary>
|
|
</indexterm><indexterm><primary>Zone de pose</primary><secondary>icône
|
|
d'action</secondary></indexterm><indexterm><primary>Fichiers posés</primary></indexterm></title>
|
|
<para>Pour indiquer l'argument (fichier), utilisez la syntaxe suivante:<indexterm>
|
|
<primary>Syntaxe</primary><secondary>Arg_n</secondary></indexterm></para>
|
|
<programlisting>%Arg_n%</programlisting>
|
|
<para>ou</para>
|
|
<programlisting>%(File)Arg_n%</programlisting>
|
|
<para><filename>(File)</filename> est facultatif, étant donné
|
|
que les arguments indiqués pour <computeroutput>Arg_n sont</computeroutput>
|
|
considérés par défaut comme des fichiers. Pour plus de
|
|
détails sur l'utilisation de la syntaxe <computeroutput>%(String)Arg_n%</computeroutput>, reportez-vous à la section <!--Original XRef content:
|
|
'”Interprétation d'un
|
|
argument (fichier) en tant que chaîne”, page 181'--><xref role="SecTitleAndPageNum"
|
|
linkend="SAG.CrAct.mkr.19">.</para>
|
|
<para>Cette syntaxe permet à l'utilisateur de poser un fichier de données
|
|
sur une icône d'action afin de l'utiliser comme argument pour cette
|
|
dernière. Il remplace le <symbol role="Variable">n</symbol>ième
|
|
argument de la ligne de commande. Il peut s'agir d'un fichier local ou éloigné.
|
|
</para>
|
|
<sect3 id="SAG.CrAct.div.27">
|
|
<title>Exemples</title>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>La chaîne d'exécution suivante lance <command>wc -w</command> en utilisant un fichier posé comme argument pour le
|
|
paramètre.</para>
|
|
<para remap="CodeIndent1"><programlisting>EXEC_STRING wc -w %Arg_1%</programlisting></para>
|
|
</listitem>
|
|
<listitem><para>L'exemple ci-dessous représente la définition
|
|
partielle d'une action qui n'accepte que des répertoires en tant qu'arguments.
|
|
Lorsqu'un répertoire est posé sur l'icône de cette action,
|
|
celle-ci affiche la liste des fichiers du répertoire accessibles en
|
|
lecture-écriture.</para>
|
|
<programlisting>ACTION Liste_fich_accessibles
|
|
{
|
|
ARG_TYPE FOLDER
|
|
EXEC_STRING /bin/sh -c 'ls -l %Arg_1% | grep rw-'
|
|
…
|
|
}</programlisting>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</sect3>
|
|
</sect2>
|
|
<sect2 id="SAG.CrAct.div.28">
|
|
<title id="SAG.CrAct.mkr.16">Création d'une action invitant à
|
|
indiquer un argument (fichier)<indexterm><primary>Chaîne d'exécution</primary><secondary>fichier requis</secondary></indexterm><indexterm><primary>Actions</primary><secondary>indication d'un fichier</secondary></indexterm><indexterm>
|
|
<primary></primary></indexterm></title>
|
|
<para>Pour indiquer l'argument (fichier), utilisez la syntaxe suivante:
|
|
</para>
|
|
<programlisting>%(File)"<symbol role="Variable">invite</symbol>"%</programlisting>
|
|
<para>Lorsque l'utilisateur clique deux fois sur l'icône correspondant
|
|
à cette action, un message l'invitant à indiquer un nom de fichier
|
|
s'affiche.</para>
|
|
<para>Par exemple, la chaîne d'exécution suivante affiche une
|
|
boîte de dialogue dans laquelle l'argument de la commande <command>wc -w</command> doit être indiqué:</para>
|
|
<programlisting>EXEC_STRING wc -w %(File)"Fichier à compter :"%</programlisting>
|
|
</sect2>
|
|
<sect2 id="SAG.CrAct.div.29">
|
|
<title id="SAG.CrAct.mkr.17">Création d'une action supportant les fichiers
|
|
posés ou invitant à les indiquer<indexterm><primary>Actions</primary><secondary>poser un fichier</secondary></indexterm></title>
|
|
<para>Pour indiquer l'argument (fichier), utilisez la syntaxe suivante:</para>
|
|
<programlisting>%Arg_n"<symbol role="Variable">invite</symbol>"%</programlisting>
|
|
<para>ou</para>
|
|
<programlisting>%(File)Arg_n"<symbol role="Variable">invite</symbol>"%</programlisting>
|
|
<para>L'action créée par cette syntaxe:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>accepte les fichiers posés en tant qu'arguments</para>
|
|
</listitem>
|
|
<listitem><para>affiche, lorsque l'utilisateur clique sur l'icône correspondante,
|
|
une boîte de dialogue l'invitant à entrer un nom de fichier</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>Par exemple, la chaîne d'exécution ci-dessous lance la
|
|
commande <command>lp -oraw</command> sur un fichier posé. Si l'utilisateur
|
|
a cliqué deux fois sur l'icône de l'action pour la lancer, il
|
|
est invité à indiquer un nom de fichier.</para>
|
|
<programlisting>EXEC_STRING lp -oraw %Arg_1"Fichier à imprimer:"%</programlisting>
|
|
</sect2>
|
|
<sect2 id="SAG.CrAct.div.30">
|
|
<title id="SAG.CrAct.mkr.18">Création d'une action invitant à
|
|
indiquer un argument autre qu'un fichier<indexterm><primary>Chaîne
|
|
d'exécution</primary><secondary>chaîne requise</secondary></indexterm><indexterm>
|
|
<primary>Actions</primary><secondary>arguments</secondary></indexterm><indexterm>
|
|
<primary>Arguments</primary><secondary>non-fichier</secondary></indexterm><indexterm>
|
|
<primary>Actions</primary><secondary>arguments</secondary></indexterm></title>
|
|
<para>Pour indiquer l'argument, utilisez la syntaxe suivant:</para>
|
|
<programlisting>%"invite"%</programlisting>
|
|
<para>ou</para>
|
|
<programlisting>%(String)"invite"%</programlisting>
|
|
<para><filename>(String)</filename> est facultatif; en effet, le texte indiqué
|
|
entre guillemets est considéré par défaut comme une chaîne.
|
|
Cette syntaxe affiche une boîte de dialogue qui invite l'utilisateur
|
|
à entrer des données; ne l'utilisez pas lorsqu'un nom de fichier
|
|
doit être indiqué.</para>
|
|
<para>Par exemple, la chaîne d'exécution suivante lance la commande <command>xwd</command> et invite l'utilisateur à indiquer une valeur à
|
|
ajouter à chaque pixel:</para>
|
|
<programlisting>EXEC_STRING xwd -add %"Valeur à ajouter :"% -out %Arg_1"Nom du
|
|
fichier :"%</programlisting>
|
|
</sect2>
|
|
<sect2 id="SAG.CrAct.div.31">
|
|
<title id="SAG.CrAct.mkr.19">Interprétation d'un argument (fichier)
|
|
en tant que chaîne</title>
|
|
<para>Pour indiquer l'argument, utilisez la syntaxe suivante:</para>
|
|
<programlisting>%(String)Arg_n%</programlisting>
|
|
<para>Par exemple, la chaîne d'exécution suivante permet d'imprimer
|
|
un fichier accompagné d'une page bannière indiquant son nom,
|
|
à l'aide de la commande <command>lp -t</command> <symbol role="Variable">bannière nom_fichier.</symbol></para>
|
|
<programlisting>EXEC_STRING lp -t%(String)Arg_1% %(File)Arg_1"Fichier à imprimer :"%
|
|
</programlisting>
|
|
</sect2>
|
|
<sect2 id="SAG.CrAct.div.32">
|
|
<title id="SAG.CrAct.mkr.20">Fonctions shell<indexterm><primary>Actions</primary>
|
|
<secondary>fonctions shell</secondary></indexterm><indexterm><primary>Shells</primary><secondary>actions</secondary></indexterm><indexterm><primary>Shells</primary><secondary>actions</secondary></indexterm></title>
|
|
<para>Indiquez le shell dans la chaîne d'exécution:</para>
|
|
<programlisting>/bin/sh -c '<symbol role="Variable">commande</symbol>'
|
|
/bin/ksh -c '<symbol role="Variable">commande</symbol>'
|
|
/bin/csh -c '<symbol role="Variable">commande</symbol>'</programlisting>
|
|
<sect3 id="SAG.CrAct.div.33">
|
|
<title>Exemples</title>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>La chaîne d'exécution suivante correspond à
|
|
une action qui utilise les fonctions de tube du shell:</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<programlisting>EXEC_STRING /bin/sh -c 'ps | lp'</programlisting>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>La chaîne suivante est plus complexe; elle requiert
|
|
un traitement par le shell et supporte un argument (fichier):</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<programlisting>EXEC_STRING /bin/sh -c 'tbl %Arg_1"Page de manuel :"% | troff -man'
|
|
</programlisting>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>Pour la chaîne ci-après, l'argument doit être
|
|
un fichier compressé; l'action le décompresse et l'imprime
|
|
à l'aide de la commande <command>lp -oraw</command>.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<programlisting>EXEC_STRING /bin/sh -c 'cat %Arg_1 "Fichier à imprimer :"% | uncompress | lp -oraw'
|
|
</programlisting>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>La chaîne suivante permet de lancer un script shell
|
|
:</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<programlisting>EXEC_STRING /usr/local/bin/LancerClientGnu</programlisting>
|
|
</sect3>
|
|
</sect2>
|
|
<sect2 id="SAG.CrAct.div.34">
|
|
<title>Création d'actions COMMAND pour plusieurs arguments (fichiers)<indexterm>
|
|
<primary>Chaîne d'exécution</primary><secondary>arguments multiples</secondary></indexterm><indexterm><primary>Arguments</primary><secondary>actions</secondary></indexterm></title>
|
|
<para>Les actions peuvent gérer les arguments multiples des trois manières
|
|
suivantes.</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>L'action peut être exécutée à plusieurs
|
|
reprises, à raison d'une par argument. Lorsqu'une zone <filename>EXEC_STRING</filename> définit un seul argument et que plusieurs fichiers sont
|
|
posés sur l'icône de l'action, celle-ci est exécutée
|
|
pour chaque fichier.</para>
|
|
<para>Par exemple, si plusieurs fichiers sont indiqués pour la définition
|
|
d'action suivante:</para>
|
|
<para remap="CodeIndent1"><programlisting>ACTION Affich_image_écran
|
|
{
|
|
EXEC_STRING xwud -in %Arg_1%
|
|
…
|
|
}</programlisting></para>
|
|
<para>Dans ce cas, l'action Affich_image_écran est exécutée
|
|
à plusieurs reprises.</para>
|
|
</listitem>
|
|
<listitem><para>L'action peut utiliser deux (ou plus) fichiers non interchangeables.
|
|
Par exemple:</para>
|
|
<programlisting remap="CodeIndent1"><command>xsetroot -cursor</command> <symbol role="Variable">fich_curseur fich_masque</symbol></programlisting>
|
|
<para>Cette action requiert deux fichiers, indiqués dans un ordre donné.
|
|
</para>
|
|
</listitem>
|
|
<listitem><para>Une action peut également exécuter la même
|
|
commande de façon séquentielle sur chaque fichier. Par exemple
|
|
:</para>
|
|
<para remap="CodeIndent1"><programlisting><command>pr</command> <symbol role="Variable">fichier</symbol> [<symbol role="Variable">fichier</symbol> …]</programlisting></para>
|
|
<para>Cette action regroupe un ou plusieurs fichiers dans un même travail
|
|
d'impression.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<sect3 id="SAG.CrAct.div.35">
|
|
<title id="SAG.CrAct.mkr.21">Création d'une action avec des arguments
|
|
non interchangeables<indexterm><primary>Actions</primary><secondary>arguments
|
|
non interchangeables</secondary></indexterm><indexterm><primary>Arguments</primary><secondary>non interchangeables</secondary></indexterm></title>
|
|
<para>Utilisez l'une des syntaxes décrites ci-dessous.</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>Pour que l'action invite à indiquer les noms de fichier,
|
|
utilisez la syntaxe suivante pour chaque argument:</para>
|
|
<programlisting>%(File)”<symbol role="Variable">invite</symbol>”%
|
|
</programlisting>
|
|
<para>Utilisez une chaîne <symbol role="Variable">invite</symbol> différente
|
|
pour chaque argument.</para>
|
|
<para>Par exemple, la chaîne suivante invite à spécifier
|
|
deux fichiers:</para>
|
|
<programlisting>EXEC_STRING xsetroot -cursor %(File)”Bitmap curseur :”% \
|
|
%(File)”Bitmap masque :”%</programlisting>
|
|
</listitem>
|
|
<listitem><para>Pour que l'action supporte les fichiers posés, utilisez
|
|
la syntaxe suivante pour chaque argument:</para>
|
|
<programlisting> %Arg_n%</programlisting>
|
|
<para>Attribuez une valeur différente à <symbol role="Variable">n</symbol> pour chaque argument. Par exemple:</para>
|
|
<programlisting>EXEC_STRING diff %Arg_1% %Arg_2%</programlisting>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</sect3>
|
|
<sect3 id="SAG.CrAct.div.36">
|
|
<title id="SAG.CrAct.mkr.22">Création d'une action avec des arguments
|
|
interchangeables<indexterm><primary>Actions</primary><secondary>arguments
|
|
interchangeables</secondary></indexterm><indexterm><primary>Arguments</primary>
|
|
<secondary>interchangeables</secondary></indexterm></title>
|
|
<para>Utilisez l'une des syntaxes décrites ci-dessous.</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>Pour créer une action supportant les fichiers posés,
|
|
chargée d'exécuter une commande du type <command>commande</command> <symbol>fichier</symbol><subscript>1</subscript> <symbol role="Variable">fichier</symbol><subscript>2</subscript> …, utilisez la syntaxe suivante pour
|
|
les arguments:</para>
|
|
<programlisting remap="CodeIndent1">%Args%</programlisting>
|
|
</listitem>
|
|
<listitem><para>Pour créer une action qui prenne en charge plusieurs
|
|
fichiers posés, ou qui affiche un message invitant à indiquer
|
|
un fichier lorsque l'utilisateur clique deux fois dessus, utilisez la syntaxe
|
|
suivante pour les arguments:</para>
|
|
<programlisting remap="CodeIndent1">%Arg_1”<symbol role="Variable">invite</symbol>”% %Args%</programlisting>
|
|
<para>La commande sera lancée sous la forme <command>commande</command> <symbol role="Variable">fichier</symbol><subscript>1</subscript> <symbol role="Variable">fichier</symbol><subscript>2</subscript> ….</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<sect4 id="SAG.CrAct.div.37">
|
|
<title>Exemples</title>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>La chaîne suivante crée une action qui exécute
|
|
la commande:</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<programlisting><command>pr</command> <symbol role="Variable">fichier</symbol><subscript>
|
|
1</subscript> <symbol role="Variable">fichier</symbol><subscript>2</subscript></programlisting>
|
|
<para>Cette action prend en charge plusieurs arguments (fichiers).</para>
|
|
<programlisting>EXEC_STRING pr %Args%</programlisting>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>La chaîne suivante crée une action semblable
|
|
à la précédente, qui affiche en outre une invite lors
|
|
de l'exécution d'un double déclic par l'utilisateur (pas d'arguments):
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<programlisting>EXEC_STRING pr %Arg_1"Fichier(s) à imprimer :"% %Args%
|
|
</programlisting>
|
|
</sect4>
|
|
</sect3>
|
|
<sect3 id="SAG.CrAct.div.38">
|
|
<title id="SAG.CrAct.mkr.23">Création d'une action pour plusieurs fichiers
|
|
posés<indexterm><primary>Actions</primary><secondary>poser plusieurs
|
|
fichiers</secondary></indexterm></title>
|
|
<para>Pour créer une action qui supporte plusieurs arguments et exécute
|
|
une commande du type:</para>
|
|
<programlisting><command role="Variable">commande</command> <symbol role="Variable">fichier</symbol><subscript>1</subscript> <symbol role="Variable">fichier</symbol><subscript>
|
|
2</subscript> …</programlisting>
|
|
<para>Utilisez la syntaxe:</para>
|
|
<programlisting>%Args%</programlisting>
|
|
<sect4 id="SAG.CrAct.div.39">
|
|
<title>Exemples</title>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>La chaîne suivante lance le script Vérification
|
|
sur plusieurs fichiers:</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<programlisting>EXEC_STRING /usr/local/bin/Vérification \
|
|
%Arg_1"Fichier à vérifier ?"% %Args%</programlisting>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>La chaîne suivante exécute la commande <command>lp -oraw</command> sur plusieurs fichiers:</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<programlisting>EXEC_STRING lp -oraw %Arg_1"Fichier à imprimer :"% %Args%
|
|
</programlisting>
|
|
</sect4>
|
|
</sect3>
|
|
</sect2>
|
|
</sect1>
|
|
<sect1 id="SAG.CrAct.div.40">
|
|
<title id="SAG.CrAct.mkr.24">Support de fenêtrage et émulateurs
|
|
de terminal pour les actions COMMAND<indexterm><primary>Actions</primary>
|
|
<secondary>support de fenêtrage</secondary></indexterm><indexterm><primary>Emulateur de terminal</primary><secondary>actions</secondary></indexterm></title>
|
|
<para>Les actions <command>COMMAND</command> supportent les fenêtres
|
|
du Bureau des manières décrites ci-dessous.</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>Si l'application dispose de sa propre fenêtre, l'action
|
|
peut être conçue de sorte qu'aucune fenêtre supplémentaire
|
|
ne soit ouverte. Cette option est également utilisée pour les
|
|
actions qui lancent des commandes ne requérant aucune entrée
|
|
utilisateur et ne générant aucune sortie.</para>
|
|
</listitem>
|
|
<listitem><para>Si l'application doit s'exécuter dans une fenêtre
|
|
d'émulation de terminal, l'action peut ouvrir cette fenêtre avant
|
|
de lancer l'application. Il existe plusieurs options de terminal.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<sect2 id="SAG.CrAct.div.41">
|
|
<title id="SAG.CrAct.mkr.25">Définition du support de fenêtrage</title>
|
|
<para>Pour indiquer le type de support de fenêtrage utilisé par
|
|
l'action, utilisez la zone <filename>WINDOW_TYPE</filename>.</para>
|
|
<informaltable>
|
|
<tgroup cols="2" colsep="0" rowsep="0">
|
|
<colspec colwidth="176*">
|
|
<colspec colwidth="352*">
|
|
<tbody>
|
|
<row>
|
|
<entry align="left" valign="top"><para>WINDOW_TYPE</para><indexterm><primary>Zone</primary><secondary>WINDOW_TYPE</secondary></indexterm></entry>
|
|
<entry align="left" valign="top"><para>Type de support de fenêtrage
|
|
</para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><filename><indexterm><primary>Support
|
|
de fenêtrage</primary></indexterm><indexterm><primary></primary><secondary>NO_STDIO</secondary></indexterm>NO_STDIO</filename></para></entry>
|
|
<entry align="left" valign="top"><para>Aucun. Utilisez cette valeur si l'application
|
|
dispose de sa propre fenêtre, ou si la commande ne génère
|
|
aucune sortie visible.</para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><filename><indexterm><primary>Support
|
|
de fenêtrage</primary></indexterm><indexterm><primary></primary><secondary>PERM_TERMINAL</secondary></indexterm> PERM_TERMINAL</filename></para></entry>
|
|
<entry align="left" valign="top"><para>Fenêtre d'émulation de
|
|
terminal permanente. L'action ouvre une fenêtre de terminal qui reste
|
|
ouverte jusqu'à ce que l'utilisateur demande explicitement sa fermeture;
|
|
des données peuvent être entrées dans cette fenêtre.
|
|
Cette valeur doit être utilisée avec les commandes qui exigent
|
|
des entrées et génèrent une sortie avant de prendre fin
|
|
(par exemple, <command>ls</command> <symbol role="Variable">répertoire</symbol> ).</para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><command><indexterm><primary>Support
|
|
de fenêtrage</primary></indexterm><indexterm><primary>TERMINAL</primary>
|
|
</indexterm> TERMINAL</command></para></entry>
|
|
<entry align="left" valign="top"><para>Fenêtre d'émulation de
|
|
terminal provisoire. L'action ouvre une fenêtre de terminal qui se ferme
|
|
dès la fin de l'exécution de la commande. Utilisez cette valeur
|
|
dans le cas des commandes plein écran (par exemple, <command>vi</command>).
|
|
</para></entry></row></tbody></tgroup></informaltable>
|
|
</sect2>
|
|
<sect2 id="SAG.CrAct.div.42">
|
|
<title id="SAG.CrAct.mkr.26">Définition d'options de ligne de commande
|
|
pour l'émulateur de terminal<indexterm><primary>Emulateur de terminal</primary><secondary>options de ligne de commande</secondary></indexterm><indexterm>
|
|
<primary>Actions</primary><secondary>options de terminal</secondary></indexterm></title>
|
|
<para>Pour définir ces options, utilisez la zone <filename>TERM_OPTS</filename> de la définition de l'action.</para>
|
|
<para>Par exemple, l'action suivante invite à indiquer l'hôte
|
|
d'exécution:</para>
|
|
<programlisting>ACTION Ouvrir_term_sur_système_indiqué
|
|
{
|
|
WINDOW_TYPE PERM_TERMINAL
|
|
EXEC_HOST %(String)"Terminal éloigné sur :"%
|
|
TERM_OPTS -title %(String)"Titre de la fenêtre :"%
|
|
EXEC_STRING $SHELL
|
|
}</programlisting>
|
|
</sect2>
|
|
<sect2 id="SAG.CrAct.div.43">
|
|
<title id="SAG.CrAct.mkr.27">Définition d'un émulateur de terminal
|
|
par défaut différent<indexterm><primary>Emulateur de terminal</primary><secondary>par défaut</secondary></indexterm><indexterm>
|
|
<primary>Actions</primary><secondary>émulateur de terminal par défaut</secondary></indexterm></title>
|
|
<para>Par défaut, les actions utilisent l'émulateur de terminal <command>dtterm</command>; vous pouvez cependant en indiquer un autre. L'émulateur
|
|
par défaut est pris en compte lorsque l'action n'identifie pas explicitement
|
|
l'émulateur à utiliser.</para>
|
|
<para>L'émulateur utilisé par les actions doit être associé
|
|
aux options de ligne de commande suivantes:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para><command>-title</command> <symbol role="Variable">titre_fenêtre</symbol></para>
|
|
</listitem>
|
|
<listitem><para><command>-e</command> <symbol role="Variable">commande</symbol>
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>Les ressources ci-dessous définissent l'émulateur utilisé
|
|
par les actions.</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para><indexterm><primary>Ressources</primary><secondary>localTerminal</secondary></indexterm>La ressource <systemitem>localTerminal</systemitem>
|
|
indique l'émulateur associé aux applications locales.</para>
|
|
<programlisting remap="CodeIndent1">*localTerminal: <symbol role="Variable">terminal</symbol></programlisting>
|
|
<para>Par exemple:</para>
|
|
<programlisting>*localTerminal: xterm</programlisting>
|
|
</listitem>
|
|
<listitem><para id="SAG.CrAct.mkr.28">La ressource <systemitem>remoteTerminal</systemitem> indique l'émulateur associé aux applications éloignées.
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<programlisting>*remoteTerminal: <symbol role="Variable">hôte</symbol>:<symbol role="Variable">terminal</symbol> [,<symbol role="Variable">hôte</symbol>:<symbol role="Variable">terminal</symbol>…]</programlisting>
|
|
<para>Par exemple:</para>
|
|
<programlisting>*remoteTerminal: sysibm1:/usr/bin/xterm,syshp2:/usr/bin/yterm
|
|
</programlisting>
|
|
</sect2>
|
|
</sect1>
|
|
<sect1 id="SAG.CrAct.div.44">
|
|
<title id="SAG.CrAct.mkr.29"><indexterm><primary>Actions</primary><secondary>arguments restrictifs</secondary></indexterm><indexterm><primary>Arguments</primary><secondary>restrictions pour les actions</secondary></indexterm>Restriction
|
|
des actions à certains arguments</title>
|
|
<para>Pour préciser l'action, vous avez la possibilité de l'associer
|
|
à certains arguments uniquement. Par exemple, il est préférable
|
|
de faire en sorte que l'action permettant d'afficher les fichiers PostScript
|
|
n'accepte que ce type de fichier comme argument. Si un fichier incorrect est
|
|
indiqué, l'action affiche un message d'erreur.</para>
|
|
<para>Les restrictions s'appliquent en fonction:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>du type de données du fichier indiqué comme
|
|
argument</para>
|
|
</listitem>
|
|
<listitem><para>du nombre d'arguments (par exemple, aucun argument ou un ou
|
|
plusieurs arguments), ce qui permet d'indiquer différents comportements
|
|
pour la pose et le double clic sur l'icône de l'action</para>
|
|
</listitem>
|
|
<listitem><para>le mode de lecture-écriture de l'argument</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<sect2 id="SAG.CrAct.div.45">
|
|
<title id="SAG.CrAct.mkr.30">Restriction des actions à certains types
|
|
de données<indexterm><primary>Actions</primary><secondary>restriction
|
|
en fonction du type de données</secondary></indexterm></title>
|
|
<para><indexterm><primary>Zone</primary><secondary>ARG_TYPE</secondary></indexterm>Utilisez
|
|
la zone <filename>ARG_TYPE</filename> pour définir les types de données
|
|
auxquels l'action s'applique (indiquez les noms d'attributs de données).
|
|
</para>
|
|
<para>Vous pouvez indiquer plusieurs types de données, à condition
|
|
de les séparer par des virgules.</para>
|
|
<para>Dans l'exemple de définition d'action suivante, on considère
|
|
que le type de données Gif a été créé.
|
|
</para>
|
|
<programlisting>ACTION Ouvrir_Gif
|
|
{
|
|
TYPE COMMAND
|
|
LABEL "Afficher fichier GIF"
|
|
WINDOW_TYPE NO_STDIO
|
|
ARG_TYPE Gif
|
|
ICON xgif
|
|
DESCRIPTION Permet d'afficher les fichiers GIF.
|
|
EXEC_STRING xgif
|
|
}</programlisting>
|
|
</sect2>
|
|
<sect2 id="SAG.CrAct.div.46">
|
|
<title>Restriction d'une action en fonction du nombre d'arguments<indexterm>
|
|
<primary>Actions</primary><secondary>nombre d'arguments</secondary></indexterm></title>
|
|
<para><indexterm><primary>Zone</primary><secondary>ARG_COUNT</secondary></indexterm>Pour
|
|
indiquer le nombre d'arguments supportés par l'action, utilisez la
|
|
zone <filename>ARG_COUNT</filename>. Les valeurs possibles sont les suivantes
|
|
:</para>
|
|
<informaltable>
|
|
<tgroup cols="2" colsep="0" rowsep="0">
|
|
<colspec colwidth="70*">
|
|
<colspec colwidth="458*">
|
|
<tbody>
|
|
<row>
|
|
<entry align="left" valign="top"><para>*</para></entry>
|
|
<entry align="left" valign="top"><para>(défaut) Nombre d'arguments
|
|
illimité. Les autres valeurs sont prioritaires par rapport à
|
|
*.</para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para>n</para></entry>
|
|
<entry align="left" valign="top"><para>Toute valeur entière, y compris
|
|
0.</para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para>>n</para></entry>
|
|
<entry align="left" valign="top"><para>Plus de n arguments.</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><n</para></entry>
|
|
<entry align="left" valign="top"><para>Moins de n arguments.</para></entry>
|
|
</row></tbody></tgroup></informaltable>
|
|
<para>La zone <filename>ARG_COUNT</filename> permet d'indiquer différents
|
|
comportements pour l'icône d'action, selon que l'utilisateur clique
|
|
deux fois dessus ou y pose un fichier. Pour plus de détails, reportez-vous
|
|
à la section suivante <!--Original XRef content: '”Définition
|
|
de comportements différents pour la pose et le double clic”'--><xref
|
|
role="SectionTitle" linkend="SAG.CrAct.mkr.31">.</para>
|
|
</sect2>
|
|
<sect2 id="SAG.CrAct.div.47" role="Procedure">
|
|
<title id="SAG.CrAct.mkr.31">Définition de comportements différents
|
|
pour la pose et le double clic<indexterm><primary>Actions</primary><secondary>pose et double clic</secondary></indexterm><indexterm><primary>Zone</primary>
|
|
<secondary>ARG_COUNT</secondary></indexterm></title>
|
|
<para>La procédure suivante permet de créer une action prenant
|
|
en charge les fichiers posés, mais n'invitant pas à indiquer
|
|
un fichier lors d'un double clic utilisateu:</para>
|
|
<orderedlist>
|
|
<listitem><para>Créez une définition d'action pour la fonction
|
|
double clic.</para>
|
|
<para>Indiquez la valeur 0 dans la zone <filename>ARG_COUNT</filename>. Dans
|
|
la zone <filename>EXEC_STRING</filename>, spécifiez une syntaxe ne
|
|
supportant pas les arguments posés.</para>
|
|
</listitem>
|
|
<listitem><para>Créez une définition d'action pour la fonction
|
|
pose.</para>
|
|
<para>Indiquez la valeur >0 dans la zone <filename>ARG_COUNT</filename>. Dans
|
|
la zone <filename>EXEC_STRING</filename>, spécifiez une syntaxe supportant
|
|
les arguments posés.</para>
|
|
</listitem>
|
|
</orderedlist>
|
|
<para>Dans les exemples ci-dessous, les commandes suivantes permettent de
|
|
lancer l'éditeur <command>vedit</command>.</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>Pour lancer l'éditeur sans argument:</para>
|
|
<programlisting remap="CodeIndent1">vedit</programlisting>
|
|
</listitem>
|
|
<listitem><para>Pour lancer l'éditeur et ouvrir un fichier en lecture
|
|
seule:</para>
|
|
<programlisting remap="CodeIndent1">vedit -R <symbol role="Variable">nom_fichier</symbol></programlisting>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>Les deux actions ci-dessous permettent de créer les fonctions
|
|
pose et double clic pour l'action Vedit. La première action est prioritaire
|
|
lors de la recherche dans la base de données; en effet, la définition <filename>ARG_COUNT 0</filename> est plus précise que (<filename>ARG_COUNT *</filename> ).</para>
|
|
<programlisting># Fonction double clic
|
|
ACTION Vedit
|
|
{
|
|
TYPE COMMAND
|
|
ARG_COUNT 0
|
|
WINDOW_TYPE PERM_TERMINAL
|
|
EXEC_STRING vedit
|
|
}
|
|
|
|
# Fonction pose
|
|
ACTION Vedit
|
|
{
|
|
TYPE COMMAND
|
|
WINDOW_TYPE PERM_TERMINAL
|
|
EXEC_STRING vedit -R %Arg_1%
|
|
}</programlisting>
|
|
</sect2>
|
|
<sect2 id="SAG.CrAct.div.48">
|
|
<title>Restriction d'une action en fonction du mode de l'argument</title>
|
|
<para>Pour indiquer le mode de lecture-écriture de l'argument, utilisez
|
|
la zone <filename>ARG_MODE</filename>. Les valeurs possibles sont les suivantes:
|
|
</para>
|
|
<informaltable>
|
|
<tgroup cols="2" colsep="0" rowsep="0">
|
|
<colspec colwidth="65*">
|
|
<colspec colwidth="463*">
|
|
<tbody>
|
|
<row>
|
|
<entry align="left" valign="top"><para>*</para></entry>
|
|
<entry align="left" valign="top"><para>(défaut) Mode quelconque.</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para>!w</para></entry>
|
|
<entry align="left" valign="top"><para>Non accessible en écriture.
|
|
</para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para>w</para></entry>
|
|
<entry align="left" valign="top"><para>Accessible en écriture.</para></entry>
|
|
</row></tbody></tgroup></informaltable>
|
|
</sect2>
|
|
</sect1>
|
|
<sect1 id="SAG.CrAct.div.49">
|
|
<title id="SAG.CrAct.mkr.32">Création d'actions exécutant des
|
|
applications sur des systèmes éloignés<indexterm><primary>Actions</primary><secondary>lancement d'applications éloignés</secondary></indexterm></title>
|
|
<para>Vous devez connaître la signification des termes suivants:</para>
|
|
<informaltable>
|
|
<tgroup cols="2" colsep="0" rowsep="0">
|
|
<colspec colwidth="179*">
|
|
<colspec colwidth="349*">
|
|
<tbody>
|
|
<row>
|
|
<entry align="left" valign="top"><para><indexterm><primary>Hôte de base
|
|
de données</primary></indexterm>Hôte de base de données
|
|
</para></entry>
|
|
<entry align="left" valign="top"><para>Système contenant la définition
|
|
de l'action.</para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><indexterm><primary>Hôte d'exécution</primary></indexterm><indexterm><primary>création d'actions</primary>
|
|
</indexterm>Hôte d'exécution</para></entry>
|
|
<entry align="left" valign="top"><para>Système sur lequel le programme
|
|
s'exécute.</para></entry></row></tbody></tgroup></informaltable>
|
|
<para>Dans la plupart des cas, les actions et les applications associées
|
|
sont installées sur le même système; étant donné
|
|
que l'hôte d'exécution par défaut d'une action est l'hôte
|
|
de base de données, aucune syntaxe particulière n'est requise.
|
|
</para>
|
|
<para>Cependant, lorsque l'hôte d'exécution est différent
|
|
de l'hôte de base de données, le système sur lequel la
|
|
chaîne d'exécution sera lancée doit être indiqué
|
|
dans la définition de l'action.</para>
|
|
<para>La fonction de recherche des actions et des applications sur différents
|
|
systèmes fait partie de l'architecture client/serveur du Bureau. Pour
|
|
plus de détails sur les applications en réseau, reportez-vous
|
|
à la section <!--Original XRef content: '”Gestion des services
|
|
d'applications”, page 106'--><xref role="SecTitleAndPageNum" linkend="SAG.ClSrv.mkr.15">.
|
|
</para>
|
|
<sect2 id="SAG.CrAct.div.50">
|
|
<title id="SAG.CrAct.mkr.33">Création d'une action exécutant
|
|
une application éloignée<indexterm><primary>Zone</primary>
|
|
<secondary>EXEC_HOST</secondary></indexterm></title>
|
|
<para><indexterm><primary>Zone</primary><secondary>EXEC_HOST</secondary></indexterm><indexterm>
|
|
<primary>Hôte d'exécution</primary><secondary>zone EXEC_HOST</secondary></indexterm>Pour définir l'emplacement de l'application,
|
|
utilisez la zone <filename>EXEC_HOST</filename> de la définition de
|
|
l'action.</para>
|
|
<para>Vous pouvez indiquer les valeurs suivantes:</para>
|
|
<informaltable>
|
|
<tgroup cols="2" colsep="0" rowsep="0">
|
|
<colspec colwidth="176*">
|
|
<colspec colwidth="352*">
|
|
<tbody>
|
|
<row>
|
|
<entry align="left" valign="top"><para><filename><indexterm><primary>Mots
|
|
clé</primary></indexterm><indexterm><primary>σ</primary><secondary>DataBaseHost</secondary></indexterm> %DatabaseHost%</filename></para></entry>
|
|
<entry align="left" valign="top"><para>Système hôte sur lequel
|
|
l'action est définie.</para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><filename>%LocalHost%</filename></para></entry>
|
|
<entry align="left" valign="top"><para>Système hôte sur lequel
|
|
l'action est lancée (<emphasis>serveur de session</emphasis>).</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><filename><indexterm><primary>Mots
|
|
clé</primary></indexterm><indexterm><primary>σ</primary><secondary>DisplayHost</secondary></indexterm> %DisplayHost%</filename></para></entry>
|
|
<entry align="left" valign="top"><para>Système hôte sur lequel
|
|
le serveur X s'exécute (non autorisé dans le cas des terminaux
|
|
X).</para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><filename><indexterm><primary>Mots
|
|
clé</primary></indexterm><indexterm><primary>σ</primary><secondary>SessionHost</secondary></indexterm> %SessionHost%</filename></para></entry>
|
|
<entry align="left" valign="top"><para>Système hôte sur lequel
|
|
le Gestionnaire de connexion en cours s'exécute.</para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><symbol role="Variable">nom_hôte</symbol></para></entry>
|
|
<entry align="left" valign="top"><para>Utilisez cette valeur pour les environnements
|
|
dans lesquels l'action doit toujours être exécutée sur
|
|
un système hôte donné.</para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para>%"<symbol role="Variable">invite</symbol>"%
|
|
</para></entry>
|
|
<entry align="left" valign="top"><para>Invite l'utilisateur à indiquer
|
|
le nom hôte lors de chaque exécution de l'action.</para></entry>
|
|
</row></tbody></tgroup></informaltable>
|
|
<para>La valeur par défaut est <filename>%DatabaseHost%</filename>, <filename>%LocalHost%</filename>.<indexterm><primary>Zone</primary><secondary>EXEC_HOST</secondary><tertiary>valeur par défaut</tertiary></indexterm> Ainsi,
|
|
lorsque la zone <filename>EXEC_HOST</filename> n'est pas précisée,
|
|
une tentative d'exécution de la commande est effectuée sur le
|
|
système hôte contenant la définition de l'action. En cas
|
|
d'échec, le serveur de sessions est utilisé.</para>
|
|
<sect3 id="SAG.CrAct.div.51">
|
|
<title>Exemples</title>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>La zone suivante désigne le système hôte <command>ddsyd</command>:</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<programlisting>EXEC_HOST ddsyd</programlisting>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>La zone suivante invite à indiquer un système
|
|
hôte:</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<programlisting>EXEC_HOST %"Hôte contenant l'application :"%</programlisting>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>La zone suivante indique que l'action tente de lancer l'application
|
|
sur le système hôte qui contient sa définition. En cas
|
|
d'échec, elle tente de la lancer sur le système hôte <command>ddsyd</command>.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<programlisting>EXEC_HOST %DatabaseHost%, ddsyd</programlisting>
|
|
</sect3>
|
|
</sect2>
|
|
</sect1>
|
|
<sect1 id="SAG.CrAct.div.52">
|
|
<title id="SAG.CrAct.mkr.34">Utilisation de variables dans les définitions
|
|
d'actions et de types de données<indexterm><primary>Variables</primary>
|
|
<secondary>définitions d'actions</secondary></indexterm><indexterm>
|
|
<primary>Actions</primary><secondary>utilisation de variables</secondary>
|
|
</indexterm><indexterm><primary>Types de données</primary><secondary>utilisation de variables</secondary></indexterm></title>
|
|
<para>Vous pouvez indiquer des variables d'environnement et des variables
|
|
chaînes de caractères dans les fichiers de définition
|
|
d'actions et de types de données.</para>
|
|
<sect2 id="SAG.CrAct.div.53">
|
|
<title id="SAG.CrAct.mkr.35">Variables chaînes de caractères (actions)<indexterm>
|
|
<primary>Variables</primary><secondary>chaînes de caractères</secondary></indexterm><indexterm><primary>Actions</primary><secondary>variables chaînes de caractères</secondary></indexterm></title>
|
|
<para>Ce type de variable entre en vigueur lorsqu'elle est définie
|
|
et le reste jusqu'à la fin du fichier. Il n'existe aucune variable
|
|
globale pour la base de données.</para>
|
|
<para>Si une variable d'environnement et une variable chaîne de caractères
|
|
portent le même nom, cette dernière est prioritaire.</para>
|
|
<sect3 id="SAG.CrAct.div.54" role="Procedure">
|
|
<title>Définition d'une variable chaîne de caractères</title>
|
|
<itemizedlist>
|
|
<listitem><para>Utilisez la syntaxe:</para>
|
|
<programlisting remap="CodeIndent1">set <symbol role="Variable">nom_variable</symbol>=<symbol role="Variable">valeur</symbol></programlisting>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>Les noms de variables peuvent contenir des caractères alphanumériques
|
|
et le caractère de soulignement “__”. Chaque définition
|
|
de variable doit figurer sur une ligne distincte.</para>
|
|
<para>Par exemple:</para>
|
|
<programlisting>set Remote_Application_Server=sysapp
|
|
set Remote_File_Server=sysdata</programlisting>
|
|
</sect3>
|
|
<sect3 id="SAG.CrAct.div.55" role="Procedure">
|
|
<title>Référence à une variable chaîne de caractères
|
|
:</title>
|
|
<itemizedlist>
|
|
<listitem><para>Utilisez la syntaxe:</para>
|
|
<para remap="CodeIndent1">$[{]<symbol role="Variable">nom_variable</symbol>[}]
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>Par exemple:</para>
|
|
<programlisting>EXEC-HOST $Remote_Application_Server
|
|
CWD /net/ ${Remote_File_Server}/doc/projet</programlisting>
|
|
</sect3>
|
|
</sect2>
|
|
<sect2 id="SAG.CrAct.div.56">
|
|
<title id="SAG.CrAct.mkr.36">Variables d'environnement (actions et types de
|
|
données)<indexterm><primary>Variables</primary><secondary>d'environnement</secondary><tertiary>définitions d'actions</tertiary></indexterm><indexterm>
|
|
<primary>Actions</primary><secondary>variables d'environnement</secondary>
|
|
</indexterm></title>
|
|
<itemizedlist>
|
|
<listitem><para>Utilisez la syntaxe suivante pour faire référence
|
|
à une variable d'environnement:</para>
|
|
<para remap="CodeIndent1"><filename>$[{]</filename><symbol role="Variable">variable</symbol>[<filename>}]</filename>.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>La variable est remplacée par sa valeur lors du chargement de
|
|
la base de données. Si une variable d'environnement et une variable
|
|
chaîne de caractères portent le même nom, cette dernière
|
|
est prioritaire.</para>
|
|
<para>Par exemple, la chaîne d'exécution suivante permet d'imprimer
|
|
un fichier avec une bannière indiquant le nom de connexion:</para>
|
|
<programlisting>EXEC-STRING lp -t$LOGNAME %(File)Arg_1%</programlisting>
|
|
</sect2>
|
|
</sect1>
|
|
<sect1 id="SAG.CrAct.div.57">
|
|
<title id="SAG.CrAct.mkr.37">Exécution d'actions à partir de
|
|
la ligne de commande<indexterm><primary>Actions</primary><secondary>exécution
|
|
d'autres actions</secondary></indexterm></title>
|
|
<para>Pour effectuer cette opération, utilisez la commande du Bureau <command>dtaction</command>. Les actions peuvent être exécutées
|
|
à partir:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>de scripts</para>
|
|
</listitem>
|
|
<listitem><para>d'autres actions</para>
|
|
</listitem>
|
|
<listitem><para>de la ligne de commande d'une fenêtre d'émulation
|
|
de terminal.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<sect2 id="SAG.CrAct.div.58">
|
|
<title>Commande dtaction<indexterm><primary>dtaction</primary><secondary>syntaxe</secondary></indexterm></title>
|
|
<para><command>dtaction [-user</command> <symbol role="Variable">nom_utilisateur</symbol><command>] [-execHost</command> <symbol role="Variable">nom_hôte</symbol><command>]</command> <symbol role="Variable">nom_action</symbol> <command>[</command><symbol role="Variable">argument</symbol> <command>[</command><symbol role="Variable">argument</symbol><command>]…]</command></para>
|
|
<informaltable>
|
|
<tgroup cols="2" colsep="0" rowsep="0">
|
|
<colspec colwidth="192*">
|
|
<colspec colwidth="336*">
|
|
<tbody>
|
|
<row>
|
|
<entry align="left" valign="top"><para><filename>-user</filename> <symbol role="Variable">nom_utilisateur</symbol></para></entry>
|
|
<entry align="left" valign="top"><para>Permet à un autre utilisateur
|
|
d'exécuter l'action. Si <command>dtaction</command> est lancée
|
|
par un utilisateur différent de <symbol role="Variable">nom_utilisateur,</symbol> il est invité à indiquer un mot de passe.</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para>-<command>execHost</command> <symbol role="Variable">nom_hôte</symbol></para></entry>
|
|
<entry align="left" valign="top"><para>Actions de type <command>COMMAND</command>
|
|
uniquement; indique le système hôte d'exécution de la
|
|
commande.</para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><symbol role="Variable">argument</symbol></para></entry>
|
|
<entry align="left" valign="top"><para>Arguments associés à
|
|
l'action; il s'agit généralement de fichiers.</para></entry>
|
|
</row></tbody></tgroup></informaltable>
|
|
<para>Le client <command>dtaction</command> dispose d'options de ligne de
|
|
commande supplémentaires. Pour plus de détails, consultez la
|
|
page de manuel <filename moreinfo="RefEntry">dtaction(1)</filename>.</para>
|
|
</sect2>
|
|
<sect2 id="SAG.CrAct.div.59">
|
|
<title>Création d'une action exécutant une autre action<indexterm>
|
|
<primary>Actions</primary><secondary>exécution d'autres actions</secondary>
|
|
</indexterm></title>
|
|
<para>Indiquez <command>dtaction</command> dans la zone <filename>EXEC_STRING</filename> de l'action.</para>
|
|
<para>Par exemple, l'action ci-dessous utilise l'action intégrée
|
|
Spell, dont le libellé est Vérifier orthographe dans le Gestionnaire
|
|
d'applications. La nouvelle action lance l'Editeur de texte et Spell, puis
|
|
affiche les erreurs d'orthographe dans une fenêtre d'émulation
|
|
de terminal distincte.</para>
|
|
<programlisting>ACTION Editer_et_vérifier
|
|
{
|
|
WINDOW_TYPE NO_STDIO
|
|
EXEC_STRING /bin/sh -c 'dtaction Spell \
|
|
%Arg_1"Fichier :"%; dtpad %Arg_1%'
|
|
}</programlisting>
|
|
</sect2>
|
|
<sect2 id="SAG.CrAct.div.60">
|
|
<title id="SAG.CrAct.mkr.38">Création d'une action exécutée
|
|
par un autre utilisateur<indexterm><primary>Actions</primary><secondary>exécution par un autre utilisateur</secondary></indexterm><indexterm>
|
|
<primary>dtaction</primary><secondary>modification de l'utilisateur</secondary>
|
|
</indexterm></title>
|
|
<para>Utilisez la syntaxe suivante dans la zone <filename>EXEC_STRING</filename>
|
|
:</para>
|
|
<programlisting>EXEC_STRING dtaction -user <symbol role="Variable">nom_utilisateur</symbol> <symbol role="Variable">nom_action</symbol> [<symbol role="Variable">argument_fichier</symbol>]</programlisting>
|
|
<para>Pour avoir accès au système, le nouvel utilisateur (<symbol role="Variable">nom_utilisateur</symbol>) doit disposer d'une des autorisations
|
|
suivantes:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>autorisation de lecture sur le fichier <filename>.Xauthority</filename> de l'utilisateur de connexion</para>
|
|
</listitem>
|
|
<listitem><para><emphasis>ou</emphasis> autorisation <command>xhost</command></para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>Par exemple, les actions suivantes permettent de devenir utilisateur
|
|
root et d'éditer un fichier app-defaults.</para>
|
|
<programlisting>ACTION AppDefaults
|
|
{
|
|
WINDOW_TYPE NO_STDIO
|
|
EXEC_STRING /usr/dt/bin/dtaction -user root \
|
|
EditerAppDefaults %Arg_1"Fichier :"%
|
|
}
|
|
|
|
ACTION EditerAppDefaults
|
|
{
|
|
WINDOW_TYPE TERMINAL
|
|
EXEC_STRING /bin/sh -c 'chmod +w %Arg_1%; \
|
|
vi %Arg_1%; chmod -w %Arg_1%'
|
|
}</programlisting>
|
|
</sect2>
|
|
</sect1>
|
|
<sect1 id="SAG.CrAct.div.61">
|
|
<title id="SAG.CrAct.mkr.39">Création d'actions internationalisées<indexterm>
|
|
<primary>Actions</primary><secondary>localisation</secondary></indexterm><indexterm>
|
|
<primary>Localisation</primary><secondary>actions</secondary></indexterm></title>
|
|
<para>Le chemin de recherche de types de données comporte des emplacements
|
|
liés à la langue utilisée. Le Bureau utilise la valeur
|
|
de <systemitem>LANG</systemitem> pour identifier les répertoires dans
|
|
lesquels rechercher les définitions de types de données.</para>
|
|
<sect2 id="SAG.CrAct.div.62">
|
|
<title>Emplacements des actions internationalisées</title>
|
|
<para>Les définitions des actions adaptées au pays doivent être
|
|
situées dans les répertoires associés à la langue
|
|
utilisée, dans le chemin de recherche des actions.</para>
|
|
<para>Les chemins de recherche par défaut sont les suivants:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>actions personnelles: <symbol role="Variable">Rép_personnel</symbol><filename>/.dt/types</filename></para>
|
|
</listitem>
|
|
<listitem><para>actions système: <filename>/etc/dt/appconfig/types/</filename><symbol role="Variable">langue</symbol></para>
|
|
</listitem>
|
|
<listitem><para>actions intégrées: <filename>/usr/dt/appconfig/types/</filename><symbol role="Variable">langue</symbol>.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</sect2>
|
|
<sect2 id="SAG.CrAct.div.63" role="Procedure">
|
|
<title>Internationalisation d'une action existante<indexterm><primary>Actions</primary><secondary>libellés</secondary></indexterm><indexterm><primary>Libellés</primary><secondary>actions</secondary></indexterm><indexterm>
|
|
<primary>Localisation</primary><secondary>libellés d'actions</secondary>
|
|
</indexterm></title>
|
|
<orderedlist>
|
|
<listitem><para>Créez un fichier dans le répertoire correspondant
|
|
à la langue (par exemple, <filename>/etc/dt/appconfig/types/fr_FR</filename>).
|
|
</para>
|
|
</listitem>
|
|
<listitem><para>Copiez la définition de l'action dans le fichier de
|
|
configuration lié à la langue.</para>
|
|
<para>Par exemple, vous pouvez copier une définition d'action de</para>
|
|
<para remap="CodeIndent1"><filename><symbol role="Variable">racine_app</symbol>/dt/appconfig/types/C/<symbol role="Variable">fichier</symbol>.dt</filename></para>
|
|
<para>vers</para>
|
|
<para remap="CodeIndent1"><filename><symbol role="Variable">racine_app</symbol>/dt/appconfig/types/fr_FR/<symbol role="Variable">nouveau_fichier</symbol>.dt</filename></para>
|
|
</listitem>
|
|
<listitem><para>Ajoutez une zone <command>LABEL</command> ou modifiez celle
|
|
qui existe.</para>
|
|
<para remap="CodeIndent1"><command>LABEL</command> <symbol role="Variable">chaîne</symbol></para>
|
|
<para>Les Gestionnaires d'applications et de fichiers utilisent cette chaîne
|
|
pour identifier l'icône d'action.</para>
|
|
</listitem>
|
|
<listitem><para>Localisez un ou plusieurs des éléments suivants
|
|
:</para>
|
|
<itemizedlist remap="Bullet2">
|
|
<listitem><para>icônes: zone <command>ICON</command></para>
|
|
</listitem>
|
|
<listitem><para>aide sur l'élément: zone <command>DESCRIPTION</command></para>
|
|
</listitem>
|
|
<listitem><para>invites localisées: texte entre guillemets dans la
|
|
zone <filename>EXEC_STRING</filename></para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</listitem>
|
|
</orderedlist>
|
|
</sect2>
|
|
</sect1>
|
|
<sect1 id="SAG.CrAct.div.64">
|
|
<title id="SAG.CrAct.mkr.40">Création d'actions pour les applications
|
|
ToolTalk<indexterm><primary>Actions</primary><secondary>TT_MSG</secondary>
|
|
<tertiary>création</tertiary></indexterm><indexterm><primary>ToolTalk</primary><secondary>applications</secondary></indexterm><indexterm><primary><$nopage>ToolTalk</primary><secondary>action, Voir Actions</secondary>
|
|
</indexterm></title>
|
|
<note>
|
|
<para>Les informations suivantes ne s'appliquent qu'aux programmes qui supportent
|
|
la messagerie ToolTalk.</para>
|
|
</note>
|
|
<para>Les actions permettant d'envoyer des messages ToolTalk, sont du type <filename>TT_MSG</filename>.</para>
|
|
<programlisting>ACTION nom_action
|
|
{
|
|
TYPE TT_MSG
|
|
…
|
|
}</programlisting>
|
|
<sect2 id="SAG.CrAct.div.65">
|
|
<title>Zones addressing et disposition</title>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>La valeur de la zone ToolTalk <command>addressing</command>
|
|
est toujours <filename>TT_PROCEDURE</filename>.</para>
|
|
</listitem>
|
|
<listitem><para>Par défaut, la valeur de la zone <command>disposition</command> est la spécification de forme de message statique.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<sect3 id="SAG.CrAct.div.66">
|
|
<title>Messages non pris en charge</title>
|
|
<para>Les messages suivants ne sont pas pris en charge par les actions de
|
|
type <filename>TT_MSG</filename>:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>messages ToolTalk orientés objet</para>
|
|
</listitem>
|
|
<listitem><para>arguments contextuels des messages</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</sect3>
|
|
<sect3 id="SAG.CrAct.div.67">
|
|
<title>Mots clés des actions TT_MSG<indexterm><primary>Actions</primary>
|
|
<secondary>TT_MSG</secondary><tertiary>mots clés</tertiary></indexterm></title>
|
|
<informaltable>
|
|
<tgroup cols="2" colsep="0" rowsep="0">
|
|
<colspec colwidth="163*">
|
|
<colspec colwidth="365*">
|
|
<thead>
|
|
<row><entry align="left" valign="bottom"><para>Mot clé</para></entry>
|
|
<entry align="left" valign="bottom"><para>Utilisation</para></entry></row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry align="left" valign="top"><para><filename>TT_CLASS</filename></para></entry>
|
|
<entry align="left" valign="top"><para>Définit la valeur de la zone
|
|
ToolTalk <command>class</command>.</para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><filename>TT_SCOPE</filename></para></entry>
|
|
<entry align="left" valign="top"><para>Définit la valeur de la zone
|
|
ToolTalk <command>scope</command>.</para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><filename>TT_OPERATION</filename></para></entry>
|
|
<entry align="left" valign="top"><para>Définit la valeur de la zone
|
|
ToolTalk <command>operation</command>.</para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><filename>TT_FILE</filename></para></entry>
|
|
<entry align="left" valign="top"><para>Définit la valeur de la zone
|
|
ToolTalk <command>file</command>.</para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><filename>TT_ARGn_MODE</filename></para></entry>
|
|
<entry align="left" valign="top"><para>Définit la valeur de l'attribut
|
|
ToolTalk <command>mode</command> pour le <symbol role="Variable">n</symbol>ième
|
|
message.</para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><filename>TT_ARGn_VTYPE</filename></para></entry>
|
|
<entry align="left" valign="top"><para>Définit la valeur de l'attribut
|
|
ToolTalk <command>vtype</command> pour le <symbol role="Variable">n</symbol>ième
|
|
message.</para></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><filename>TT_ARGn_VALUE</filename></para></entry>
|
|
<entry align="left" valign="top"><para>Définit la valeur du <symbol role="Variable">n</symbol>ième message.</para></entry></row></tbody>
|
|
</tgroup></informaltable>
|
|
</sect3>
|
|
</sect2>
|
|
</sect1><?Pub Caret>
|
|
</chapter>
|
|
<!--fickle 1.14 mif-to-docbook 1.7 01/02/96 15:21:25-->
|
|
<?Pub *0000102034>
|