.. _auto_assembler_fetch_node:

*ASSEMBLER FETCH NODE*
======================

Fetches specific assembler nodes by ID from the d3VIEW graph store and returns those nodes together with their connecting edges as a structured graph. Optionally expands the result to include directly connected neighbour nodes, with optional type filtering on those neighbours.

When to use
-----------

Classification: **default**.

Tagged: ``assembler``, ``assembly``, ``designstep``, ``edges``, ``fetch``, ``graph``, ``loadcase``, ``nodes``.

Inputs
------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20 20 20

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Node Type
     - node_type
     - select
     - —
     - ✓
     - The entity type of the primary nodes to fetch (e.g., 'designstep', 'simulation', 'assembly'); must match one of the supported assembler node types.
   * - Node IDs
     - node_ids
     - text
     - —
     - ✓
     - Comma-separated list of integer node IDs to fetch for the selected node type (e.g., '123,456,789'); at least one ID is required.
   * - Fetch Connected Nodes
     - fetch_connected_nodes
     - boolean
     - False
     - 
     - When true, the worker also retrieves all nodes directly connected to the primary nodes via graph edges; defaults to false (fetch primary nodes only).
   * - Connected Node Types Filter
     - connected_node_types_filter
     - select
     - —
     - 
     - Multi-select whitelist of node types to include when expanding connected nodes; leave empty to include all connected node types — only evaluated when 'Fetch Connected Nodes' is enabled.

Outputs
-------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20

   * - Label
     - ID
     - Type
     - Description
   * - Graph
     - graph
     - json
     - JSON object containing the full graph payload with 'nodes' and 'edges' arrays as returned by the assembler — suitable for passing to downstream graph-aware workers.
   * - Nodes
     - nodes
     - dataset
     - Tabular dataset (one row per node) with columns for id, name, type, description, and metadata fields; convenient for row-level inspection or joining.
   * - Edges
     - edges
     - dataset
     - Tabular dataset (one row per edge) with columns for source node id, target node id, and edge type (e.g., 'has_simulation', 'uses_file'); empty if no edges were resolved.
   * - Node Count
     - node_count
     - number
     - Integer count of all nodes present in the returned graph, including any expanded connected nodes.
   * - Edge Count
     - edge_count
     - number
     - Integer count of all edges present in the returned graph.
   * - Summary
     - summary
     - text
     - Human-readable text summarising the fetch operation — reports node type queried, IDs requested, and counts of nodes and edges retrieved.

Disciplines
-----------

- cae.preprocessing.scenario
- platform.ontology
- platform.workflow

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>platform</code> schema. Worker id: <code>assembler_fetch_node</code>. Schema hash: <code>571b56c71f4e</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>