Question 1

Zammadでユーザー名を「名 姓」ではなく「姓 名」で表示する方法は？

Accepted Answer

設定 → ブランディングに移動し、ui_user_name_formatオプションをlast_firstに変更します。これにより、UI全体（ドロップダウン、概要、チケットサイドバー、受信者選択）で「姓 名」順が適用されます。デフォルトはfirst_lastです。メールのフォーマットは常に「名 姓」のままです。名前がない場合のエッジケースは自動的に処理されます。この機能はZammad 1.4.x以降で利用可能です。

Question 2

インライン画像を含むメールに返信する際に発生するZammadエラー「Variable $files of type [UploadFileInput!]! was provided invalid value for 0.content (invalid base64)」の修正方法

Accepted Answer

このエラーは、引用内容にインライン画像を含むチケットへ返信または転送する際に、Zammad 7.1.x のデスクトップビューで発生します。根本原因：`app/frontend/shared/components/Form/fields/FieldEditor/features/image-handler/ImageHandler.vue` において、`handleUpload()` のガードと `uploadCacheExists` computed が、`/api/v1/attachments/` で始まる画像 URL のみに一致するようになっています。引用されたメール内のインライン画像は、代わりに `/api/v1/ticket_attachment/:ticket_id/:article_id/:id?view=inline` という URL を使用するため、ガードをすり抜けてしまい、無効な base64 として GraphQL ミューテーションに送信されます。修正方法：ガードの対象を `/api/v1/attachments/` から `/api/v1/` へ広げます。Zammad API によってすでに配信されている画像はサーバー側で永続化されており、クライアント側で再アップロードしてはならないためです。この修正を含む上流の PR は現在進行中です。マージされるまでの間、このエラーは一時的なもので無害である点にご留意ください。返信は正常に送信されるため、エージェントは赤いフラッシュ表示を安全に無視できます。

Question 3

なぜ Zammad はログインのルックアップ時にインデックスを使用せず、users テーブルに対してシーケンシャルスキャンを実行するのですか？

Accepted Answer

原因: `users.login` には `LOWER(login)` に対する一意の式インデックスがあり、すべてのログイン名は小文字で保存されている(`User#check_login` がバリデーション前に小文字化する)。ルックアップは `login = ?` でクエリを実行していたが、PostgreSQL はこれを `LOWER(login)` インデックスから処理できないため、認証、パスワードリセット、SSO、CTI ルックアップ、受信メールの送信者識別、および OTRS インポートのすべてが users テーブルをスキャンしていた。psql で `SET enable_seqscan = off;` を実行した後、`EXPLAIN SELECT id FROM users WHERE login = 'admin@example.com';`(Seq Scan と表示される)と `EXPLAIN SELECT id FROM users WHERE LOWER(login) = LOWER('admin@example.com');`(Index Scan using index_users_on_login と表示される)を比較して確認できる。

修正(issue #6452 でマージ済み、動作は 100% 同一): 単一のファインダー `User.by_login(identifier)` が標準的なルックアップを担う。これは入力を小文字化し、完全一致の比較に加えて `LOWER(login) = LOWER(?)` を追加するため、インデックスが使用される。大文字小文字を区別しないすべての呼び出し箇所(パスワードログイン / `User.identify`、パスワードリセット、インポーターなど)はこれを経由する。明示的に大文字小文字を区別するファインダーが、与えられた値をそのまま一致させる必要がある5箇所(OpenID Connect/SAML の `uid`、`x-zammad-customer-login` メールヘッダー、REST の create/update でのログインによるユーザー関連付け、チケットの一括更新、Check_MK および CSV インポート、そして `x-zammad-ticket-owner`/`x-zammad-ticket-customer` ヘッダー)に対応し、それぞれはスペックによって担保されている。`login = :x OR email = :x` によるルックアップ(受信メールの送信者識別)では、ログインを同じ `LOWER` 式で比較するようになり、PostgreSQL が OR に対してログインとメール両方のインデックスを組み合わせて使用できるようになった。ルックアップがインデックスで処理されることをアサートするスペックもある。エンドユーザーは #6452 を含むリリースに Zammad を更新するだけでよく、マイグレーションやインデックスの変更は不要である。

Question 4

Zammad Webチャネル経由でチケットを作成する際に、新規カスタマーに対してグループが表示されない問題を修正する方法

Accepted Answer

Zammad 6.3.1 では、Channel → Web → Group selection for Ticket creation を空白のままにすると、新規の顧客に対してグループが正しく表示されなくなる場合があります。回避策として、Channels → Web に移動して Web チャネルを開き、Group selection for Ticket creation で all groups を手動で選択して保存してください。これにより、顧客には選択可能なグループが表示され、チケットを作成できるようになります。この問題は、それ以降の stable/develop ビルドでは再現できなかったため、問題が解決しない場合は Zammad をアップデートしてください。

Zammad

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト