Solaris 一般桌上管理系統環境：進階使用者和系統管理員指南

第 12章人工建立動作

建立動作有兩種方法：

使用「建立動作」桌上管理系統應用程式
人工建立動作定義

人工建立動作需要您編輯資料庫檔案。本章描述如何人工建立動作定義。

有關動作的簡介，請參閱第 10章, 動作與資料類型簡介。

有關使用「建立動作」的資訊，請參閱第 11章, 使用建立動作來建立動作與資料類型。

有關動作定義的參考資訊，請參閱 dtactionfile(4) 線上援助頁。

您必須人工建立動作的理由

有三種基本類型的動作：

COMMAND
MAP
TT_MSG

建立動作工具是設計來建立特定類型的 COMMAND 與 MAP 動作。所有的 TT_MSG 動作都必須以人工建立。

有關更多的資訊，請參閱 "建立動作的限制"。

COMMAND 動作

指令動作執行啟動應用程式的指令、執行 shell 程序檔或執行作業系統指令。動作的定義包括要執行的指令（EXEC_STRING）。

建立「動作工具」工具可以用於建立最常見的指令動作類型。然而，可能會有一些您必須以人工建立動作的情況；但是，如果動作指定如下，您必須人工建立 指令動作：

每個引數都有不同提示符號的多重檔案引數。
動作呼叫-動作呼叫其它動作的能力。
引數計數的相依行為-為不同數目的檔案引數建立有非常不同行為的動作能力。
遠端執行主機-在系統上而非包含動作定義者執行應用程式的能力。
使用者的變更-以不同的使用者執行動作的能力（例如，以 root 密碼提示然後以 root 執行）。

MAP 動作

對映動作是 ``對映'' 至其它動作而非直接指定指令或 ToolTalk 訊息的動作。

對映提供指定動作的替代名稱的能力。例如，名為 IconEditor 的指令動作啟動圖示編輯程式。資料庫也包括定義中限制為點陣圖與像素對應檔案（由 ARG_TYPE欄位）的開啟動作，此動作對映至 IconEditor 動作。此讓使用者藉由選擇「檔案管理者」中的點陣圖或像素對應，然後從「所選項目」功能表選擇「開啟」來啟動「圖示編輯程式」。

「建立動作」為「開啟」與「列印」動作提供了有限的對映。其它所有的對映動作都必須以人工建立。

TT_MSG (ToolTalk 訊息) 動作

TT_MSG 動作可發送 ToolTalk 訊息。所有的 TT_MSG 動作都必須以人工建立。

人工建立動作：一般步驟

本節解釋如何建立動作定義的配置檔案。

動作的配置檔案

包含動作定義的配置檔案必須符合這些需求：

檔案必須使用命名慣例 name .dt

檔案必須位於資料庫（動作與資料類型）搜尋路徑上。預設搜尋路徑為：

個人的動作-HomeDirectory /.dt/types

整個系統的動作-/etc/dt/appconfig/types/language

內建的動作-/usr/dt/appconfig/types/language. 您不應使用此目錄。

有關修改動作/資料類型搜尋路徑的資訊，請參閱 "設定搜尋路徑的值"。

人工建立動作

開啟現存資料庫檔案或建立新檔案。

請參閱前一節， "動作的配置檔案"。

使用此語法建立動作定義：
```
	ACTION action_name
 	{
  		TYPE		action_type
  		action_field
 		...
 	}
```
其中：

action_name-用於執行動作的名稱。

action_type-指令（預設）、對映或 TT_MSG。

action_field-此類型動作的所需或選擇性的欄位之一。所有欄位都是由一個關鍵字與一個值所組成的。

本章中涵蓋許多的動作欄位。有關更多的資訊，請參閱 dtactionfile(4) 線上援助頁。

儲存檔案。

如果您想要動作圖示有個唯一的影像，請為此動作建立圖示。圖示的預設位置為：
- 個人圖示： HomeDirectory /.dt/icons
- 整個系統的圖示：/etc/dt/appconfig/icons/language 。預設 語言 為 C。
  
  有關更多的資訊，請參閱 "指定由動作使用的圖示影像"。

連按兩下桌面工具應用程式群組中的重新載入動作。

建立動作的動作檔案。動作檔案在「檔案管理者」或代表動作的「應用程式管理者」中建立圖示。（如果動作的寫入目的是為了啟動應用程式，圖示就稱為 應用程式圖示。）

如果要建立動作檔案，請建立與 action_name 有相同名稱的可執行檔案。您可以將檔案放在任何您有寫入許可權的目錄中。您可以任意地建立動作檔案的數目。

建立 COMMAND 動作的範例

下列步驟建立啟動在遠端系統 AppServerA 上的傳真應用程式的個人動作。啟動傳真應用程式的指令為：

 /usr/fax/bin/faxcompose [檔案名稱]

建立包含指令的檔案 HomeDirectory /.dt/types/Fax.dt。

