Question 1

Actual Budget で api.updateCategory を呼び出した際に発生する "TypeError: Cannot read properties of undefined (reading 'trim')" を修正する方法

Accepted Answer

これは `@actual-app/api` バージョン 26.8.1 および 26.9.0 における既知のバグです: `updateCategory` は無条件に `category.name.trim()` を呼び出すため、`name` を省略した部分更新(例: `group_id` や `hidden` のみを変更する場合)では TypeError がスローされ、何も書き込まれません。回避策: 更新ペイロードに常にカテゴリの現在の名前を含めてください。例えば:

```js
await api.updateCategory(categoryId, { group_id: groupId, name: currentName });
```

これは成功し、名前は変更されません。恒久的な修正(`name` が実際に提供された場合にのみ trim を行う)はメンテナーに提案済みですが、それがリリースされるまでは、変更するフィールドと一緒に既存の `name` を渡すことが必要な回避策です。

Question 2

スケジュールの繰り返しピッカーで特定の日付をクリックすると、日付ピッカーが保存されないままポップアップが閉じてしまうのはなぜですか？

Accepted Answer

これは既知のバグでした。基盤となるポップアップの境界からわずかにはみ出して描画される日付(たとえば、ポップアップの端からはみ出している「8」のような日付セル)をクリックすると、誤って外側のクリックとして扱われ、選択した日付が保存されないままポップアップが閉じてしまっていました。このバグはPR #8427で修正されました。これを解決するには、この修正を含むリリースバージョンにActual Budgetを更新してください(最新のリリースまたはDockerイメージをプルしてください)。更新後に設定の変更や回避策は必要ありません。

Question 3

Actual Budgetでダッシュボードウィジェットがデバイス間で同期されないのはなぜですか？

Accepted Answer

これは、複数ダッシュボードへの移行（マイグレーション）が実行される前に、予算ファイルが複数のデバイスに存在していた場合に発生します。各デバイスが 'Main' ダッシュボードページに対して独自のUUIDを生成したため、ウィジェットがデバイスごとに異なるダッシュボードIDでタグ付けされ、同期に失敗します。修正方法：正しいダッシュボードレイアウトを持つデバイスで同期IDをリセットしてください。設定 → 詳細設定 → 同期のリセット に進みます（これにより、単一のダッシュボードIDセットを持つ予算ファイルのクリーンなコピーがサーバーにアップロードされます）。その後、他のデバイスで予算を再度開く／再同期し、クリーンなコピーをダウンロードさせてください。注意：リセット後はこのバージョンが正規版となるため、リセットする前にすべてのウィジェットが正しく表示されていることを確認してください。

Question 4

Actual Budgetでは、複数のユーザーが個別のSimpleFinまたは銀行同期アカウントを持つことはできますか？

Accepted Answer

はい。ユーザーごとの銀行同期はPR #9214で実装され、サーバー全体で1つのアカウントを共有する代わりに、各ユーザーが独自のSimpleFin/銀行の認証情報を保存できるようになりました。これを使用するには、そのPRを含むリリースにアップデートしてください。古いバージョンでは、ユーザーごとに個別のActual Budgetインスタンス（例：別々のDockerコンテナ）を実行し、それぞれに独自のSimpleFin認証情報と、OpenID（例：PocketID）などの独自の認証を設定することが唯一の回避策です。

Question 5

Actual Budget の銀行同期で「You don't have the required permissions to set up secrets」エラーを修正する方法

Accepted Answer

Actual Budget のマルチユーザーモードでは、サーバーの銀行同期シークレット（SimpleFIN、GoCardless、Pluggy.ai）を使用できるのは Admin ユーザーのみであり、Basic ロールのユーザーはアカウントの連携がブロックされています。現時点では、ユーザー単位の設定や細かな粒度の権限設定はまだありません（機能リクエスト #8014 で追跡されています）。回避策：1) 管理者がユーザーに代わって、そのユーザーのアカウントを銀行同期プロバイダーに連携します。2) ユーザーを一時的に Admin に昇格させ、SimpleFIN／銀行同期の連携を完了させてから、Basic に戻します。どちらの方法を使う場合でも、管理者が事前にサーバー上で銀行同期シークレットを設定しておく必要があります。

actual

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト