# Revit での使用例

Revit 内で、そこに含まれるデータの一部を使って検索しようとしたことがありますか?

次の例のような作業を行ったことがあるのではないでしょうか。

下図では、Revit モデル内のすべての部屋を収集し、必要な部屋のインデックスを(部屋番号で)取得し、最終的にそのインデックスにある部屋がわかります。

!

> 1. モデル内のすべての部屋を収集します。
> 2. 検索する部屋番号。
> 3. 部屋番号を取得し、その番号のインデックスを見つけます。
> 4. インデックスで部屋を取得します。

## 演習: 部屋のディクショナリ

### パート I: 部屋のディクショナリを作成する

> 下のリンクをクリックして、サンプル ファイルをダウンロードします。
>
> すべてのサンプル ファイルの一覧については、付録を参照してください。

次に、ディクショナリを使用して、これを再作成してみましょう。まず、Revit モデル内のすべての部屋を収集する必要があります。

!

> 1. 操作する Revit カテゴリを選択します(ここでは部屋を操作します)。
> 2. Dynamo に対して、これらの要素すべての収集を指示します。

次に、このデータを検索するために使うキーを決定する必要があります。(キーに関する情報は、「[ディクショナリとは](/ja/5_essential_nodes_and_concepts/5-5_dictionaries-in-dynamo/1-what-is-a-dictionary.md)」セクションを参照してください)。

!

> 1. 使用するデータは部屋番号です。

ここでは、指定されたキーと要素でディクショナリを作成します。

!

> 1. **Dictionary.ByKeysValues** ノードは、適切に入力されるとディクショナリを作成します。
> 2. `Keys` は文字列であることが必要ですが、`values` はさまざまなオブジェクト タイプにすることができます。

最終的に、部屋番号を使って、ディクショナリから部屋を取得することができます。

!

> 1. `String` は、ディクショナリからオブジェクトを検索するために使用しているキーです。
> 2. **Dictionary.ValueAtKey** ノードで、ディクショナリからオブジェクトを取得します。

### パート II: 値の検索

ディクショナリによるこの同じ方法を使用して、グループ化されたオブジェクトでディクショナリを作成することもできます。指定されたレベルですべての部屋を検索する場合、上のグラフを次のように修正できます。

!

> 1. キーとして部屋番号を使用するのではなく、パラメータの値(ここではレベル)を使用できます。

!

> 2. これで、部屋をそのレベルごとにグループ化することができます。

!

> 3. レベルごとにグループ化された要素を使用することで、共有のキー(固有のキー)をディクショナリのキーとして使用し、部屋のリストを要素として使用できるようになります。

!

> 4. 最終的に、Revit モデル内のレベルを使用して、ディクショナリ内で、そのレベルに配置されている部屋を検索できます。`Dictionary.ValueAtKey` は、レベル名を取得して、そのレベルの部屋オブジェクトを返します。

\[Dictionary]カテゴリのノードを使用する機会は、実際には無限にあるのです。Revit 内の BIM データを要素自体に関連付けることができるので、さまざまな使用例が考えられます。


---

# 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://primer2.dynamobim.org/ja/5_essential_nodes_and_concepts/5-5_dictionaries-in-dynamo/4-dictionary-use-cases.md?ask=<question>
```

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.