將以下動作定義放在檔案中：
```
ACTION FaxComposer
	{
 		TYPE					COMMAND
 		ICON					fax
 		WINDOW_TYPE			NO_STDIO
 		EXEC_STRING			/usr/fax/bin/faxcompose -c %Arg_1%
 		EXEC_HOST     	 	AppServerA
 		DESCRIPTION    	Runs the fax composer
```
```
	}
```
WINDOW_TYPE 與 EXEC_STRING 欄位描述動作的行為。

WINDOW_TYPE- NO_STDIO 關鍵字指定動作不需在終端機模擬器視窗中執行。

請參閱 "指定動作的視窗支援"。

EXEC_STRING-語法 %Arg _1% 接受定位檔案。如果連按兩下動作圖示，動作會開啟空白的傳真撰寫程式視窗。

請參閱 "建立 COMMAND 動作的執行字串"。

儲存檔案。

使用「圖示編輯程式」在 HomeDirectory /.dt/icons 目錄中建立下列的圖示影像檔案：
- fax.m.pm，大小 32 乘 32 像素
- fax.t.pm，大小 16 乘 16 像素

連按兩下桌面工具應用程式群組中的重新載入動作。

建立您有寫入許可權的目錄（例如，您的主目錄）中名為 FaxComposer 的可執行的檔案。

建立 MAP 動作的範例

假定您傳真的大部分檔案都是以「文字編輯程式」所建立的而且是資料類型 TEXTFILE（名為 *.txt 的檔案）。

這些步驟將 ``傳真'' 功能表項目增加至資料類型的「所選項目」功能表。

開啟之前範例中建立的檔案 HomeDirectory /.dt/types/Fax.dt。

增加此對映動作定義至檔案：

ACTION Fax
 	{
 		ARG_TYPE			TEXTFILE
 		TYPE				MAP
 		MAP_ACTION		FaxComposer
 	}

儲存檔案。

從 /usr/dt/appconfig/types/ 取得優先順序的個人語言相依的配置檔案 /dtpad.dt 複製 TEXTFILE 的資料屬性定義至新檔案 HomeDirectory /.dt/types/textfile.dt。將傳真動作增加至 ACTIONS 欄位。
```
DATA_ATTRIBUTES TEXTFILE
 	{
 		ACTIONS			Open,Print,Fax
 		ICON				Dtpenpd
 		...
 	}
```

儲存檔案。

開啟「應用程式管理者」並連按兩下桌面工具應用程式群組中的「重新載入動作」。

重新載入動作/資料類型資料庫

為了使新的或編輯的動作定義生效，桌上管理系統必須重新讀取資料庫。

開啟桌面工具應用程式群組並連按兩下「重新載入動作」。

或，執行指令：

	dtaction ReloadActions

ReloadActions 是其圖示標為 ``重新載入動作'' 的動作的名稱。

當使用者如下執行時，也會重新讀取動作資料庫：

登入

重新啟動工作區管理者

藉由從檔案功能表選擇儲存以在建立動作視窗中儲存動作

建立動作的動作檔案 (圖示)

動作檔案 是建立以提供「檔案管理者」或「應用程式管理者」中的動作視覺表示方式的檔案。

圖 12-1 應用程式管理者中的動作檔案（動作圖示）

既然動作檔案的圖示代表動作，有時它也稱為 動作圖示。如果隱藏的動作啟動應用程式，動作檔案圖示就稱為 應用程式圖示。

連按兩下動作圖示會執行動作。動作圖示也可以是定位區域。

如果要建立動作檔案（動作圖示）

建立與動作名稱有相同名稱的可執行檔案。檔案的內容不會影響。

例如，如果動作定義為：

ACTION   MyFavoriteApp
{
 	EXEC_STRING				Mfa -file %Arg_1%
 	DESCRIPTION				Runs MyFavoriteApp
 	ICON						Mfapp
 }

那麼動作檔案將會是名為 MyFavoriteApp 的可執行檔案。在「檔案管理者」與「應用程式管理者」中，MyFavoriteApp 檔案會使用圖示影像 Mfapp. size.type。連按兩下 MyFavoriteApp 的圖示將會執行動作的執行字串，而圖示的「關於項目」輔助說明將會是 說明 欄位的內容（"runs MyFavoriteApp"）。

動作標籤

如果動作定義包括 標籤 欄位，將會將動作檔案標示在「檔案管理者」與具有此欄位內容的「應用程式管理者」而非檔案名稱 ( action_name) 中。例如，如果動作定義包括：

動作   MyFavoriteApp
{
 	LABEL      Favorite Application
 	...
 }

那麼動作圖示將會標示為 ``最喜愛的應用程式''。

指定由動作使用的圖示影像

使用 ICON 欄位來指定為動作所建立的動作圖示的「檔案管理者」與「應用程式管理者」所使用的圖示。

如果您未指定圖示，系統則使用預設動作圖示影像檔案 /usr/dt/appconfig/icons/language /Dtactn.*。

