Nuclet Unterstützende Nuclets – Nuclet: REST-Client-Utils(noch nicht verfügbar) – Referenz zum Nuclet.

Sprache: Deutsch · English

Nuclet: REST-Client-Utils(noch nicht verfügbar)

Nuclet: REST-Client-Utils(noch nicht verfügbar) – Referenz zum Nuclet.

Auf dieser Seite

Releases

Version	Datum	Hinweise	Kompatibilität
1.0.0	20.01.2023	Erste veröffentlichte Fassung	ab Nuclos 4.2022.25.1

Überblick

Dieses Nuclet unterstützt die Verwendung externer REST-Services im Regelcode.

Version 1.0

Beschreibung von Version 1.0.0

Thema	Beschreibung
REST-Protokoll	Das BO System > REST-Protokoll protokolliert alle vom Nuclet generierten Requests
Verwendung in Regeln	Die Klasse RESTUtils stellt dazu mehrere Methoden bereit

Verwendung in der Regelprogrammierung von Version 1.0.0

Klasse RESTUtils
static RESTContext execute(RESTContext restContext)	Führt einen Request durch, mit den in restContext angegebenen Parametern
Beispiel GLS Versandauftrag (JSON)
	RESTContext restContext = new RESTContext(); restContext.setAddress(credentials.getAddress()); restContext.setRequest(getRequest(credentials, bo, referenceLabel)); restContext.setReference("GLS: Post Shipment for " + referenceProtokoll); restContext.setEncoding(RESTContext.ENCODING_UTF_8); restContext.setContentType(RESTContext.FORMAT_JSON); restContext.setAcceptEncoding("gzip,deflate"); restContext.setAcceptLanguage("de"); restContext.setAccept(RESTContext.FORMAT_JSON); restContext.setAuthorization(RESTContext.Authorization.Basic); restContext.setUser(credentials.getUser()); restContext.setPassword(credentials.getPassword()); context.log("Starte Übermittlung des Lieferscheins an GLS: " + restContext.getUrlWithParameters()); RESTUtils.execute(restContext); RESTShipmentResponseGLS response = null; if (restContext.isError()) { context.log("Fehler beim Übermitteln des GLS Shipment Response: " + restContext.getErrorMessage()); } else { try { response = objectMapper.readValue(restContext.getResponse(), RESTShipmentResponseGLS.class); // ... } catch (JsonProcessingException e) { throw new BusinessException("Fehler beim Auswerten des GLS Shipment Response: " + e.getMessage()); } }
Beispiel Prüfung USt-ID (Inline)
	RESTContext result = new RESTContext(); result.setContentType(RESTContext.FORMAT_APPLICATION_X_WWW_FORM_URLENCODED); result.setEncoding(RESTContext.ENCODING_UTF_8); result.setTest(Boolean.FALSE); result.setAddress(pruefungsObjekt.getUrl()); result.addParameter(Parameter.UST_ID_1, pruefungsObjekt.getValue(Parameter.UST_ID_1)); result.addParameter(Parameter.UST_ID_2, pruefungsObjekt.getValue(Parameter.UST_ID_2)); result.addParameter(Parameter.FIRMENNAME, pruefungsObjekt.getValue(Parameter.FIRMENNAME)); result.addParameter(Parameter.ORT, pruefungsObjekt.getValue(Parameter.ORT)); result.addParameter(Parameter.PLZ, pruefungsObjekt.getValue(Parameter.PLZ)); result.addParameter(Parameter.STRASSE, pruefungsObjekt.getValue(Parameter.STRASSE)); result.setReference("Prüfung USt-ID für Prüfling " + pruefungsObjekt.getPruefling()); RESTUtils.execute(restContext);

Integration von Version 1.0.0

Die Integration nach erfolgtem Nucletimport (siehe Nuclet Import) ist wie folgt vorzunehmen.

Schritt	Beschreibung	Screenshot
1	Führen Sie einmalig den Job Initialisiere Nuclet REST-Client-Utils (unter Administration > Jobsteuerung) aus