4D WritePro インターフェース

4D WritePro インターフェースは、エンドユーザーが 4D Write Proドキュメントを簡単にカスタマイズできるパレットを提供します。

4D のデベロッパーは、これらのパレットをアプリケーションに簡単に実装することができます。 それにより、エンドユーザーは、フォントやテキストの揃え方向、ブックマーク、表レイアウト、フレームなど、4D Write Pro のプロパティをすべて管理することができます。

インターフェースのマニュアルについては、4D デザインリファレンス の 4D Write Pro エリアのドキュメント を参照ください。

You will find below:

• the Table Wizard configuration documentation.
• the integrated A.I. documentation (developer preview)

表ウィザード

表ウィザードは、コンテキスト、データソース、およびフォーミュラを使用した、データベースのデータに基づく表組みの作成をさらに簡素化します。

エンドユーザーがアクセスできる表ウィザードは、4D デベロッパーが設定し提供するテンプレートをロードします。 これにより、デベロッパーはユーザーの特定のユースケースやビジネス要件に応じてテンプレートをカスタマイズすることができます。

表ウィザードには、デフォルトのテンプレートおよびテーマが用意されており、デベロッパーはそれらを、アプリケーションで必要とされる内容に適合させることができます。

アプリケーションに表ウィザードを実装するために、デベロッパーはテンプレートファイルを作成し、設定することができます。

WP表ウィザードのインターフェース

ユーザーは、4D Write Pro インタフェースツールバーとサイドバーの "表を挿入" メニューボタンから表ウィザードダイアログを開きます。

このインターフェースで、ユーザーは最初のドロップダウンリストからテンプレートまたはテーブルを選択し、2番目のドロップダウンリストからテーマを選択します。

列について:

テンプレートまたはテーブルの選択に応じて、テンプレートに保存されているフィールドのリストが表示されます (BLOB およびオブジェクト型は自動的に除外されます)。 表の列として表示させたいフィールドは、フィールド名の左にあるチェックボックスで選択します。また、表示する列の順序はフィールドをドラッグしてリスト内を移動させることで変更することができます。

行について:

表ウィザードでは、ヘッダー行と追加の行の数 (それぞれ 0～5) を定義したり、ブレーク行 (小計行) を繰り返し行の上または下に設定したり、キャリーオーバー行 の表示/非表示を選択したりすることもできます。

さらに、次のオプションを使用して、データソースが空の場合の表組みの動作を選択できます: データ行を表示、データ行を非表示、表を非表示、プレースホルダー行を表示。

表示について:

ユーザーは、ドロップダウンリストから希望するオプションを選択することで、好みのズームレベルを調整し、ラジオボタンを使ってフォーミュラまたはデータを表示し、チェックボックスを使って水平ルーラーを表示するかどうかを選択します。

表の作成とカスタマイズが完了したら、挿入 ボタンをクリックして、WPドキュメントに表組みを追加することができます。

ドキュメントに表が統合されると、ユーザーはそのスタイルをカスタマイズできます。 ツールバーやサイドバーの書式設定ツールはすべて利用可能です。

WP表ウィザードのテンプレートの設定

テンプレートの設定には以下が含まれます:

• テンプレートファイル: テーブルとフィールドを定義し、アプリケーションに適合したフォーミュラを用意します。
• トランスレーションファイル: テーブル、フィールド、フォーミュラの翻訳名を指定します。
• テーマファイル: グラフィックスタイルとテーマをデザインしカスタマイズします。

表ウィザードを設定するにあたって、これら 3種類のファイルにはそれぞれ明確な役割がありますが、いずれも必須ではありません。

テンプレートファイル

テンプレートファイルを使って、以下のことが定義できます:

• 表のデータソースとして使用されるエンティティセレクションを返すフォーミュラ
• ブレーク行のフォーミュラ (ブレーク行を挿入できる場合)
• 表の列として使用できるデータクラス属性
• ブレーク行、キャリーオーバー行、プレースホルダー行、追加の行において、コンテキストメニューから選択可能なフォーミュラ