圖 12-2 預設動作圖示影像

預設動作圖示可以使用資源來變更：

*actionIcon:    icon_file_name

其中 icon_file_name 可以是基本名稱或絕對路徑。

ICON 欄位的值可以是：

基本檔案名稱

基本檔案名稱是包含圖示影像減去檔案名稱的大小（m 與 t）與影像類型（bm and pm）字尾的檔案名稱。例如，如果檔案名稱為 GameIcon.m.pm 與 GameIcon.t.pm，請使用 GameIcon。

如果您使用基本檔案名稱，圖示檔案必須放在圖示搜尋路徑上的目錄中：
- 個人圖示： HomeDirectory /.dt/icons
- 整個系統的圖示：/etc/dt/appconfig/icons/language

圖示檔案的絕對路徑，包括完整的檔案名稱

唯有當圖示檔案不在圖示搜尋路徑上時才應使用絕對路徑。例如，如果圖示檔案 GameIcon.m.pm 是放在不在圖示搜尋路徑上的目錄 /doc/projects 中，ICON 欄位的值會是 /doc/projects/GameIcon.m.pm。

表 12-1 列出您應該建立的圖示大小與相等的檔案名稱。

表 12-1 動作圖示的圖示名稱與大小


像素的大小	點陣圖名稱	像素對應名稱
48 乘 48	`name.l.bm`	`name` `.l.pm`
32乘 32	`name` `.m.bm`	`name.m.pm`
16乘 16	`name.t.bm`	`name.t.pm`

修改現存動作定義

您可以修改您系統上任何可供使用的動作，包括內建動作。

註解 -

當修改內建動作資料庫時，請小心使用。內建動作是設計來與桌上管理系統應用程式共同良好運作的。

尋找您想要修改的動作定義。

動作定義的預設位置為：
- 內建動作：/usr/dt/appconfig/types/language
- 整個系統的動作：/etc/dt/appconfig/types/language
- 個人動作：HomeDirectory /.dt/types
  
  您的系統可能會包括其它的位置。如果要看您的系統為動作所使用的位置清單，請鍵入指令：
```
	dtsearchpath -v
```
  您的系統使用列在 DTDATABASESEARCHPATH 之下的目錄。

如果有必要，請將動作定義的文字複製至這些目錄之一中的新的或現存檔案：
- 整個系統的動作：/etc/dt/appconfig/types/language
- 個人動作：HomeDirectory /.dt/types
  
  既然您不應在 /usr/dt/appconfig/types/language 目錄中編輯檔案，那么您必須複製內建動作。

編輯動作定義。

當您完成編輯時，請儲存檔案。

連按兩下桌面工具應用程式群組中的重新載入動作。

動作定義中的優先順序

當使用者呼叫動作時，系統會搜尋符合動作名稱的資料庫。當一個以上的動作以該名稱存在時，系統會使用優先順序規則來決定要使用何者。

如果未應用其它的優先順序規則，優先順序以定義的位置為基礎。下表的優先順序是由高到低的順序：
- 個人動作（HomeDirectory /.dt/types）
- 整個系統的本機動作（/etc/dt/appconfig/types/language)
- 整個系統的遠端動作（主機名稱 :/etc/dt/appconfig/types/language)。搜尋的遠端主機就是列在應用程式搜尋路徑中的那一些。
- 內建動作（/usr/dt/appconfig/types/language)

在已知的目錄中，*.dt 檔案是以字母順序讀取的。

由 ARG_CLASS、ARG_TYPE、ARG_MODE 或 ARG_COUNT所限制的動作對於未受限制的動作有優先順序。(此四個欄位的預設值為 *。)

其中應用一項以上的限制，由高到低的優先順序為：
- ARG_CLASS
- ARG_TYPE
- ARG_MODE
- ARG_COUNT
  
  其中有一項以上的受限制 ARG_COUNT 存在，由高到低的優先順序為：
- 特定的整數值 n
- <n
- >n
- *
例如，試想下列部分的動作定義：
```
ACTION EditGraphics
 # EditGraphics-1
 {
 	ARG_TYPE				XWD
 	...
 }
 
```
```
ACTION EditGraphics
 # EditGraphics-2
 {
 	ARG_COUNT  				0
 	...
 }
 
```
```
ACTION EditGraphics
 # EditGraphics-3
 {
 	ARG_TYPE  		*
     ...
 }
```
連按兩下 EditGraphics 動作圖示會啟動 EditGraphics-2，因為未提供引數，而且 ARG_COUNT 0 有優先順序。當 XWD 類型的檔案引數被提供時，會使用 EditGraphics-1，因為其指定 XWD ARG_TYPE。所有其它檔案引數都使用 EditGraphics-3。

建立 COMMAND 動作的執行字串

指令 動作的最小需求為兩個欄位 -動作 與 EXEC_STRING。

動作 action_name
 {
     EXEC_STRING execution_string
 }

