# CALLURL

#### Syntax

**CALLURL**(*url*; *method*; *body*; *header*)

* *url* - die url, an die die Anfrage gesendet wird - ***Wertetyp**: Text*
* *method* - die http-Anforderungsmethode ("GET", "POST", "DELETE", ...) - ***Wertetyp**: Text (optional, Standardwert: "GET")*
* *body* - die Body-Daten der http-Anfrage -***Wertetyp**: Text (optional, Standardwert: empty)*
* *header* - die Kopfzeile der http-Anfrage - ***Wertetyp**: Text (optional, Standardwert: empty)*

#### Bemerkungen

* Die Funktion gibt das Ergebnis der http-Anfrage als Text zurück.
* Wenn die URL-Anfrage einen anderen Mime-Typ als text/..., application/javascript, application/json, application/xml zurückgibt, liefert die Funktion !ERROR.

#### Verknüpfung der CALLURL Funktion mit einem Datenbank-Widget

Es ist möglich, bei der CALLURL Funktion eine Authentifizierung zu verwenden, die bei einer REST oder Essbase Connection hinterlegt ist. Damit kann man z.B. Anfragen direkt an eine REST api mit entsprechender Authentifizierung oder an die REST api eines Essbase Servers schicken.

Dazu wird das Widget, bei welchem die Connection definiert ist, als Referenz in der Connection Formel hinterlegt.

#### Beispiel 1

Nach einem Klick auf die Schaltfläche CallURL wird die URL aus dem oberen Zellen-Widget gesendet, und das Ergebnis wird der unteren Zelle zugewiesen.

<figure><img src="/files/6Tx5lhZiVHjgLXCYVWu5" alt=""><figcaption></figcaption></figure>

In diesem Beispiel wird eine Post-Anfrage an eine URL gesendet, einschließlich Body- und Header-Informationen.

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

#### **Beispiel 2** : ChatGPT Kommunikation

Das "CALLURL" Schaltfeld verwendet das "REST api" Schaltfeld als Referenz bei der Connection Formel. Dadurch wird beim Abschicken einer Anfrage mit der CALLURL Funktion die Authentifizierung der Verbindung verwendet, in diesem Fall ein Bearer Token (der von ChatGPT verlangt wird).

<figure><img src="/files/qfp68S3UxZ30gmAkKeaR" alt=""><figcaption><p>Das CALLURL Schaltfeld referenziert das REST api Schaltfeld in der Connection Formel</p></figcaption></figure>

<figure><img src="/files/darV8fR2xUMzbyaNFajJ" alt=""><figcaption><p>Anschließend kann die Abfrage über die CALLURL Funktion abgesendet werden</p></figcaption></figure>


---

# 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://docs.nedyx.com/version-1.83-de/nedyx/clearlines-funktionen/datenbank-funktionen/callurl.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.