> 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/es/flujos-de-trabajo-e-integraciones/arcgis-integration/arcgis-pro-attach-reports.md).

# Adjuntando Informes a las anotaciones de Pozo de sondeo

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

> **Capítulos del vídeo:** 0:00 Cómo GeoDin organiza las carpetas de Informes del Pozo de sondeo | 0:37 Encontrando anotaciones de Documento | 1:14 Preparando el campo AttachKey | 1:53 Seleccionando Pozos de observación con Enlazar documentos | 2:25 Calculando los Valores de AttachKey | 3:33 Habilitando Y generando Encontrados de adjuntos | 4:35 Añadiendo los adjuntos | 5:34 Verificando los Informes adjuntos

Cuando un dibujo de Civil 3D con los Pozos de observación de GeoDin® Ground se incorpora en ArcGIS Pro ([Tutorial Anterior](/geodin-ground/es/flujos-de-trabajo-e-integraciones/arcgis-integration/arcgis-pro-ground-model.md)), los Informes PDF exportados pueden adjuntarse a la anotación de Documento de cada Pozo de sondeo, de modo que se abra el Informe geotécnico correcto desde la entidad correcta. Este tutorial crea una clave coincidente y ejecuta las dos herramientas de geoprocesamiento que vinculan los PDF con las anotaciones.