執行字串是 指令 動作定義最重要的部分。它會使用與您將會在終端機視窗中所執行的指令行類似的語法，但還包括處理檔案與字串引數的其它語法。

執行字串的一般功能

執行字串可包括：

檔案與非檔案引數
Shell 語法
絕對路徑或可執行的名稱

動作引數

引數是指令或應用程式要正確執行所需要的資訊。例如，試想您可以用以開啟「文字編輯程式」中的檔案之指令行：

dtpad 檔案名稱

在此指令中，檔案名稱是 dtpad 指令的檔案引數。

就像應用程式與指令，動作可以有引數。指令 動作可以使用的資料有兩種類型：

檔案
字串資料

在執行字串中使用 Shell

執行字串是直接執行的，而不是經由 shell。但是，您可以在執行字串中明確地呼叫 shell。

例如：

EXEC_STRING  	\ 
   /bin/sh -c \
   'tar -tvf% （File）Arg_1% 2>&1 | \${PAGER:-more};\ 
   echo "\\n*** 從視窗功能表選擇關閉以關閉 ***"'

可執行的名稱或絕對路徑

如果您的應用程式是位於路徑變數中列出的目錄中，您可以使用簡單的可執行名稱。如果應用程式是在它處，您必須使用絕對路徑於可執行的檔案。

建立不使用引數的動作

使用您將會用以從指令行啟動應用程式的 EXEC_STRING 的相同語法。

範例

此執行字串是啟動 X 用戶端 xcutsel 的部分動作。
```
EXEC_STRING xcutsel
```

此執行字串啟動具有數位時鐘的用戶端 xclock。指令行包括指令行的選項，但不需要引數。
```
EXEC_STRING xclock -digital
```

建立接受定位檔案的動作

為檔案引數使用此語法：

%Arg_n%

或

%（File）Arg_n%

(檔案) 是選擇性的，因為提供給 Arg_n 的引數被假設為 (依據預設值) 檔案。（請參閱"解譯檔案引數為字串"如何使用 %(String)Arg_n% 語法的資訊。)

此語法讓使用者在動作圖示上定位資料檔案物件，以啟動具有該檔案引數的動作。其在指令行中代替 nth 引數。檔案可以是本機或遠端檔案。

範例

執行字串將使用定位檔案作為 -載入 參數來執行 wc -w。
```
EXEC_STRING wc -w%Arg _1%
```

此範例顯示只與目錄引數運作的動作的部分定義。當目錄定位於動作圖示上時，動作在具有讀取及寫入的許可權的目錄中顯示所有檔案的清單。
```
	ACTION  List_Writable_Files
 	{
 	    ARG_TYPE     FOLDER
 	    EXEC_STRING /bin/sh -c 's -l %Arg_1% | grep rw-'
 	    ...
 	}
```

建立一個提示檔案引數的動作

為檔案引數使用此語法：

%（File）"提示符號"%

當使用者連按兩下動作圖示時，此語法建立顯示檔案名稱的提示符號的動作。

例如，這個執行字串會顯示一個對話方塊，提示 wc -w 指令的檔案引數：

EXEC_STRING wc -w%（File）"在檔案中計數字數："%

建立接受定位檔案或提示符號的動作

為檔案引數使用此語法：

%Arg_n"提示符號"%

或

%（File）Arg_n"提示符號"%

此語法產生如下動作：

接受定位檔案為檔案引數。

當使用者連按兩下動作圖示時，顯示提示檔案名稱的對話框。

例如，這個執行字串會執行 lp -oraw。如果動作是由連按兩下圖示所啟動的，會出現對話框以提示檔案名稱。
```
EXEC_STRING lp -oraw %Arg _1"列印的檔案："%
```

建立一個提示非檔案引數的動作

為非檔案參數使用此語法：

%"提示符號"%

或

%（String）"提示符號"%

（String） 是選擇性的，因為按預設解譯引號的文字為字串資料。此語法顯示提示非檔案資料的對話框；當提示檔案名稱時，請勿使用此語法。

例如，此執行字串執行 xwd 指令與要增加至每個像素的值的提示符號：

EXEC_STRING xwd -add% "增加值："% -out %Arg _1" 檔案名稱："%

解譯檔案引數為字串

為引數使用此語法：

%（String）Arg_n%

例如，此執行字串列印具有包含檔案名稱的標題的檔案，方法是使用指令 lp -t 標題檔案名稱。

EXEC_STRING lp -t%（String）Arg_1%% （File）Arg_1" 列印的檔案："%

在動作中提供 Shell 能力

在執行字串中指定 shell：

/bin/sh -c '指令' 
/bin/ksh -c '指令' 
/bin/csh -c 'command'

範例

此執行字串舉例說明使用 shell 管道的動作。
```
	EXEC_STRING /bin/sh -c 'ps | lp'
```

此為需要 shell 處理並接受檔案引數的更複雜的執行字串。
```
	EXEC_STRING /bin/sh -c 'tbl %Arg _1"線上援助頁："% | troff -man'
```

