# 5-5、賬戶管理器 # 賬戶管理器 - - - - - - 此頁面上的所有內容僅適用于\[\[交易終端\](Trading-Terminal.md)\]\]。 帳戶管理器是一個顯示交易信息的交互式表格。 通常它有3個標簽頁：訂單/持倉和帳戶信息。 要創建帳戶管理器，您需要描述每個標簽頁的列并提供數據。 備注 1. [Broker API](Broker-API.html)\[supportCustomBottomWidget|Trading-Controller#configFlags\]\] 標志應被禁用，以顯示客戶經理。 備注 2. \[\[Trading Controller\]\] 應實現 \[[accountManagerInfo](Broker-API.md%7CTrading-Controller#accountmanagerinfo)\]\] ## 帳戶管理器Mete信息 此信息將返回 \[[accountManagerInfo](Broker-API.md%7CTrading-Controller#accountManagerInfo)\]\]. ### 帳戶管理器頭信息 帳戶管理器頭信息由經紀商的標題和帳戶名或帳戶列表組成。 ##### accountTitle: String ##### accountsList: AccountInfo數組 ##### account: 賬戶信息的[WatchedValue](WatchedValue.html) `AccountInfo` 是一個只有`name`為必須鍵和對應值的對象。 1. `id` - 帳戶ID 2. `name` - 賬戶名稱 3. `currency` - 賬戶貨幣 如果未設置`currency`，則`USD`將用作默認值。 ### 訂單頁 ##### orderColumns: array of \[[Column](%7CAccount-Manager#column-description)\]\] 要在訂單頁面中顯示的列的說明。 您可以顯示\[[order](%7CTrading-Objects-and-Constants.md#%EF%BC%83order)\]\]的任何字段，也可以將自己的字段添加到訂單對象中并顯示它們。 ##### possibleOrderStatuses: array of \[[OrderStatus](%7CTrading-Objects-and-Constants.md#orderstatus)\]\] 在訂單過濾器中使用的可選狀態列表。如果未設置，則使用默認列表。 #### hasHistoryColumns: array of [Column](#column-description) 如果存在 如果是 `true` ，將顯示歷史頁面。 之前會話歷史上的所有訂單都將顯示在歷史記錄中。 ### historyColumnsSorting: [SortingParameters](#sortingparameters) 表的可選排序。 如果未設置，則表按第一列排序。 ### 持倉頁 ##### positionColumns: array of \[[Column](%7CAccount-Manager#column-description)\]\] 您可以顯示\[[position](%7CTrading-Objects-and-Constants.md#%EF%BC%83position)\]\]的任何字段，或者將您自己的字段添加到位置對象并顯示它們。 ### 附加頁面（例如帳戶摘要） ##### pages: array of \[[Page](%7CAccount-Manager#page)\]\] 使用`pages`您可以向賬戶管理器添加新的tab頁。每個選項卡都是一組列表。 #### Page `Page` 是額外的賬戶管理器tab頁說明。 它是一個包含以下字段的對象： 1. `id`: String 頁面的唯一標識 1. `title`: String 頁面標題。 顯示在選項卡上。 1. `tables`: Array of \[\[Table|Account-Manager#table\]\]. 可以在此選項卡中顯示一個或多個表。 #### Table 您可以向\[[Page](%7CAccount-Manager#page)\]\]添加一個或多個表。 帳戶摘要表metainfo是一個包含以下字段的對象： 1. `id`: String 唯一標識 1. `title`: String 表的可選標題。 1. `columns`: array of \[[Column](%7CAccount-Manager#column-description)\]\] 2. `getData`: Promise 此方法用于請求表數據。 它返回promise（或Deferred）并接收它返回的數據數組。 每一行都是一個對象。 此對象的鍵是具有相應值的列名稱。 有一個預定義的字段 `isTotalRow` 可以用來標記一個表的底部的一行。 1. `changeDelegate` : \[[Delegate](Delegate.html)\] 用于觀察數據更改并更新表。 通過`fire`方法將新的賬戶管理器數據傳遞給delegate。 1. `initialSorting`: 具有以下屬性的對象: - `columnId` - 將用于排序的列的`id`或`property`。 - `asc` - （可選，默認為`false`） - 如果是`true`，則初始排序將按升序排列。 `initialSorting` 是表的可選排序。 如果未設置，則表按第一列排序。 **注意**：如果表中有多行，并且想使用 `changeDelegate` 更新一行，請確保每行中都有 `id` 字段來標識它。 如果表中只有一行，則不是必須的。 ### Formatters ##### customFormatters: 一組列格式的描述 可選數組定義自定義格式化。 每個描述都是一個包含以下字段的對象： `name`: 唯一標識 `format(options)`: 用于格式化單元格值的方法。 `options` 是一個具有以下鍵的對象： 1. `value` - 要格式化的值 2. `priceFormatter` - 價格標準格式。 您可以使用`format(price)` 方法來設置價格的值。 3. `prevValue` - 可選字段。 它是一個以前的值，所以你可以相應地進行比較和格式化。如果當前列具有 `highlightDiff: true` key. 4. `row` - 具有當前行中所有鍵/值對的對象 ### 列描述 帳戶管理器描述中最有價值的部分是其列的描述。 ##### label 列標題。 它將顯示在表的標題行中。 ##### className 可選的 `className` 被添加到每個值單元格的html標簽。 您可以使用它來自定義表的樣式。 以下是預定義類的列表： class名描述tv-data-table\_\_cell--symbol-cell商品字段的特殊格式化器tv-data-table\_\_cell--right-align它將單元格值右對齊tv-data-table\_\_cell--buttons-cell單元格按鈕##### formatter 用于格式化數據的格式化器。 如果沒有設置 `formatter` ，則按照原樣顯示該值。 格式化器可以是默認的或者是定制的 以下是默認格式化程序列表： 名稱描述symbol它用于商品字段。 它顯示 `brokerSymbol` ，但是當您單擊符號時，將 `symbol` 字段設置為圖表。 `property`鍵被忽略。side它用于顯示方向：賣或買。type用于顯示類型：限價/停損/限價停損/市價。formatPrice格式化價格formatPriceForexSup與 `formatPrice` 一樣，但它使得價格的最后一個字符被上標。 只有當儀器的類型為 `forex` 時，它才起作用。status格式化`status`date顯示日期或時間localDate顯示的日期或時間在本地時區。fixed顯示一個小數點后2位的數字。pips顯示一個小數點后1位的數字。profit顯示利潤。它還添加了 `+`，分隔成千位，并設置紅色或綠色的單元文本顏色。有一些特殊的格式化程序用于向表中添加按鈕： `orderSettings`將修改/取消按鈕添加到訂單選項卡。 始終為此格式化程序將`modificationProperty`值設置為`status`。 `posSettings`將編輯/關閉按鈕添加到位置/凈位置選項卡 `tradeSettings`將編輯/關閉按鈕添加到個人位置選項卡。 始終為此格式化程序將`modificationProperty`值設置為`canBeClosed`。 ##### property `property` 是用于獲取顯示數據對象的關鍵字。 ##### sortProp 可選的 `sortProp` 是用于數據排序的數據對象的鍵。 ##### modificationProperty 可選的 `modifyProperty` 是數據對象的一個關鍵字，它被用于修改。 ##### notSortable 可選的 `notSortable` 可以設置為防止列的排序。 ##### help `help` 是列的提示字符串。 ##### highlightDiff `highlightDiff` 可以使用`formatPrice`和`formatPriceForexSup`格式化器來設置字段的更改。 ##### fixedWidth 如果為`true`，則當數字數字減少時，列寬不會減小。 ### supportedStatusFilters 訂單狀態的可選數字數組，僅應用于訂單列。 如果可用，則該列將僅顯示在狀態過濾器的指定選項卡中。 以下是可能的訂單狀態列表： - 0 - All - 1 - Canceled - 2 - Filled - 3 - Inactive - 5 - Rejected, - 6 - Working ### 上下文菜單 #### contextMenuActions(e, activePageItems) `e`: 瀏覽器傳遞的上下文對象 `activePageItems`: 當前頁面的`ActionMetainfo`項目數組 可選方法以創建一個自定義上下文菜單。 它返回用`ActionMetainfo`數組解析的 `Promise`。