{% hint style="info" %}
Para el mismo flujo de trabajo que parte de Capas de Punto exportadas por GeoDin® (un registro por Pozo de sondeo), consulte [Adjuntar Informes](https://docs.geodin.com/integrations-and-plug-ins/overview/attach-reports) en la documentación de GeoDin®. La Versión siguiente gestiona la Capa de anotación de Civil 3D, donde cada Pozo de sondeo tiene **múltiples** Registros de anotación.
{% endhint %}

## Paso 1: Localiza los informes y confirma las anotaciones

* Al importar, GeoDin® Ground crea un directorio de Documentos junto al dibujo, estructurado por Proyecto con una subcarpeta por Pozo de sondeo, cada una con el informe geotécnico de ese Pozo de sondeo.
* Copia los PDF del Informe en un directorio de trabajo para simplificar la correspondencia.

<figure><img src="/files/3f394c2db767e1c289d86881bcd2c190b052abbf" alt=""><figcaption><p>El directorio de Documentos exportado y el PDF Geotech Soil Log de un Pozo de sondeo</p></figcaption></figure>

* En la Tabla de atributos de la Capa de anotaciones, confirma el registro de Documento del Pozo de sondeo: su **RefName** indica "1 Documento(s)".

<figure><img src="/files/cb13207b56408c22253801ac4119a07cfbcc0c32" alt=""><figcaption><p>El registro de anotación de Documento en la Tabla de atributos</p></figcaption></figure>

## Paso 2: añadir un campo clave

* Abrir la vista de campos de la clase de entidad y añadir un nuevo campo llamado **AttachKey** con **Asignar tipo de datos = Texto**. Guardar los cambios.

<figure><img src="/files/df3a09d8cbcad270ee6f1a4086ee3f9d89e98f2a" alt=""><figcaption><p>El campo AttachKey agregado como Texto</p></figcaption></figure>

## Paso 3: Seleccionar solo las anotaciones del Documento

* Usar **Seleccionar por Atributos** con la cláusula: **RefName contenidos el Texto** `Documento`.
* Aplicar y verificar el Recuento de Selección antes de continuar - la clave solo debe calcularse para estos Registros.

<figure><img src="/files/9afc00a581fbf8618729347df0fd721d20bc0eaf" alt=""><figcaption><p>Seleccionando los Registros de anotación del Documento</p></figcaption></figure>

## Paso 4: Calcular la clave

* Con la Selección activa, haz clic derecho **AttachKey > Calcular campo**, establece **Tipo de Término = Python**, Término `extract_bh(!Capa!)`, y este Bloque de Código:

```python
def extract_bh(capa):
    capa = capa.upper()

    # Definir prefijo y sufijo conocidos
    prefix = "LOC_BASE-"
    suffix = "-BASIC"

    Cuando capa.startswith(prefix) y capa.endswith(suffix):
        return capa[len(prefix):-len(suffix)] + " -"

    return Ninguna
```

<figure><img src="/files/1f9c5ea943f67d151e75a11135419fb7f7482223" alt=""><figcaption><p>Calcular campo aplicado solo a los registros seleccionado</p></figcaption></figure>

* El final `" -"` es intencional: hace que la clave sea lo suficientemente específica como para coincidir por prefijo exactamente con el nombre de archivo de un informe, de modo que los pozos de observación con nombres similares (BH1 frente a BH1A) no puedan cruzarse.

<figure><img src="/files/2d895d1dbea73eedd7fdb9bd91a86baf789384eb" alt=""><figcaption><p>La clave rellenada - Nombre de la perforación más un guion final</p></figcaption></figure>

## Paso 5: Habilitar adjuntos

* Abrir la clase de entidad **Propiedades > Administrar** y habilitar **Adjuntos** (los adjuntos son una entidad de geodatabase: la capa de anotación debe ser una clase de entidad de geodatabase, no un shapefile). Guardar.

<figure><img src="/files/71f8d33bea09143d6d7e333a134d9c90c7e75315" alt=""><figcaption><p>Adjuntos habilitados en la clase de entidad</p></figcaption></figure>

## Paso 6: Generar la tabla de correspondencia

* Ejecute la **Generar tabla de correspondencia de adjuntos** de geoprocesamiento:
  * **Conjunto de datos de entrada**: la capa de anotación (registros seleccionados).
  * **Directorio de entrada**: la carpeta de trabajo con los PDF.
  * **Campo clave**: `AttachKey` - **Filtro de datos de entrada**: `*.pdf` - **Patrón de coincidencia**: **Prefijo**.

<figure><img src="/files/192182754b24a54614c44c4be2b2c0c437eb6612" alt=""><figcaption><p>Generar tabla de correspondencia de adjuntos con el patrón de coincidencia configurado como Prefijo</p></figcaption></figure>

## Paso 7: Añadir los adjuntos

* Ejecute **Añadir adjuntos** con el mismo conjunto de datos de entrada, **Campo de unión de entrada** `OBJECTID`, la tabla de correspondencia del paso 6, y **Campo de unión de correspondencia** `MatchID`.

<figure><img src="/files/ca0cf2b701123cfcb9c11f79cf9922bab5bba660" alt=""><figcaption><p>Añadir adjuntos uniendo OBJECTID con MatchID</p></figcaption></figure>

## Paso 8: Verificar

* Haga clic en una anotación de documento en la escena y desplácese por su ventana emergente: el informe geotécnico aparece como un adjunto.
* Compruebe uno o dos pozos de observación más para confirmar que la coincidencia funcionó de forma consistente.

<figure><img src="/files/7f0b5b1204fba40a2058c130c32de0cb39b99191" alt=""><figcaption><p>El informe adjunto a la anotación, verificado en la ventana emergente</p></figcaption></figure>

## Ajustes opcionales

* **Ámbito de selección** - calcular la clave **solo para los registros de documentos seleccionados**; calcular en todas las filas crea coincidencias incorrectas.
* **Especificidad de la clave** - si varios informes tienen nombres similares, haga que el formato de la clave sea más específico antes de hacer la coincidencia (el guion final `" -"` existe precisamente para eso).

***

## Trabajar con la correspondencia de adjuntos

Confirme que los adjuntos estén habilitados antes de ejecutar las herramientas de correspondencia y añadir, y compruebe un pozo de sondeo después de cada etapa (clave calculada, tabla de correspondencia generada, adjuntos añadidos) para detectar una discrepancia un paso antes de su causa, en lugar de al final.

***

**Siguiente paso:** [Publicar y revisar el modelo como una escena web](/geodin-ground/es/flujos-de-trabajo-e-integraciones/arcgis-integration/arcgis-web-scene.md) - los informes adjuntos permanecen disponibles en las ventanas emergentes de la escena publicada.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.geodin.com/geodin-ground/es/flujos-de-trabajo-e-integraciones/arcgis-integration/arcgis-pro-attach-reports.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