此執行字串需要引數成為壓縮檔案。動作將解壓縮檔案並使用 lp -oraw 來列印它。
```
EXEC_STRING				/bin/sh -c 'cat%Arg _1 "列印的檔案："% | \ 
            uncompress | lp -oraw'
```

此執行字串啟動 shell 程序檔。

	EXEC_STRING /usr/local/bin/StartGnuClient

建立多重檔案引數的 COMMAND 動作

動作處理多重檔案引數的方法有三種：

動作可以重覆地執行，一次一個引數。當 EXEC_STRING 包含單個檔案引數與藉由在動作圖示上定位多重檔案所提供的多重檔案引數時，每個檔案引數的動作是分開執行的。

例如，如果供應多重檔案引數至以下動作定義：
```
	ACTION DisplayScreenImage
	{ 	
			EXEC_STRING					xwud -in %Arg_1%
 		...
 	}
```
DisplayScreenImage 動作是重覆地執行。

動作可以使用兩個或以上的不可交換的檔案引數。例如：
```
	xsetroot -cursor cursorfile maskfile  
```
需要兩個特別順序的唯一檔案。

動作可以按照順序地執行每個檔案引數上的相同指令。例如：
```
	pr file [file ...]  
```
將會在一份列印工作中列印一份或許多檔案。

建立不可交換的引數的動作

使用下列語法慣例之一：

如果您想要動作提示檔案名稱，使用此語法於每個檔案引數：
```
	%（File）"提示符號"%
```
每個引數使用不同的 提示符號 字串。

例如，此執行字串提示兩個檔案。
```
	EXEC_STRING   	xsetroot -cursor% 
（File）"游標點陣圖："% \ %（檔案）"遮罩點陣圖："%
```

如果要接受定位檔案，請使用此語法於每個檔案引數：
```
	 %Arg _n%
```
每個引數使用不同的 n 值。例如：
```
 	EXEC_STRING				diff%Arg _1%%Arg _2%
```

建立具有可交換檔案引數的動作

使用下列語法慣例之一：

如果要建立接受定位檔案並以格式 指令檔案 1 檔案 2 ...，發出指令的動作，請使用此語法於檔案引數：
```
	%Args%
```

如果要建立接受多重定位檔案的動作，或在連按兩下時會顯示單一檔案提示符號的動作，請使用此語法於檔案引數：
```
	%Arg_1"提示符號"% %Args% 
```
動作將會以此格式發出指令：指令檔案 1 檔案 2 ....

範例

此執行字串會建立執行如下的動作：
```
	pr 檔案 1 檔案 2
```
以多重檔案引數。
```
	EXEC_STRING pr%Args% 
```

此執行字串建立與之前的範例類似的動作，除了此動作會在連按兩下時顯示提示符號（無檔案引數）。
```
	EXEC_STRING  pr%Arg _1"列印的檔案："%%Args% 
```

建立多重定位檔案的動作

如果要接受多重定位檔案引數並執行指令行格式如下：

指令 檔案 1 檔案 2 ...

使用語法：

%Args%

範例

此執行字串會為多重檔案執行名為 Checkout 的程序檔：

EXEC_STRING 	/usr/local/bin/Checkout \ 
           %Arg_1" 結束什麼檔案？"%%Args%

這個執行字串將對多重檔案執行 lp -oraw：

EXEC_STRING 	lp -oraw%Arg _1"列印的檔案："%%Args%

COMMAND 動作的視窗支援與終端機模擬器

指令 動作在桌上管理系統上支援視窗的方法有數種。

如果應用程式有其自己的視窗，便可以寫入動作以不提供其它的視窗支援。當動作執行不需要直接的使用者輸入且無輸出的指令時，也使用此選項。

如果應用程式必須在終端機模擬器視窗中執行，便可以寫入動作以開啟視窗，然後執行應用程式。有數種終端機選項。

指定動作的視窗支援

使用 WINDOW_TYPE 欄位指定如表 12-2 中所示的動作需要的視窗支援類型。

表 12-2 WINDOW_TYPE 欄位及視窗支援提供的


`WINDOW_TYPE`	視窗支援提供的
`NO_STDIO`	無。如果應用程式有其自己的視窗，或是如果指令沒有可見的輸出，使用 `NO_STDIO`。
`PERM_TERMINAL`	永久終端機模擬器視窗。動作開啟終端機視窗，此視窗會保持開啟直到使用者確實地關閉它。使用者可以將資料輸入視窗中。使用獲得一些輸入、產生一些輸出、然後終止指令 (例如，`ls` `directory`)。
`TERMINAL`	暫存終端機模擬器視窗。動作會開啟指令一完成就關閉的終端機視窗。使用全螢幕的指令 (例如，`vi`)。

指定終端機模擬器的指令行選項

使用動作定義中的 TERM_OPTS 欄位來指定終端機模擬器的指令行選項。

