Analytics のメイン メニューへのカスタム項目の追加

独自の Analytics スクリプトや頻繁に使用されるコマンドなどのカスタム項目を、Analytics のメイン メニューに追加できます。カスタム項目は、［アプリケーション］メニューの下に表示されます。この機能は、他のユーザーが使用するスクリプトを作成し、スクリプトのアクセスするための単一の使いやすい場所が必要な場合に、特に有用です。

プロジェクト レベルまたはグローバル アクセス

個別の Analytics プロジェクトに制限されるカスタム メニュー項目を作成するか、Analytics が開くたびにグローバルで項目を使用可能にすることができます。

  • プロジェクト レベル アクセスAnalytics プロジェクト (*.acl) と同じフォルダーのカスタム メニュー項目を含むテキスト ファイル（*.mnu）を見つけます
  • グローバル アクセスAnalytics の実行ファイル (ACLWin.exe) と同じフォルダーのカスタム メニュー項目を含むテキスト ファイル（*.mnu）を見つけます

また、アプローチを結合し、プロジェクト レベルとグローバル カスタム メニュー項目の両方を作成することもできます。

メモ

他の Analytics ユーザーがカスタム メニュー項目を使用する場合は、*.mnu ファイルに、ファイルを検索する場所に関する説明を付加します。

構成可能なメニュー ファイル (*.mnu)

.mnu ファイル拡張子の 1 つ以上のテキスト ファイルを使用し、カスタム メニュー項目を作成します。

サブメニュー エントリ

各 *.mnu ファイルは、［アプリケーション］メニューの下に、個別のサブメニュー エントリを作成します。たとえば、Account scripts.mnu は、アカウント スクリプト サブメニュー エントリと次のメニュー構造を作成します。アプリケーション > アカウント スクリプト。

サブメニュー エントリは、 アプリケーションメニューにアルファベット順で表示されます。

カスタム メニュー項目

個別のカスタム メニュー項目は、各サブメニュー エントリ内に含まれます。たとえば、次のスクリプトを実行する 2 つの項目を作成できます。

  • 買掛金分析

    (アプリケーション > アカウント スクリプト > 買掛金分析)

  • 売掛金分析

    (アプリケーション > アカウント スクリプト > 売掛金分析)

カスタムメニュー項目は、項目が *.mnu ファイルにリストされている順序でサブメニューに表示されます。

要件に合わせて、複数の *.mnu ファイルを使用し、複数レベルのカスケード サブメニューを作成できます。

ヒント

サブメニュー レベルが多すぎると、ユーザーが混乱する可能性があります。サブメニュー項目を 3 つに制限することをお勧めします。

カスタム メニュー項目の最大数

アプリケーションメニューには、最大 179 個のカスタム メニュー項目を含めることができます。最大数は、すべてのサブメニュー レベルとすべての *.mnu ファイルにわたるカスタ ムメニュー項目の合計数に適用されます。

メニュー ファイル構文

メモ

メニュー ファイルの必要な構文は、正確に指定する必要があります。余分なスペースが 1 つあるだけでも、Analytics はメニュー ファイルを無視し、カスタム メニュー項目が表示されないことがあります。

以下の要件に正確に従ってください。

ヒント

メニュー ファイルを、すべての出力不能な文字が表示される Notepad++ などのテキスト エディターで作成または編集し、ファイルに含まれる文字が正確に表示されるようにします。

モノスペースまたは固定幅フォントを使用すると、個別の文字が垂直に配置されます。

同じメニュー ファイルの Template.mnu は、Analytics と一緒にインストールされる、Sample Data Files フォルダーに含まれます。

  • Template.mnuは、Sample Project.acl および Sample Data Files フォルダーに含まれる他のサンプル Analytics プロジェクトで、［アプリケーション］メニューのサブメニュー エントリ［テンプレート］を作成します。
  • ［テンプレート］サブメニュー エントリには、最初のレベルに 6 つのカスタム メニュー項目が含まれます。
  • 最初のレベルのカスタム メニュー項目の 1 つである Margins Analysis には、2 番目のレベルに 4 つのカスタム メニュー項目があります。
  • Template.mnu のカスタム メニュー項目のほとんどは、メニュー ファイルの概念を示すプレースホルダーにすぎません。

Template.mnu の内容は、付随する構文要件とともに、以下に示します。

Template.mnu の内容

MAIN MENU                           6                                        .
Margins Analysis                    8 menu_def                               .
Inventory Analysis                  PAUSE 'SAMPLE INVENTORY ANALYSIS BATCH'  .
Accounts Payable Analysis           PAUSE 'LAUNCH YOUR A/P BATCH(ES)'        .
Accounts Receivable Analysis        PAUSE 'DO A/R BATCH(ES) HERE'            .
Internal Audit Functions            PAUSE 'SAMPLE INTERNAL AUDIT PROCESSES'  .
ACL の終了                            QUIT                                     .
                                                                             .
MARGINS ANALYSIS                    4                                        .
Exception Listing                   PAUSE 'DO Batch where margin<=0'         .
High Margin Products                PAUSE 'Sample Batch top 5 margins'       .
Low Margin Products                 PAUSE 'Calculate lowest 5 margins'       .
Margin Statistics                   STATISTICS                               .

メニュー ファイル構文要件

プロパティ 要件
行の長さ

メニュー ファイルの各行の長さはすべて同じでなければなりません。

必須ではありませんが、ピリオド（.）を使用して、改行の直前で、各行の最後を視覚的に示すことをお勧めします。
行番号

