介面

應用程式介面是 Desktop Manager 所支援之配置系統的延伸。介面會視配置系統的不同，而決定各應用程式是否可以選擇使用中央配置資料。受支援的配置系統包括：

• GConf：Gnome 配置系統，桌面和多數 Gnome 應用程式均會使用，如 Evolution。

• StarSuite Registry：StarSuite 和 OpenOffice.org 所使用的配置系統。

• Mozilla Preferences：Mozilla 所使用的配置系統。

• Java Preferences：供 Java 應用程式使用的配置 API。

此外亦提供桌面定義介面，可以將桌面啟動程式、功能表項目和啟動程式增加到使用者的桌面上。

GConf 介面

GConf 介面屬於 Solaris 之 SUNWapoc-adapter-gconf 套裝軟體的一部分。當您從相應的 packageAdapter 安裝介面時，即會更新 /etc/gconf/2/path 中的 GConf 資料來源路徑，將 Desktop Manager 資源併入其中。介面提供的兩種資料來源包括：

• 「apoc:readonly:」：提供對策略中不受保護設定的存取權限。請在使用者設定與本機預設值之間插入此資料來源。

• 「apoc:readonly:mandatory@」：提供對策略中受保護設定的存取權限。請在本機強制設定與使用者設定之間插入此資料來源。

GConf 介面配置

GConf 介面會在安裝時進行配置，但是其運作則須取決於代表強制中央設定及預設設定之兩項資料來源的 GConf 路徑檔案 (/etc/gconf/2/path) 存在與否而定。安裝之後，當此路徑檔案中包含了正確的資訊，以便於 GConf 能夠如預期般地選用中央設定時，管理員必須確定檔案中仍保有前綴詞為「apoc」的資料來源，使之能夠在需要時修改該路徑，以納入其他自訂的資料來源。您亦須確定此資料來源位於代表強制中央設定之資料來源的本機強制設定與使用者設定之間，以及代表預設中央設定之資料來源的使用者設定與本機預設設定之間。

Java Preferences 介面

「Java Preferences」介面屬於 Solaris 之 SUNWapcj 套裝軟體的一部分。

Java Preferences 介面配置

「Preferences API」實作中會提供「Java Preferences」介面；「Preferences API」是其他現有實作 (如 JRE 所提供的預設檔案型系統) 所必須的包裝程式。若要能夠在使用「Preferences API」的 Java 應用程式中使用中央配置，必須撰寫該應用程式的啟動程序檔，並以 /usr/lib/apoc/apocjlaunch 程序檔為其輔助程式。此程序檔需要定義一些環境變數，並在其尾端併入 apocjlaunch 程序檔 (會以必要的環境啟動 Java 應用程式)。必須設定的環境變數包括：

• JAVA：包含 Java 執行階段可執行檔的路徑。

• APPLICATION：包含該應用程式的一般 Java 執行階段呼叫尾隨部分。例如單一類別啟動的 classname [arguments] 或 jar 歸檔啟動的 -jar jarname [arguments]。

其他可以設定的選擇性環境變數包括：

• CLASSPATH：以冒號分隔的 jar 或類別檔案清單，必須是應用程式類別路徑的一部分。

• DEFINES：包含定義敘述的字串，必須是應用程式啟動的一部分。

• PREFFACTORY：應用程式必須使用之基礎「Preferences API」實作中的工廠類別名稱。

Mozilla 介面

Mozilla 介面是 Solaris 之 SUNWmozapoc-adapter 套裝軟體的一部分。

Mozilla 介面配置

Mozilla 介面會在安裝此產品時一併安裝，並不需要進行其他任何配置。

StarSuite 介面

StarSuite 介面隨附於標準的 StarSuite 安裝中，可讓您存取設定檔配置資料，而不需要任何特殊的修改。

StarSuite 介面配置

StarSuite 介面會在安裝此產品時一併安裝，並不需要進行其他任何配置。

桌面定義介面

「桌面定義」介面由下列套裝軟體組成：

套裝軟體名稱	說明
SUNWapleg	配置存取二進位檔
SUNWardsa	桌面定義介面
SUNWardsa-misc	介面的系統整合

這些套裝軟體會在安裝 Desktop Manager 用戶端元件時一併安裝，並不需要其他任何的設定。

桌面定義介面配置

「桌面定義」介面透過使用者登入時所使用的設定程序進行配置，並不需要其他任何的設定。

移除介面

Mozilla 及 StarSuite 介面會在移除這些產品時一併移除。只要將安裝一節所述之套裝軟體移除，並使用適當的套裝軟體管理系統工具，便可將 GConf、Java Preferences 及桌面定義介面移除。

移除「Java Preferences」介面之後，便不應再繼續使用因為啟動 Java 應用程式而利用「Preferences API」所撰寫的啟動程序檔。由於部分必要的類別將無法再繼續使用，因此會導致需要使用這些類別的 Java 呼叫失敗。

介面疑難排解

可能會造成看不到相應應用程式之中央配置資料的問題中，有絕大部分是 Configuration Agent 所造成，這是因為所有介面皆會使用 Configuration Agent 擷取資料所致。

中央配置中如有某項設定 (或其群組) 未見生效，可能是使用者已在應用程式中明確設定了該設定的值 (一般會透過產品的 [選項] 或 [喜好設定] 對話方塊)。此時除非將中央設定定義為保護 (意即管理員強制使用該值，使用者無法加以修改)，否則使用者的喜好設定將優於 Desktop Manager 所設定的值。