例如，下列執行主機的動作提示符號：

ACTION OpenTermOnSystemUserChooses
 {
 	WINDOW_TYPE					PERM_TERMINAL
 	EXEC_HOST    				%(String)"Remote terminal on:"%
 	TERM_OPTS    				-title %(String)"Window title:"%
 	EXEC_STRING  				$SHELL
 }

指定不同的預設終端機模擬器

由動作所使用的預設終端機模擬器是 dtterm。您可以將此變更為其它的終端機模擬器。預設終端機模擬器是用於當動作未明確地指定使用的終端機模擬器時。

由動作所使用的終端機模擬器必須有這些指令行選項：

-標題 window_title
-e 指令

兩項資源決定預設終端機模擬器由動作所使用：

localTerminal 資源指定由本機應用程式所使用的終端機模擬器。
```
	*localTerminal:		 終端機
```
例如：
```
 	*localTerminal:				xterm
```

remoteTerminal 資源指定由遠端應用程式所使用的終端機模擬器。

	*remoteTerminal:		host:終端機 [,host:終端機...]

例如：

 	*remoteTerminal:		sysibm1:/usr/bin/xterm,syshp2:/usr/bin/yterm

限制動作以確定引數

限制動作為特殊類型的引數使動作更精確。例如，您應該限制 PostScript 檔案的查看器呼叫為只有 PostScript 檔案引數的動作；有了限制，如果指定非 PostScript 的檔案，動作將會回覆錯誤對話。

您可以限制動作，基於：

檔案引數的資料類型。

檔案引數的數目-例如，無引數對一個或多個引數。這樣會提供動作圖示的不同定位與連按兩下的行為。

引數的讀取/寫入模式。

為指定的資料類型限制動作

使用 ARG_TYPE欄位來指定其動作為有效的資料類型。使用資料屬性名稱。

您可以輸入資料類型的清單，以逗號分開登錄。

例如，以下動作定義假定 GIF 資料類型已建立。

ACTION Open_Gif
 {
 	TYPE					COMMAND
 	LABEL					"Display Gif"
 	WINDOW_TYPE			NO_STDIO
 	ARG_TYPE				Gif
 	ICON					xgif
 	DESCRIPTION			Displays gif files
 	EXEC_STRING			xgif
 }

以引數數目為基礎限制動作

使用 ARG_COUNT欄位以指定動作可以接受的引數數目。有效值為：

*（預設值）-任何數目的引數。其他值對於 * 有優先順序。

n-任何非負數的整數，包括 0。

>n-多於 n 個引數。

<n-少於 n 個引數。

ARG_COUNT 的用途之一就是提供不同的動作圖示行為，視使用者是否連按兩下圖示或在其上定位檔案而定。請參閱下節，"如果要提供不同的連按兩下與定位行為。"

提供不同的連按兩下與定位行為

使用此程序以建立接受定位檔案但當連按兩下動作圖示時不提示檔案的動作。

建立連按兩下功能的動作定義。

使用 ARG_COUNT欄位以指定 0 引數。使用語法於不接受定位引數的 EXEC_STRING。

建立定位功能的第二種動作定義。

使用 ARG_COUNT欄位以指定 >0 引數。使用語法於接受定位檔案的EXEC_STRING。

例如，假定下列兩個指令行可以用於啟動名為 vedit 的編輯程式：
- 如果要啟動沒有檔案引數的編輯程式：
```
	vedit
```
- 如果要啟動具有開啟為唯讀文件的檔案引數的編輯程式：
```
	vedit -R 檔案名稱
```
  下列兩個動作建立名為 Vedit 動作的定位與連按兩下功能。既然 ARG_COUNT 0 比定位功能定義的暗示 ARG_COUNT * 更特定，第一個動作在資料庫搜尋配對時有優先順序。
```
# Double-click functionality
 ACTION Vedit
 {
 	TYPE						COMMAND
 	ARG_COUNT				0
 	WINDOW_TYPE				PERM_TERMINAL
 	EXEC_STRING				vedit
 }

 # Drop functionality
 ACTION Vedit
 {
 	TYPE						COMMAND
 	WINDOW_TYPE				PERM_TERMINAL
 	EXEC_STRING				vedit -R %Arg_1%
 }
```

以引數模式為基礎限制動作

使用 ARG_MODE 欄位以指定引數的讀取/寫入模式。有效值為：

* (預設值)-任何模式

!w-不可寫入

w-可寫入

建立在遠端系統上執行應用程式的動作

討論到動作與遠端執行時，有兩個經常使用的名詞：

資料庫主機-包含動作定義的系統

執行主機-執行可執行檔案的系統

在大部分的情況中，動作與其應用程式是位於相同的系統上；既然動作的預設執行主機是資料庫主機，就不需要特殊的語法了。

然而，當執行主機與資料庫主機不同時，動作定義必須指定執行字串應執行之處。

