デスクトップエディターをパラメーター付きで実行する
はじめに
特定のタスクを実行するためにデスクトップエディターを起動したい場合があります。例えば、アプリを実行しているときに新しいファイルを作成する、既存のファイルを閲覧専用で開く、またはデバッグモードでアプリケーションを実行するなどです。これらはコマンドラインフラグを使用して実行できます。
利用可能なフラグの一覧
ここでは、デスクトップエディターを実行する際に使用できるフラグとその簡単な説明を見つけることができます。
デバッグモードでデスクトップエディターを実行する
このオプションはすべてのオペレーティングシステムで使用できます。
--ascdesktop-support-debug-info - デバッグモードでデスクトップエディターを実行し、コンソールを開くことができるようにします。デバッグモードで作業を開始するには、上部ツールバーの任意の編集可能なフィールド(例:フォントリストコンボ)を右クリックして、要素を検査をクリックします。F1キーを押してDevToolsウィンドウを開くこともできます。
バージョン7.1からは、必要な値を指定して--ascdesktop-support-debug-info-keepフラグを使用することもできます:
--ascdesktop-support-debug-info-keep=1 - デバッグモードを永続的に有効にし、アクティブ化のための別のパラメーターを必要としません(パラメーターはアプリケーション設定ファイルに保存されます)。
--ascdesktop-support-debug-info-keep=0 - デバッグモードを永続的に無効にし、アクティブ化のための別のパラメーターを必要とします(パラメーターはアプリケーション設定ファイルに保存されます)。
--ascdesktop-support-debug-info-keep=default - デフォルト設定をリセットします(アプリケーション設定ファイルからパラメーターを削除します)。

