> For the complete documentation index, see [llms.txt](https://docs.geodin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.geodin.com/geodin-ground/de/workflows-und-integrationen/arcgis-integration/arcgis-pro-attach-reports.md).

# Berichte zu Bohrloch-Anmerkungen anhängen

{% embed url="<https://www.youtube.com/watch?v=34Gydh4vkws>" %}

> **Videokapitel:** 0:00 Wie GeoDin Bohrungs-Berichtsverzeichnisse organisiert | 0:37 Dokumentanmerkungen finden | 1:14 Das AttachKey-Feld vorbereiten | 1:53 Bohrungen mit Verknüpfte Dokumente auswählen | 2:25 Die AttachKey-Werte berechnen | 3:33 Anhang-Treffer aktivieren und erzeugen | 4:35 Die Anhänge hinzufügen | 5:34 Die angehängten Berichte überprüfen

Wenn eine Civil-3D-Zeichnung mit GeoDin® Ground-Bohrungen in ArcGIS Pro ([Vorige Anleitung](https://docs.geodin.com/geodin-ground/de/workflows-und-integrationen/arcgis-integration/arcgis-pro-ground-model.md)), die exportierten PDF-Berichte können an die Dokumentanmerkung jedes Bohrlochs angehängt werden - sodass der richtige geotechnische Bericht vom richtigen Feature geöffnet wird. Dieses Tutorial erstellt einen Abgleichsschlüssel und führt die beiden Geoverarbeitungstools aus, die die PDFs mit den Anmerkungen verknüpfen.

{% hint style="info" %}
Für denselben Workflow ausgehend von den von GeoDin® exportierten Punktschichten (ein Datensatz pro Bohrloch), siehe [Berichte anhängen](https://docs.geodin.com/integrations-and-plug-ins/overview/attach-reports) in der GeoDin®-Dokumentation. Die folgende Version behandelt die Civil-3D-Anmerkungsschicht, in der jedes Bohrloch **mehrere** Anmerkungsdatensätze.
{% endhint %}

## Schritt 1: Die Berichte finden und die Anmerkungen bestätigen

* Beim Importieren erstellt GeoDin® Ground neben der Zeichnung ein Dokumente-Verzeichnis, nach Projekt strukturiert mit einem Unterverzeichnis pro Bohrloch, das den geotechnischen Bericht dieses Bohrlochs enthält.
* Kopieren Sie die Berichts-PDFs in ein einziges Arbeitsverzeichnis, um das Abgleichen zu vereinfachen.

<figure><img src="https://2671760131-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPq7NpdI8RP7yepuTnGLt%2Fuploads%2Fgit-blob-f97670b6dc77ca6f955145752b90e9197b870c91%2FAGP_Attach_01_Documents_Folder.png?alt=media" alt=""><figcaption><p>Das Verzeichnis der exportierten Dokumente und ein Bohrloch-Geotech-Soil-Log-PDF</p></figcaption></figure>

* In der Attributtabelle der Annotationsebene bestätigen Sie den Dokument-Datensatz des Bohrlochs: sein **Referenzname** lautet „1 Dokument(e)“.

<figure><img src="https://2671760131-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPq7NpdI8RP7yepuTnGLt%2Fuploads%2Fgit-blob-ad9f9aa5bfece6e01f0a151f1ecef21d604828f6%2FAGP_Attach_02_Attribute_Table.png?alt=media" alt=""><figcaption><p>Der Dokument-Annotationsdatensatz in der Attributtabelle</p></figcaption></figure>

## Schritt 2: Hinzufügen eines Schlüsselfelds

* Öffnen Sie die Ansicht der Feature-Class-Felder und fügen Sie ein Neu-Feld mit dem Namen **AttachKey** mit **Datentypzuordnung = Text**. Speichern Sie die Änderungen.

<figure><img src="https://2671760131-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPq7NpdI8RP7yepuTnGLt%2Fuploads%2Fgit-blob-95c0981b3c737102f7b464f8130333a79ae14316%2FAGP_Attach_03_AttachKey_Field.png?alt=media" alt=""><figcaption><p>Das AttachKey-Feld als Text hinzugefügt</p></figcaption></figure>

## Schritt 3: Nur die Dokument-Anmerkungen Auswählen

* Benutzen Sie **Auswählen nach Attribute** mit der Klausel: **RefName enthält den Text** `Dokument`.
* Übernehmen und die Zählung der Auswahl überprüfen, bevor Sie fortfahren - der Schlüssel muss nur für diese Datensätze Berechnet werden.

<figure><img src="https://2671760131-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPq7NpdI8RP7yepuTnGLt%2Fuploads%2Fgit-blob-e4a1416ea93fa76b16e16629b52c1159a4cb0dc2%2FAGP_Attach_04_Select_By_Attributes.png?alt=media" alt=""><figcaption><p>Auswählen der Dokument-Anmerkungs-Datensätze</p></figcaption></figure>

## Schritt 4: Den Schlüssel berechnen

* Bei aktiver Auswahl / Selektion, Rechtesklick **AttachKey > Feld berechnen**, gesetzt **Ausdruck Art = Python**, Ausdruck `extract_bh(!Schicht!)`, und dieser Schlüsselblock:

```python
def extract_bh(Schicht):
    schicht = schicht.upper()

    # Bekannten Präfix und Suffix definieren
    prefix = "LOC_BASE-"
    suffix = "-BASIC"

    wenn schicht.startswith(prefix) und schicht.endswith(suffix):
        return Schicht[len(prefix):-len(suffix)] + " -"

    return keine
```

<figure><img src="https://2671760131-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPq7NpdI8RP7yepuTnGLt%2Fuploads%2Fgit-blob-a58a2272e6e779184e61047469320cae1cea6440%2FArcGIS_Pro_Calculate_AttachKey.png?alt=media" alt=""><figcaption><p>Feld berechnen wurde nur zu den selektierten Datensätzen angewendet</p></figcaption></figure>

* Das nachfolgende `" -"` ist beabsichtigt: Es macht den Schlüssel so spezifisch, dass er genau zu einem Bericht-Dateinamen per Präfix passt, sodass ähnlich benannte Bohrungen (BH1 vs. BH1A) nicht gegenseitig abgeglichen werden können.

<figure><img src="https://2671760131-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPq7NpdI8RP7yepuTnGLt%2Fuploads%2Fgit-blob-b9285f876960edd93f67f31a5861ae7998991862%2FAGP_Attach_06_Key_Populated.png?alt=media" alt=""><figcaption><p>Der befüllte Schlüssel - Bohrungsname plus nachgestellter Bindestrich</p></figcaption></figure>

## Schritt 5: Anhänge aktivieren

* Öffnen Sie die Feature-Class **Eigenschaften > Verwalten** und aktivieren Sie **Anhänge** (Anhänge sind eine Geodatabase-Funktion – die Annotationsschicht muss eine Geodatabase-Feature-Class sein, nicht ein Shapefile). Speichern.

<figure><img src="https://2671760131-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPq7NpdI8RP7yepuTnGLt%2Fuploads%2Fgit-blob-3b70fbcfa08089a8024a389d184172b77291638b%2FAGP_Attach_07_Enable_Attachments.png?alt=media" alt=""><figcaption><p>Anhänge für die Feature-Class aktiviert</p></figcaption></figure>

## Schritt 6: Die Treffer-Tabelle generieren

* Führen Sie das **Anhangs-Treffer-Tabelle generieren** Geoverarbeitungswerkzeug aus:
  * **Eingabe-Dataset**: die Annotationsschicht (selektierte Datensätze).
  * **Eingabe-Verzeichnis**: das Arbeitsverzeichnis mit den PDFs.
  * **Schlüsselfeld**: `AttachKey` - **Eingangsdatenfilter**: `*.pdf` - **Treffermuster**: **Präfix**.

<figure><img src="https://2671760131-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPq7NpdI8RP7yepuTnGLt%2Fuploads%2Fgit-blob-a42ca0a4e9253c39016cf0cdec89b69174169127%2FAGP_Attach_08_Match_Table.png?alt=media" alt=""><figcaption><p>Anhangs-Treffer-Tabelle generieren, wobei das Treffermuster auf Präfix gesetzt ist</p></figcaption></figure>

## Schritt 7: Die Anhänge hinzufügen

* Führen Sie aus **Anhänge hinzufügen** mit demselben Eingabe-Dataset, **Eingabe-Verknüpfungsfeld** `OBJECTID`, der Treffer-Tabelle aus Schritt 6 und **Treffer-Verknüpfungsfeld** `MatchID`.

<figure><img src="https://2671760131-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPq7NpdI8RP7yepuTnGLt%2Fuploads%2Fgit-blob-4812b0a7d523737d75cd41f6a33369d06a8bfe72%2FAGP_Attach_09_Add_Attachments.png?alt=media" alt=""><figcaption><p>Anhänge hinzufügen und OBJECTID mit MatchID verknüpfen</p></figcaption></figure>

## Schritt 8: Überprüfen

* Klicken Sie in der Szene auf eine Dokumentannotation und scrollen Sie in deren Pop-up: Der geotechnische Bericht wird als Anhang angezeigt.
* Überprüfen Sie stichprobenartig ein oder zwei weitere Bohrungen, um zu bestätigen, dass der Abgleich durchgehend funktioniert hat.

<figure><img src="https://2671760131-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPq7NpdI8RP7yepuTnGLt%2Fuploads%2Fgit-blob-30e08c2a452c3e72eb5158903f72b300fd7af258%2FArcGIS_Pro_Attachment_Popup.png?alt=media" alt=""><figcaption><p>Der an die Annotation angehängte Bericht, im Pop-up überprüft</p></figcaption></figure>

## Optionale allgemeine Einstellungen

* **Umfang der Auswahl / Selektion** – den Schlüssel berechnen **nur für die selektierten Dokumentdatensätze**; die Berechnung über alle Zeilen hinweg erzeugt falsche Treffer.
* **Schlüsselspezifität** – wenn mehrere Berichte ähnliche Namen haben, machen Sie das Schlüsselpapiertformat vor dem Abgleich spezifischer (das nachgestellte `" -"` existiert genau dafür).

***

## Arbeiten mit Anhangsabgleich

Bestätigen Sie, dass Anhänge aktiviert sind, bevor Sie die Werkzeuge zum Abgleichen und Hinzufügen ausführen, und überprüfen Sie nach jeder Phase stichprobenartig ein Bohrloch (Schlüssel berechnet, Treffer-Tabelle generiert, Anhänge hinzugefügt), damit eine Nichtübereinstimmung einen Schritt von ihrer Ursache entfernt erkannt wird statt erst am Ende.

***

**Folgende Schritt:** [Das Modell als Webszene veröffentlichen und überprüfen](https://docs.geodin.com/geodin-ground/de/workflows-und-integrationen/arcgis-integration/arcgis-web-scene.md) – die angehängten Berichte bleiben in den Pop-ups der veröffentlichten Szene verfügbar.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.geodin.com/geodin-ground/de/workflows-und-integrationen/arcgis-integration/arcgis-pro-attach-reports.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