在不同的系統上尋找動作與應用程式的能力是桌上管理系統的用戶端/伺服器架構的一部分。有關網路應用程式更深入的討論，請參閱 "管理應用程式服務"。

建立執行遠端系統應用程式的動作

使用動作定義中的 EXEC_HOST 欄位以指定應用程式的位置。

EXEC_HOST 的有效值為：

%DatabaseHost%-定義動作的主機。

%LocalHost%-呼叫動作的主機(the session server)。

%DisplayHost%-正在執行 X 伺服器的主機 (不允許 X 終端機)。

%SessionHost%-正在執行控制登入管理器的主機。

主機名稱-命名的主機。使用其中應永遠在一特定主機上呼叫動作的此環境值。

%"提示符號"%-每次呼叫動作時，提示使用者主機名稱。

預設值為 %DatabaseHost%、%LocalHost%。 EXEC_HOST欄位時，動作會先嘗試在包含動作定義的主機上執行指令。如果失敗，動作會嘗試在階段作業伺服器上執行指令。

範例

此欄位指定主機 ddsyd：
```
	EXEC_HOST  ddsyd
```

此欄位提示主機名稱：

	EXEC_HOST%  "包含應用程式的主機："%

此欄位指定動作將會嘗試執行包含動作定義的主機上的應用程式。如果失敗，動作會嘗試執行主機 ddsyd 上的應用程式。
```
 	EXEC_HOST%DatabaseHost%  , ddsyd
```

使用動作與資料類型定義中的變數

您可以將字串變數與環境變數納入動作與資料類型定義檔案中。

使用動作中的字串變數

字串變數定義從定義的位置到檔案的結尾都一直維持有效。沒有整體的資料庫字串變數。

如果字串變數與環境變數有相同的名稱，字串變數有優先順序。

如果要定義字串變數

使用語法：

	設定  variable_name=value

變數名稱可以包含任何文字字元與底線（_）。每個變數定義都必須在不同的行上。

例如：

設定 Remote_Application_Server=sysapp 
設定 Remote_File_Server=sysdata

如果要參考字串變數

使用語法：

	$[{] variable_name[}]

例如：

EXEC-HOST    $Remote_Application_Server 
CWD   	/net/${Remote_File_Server}/doc/project

使用動作與資料類型中的環境變數

使用語法參考環境變數：

	$[{]變數所指定的位置[}]。

當載入資料庫時，變數會擴展（由其值取代）。如果字串變數與環境變數有相同的名稱，字串變數有優先順序。

例如，此執行字串會列印具有包含登入名稱的標題檔案。

EXEC-STRING lp -t$LOGNAME% （檔案）Arg_1%

從指令行呼叫動作

桌上管理系統提供從指令行執行動作的 dtaction 指令。您可以使用 dtaction，執行來自下列的動作：

程序檔
其它動作
終端機模擬器指令行

語法 `dtaction`

dtaction [-user user_name] [-execHost 主機名稱] \
 action_name [argument [argument]...]

-user user_name-提供以不同使用者來執行動作的能力。如果 dtaction 是由 user_name 以外的使用者所呼叫，會有密碼的提示符號顯示出來。

-execHost 主機名稱-僅適用於 COMMAND 動作而已；指定將在其上執行指令的主機。

argument-動作的引數；通常是檔案引數。

dtaction 用戶端有其它的指令行選項。有關更多的資訊，請參閱 dtaction(1) 線上援助頁。

建立執行其它動作的動作

使用動作的 EXEC_STRING 中的 dtaction。

例如，以下動作使用名為 Spell（拼字）（在「應用程式管理者」中標為``檢查拼字''的動作）的內建動作。新動作會執行「文字編輯程式」與 Spell（拼字）動作，在不同的終端機模擬器視窗中顯示拼字錯誤。

ACTION EditAndSpell
 {
 	WINDOW_TYPE				NO_STDIO
 	EXEC_STRING				/bin/sh -c 'dtaction Spell \
 								%Arg_1"File:"%; dtpad %Arg_1%'
 }

建立以不同使用者執行的動作

使用以下 EXEC_STRING 中的語法：

EXEC_STRING   dtaction -user user_name  action_name [ file_argument]

新的使用者（user_name）必須經由下列機制之一，以到系統的顯示器存取權：

登入使用者的 .Xauthority 檔案上的讀取許可權

或，xhost 許可權

例如，下列兩個動作提供成為 root 與編輯 app-defaults 檔案的能力。

ACTION AppDefaults
 {
 	WINDOW_TYPE				NO_STDIO
 	EXEC_STRING				/usr/dt/bin/dtaction -user root \
 								EditAppDefaults %Arg_1"File:"%
 }
 ACTION EditAppDefaults
 {
 	WINDOW_TYPE				TERMINAL
 	EXEC_STRING				/bin/sh -c 'chmod +w %Arg_1%; \
 								vi %Arg_1%; chmod -w %Arg_1%'
 }

建立本土化動作

資料類型的搜尋路徑包括語言相依的位置。桌上管理系統使用 LANG 的值來決定搜尋資料類型的位置。

