サブフィールドにアクセスするには、フィールド名を英数字の述部として含めます。\
たとえば、上の例では `name[0][first]` は「John」を返し、`name[1][first]` は「Jane」を返します。
**混合型**
```
[
{"number": "555-5555555", "ext": "55"},
{"number": "777-7777777", "ext": "77"},
{"number": "888-8888888", "ext": "", "type": "Home"},
{"number": "999-9999999", "type": "Work"}
]
```
特定の値を取得するには、最初の数値述部で値全体を取得できます。例: `phone[1]` は2番目の電話の値全体 `{"number": "777-7777777", "ext": "77"}` を返します。\
特定のサブフィールドを取得するには、述部を2段にします。例: `phone[1][number]` は2番目の値の電話番号だけを返します。
{% endtab %}
{% tab title="例" %}
これらの例を参考にして、Keeper表記法によるクエリを作成してください。 各例でのレコードUIDはサンプルです。
{% hint style="warning" %}
Keeper表記法を利用する場合は、例にあるUIDを実際のレコードのレコードUIDに置き換えてください。
{% endhint %}
**レコードのタイプ、タイトル、メモを照会する**\
`keeper://EG6KdJaaLG7esRZbMnfbFA/type`\
`keeper://EG6KdJaaLG7esRZbMnfbFA/title`\
`keeper://EG6KdJaaLG7esRZbMnfbFA/notes`
**ログインレコードのパスワードを照会する**\
`keeper://EG6KdJaaLG7esRZbMnfbFA/field/password`\
戻り値: `RX$u!h!pBzDGhR4Jr6#b` (レコードからランダムに生成されたパスワード)
**連絡先のレコードからファーストネームを照会する**\
`keeper://3FXqmP5nFKwju0H8pl0DmQ/field/name[first]`
戻り値: `'Craig'`
**レコードからファイルを照会する**\
`keeper://bf3dg-99-JuhoaeswgtFxg/file/credentials.txt`
戻り値: `b"jNxmJkhbZ[...]6jQtE"` (credentials.txtの内容)
**ラベルが「code」のカスタム暗証番号フィールドを照会する**
`keeper://aj3dg-9ecJuhoa-sdyehg/custom_field/code`
戻り値: `5876` (暗証番号)
**ログインレコードの二要素コードフィールドを照会する**
`keeper://aj3dg-9ecJuhoa-sdyehg/field/oneTimeCode`
戻り値: `5876891`
**複数のカスタムフィールド電話番号の2番目を照会する**
`keeper://aj3dg-9ecJuhoa-sdyehg/custom_field/phone[1]`
戻り値: `{"number":"555-555-5555", "type": "home"}`
**この電話フィールドの番号だけを取得する**
`keeper://aj3dg-9ecJuhoa-sdyehg/custom_field/phone[1][number]`
戻り値: `"555-555-5555"`
**レコードにあるすべての電話番号を配列として取得する**
`keeper://aj3dg-9ecJuhoa-sdyehg/custom_field/phone[]`
戻り値:
```javascript
[
{"number":"123-456-7890", "type": "work"},
{"number":"555-555-5555", "type": "home"}
]
```
{% endtab %}
{% endtabs %}
## 名前でレコードを取得
KeeperシークレットマネージャーSDKでは、レコード名でレコードを取得するKeeper表記法をサポートしています。
### 表記文字のエスケープ
レコードのどこかに「/」「\」「\[」「]」が含まれている場合は、その文字をバックスラッシュでエスケープする必要があります。これらの記号は、内部セクションおよびインデックスの区切り文字として表記法で使用され、レコードタイトル、フィールドラベル、ファイル名に含まれる場合はエスケープする必要があります。
例:
タイトル: Twitter Login \[Marketing]\
`keeper://Twitter Login \[Marketing\]/field/password`\
ラベルが「/. links」のURLカスタムフィールド\
`keeper://My Slashdot Links/custom_field/\/.links[]` (すべてのリンク)\
`keeper://My Slashdot Links/custom_field/\/.links[1]` (2番目のリンクのみ)\
ファイル名: creds\[2].crt\
`keeper://My \/.Credentials/file/creds\[2\].crt`
### 名前を使用した環境切替の簡略化
Keeper表記法のレコードタイトル取得機能を使用すると、一度Keeper表記法で記述したクエリを、異なるビルド環境で異なるシークレットマネージャーアプリケーションを活用して再利用することができます。
例:
この例では、2つの共有フォルダを作成しました。1つは開発環境用、もう1つは本番用です。 それぞれのフォルダ内には、同じ名前のレコードがあります。 これらのレコードは同じ名前ですが、格納されているクレデンシャルは異なります。
それぞれの共有フォルダは、異なるシークレットマネージャーアプリケーションに関連付けられます。
関連するシークレットマネージャー統合で、以下のように表記法を使用してクレデンシャルを取得します。\
`keeper://MySQL Creds/field/password`\
\
開発ビルドで使用される統合では、「Development Environment」フォルダに関連付けられたシークレットマネージャーアプリケーションを使用します。その後、プロダクションビルドを行う際には、関連付けられたシークレットマネージャーアプリケーションを「Production Environment」に変更するだけで、コードやスクリプトの変更は必要ありません。
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.keeper.io/keeperpam/jp/secrets-manager/about/keeper-notation.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