テンプレートファイルはプロジェクトの "Resources/4DWP_Wizard/Templates" フォルダーに保存する必要があります。

JSON形式のテンプレートファイルには、以下の属性が含まれます:

属性	型	必須	説明
tableDataSource	Text	○	表のデータソースのフォーミュラ
columns	Collection	○	表の列のコレクション
columns.check	Text	○	表ウィザードであらかじめチェックされている場合は true。 列のチェックをあらかじめ外しておく場合は false。
columns.header	Text	○	ユーザーに提示する表示名
columns.source	Text	○	Formula
breaks	Collection		ブレークオブジェクトのコレクション。 ブレークの順番は重要です。 この順番は、ドキュメント内でブレーク行が繰り返し行の上にある場合の順番に対応します。
breaks.label	Text	○	ユーザーに提示する表示名
breaks.source	Text	○	Formula
breakFormulas	Collection		ブレーク行に適用可能なフォーミュラオブジェクトのコレクション
breakFormulas.label	Text	○	ユーザーに提示する表示名
breakFormulas.source	Text	○	Formula
bcorFormulas	Collection		下部キャリーオーバー行に適用可能なフォーミュラオブジェクトのコレクション
bcorFormulas.label	Text	○	ユーザーに提示する表示名
bcorFormulas.source	Text	○	Formula
extraFormulas	Collection		追加の行に適用可能なフォーミュラオブジェクトのコレクション
extraFormulas.label	Text	○	ユーザーに提示する表示名
extraFormulas.source	Text	○	Formula
placeholderFormulas	Collection		プレースホルダー行に挿入されるフォーミュラオブジェクトのコレクション

フランス語のランゲージについて

もし、4Dランゲージがフランス語に設定された環境で実行される可能性があるのであれば、ランゲージ設定に関わらず正しく解釈されるよう、フォーミュラに トークン を使用するようにしてください。

例題

JSONファイルの簡単な一例を以下に示します:

{
    "tableDataSource": "ds.People.all().orderBy(\"toCompany.name asc, continent asc, country asc, city asc\")",
    "columns": [{
            "check": true,
            "header": "Firstname",
            "source": "This.item.firstname"
        }, {
            "check": true,
            "header": "Lastname",
            "source": "This.item.lastname"
        }, {
            "check": true,
            "header": "Salary",
            "source": "String(This.item.salary;\"###,###.00\")"
        }
    ],
    "breaks": [{
            "label": "Company",
            "source": "This.item.toCompany.name"
        }
    ],
    "breakFormulas": [{
            "label": "Company",
            "source": "This.item.toCompany.name"
    }, {
            "label": "Sum of salaries",
            "source": "String(This.breakItems.sum(\"salary\"); \"###,###.00\")"
        }
    ],
    "bcorFormulas": [{
            "label": "Sum of salaries",
            "source": "String(This.tableData.sum(\"salary\"); \"###,###.00\")"
        }
    ],
    "extraFormulas": [{
            "label": "Sum of salaries",
            "source": "String(This.tableData.sum(\"salary\"); \"###,###.00\")"
        }
    ]
}

トランスレーションファイル

トランスレーションファイルは、テンプレート、テーマ、テーブル、フィールド、およびフォーミュラの翻訳名を指定します。 これらのファイルはプロジェクトの "Resources/4DWP_Wizard/Translations" フォルダーに追加します。

各トランスレーションファイルには、対応する言語コード (英語なら "en"、日本語なら "ja" など) のファイル名を付けます。

JSON形式のトランスレーションファイルには、以下の属性が含まれます:

属性	型	必須	説明
テーブル	Collection		翻訳されたテーブルオブジェクトのコレクション
fields	Collection		翻訳されたフィールドオブジェクトのコレクション
formulas	Collection		翻訳されたフォーミュラオブジェクトのコレクション
fileNames	Collection		翻訳された fileNameオブジェクトのコレクション (テーマとテンプレート名に適用)

これら属性に含まれるコレクションの各オブジェクト要素は以下の属性を含みます:

属性	型	必須	説明
original	Text	○	翻訳の対象となる原文
translation	Text	○	原文を翻訳したもの

これらの属性を定義することで、原文と翻訳されたコンテンツ間の適切な対応が確保されます。

テンプレート名やフォーミュラ名 (ブレーク行、キャリーオーバー行、追加の行) がトランスレーションファイルに存在する場合、表ウィザードではその翻訳が表示されます。 また、トランスレーションファイル内で定義されたテーブルだけが表ウィザードに (翻訳されて) 表示されます。

ユーザーがインターフェースでテーブルを選択したときには、トランスレーションファイルは追加の役割を果たします。 具体的には、ユーザーに提案されるテーブルやフィールドをフィルターします。 たとえば、テーブルID を非表示にするなど、この動作は SET TABLE TITLES や SET FIELD TITLES コマンドに似ています。

例題

{
    "tables": [{
            "original": "People",
            "translation": "従業員"
        }
    ],
    "fields": [{
            "original": "lastname",
            "translation": "名字"
        }, {
            "original": "firstname",
            "translation": "名前"
        }, {
            "original": "salary",
            "translation": "給与"
        }, {
            "original": "company",
            "translation": "会社"
        }
    ],
    "formulas": [{
            "original": "Sum of salary",
            "translation": "給与の合計"
        }
    ]
}

テーマファイル

4D WritePro Interface コンポーネントには、"Arial"、"CourierNew"、"YuGothic" などのテーマがデフォルトで用意されており、"Blue" や "Green" など複数のバリエーションが用意されています。 しかし、プロジェクト内の "Resources/4DWP_Wizard/Themes" フォルダーにテーマファイルを配置することで、独自のテーマを作成することができます。

JSON形式のテーマファイルには、以下の属性が含まれます:

属性	型	必須	説明
default	Object		すべての行に適用されるデフォルトスタイルを格納したオブジェクト。
table	Object		表組みに適用されるスタイル定義を格納したオブジェクト。
rows	Object		すべての行に適用されるスタイル定義を格納したオブジェクト。
cells	Object		すべてのセルに適用されるスタイル定義を格納したオブジェクト。
header1	Object		先頭のヘッダー行に適用されるスタイル定義を格納したオブジェクト。
header2	Object		2つ目のヘッダー行に適用されるスタイル定義を格納したオブジェクト。
header3	Object		3つ目のヘッダー行に適用されるスタイル定義を格納したオブジェクト。
header4	Object		4つ目のヘッダー行に適用されるスタイル定義を格納したオブジェクト。
header5	Object		5つ目のヘッダー行に適用されるスタイル定義を格納したオブジェクト。
headers	Object		header1、header2など専用のスタイル定義がない場合に、ヘッダー行に 適用されるスタイル定義を格納したオブジェクト。
data	Object		繰り返し行に適用されるスタイル定義を格納したオブジェクト。
break1	Object		1つ目のブレーク行に適用されるスタイル定義を格納したオブジェクト。
break2	Object		2つ目のブレーク行に適用されるスタイル定義を格納したオブジェクト。
break3	Object		3つ目のブレーク行に適用されるスタイル定義を格納したオブジェクト。
break4	Object		4つ目のブレーク行に適用されるスタイル定義を格納したオブジェクト。
break5	Object		5つ目のブレーク行に適用されるスタイル定義を格納したオブジェクト。
breaks	Object		break1、break2など専用のスタイル定義がない場合に、ブレーク行に 適用されるスタイル定義を格納したオブジェクト。
bcor	Object		下部キャリーオーバー行に適用されるスタイル定義を格納したオブジェクト。
placeholder	Object		プレースホルダー行に適用されるデフォルトスタイルを格納したオブジェクト。

JSONファイルで設定する各属性に対して、以下の WP属性を定義することができます (対応する WP定数 を指定します):