本土化動作的位置

本土化的動作定義必須放在沿著動作搜尋路徑的正確語言相依目錄中。

預設搜尋路徑為：

個人動作：HomeDirectory /.dt/types
整個系統的動作：/etc/dt/appconfig/types/language
內建動作：/usr/dt/appconfig/types/language

將現存動作本土化

在合適的語言相依目錄中建立檔案（例如，在 /etc/dt/appconfig/types/japanese 中）。

將動作定義複製到語言相依的配置檔案。

例如，您可能會複製動作定義自
```
 	app_root/dt/appconfig/types/C/file.dt
```
至
```
 	app_root /dt/appconfig/types/japanese/newfile.dt
```

增加 LABEL（標籤） 欄位或修改現存的 LABEL 欄位。
```
	LABEL			字串
```
「應用程式管理者」與「檔案管理者」使用標籤字串來識別動作的圖示。

在動作定義中本土化全部的下列欄位：
- 對於本土化圖示：ICON
- 對於本土化的關於項目輔助說明：DESCRIPTION
- 對於本土化的提示符號：任何 EXEC_STRING 中被參照的文字

建立 ToolTalk 應用程式的動作

註解 -

以下資訊只應用於支援 ToolTalk 訊息的應用程式。

使用動作類型 TT_MSG 以建立發出 ToolTalk 訊息的動作。

動作 action_name
$
{$
 	TYPE		TT_MSG  $
 	... $
	}

`定址` 與 `配置` 欄位

ToolTalk 定址 欄位永遠是設定為 TT_PROCEDURE。

ToolTalk 配置 欄位預設為靜態訊息型樣中的規格。

不支援的訊息

下列為 TT_MSG 類型動作所不支援的：

ToolTalk 物件導向的訊息
訊息中的內容引數

`TT_MSG` 動作的關鍵字

表 12-3 顯示 TT_MSG 動作的關鍵字與用法。

表 12-3 TT_MSG 動作關鍵字及用途


關鍵字	用途
`TT_CLASS`	定義 ToolTalk 類別訊息欄位的值
`TT_SCOPE`	定義 ToolTalk 範圍訊息欄位的值
`TT_OPERATION`	定義 ToolTalk 作業訊息欄位的值
`TT_FILE`	定義 ToolTalk 檔案訊息欄位的值
`TT_ARGn_MODE`	定義第 n 個訊息引數的 ToolTalk 模式屬性的值
`TT_ARGn_VTYPE`	定義第 n 個訊息引數的 ToolTalk vtype 屬性的值
`TT_ARGn_VALUE`	定義第 n 個訊息引數的值

第 12章 人工建立動作

您必須人工建立動作的理由

COMMAND 動作

MAP 動作

TT_MSG (ToolTalk 訊息) 動作

人工建立動作：一般步驟

動作的配置檔案

人工建立動作

建立 COMMAND 動作的範例

建立 MAP 動作的範例

重新載入動作/資料類型資料庫

建立動作的動作檔案 (圖示)

圖 12-1 應用程式管理者中的動作檔案（動作圖示）

如果要建立動作檔案（動作圖示）

動作標籤

指定由動作使用的圖示影像

圖 12-2 預設動作圖示影像

修改現存動作定義

動作定義中的優先順序

建立 COMMAND 動作的執行字串

執行字串的一般功能

動作引數

在執行字串中使用 Shell

可執行的名稱或絕對路徑

建立不使用引數的動作

範例

建立接受定位檔案的動作

範例

建立一個提示檔案引數的動作

建立接受定位檔案或提示符號的動作

建立一個提示非檔案引數的動作

解譯檔案引數為字串

在動作中提供 Shell 能力

範例

建立多重檔案引數的 COMMAND 動作

建立不可交換的引數的動作

建立具有可交換檔案引數的動作

範例

建立多重定位檔案的動作

範例

COMMAND 動作的視窗支援與終端機模擬器

指定動作的視窗支援

指定終端機模擬器的指令行選項

指定不同的預設終端機模擬器

限制動作以確定引數

為指定的資料類型限制動作

以引數數目為基礎限制動作

提供不同的連按兩下與定位行為

以引數模式為基礎限制動作

建立在遠端系統上執行應用程式的動作

建立執行遠端系統應用程式的動作

範例

使用動作與資料類型定義中的變數

使用動作中的字串變數

如果要定義字串變數

如果要參考字串變數

使用動作與資料類型中的環境變數

從指令行呼叫動作

語法 dtaction

建立執行其它動作的動作

建立以不同使用者執行的動作

建立本土化動作

本土化動作的位置

將現存動作本土化

建立 ToolTalk 應用程式的動作

定址 與 配置 欄位

不支援的訊息

TT_MSG 動作的關鍵字

第 12章人工建立動作

語法 `dtaction`

`定址` 與 `配置` 欄位

`TT_MSG` 動作的關鍵字