> For the complete documentation index, see [llms.txt](https://docs.opencityitalia.it/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.opencityitalia.it/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/loggetto-della-pratica.md).

# L'oggetto della pratica

Normalmente l'oggetto della pratica viene creato in automatico e riporta l'id della pratica e il codice fiscale del richiedente.

Nei servizi a catalogo l'application\_subject è già configurato, ma può essere personalizzato.

### Configurare l'oggetto della pratica

Per configurarlo, trascina un campo "Hidden" all'interno del modulo.

<figure><img src="/files/r3kjLCaOLR36zbsWSLGJ" alt=""><figcaption></figcaption></figure>

Nella sezione "API" del componente, inserisci "application\_subject" alla voce "Property name".

<figure><img src="/files/zU99vwagcuw6S4REdO1m" alt=""><figcaption></figcaption></figure>

Successivamente, accedi alla sezione "Data" del componente e alla voce "Calculated value" inserisci il codice JavaScript per personalizzare l'oggetto della pratica.

<div><figure><img src="/files/noVHjroTdrHiB5xCBOlG" alt=""><figcaption></figcaption></figure> <figure><img src="/files/o9X7UCm1ithVWjEVpQMY" alt=""><figcaption></figcaption></figure></div>

### Casistiche

Qui trovi tre casi d'uso per personalizzare l'oggetto della pratica: per il beneficiario, per un figlio beneficiario e per richieste presentate con ruoli diversi.

<details>

<summary>Beneficiario</summary>

Se vuoi inserire nell'oggetto della pratica il nome e cognome del beneficiario, puoi inserire questo codice:

```javascript
let name = data.beneficiary.data.family_name
let surname = data.beneficiary.data.given_name
value = `Richiesta <nome del servizio> di ${name} ${surname}`
```

</details>

<details>

<summary>Figlio beneficiario</summary>

Se vuoi inserire nell'oggetto della pratica il nome e cognome del figlio beneficiario del servizio (selezionato tra quelli presenti nel nested form) puoi inserire questo codice:

```javascript
let child = data.children.data.children.filter(child => child.tax_id === data.select_child)[0]
let name = child.given_name
let surname = child.family_name
value = `Domanda <nome del servizio> per ${name} ${surname}`
```

{% hint style="info" %}
Per selezionare il figlio beneficiario tra i figli inseriti nel Nested Form OC-Figli, vai alla sezione [Configurare logiche avanzate nel modulo del servizio](/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/le-funzioni/configurare-logiche-avanzate-nel-modulo-del-servizio.md#use-case-selezionare-un-figlio).
{% endhint %}

</details>

<details>

<summary>Più ruoli</summary>

Se vuoi comporre l'oggetto della pratica in base ai diversi ruoli del richiedente, puoi inserire il codice sottostante. In questo caso, se il ruolo selezionato è cittadino o delegato, l'oggetto della pratica riporterà nome, cognome e CF del soggetto; se invece il ruolo riguarda il legale rappresentante di un'impresa, l'oggetto della pratica riporterà il nome dell'azienda e il relativo CF.

```javascript
if (
  data.for_whom === "cittadino" ||
  data.for_whom === "delegato" ||
) {
  value =
    "Richiesta <nome del servizio> di " +
    data.beneficiary.data.family_name +
    " " +
    data.beneficiary.data.given_name +
    " (" +
    data.beneficiary.data.tax_id +
    ")";
} else if (data.for_whom === "legale_rappresentante") {
  value =
    "Richiesta <nome del servizio> per " +
    data.legal_entities.data.legal_name +
    " (" +
    data.legal_entities.data.tax_id +
    ")";
}
```

</details>


---

# 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.opencityitalia.it/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/loggetto-della-pratica.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.