WP 属性	対応する WP定数
textAlign	wk text align
backgroundColor	wk background color
borderColor	wk border color
borderStyle	wk border style
borderWidth	wk border width
font	wk font
color	wk font color
fontFamily	wk font family
fontSize	wk font size
padding	wk padding

例題

{
    "default": {
           "backgroundColor": "#F0F0F0",
           "borderColor": "#101010",
           "borderStyle": 1,
           "borderWidth": "0.5pt",
           "font": "Times New Roman",
           "color": "#101010",
           "fontFamily": "Times New Roman",
           "fontSize": "7pt",
           "padding": "2pt"
    },
    "table": {
           "backgroundColor": "#E1EAF3"
    },
    "header1": {
           "textAlign": 2,
           "borderColor": "#41548F",
           "borderWidth": "1.5pt",
           "backgroundColor": "#979BA9",
           "color": "#F4F4FF",
           "font": "Times New Roman Bold"
    },
    "data": {
           "fontSize": "13pt",
           "textAlign": 0
    },
    "break1": {
           "textAlign": 2,
           "fontSize": "15pt"
    }
}

参照

4D Write Pro - 表ウィザード (チュートリアル動画)

Integrated AI

You can use an integrated AI in the 4D Write Pro interface so that you can easily translate or enhance your documents without having to use an external AI application.

Once you have enabled the AI feature, you can display a chat box over your 4D Write Pro document and interact with chatGPT to modify the text of the selection or of the document itself.

注

The 4D Write Pro interface uses OpenAI, for which you need to provide your own key (see below).

Limitations (Developer Preview)

In the current implementation, the feature has the following limitations:

• use of a predefined AI provider and necessity to pass your OpenAI key
• basic chatting features
• no image handling
• non-configurable predefined action commands
• predefined translations English/French and French/English only

Enabling the AI feature

The AI dialog box is available by clicking on a button in the 4D Write Pro interface. This button is hidden by default, you need to enable it explicitely.

To display the AI dialog box button, you need to:

1. Get an API key from the OpenAI website.
2. Execute the following 4D code:

WP SetAIKey ("<Your OpenAI Key>") //

注

No checking is done on the OpenAI key validity. If it is invalid, the chatGPT box will stay empty.

The A.I. button is then displayed:

• in the 4D Write Pro Toolbar, in the Import Export tab,
• in the 4D Write Pro Widget, in the Font Style tab.

Click on the button to display the AI dialog box.

AI dialog box

The 4D Write Pro AI dialog box allows a straightforward interaction between the chat area and the 4D Write Pro document.

Prompt area

At the bottom of the window, the prompt area allows you to enter any question to send to the AI.

To send your question to the AI, click on the Send button:

The button icon changes when the same request is sent again:

On the left side of this area, a pop up menu provides examples of common actions that can be usually delegated to the AI.

Selecting an action writes a corresponding question to the prompt. If necessary, you can modify the question and then to click on the Send button to actually send it:

注

Default translation actions are based upon the current 4D default configuration and depend on available languages.

Copy buttons

These buttons propose basic interactions between the chat area, the underlying 4D Write Pro document, and the clipboard:

• Return raw text/Return styled text: Copy the latest response or the selected response from the AI to the 4D Write Pro document at the current insertion point, replacing the selected text if any.
• Copy raw text/Copy styled text: Copy the latest response or the selected response from the AI in the clipboard.

In both cases, if the response was provided with styles, you can decide to copy the text with or without styles.

注

The chat box uses the Markdown language to format text. Basic styles such as bold, italic, underline, titles are supported. When pasting styled text from the AI in the 4D Write Pro area, you may lose some formatting information.

Chat area

The Chat area displays the whole interaction between you and the AI. You can scroll and select and part you want.

To empty this area, you can click on the Erase button of the History area (resets the window and all interactions).

履歴

The History area lists all your prompts sent to the AI. You can hide/show this area using the button on the top right corner of the Chat area.

The Erase button allows you to reset the whole window and erase all interactions. It is equivalent to close/reopen the AI dialog box.