デスクトップエディターウィンドウのカスタマイズ
これらのオプションはLinux OSで使用できます。
--system-title-bar - デスクトップエディターをシステムウィンドウで実行します。
起動コマンドはアプリケーションのインストール形式によって異なります。詳細については、以下の異なるオペレーティングシステムでのフラグの使用セクションを参照してください。
--custom-title-bar - デスクトップエディターを標準ウィンドウ(システムウィンドウではない)で実行します。このフラグは--system-title-barフラグの効果をキャンセルするために使用されます。
これらのフラグのいずれかでアプリケーションを実行すると、選択したタイトルバーモードがアプリケーション設定に保存され、フラグを指定しなくても以降のすべての起動に適用されます。元に戻すには、反対のフラグでアプリケーションを一度実行するか、DesktopEditors.confファイルからtitlebarパラメーターを削除します。設定ファイルは~/.config/onlyoffice/フォルダー(Flatpak版の場合は~/.var/app/org.onlyoffice.desktopeditors/config/onlyoffice/)にあります。
特定のモードでファイルを開きながらデスクトップエディターを実行する
これらのオプションはWindowsおよびLinux OSで使用できます。
--review=path/to/file - 既存のDOCXファイルを変更履歴モードで開き、このモードを無効にすることはできません。XLSXおよびPPTXファイルは、スプレッドシートおよびプレゼンテーションで変更履歴モードが現在サポートされていないため、閲覧モードで開かれます。
--view=path/to/file - 既存のDOCX、XLSX、またはPPTXファイルを閲覧モードで開き、編集モードに切り替えることはできません。
path/to/fileを既存のファイルへの実際のフルパスに置き換えてください。ファイルパスは二重引用符で囲む必要があります。例:
--review="C:\Users\username\Documents\Document1.docx" - Windowsの場合
--review="/home/username/Documents/Document1.docx" - Linuxの場合
--force-use-tab - --review=path/to/fileまたは--view=path/to/fileフラグと一緒に使用して、既存のDOCXファイルをメインウィンドウの新しいタブで開きます。そうでない場合、ドキュメントは別のウィンドウで開かれます。
2つのフラグを一緒に使用する例:
--review="C:\Users\username\Documents\Document1.docx" --force-use-tabまたは--view="C:\Users\username\Documents\Document1.docx" --force-use-tab - Windowsの場合
--review="/home/username/Documents/Document1.docx" --force-use-tabまたは--view="/home/username/Documents/Document1.docx" --force-use-tab - Linuxの場合
デスクトップエディターをONLYOFFICEクラウドに接続する
このオプションはすべてのオペレーティングシステムで使用できます。
--ignore-certificate-errors - 証明書の有効性チェックを無効にし、自己署名SSL証明書をONLYOFFICEポータルで使用している場合にデスクトップエディターをONLYOFFICEクラウドに接続できるようにします。
デスクトップエディターを開く際に新しいファイルを作成する
これらのオプションはすべてのオペレーティングシステムで使用できます。
--new:word - デスクトップエディターを実行し、新しいローカルDOCXファイルを作成します。
--new:cell - デスクトップエディターを実行し、新しいローカルXLSXファイルを作成します。
--new:slide - デスクトップエディターを実行し、新しいローカルPPTXファイルを作成します。
--new:form - デスクトップエディターを実行し、新しいローカルPDFフォームファイルを作成します。
異なるオペレーティングシステムでのフラグの使用
このプロセスは、オペレーティングシステム(Windows、Linux、またはmacOS)によって異なります。お使いのOSに応じたタブを選択して、詳細な手順をお読みください:
- Windows
- Linux
- macOS
Windowsでは、ショートカットまたはターミナルを通じてアプリケーションを起動する2つの方法があります。
オプション1. ショートカットを通じてアプリを実行する:
-
デスクトップ画面上のアプリケーションショートカットを右クリックします。
-
プロパティを選択します。
-
ショートカットタブを開きます。
-
アプリケーションへのパスの後にスペースを入力し、必要なフラグを入力します。
-
適用ボタンをクリックします。
-
これらの設定を変更するには管理者権限が必要です。続行をクリックします。
-
ショートカットをクリックしてアプリケーションを起動します。
オプション2. 実行ウィンドウを通じてアプリを実行する:
-
Win+Rを押します。
-
表示された実行ウィンドウにアプリケーションへのパスを入力し、スペースを追加して必要なフラグを入力します。例:
"%ProgramFiles%\ONLYOFFICE\DesktopEditors\DesktopEditors" --ascdesktop-support-debug-info -
OKボタンをクリックします。
Linuxでは、ターミナルを使用してフラグを使用してデスクトップエディターを実行します:
- Ctrl+Alt+Tを押します。ターミナルが開きます。
- コマンドラインで、お使いのインストール形式に対応する起動コマンドを入力し、スペースを追加して必要なフラグを入力します。
- Enterキーを押します。
起動コマンドは、アプリケーションのインストール形式(DEB/RPMパッケージ、Snap、Flatpak、AppImage)によって異なります:
-
アプリケーションがDEBまたはRPMパッケージとしてインストールされている場合は、
onlyoffice-desktopeditorsと入力します。例:onlyoffice-desktopeditors --ascdesktop-support-debug-info -
アプリケーションがSnapパッケージとしてインストールされている場合。例:
snap run onlyoffice-desktopeditors --ascdesktop-support-debug-info -
アプリケーションがFlatpak経由でインストールされている場合。例:
flatpak run org.onlyoffice.desktopeditors --ascdesktop-support-debug-info -
AppImage版を使用している場合は、ダウンロードしたAppImageファイルが保存されているフォルダー(例:
cd ~/Downloads)に移動して、このファイルを実行します。例:./DesktopEditors-x86_64.AppImage --ascdesktop-support-debug-infoAppImageファイルがまだ実行可能でない場合は、まず
chmod +x DesktopEditors-x86_64.AppImageコマンドを実行して実行可能にします。
SnapおよびFlatpakアプリケーションはサンドボックス環境で実行されます。ファイルを開くフラグ(例:--reviewや--view)を使用する場合は、指定したファイルがアプリケーションのアクセスを許可されている場所(例:ホームディレクトリ)に保存されていることを確認してください。
macOSでは、ターミナルを使用してフラグを使用してデスクトップエディターを実行します:
-
Command+Spaceを押します。
-
表示されたSpotlightウィンドウで、検索ラインにTerminalと入力します。
-
Terminalオプションを選択します。ターミナルが開きます。
-
コマンドラインでアプリケーションへのパスを入力し、スペースを追加して必要なフラグを入力します。例:
"/Applications/ONLYOFFICE.app/Contents/MacOS/ONLYOFFICE" --ascdesktop-support-debug-info -
Enterキーを押します。