In dieser Tabelle werden benötigte Endpunkte und deren Authentifizierungsart hinterlegt.
Authentifizierung Felder
Endpunkt URL
Gibt die Endpunkt URL.
Art
Gibt die Authentifizierungsart an.
OAuth, Felder
Mit dieser Authentifizierungsart können Token von Autorisierungsservern der Microsoft Identy Platform abgerufen werden.
Als OAuth2 Flow wird die Option "Client Credentials unterstützt.
OAuth URL
Gibt den OAuth Token Endpunkt.
Client ID
Gibt die Client ID an.
Client Secret
Gibt das Client Secret.
Basic, Felder
Username
Gibt den Benutzernamen für die Basic Authentifizierung an.
Password
Gibt das Passwort für die Basic Authentifizierung an.
Bearer Token, Felder
Bearer Token Login Url
Gibt die Bearer Token Login Url an.
Requires Encryption
Gibt an, ob die Login Url die Anmeldedaten in verschlüsselter Form benötigt.
Bearer Token Json Key
Gibt den Schlüssel des Json Wertes der Http Antwort des Bearer Token Logins an, welcher den Bearer Token beinhaltet.
Username
Gibt den Benutzernamen für die Bearer Token Authentifizierung an.
Password
Gibt das Passwort für die Bearer Token Authentifizierung an.
Verschlüsselung, Felder
Verschlüsselungsalgorithmus
Gibt an, welcher Verschlüsselungsalgorithmus verwendet werden soll.
Kryptografischer Schlüssel
Gibt den Schlüssel einer schlüsselbasierten kryptografischen Funktion an.
API-Schlüssel, Felder
API-Schlüssel Header Name
Gibt den Namen des Header der Anfrage der für den API-Schlüssel verwendet werden soll an.
API-Schlüssel
Gibt den API-Schlüssel an.
OAuth-extern, Felder
Mit dieser Authentifizierungsart können Token von Autorisierungsservern ausßerhalb der Microsoft Identy Platform abgerufen werden.
Als OAuth2 Flow wird die Option "Client Credentials unterstützt.
OAuth2 Flow
Gibt an, welchen OAuth 2.0 Flow Sie nutzen wollen.
OAuth URL
Gibt den OAuth Token Endpunkt.
Client ID
Gibt die Client ID an.
Client Secret
Gibt das Client Secret.
Scope
Gibt den Bereich für den Token an. Ist dies leer so wird * verwendet.
Aktionen
Anmeldeinformationen und Verbindung testen
Sendet eine HTTP GET Anfrage mit den angegebenen Anmeldeinformationen an den Endpunkt, um zu prüfen, ob der Endpunkt erreicht werden kann und ob die Anmeldeinformationen korrekt sind. Wenn die Bearer Token oder OAuth2 Authentifizierungsart verwendet wird, wird eine weitere Anfrage an die Token Url mit den gegebenen Anmeldeinformationen gesendet um zu überprüfen, ob diese korrekt sind und einen Authentifizierungstoken zurückliefern. Die Antwort des getesteten Webservices wird in einem Dialog ausgegeben.
Erstellt einen Test Webrequest mit dieser Anmeldeinformation.
Web Messages
Mit dieser Tabelle können HTTP Requests an die, in der Tabelle Web Authentifizierung, hinterlegten Endpunkte erstellt und gesendet werden.
Die gesendeten Requests werden hier einen Monat lang gespeichert, dies muss allerdings in den Aufbewahrungsrichtlinien für die Tabelle mit der ID 61483 aktiviert werden.
Felder
Entry No.
Gibt die Nummer des Datensatzes an.
Date and Time
Gibt den Zeitstempel des Datensatzes an.
Method
Gibt die HTTP Request Methode an.
Target URL
Gibt die Ziel URL des Requests an.
Payload
Gibt den gesendeten Payload des Requests an.
Response
Gibt den Payload des empfangenen Responses an.
Response Reason Phrase
Gibt den http-Ursachentext des empfangenen Responses an.
Response Is Success Status
Gibt an, ob der Request akzeptiert oder abgelehnt wurde.
Response Status Code
Gibt den http-Ursachenstatuscode an.
Funktionen
CreateMessage
Mit dieser Funktion wird eine neue WebMessage anhand der übergebenen Parameter erstellt.
Parameter
RequestType Enum "Http Request Type" -> die HTTP Methode mit der der Request abgeschickt werden soll
TargetURL Text[250] -> die URL an welche die erstellte Message gesendet werden soll
RequestContent Text -> der Request Body
AddWebMessageHeader
Mit dieser Funktion wird ein HTTP Header einer bestehenden WebMessage hinzugefügt.
Parameter
HeaderType Enum "WULWebMessageHeaderTypeNVX" -> die Art des HTTP Headers (Request oder Content Header)
Name Text -> der Name des Headers
Value Text -> der Wert des Headers
AddWebMessageAuthorization
Mit dieser Funktion wird ein HTTP Header mit der konfigurierten Anmeldemethode einer bestehenden WebMessage hinzugefügt.
Parameter
HeaderType Enum "WULWebMessageHeaderTypeNVX" -> die Art des HTTP Headers (Request oder Content Header)
WebAuthorization Record "WULWebAuthorizationNVX" -> die konfigurierte Anmeldemethode
SendMessage
Mit dieser Funktion wird eine bestehende WebMessage an das definierte Webservice gesendet.
Parameter
var ResponseMessage: HttpResponseMessage -> die Antwort des Webservices welcher den Request erhalten hat
procedure ExecuteWebService(Payload: Text; WebAuthorization: Record WULWebAuthorizationNVX; EndpointURL: Text)
var
WebMessage: Record WULWebMessageNVX;
ResponseMessage: HttpResponseMessage;
BodyContent: Text;
ResponseText: Text;
begin
WebMessage.CreateMessage("Http Request Type"::POST, EndpointURL, BodyContent);
WebMessage.AddWebMessageHeader(WULWebMessageHeaderTypeNVX::"Content Header", 'Content-Type', 'application/json');
WebMessage.AddWebMessageAuthorization(WULWebMessageHeaderTypeNVX::"Request Header", WebAuthorization);
Commit();
WebMessage.SendMessage(ResponseMessage);
Commit();
ResponseText := WebMessage.GetResponse();
end;
Web Message Headers
In dieser Tabelle werden die mitgesendeten HTTP Header der zugehörigen Web Message Einträge gespeichert.
Felder
Name
Gibt den Namen des Headers an.
Value
Gibt den Wert des Headers an.
MultiPart/Form-Data Helper
Für den komplexen Content-Type MultiPart/Form-Data gibt es eine Hilfs-Codeunit zum Aufbau eines solchen Bodys.
MultiPart/Form-Data Helper