メニュー ファイル内の行数はゼロから数えます。

メニュー ファイル構文で行番号参照を指定するときにはいつでも、この番号体系を考慮してください。使用しているテキスト エディターが 1 から行番号を表示してカウントする場合は、メニュー ファイルの行番号参照を指定するときに、テキスト エディターの行番号を 1 減らす必要があります。

上記の例では、［Margins Analysis］メニュー項目は行 1 に表示され、［MARGINS ANALYSIS］サブメニュー構文ブロックは行 8 ～ 12 に表示されます。
空白行

空白行は、構文ブロック間に表示できますが、構文ブロック内には表示できません。

スペース文字から成る空白行は、メニュー ファイルの他の行と同じ長さである必要があります。

必須ではありませんが、構文ブロック間の 1 つ以上の空白行は、メニュー ファイルを視覚的に分離します。
構文ブロック

構文ブロックは、カスタム メニュー項目の各グループを定義します。複数の構文ブロックを使用して、複数のメニュー レベルを作成できます。

  • ブロックの左側には、メニュー項目の名前が各行に 1 つずつ含まれます。これらは Analytics で表示される名前です。
  • 名前の長さは最大 35 文字です。
  • ブロックの右側には、ACLScript コマンド、または構文の下位ブロックへの行参照が含まれます。
  • ブロックの右側の行は、すべての文字位置 37 から開始する必要があります。
  • テキスト要素の配置には、スペース文字のみを使用してください。タブ文字は使用しないでください。

    メモ

    メニュー ファイルにタブ文字が 1 つでもあると、ファイルが無視されます。タブ文字を表示できるテキスト エディターを使用し、タブ文字の有無を確認してください。
ブロック見出し

各構文ブロックは単一の見出し行で開始します。

行の左側にはブロック識別子を大文字で記述し、右側にはブロック内の行数を格納します。

上の例では、0 行にはブロック識別子 MAIN MENU が含まれており、そのブロック内に 6 行あることが示されています。見出し行はカウントされません。

ブロック識別子は任意です。メニュー ファイル内で構文ブロックが整理されます。Analytics アプリケーション メニュー構造には表示されません。

ブロック識別子を省略する場合、ブロックの指定された行数は、文字位置 37 から開始する必要があります。
構文の下位ブロックへの参照

構文の下位ブロックへのメニュー項目からの参照は、num menu_def の形式です。num 構文の下位ブロックが開始する行番号を指定します。つまり、下位レベルの構文ブロックの見出し行です。

上記の例では、行 1 には［Margins Analysis］メニュー項目が含まれます。これは、MARGINS ANALYSIS 下位構文ブロックが開始する行を参照します ( 8 menu_def )。
カスタム メニュー項目

カスタム メニュー項目を指定できます。

  • 有効な ACLScript コマンド
  • 構文の下位ブロックへの行参照

Analytics スクリプトを実行するカスタム メニュー項目を作成するには、DO SCRIPT スクリプト名を指定します。例：

中央値の計算スクリプト       DO SCRIPT Calculate_Median_Value

メモ

スクリプトは、カスタム メニュー項目が表示される Analytics プロジェクトに含まれる必要があります。

短いコマンドは、直接 .mnu ファイルに入力できます。複数のパラメーターを使用する長いコマンドはスクリプトに保存してください。これは、DO SCRIPT コマンドを使用して参照できます。

メニュー ファイルの作成または編集

メニュー ファイルを作成する最も簡単な方法は、Analytics サンプル メニュー ファイル（Template.mnu）をコピーして修正することです。

既に使用中のメニュー ファイルを編集するときは、以下の点に留意する必要があります。

  • メニュー ファイルを編集する前に、バックアップ用のコピーを作成してください。
  • 行を追加または削除する場合は、必ず適切に行番号参照を調整してください。
  • 可能であれば、項目はメニュー ファイルの最後に追加してください。これにより既存の行参照を保持できます。
  1. Template.mnu を、Analytics サンプル データ ファイル フォルダーから作業場所にコピーします。

    注意

    元のテンプレート ファイルは編集しないでください。問題が発生した場合に、元のファイルを再コピーして、再開できます。

  2. コピーしたファイルを適切な名前に変更します。

    ファイルに指定した名前は、Analytics の［アプリケーション］メニューのサブメニュー エントリの名前になります。

    メモ

    メニュー ファイルを最初から作成している場合は、ファイル拡張子を .mnu に変更します。

  3. 名前を変更したファイルを Notepad++ などのテキスト エディターで開き、編集して、サブメニューとカスタム メニュー項目を作成します。

    上記の メニュー ファイル構文要件 に正確に従います。

  4. 次のいずれかを実行します。
    • カスタム メニュー項目を表示する Analytics プロジェクトを含むフォルダーにファイルを保存します。
    • Analytics 実行フォルダーにファイルを保存し、コンピューターで開いているすべての Analytics プロジェクトでカスタム メニュー項目を使用できるようにします。

    ヒント

    必要に応じて、プロジェクト レベルおよびグローバル メニュー ファイルの両方を作成できます。

  5. Analytics を閉じてからもう一度開き、［アプリケーション］メニューを更新します。

    サブメニュー エントリとカスタム メニュー項目は、［アプリケーション］メニューで使用できます。

    サブメニューとカスタム メニュー項目が表示されない場合は、上記の構文要件に照らして、メニュー項目の内容を注意して確認してください。使用しているテキスト エディターで、すべての出力不能な文字を表示します。行末の追加のスペースまたはメニュー ファイルのタブ文字は、ファイルが無視されます。