NAVAX Extension Base

Handbuch

☰ Inhaltsverzeichnis

Allgemein

• NAVAX Extension Base
  Die NAVAX Extension Base stellt grundlegende Funktionen für NAVAX-Erweiterungen zur Verfügung...

Einrichtung

• NAVAX Lizenzverwaltung
  Die Seite NAVAX Lizenzverwaltung (in älteren Versionen NAVAX Lizenzübersicht oder NCEX Lizenzübersicht) zeigt den aktuellen Lizenzstatus der NAVAX-Erweiterungen an...
• Versionshistorie
  Die Seite Versionshistorie zeigt an, wann welche Version der Erweiterung installiert war...
• Echtdatengenehmigungen
  Echtdatengenehmigungen erweitern Aktionen und Prozesse um eine zusätzliche Sicherheitsstufe. Damit soll verhindert werden, dass Testdaten versehentlich als Echtdaten interpretiert werden. Besonders kritische Aktionen und Prozesse (z.B. das Senden von Daten an einen externen Dienst) können also nur mehr ausgeführt werden, wenn für die aktuelle Umgebung eine Echtdatengenehmigung erteilt wurde...
• NAVAX Dropzone-Einrichtung
  Auf der Seite NAVAX Dropzone-Einrichtung können die Einstellungen und Vorgaben für die verschiedenen Dropzones festgelegt werden...

Arbeiten mit NAVAX Apps

• Texteditor
  Über diese Seite kann Text angezeigt bzw. editiert werden...
• PDF-Viewer
  Diese Seite zeigt PDF-Dateien an...
• Dienstprotokoll Anfrage/Antwort
  Auf dieser Seite werden detaillierte Informationen darüber angezeigt, was an den Dienst gesendet bzw. vom Dienst zurückgegeben wurde. Die Informationen können für den technischen Support hilfreich sein...
• NAVAX News
  Auf dieser Seite werden aktuelle Neuigkeiten zu den NAVAX-Erweiterungen angezeigt...

Informationen für Entwickler

• QR-Codes
  QR-Codes können mit Hilfe der Codeunit NCEX QR Code Mgt. über die Funktion CreateQRCodeRedSoft erstellt werden...
• Texteditor
  Der Texteditor kann mit Hilfe der Codeunit NCEX Text Editor Mgt. über die Funktion EditText und ShowText aufgerufen werden...
• Dropzone
  Eine NAVAX Dropzone kann sehr einfach in eine Page integriert werden. Jede hinzugefügte Dropzone wird dabei über eine eindeutige ID angesprochen bzw. identifiziert...
• PDF-Viewer
  PDF-Dateien können mit Hilfe der Codeunit NCEX PDF Viewer Mgt. über die Funktion ShowPDF angezeigt werden...
• Dienstprotokoll Anfrage/Antwort
  Dienstprotokoll Anfragen/Antworten können mit Hilfe der Codeunit NCEX Service Log Mgt. über diverse Funktionen angezeigt werden...
• Update-Benachrichtigung
  Update-Benachrichtigungen zeigen an, ob Updates für NAVAX-Erweiterungen verfügbar sind...

Anhang

• Umgebungsbestätigungen (Veraltet)
• NAVAX Registrierung (Dynamics NAV AddOns)
  Der aktuelle Registrierungstatus eines NAVAX Dynamics NAV AddOns wird in der Einrichtung des AddOns unter System angezeigt...
• Installationshinweise
• Versionshinweise

Docs  /  NAVAX Extension Base  /  Allgemein
 NAVAX Extension Base

Navigation

Wie möchten Sie weiter verfahren

Installationshinweise

Docs  /  NAVAX Extension Base  /  Einrichtung
 NAVAX Lizenzverwaltung

Testversion

Lizenz beantragen

Lizenz aktivieren/aktualisieren

AGB & EULA

https://www.navax.app/EULA.php?L=de

Datenschutz

https://www.navax.app/privacyStatement.php?L=de

Bewertung abgeben

Docs  /  NAVAX Extension Base  /  Einrichtung
 Versionshistorie

Docs  /  NAVAX Extension Base  /  Einrichtung
 Echtdatengenehmigungen

Praktisches Beispiel

Echtdatengenehmigungen verwalten

Aktionen

• Aktuelle Umgebung genehmigen

  Erteilt eine Echtdatengenehmigung für die aktuelle Umgebung.

  Warnung

  Genehmigen Sie Ihre aktuelle Umgebung nur dann, wenn Sie sich absolut sicher sind. Sobald die Umgebung genehmigt wurde, kann die abgesicherte Aktion bzw. der abgesicherte Prozess von allen Benutzern aufgerufen bzw. durchgeführt werden. Echtdatengenehmigungen können zwar jederzeit wieder gelöscht bzw. entfernt werden, bereits durchgeführte Aktion werden dadurch allerdings nicht rückgängig gemacht.

Docs  /  NAVAX Extension Base  /  Einrichtung
 NAVAX Dropzone-Einrichtung

Docs  /  NAVAX Extension Base  /  Arbeiten mit NAVAX Apps
 Texteditor

Docs  /  NAVAX Extension Base  /  Arbeiten mit NAVAX Apps
 PDF-Viewer

Docs  /  NAVAX Extension Base  /  Arbeiten mit NAVAX Apps
 Dienstprotokoll Anfrage/Antwort

Docs  /  NAVAX Extension Base  /  Arbeiten mit NAVAX Apps
 NAVAX News

Docs  /  NAVAX Extension Base  /  Informationen für Entwickler
 QR-Codes

http://www.redsoft.at

[Docs] fiskaltrust POS Interface - Einrichtung, Registrierkasseneinrichtung

Methods

• CreateQRCodeRedSoft

  Creates a new QR Code.

  procedure CreateQRCodeRedSoft(QRCodeInput: Text; var TempBlob: Codeunit "Temp Blob"; Size: Integer): Boolean

  Parameters

  Type	Name	Description
  Text	QRCodeInput	The content of the QR Code to be created.
  Temp Blob	TempBlob	The Temp Blob in which the created QR Code is returned.
  Integer	Size	The size of the QR Code in pixel (default=200).

  
  
  

Docs  /  NAVAX Extension Base  /  Informationen für Entwickler
 Texteditor

Alles im Textfeld speichern

procedure EditText(var Text: Text; MaxLineStrLen: Integer; MaxTextLen: Integer; ReadOnly: Boolean) TextModified: Boolean

Parameter

• Text Gibt den Text an, der editiert werden soll.
• MaxLineStrLen Falls angegeben, kann damit die maximale Anzahl der Zeichen pro Zeile begrenzt werden. Der Text wird bei der Eingabe im Editor automatisch umgebrochen, falls die Länge überschritten wird. Der Umbruch versucht dabei Wörter ganz zu lassen.
• MaxTextLen Falls angegeben, kann damit die maximale Anzahl der Zeichen des gesamten Textes begrenzt werden.
• ReadOnly Gibt an, ob der Editor im schreibgeschützten Modus geöffnet werden soll. Im schreibgeschützten Modus kann der Text nicht geändert werden. Der Text kann aber markiert und Inhalte daraus können kopiert werden.

Szenario

• Nachfolgendes Beispiel zeigt die Integration des Editors in die Registrierkassenbon-Texteinrichtung. Die Tabelle verfügt über ein Textfeld mit einer Länge von 1000 Zeichen:

  ...
  field(10; "Text"; Text[1000])
  {
      DataClassification = CustomerContent;
      Caption = 'Text', Comment = 'DEU="Text"';
  }
  field(15; "Starting Date"; Date)
  {
  ...

  Da jeder Textzeile zusätzlich zum Text noch ein Startdatum und ein Enddatum hinterlegt werden kann und das Textfeld selbst groß genug ist, wurde hier nachfolgende einfache Lösung gewählt, welche den Text nicht auf mehrere Zeilen aufgesplittet. Ein Zeilenumbruch im Text ist trotzdem möglich. Wichtig dabei ist, dass das Textfeld in der Page auf Editable = false; gesetzt wird, da in dieser Lösung die Zeilenumbrüche (nicht sichtbar) ebenfalls im Textfeld gespeichert werden.

Implementierung

• Table

  ...
  procedure EditText(Editable: Boolean)
  var
      NCEXTextEditorMgt: Codeunit "NCEX Text Editor Mgt.";
      TempText: Text;
  begin
      TempText := Text;
      if not NCEXTextEditorMgt.EditText(TempText, 0, MaxStrLen(Text), not Editable) then
          exit;
      Text := CopyStr(TempText, 1, MaxStrLen(Text));
  end;
  ...

  Page

  ...
  field("Text"; Rec."Text")
  {
      ApplicationArea = All;
      ToolTip = 'Specifies the text. Click on the field to edit the text.', Comment = 'DEU="Gibt den Text an. Klicken Sie auf das Feld, um den Text zu bearbeiten."';
      Editable = false;
      AssistEdit = true;
  
      trigger OnAssistEdit()
      begin
          Rec.EditText(CurrPage.Editable());
          CurrPage.Update();
      end;
  }
  ...

Text auf mehrere Zeilen aufsplitten

procedure EditText(RecordRef: RecordRef; TextFieldNo: Integer; var TempBlob: Codeunit "Temp Blob"; ReadOnly: Boolean) TextModified: Boolean

Parameter

• RecordRef Gibt an, welche Tabelle und welche Datensätze aus der Tabelle in den Texteditor geladen werden sollen.

  Wichtig

  Es muss besonders darauf geachtet werden, dass die richtigen Filter am RecordRef gesetzt sind.
• TextFieldNo Gibt an, in welchem Feld der Text gespeichert ist.

  Hinweis

  Die maximale Anzahl der Zeichen pro Zeile (MaxLineStrLen) wird bei diesem Aufruf über die Länge des TextFieldNo-Feldes ermittelt. Der Text wird bei der Eingabe im Editor automatisch umgebrochen, falls die Länge überschritten wird. Der Umbruch versucht dabei Wörter ganz zu lassen.
• TempBlob Enthält den neuen, editierten Text.
• ReadOnly Gibt an, ob der Editor im schreibgeschützten Modus geöffnet werden soll. Im schreibgeschützten Modus kann der Text nicht geändert werden. Der Text kann aber markiert und Inhalte daraus können kopiert werden.

Szenario

• Nachfolgendes Beispiel zeigt eine mögliche Integration des Editors in die Textbausteinzeilen: Da die Tabelle "Extended Text Line" nur den Text enthält und das Textfeld mit einer Länge von 100 Zeichen nicht groß genug ist, wurde hier nachfolgende Lösung gewählt, welche den Text auf mehrere Zeilen aufgesplittet.

Implementierung

• pageextension 50000 "NVX Extended Text Lines" extends "Extended Text Lines"
  {
      actions
      {
          addfirst(Processing)
          {
              action(NVXTextEditorAction)
              {
                  ApplicationArea = All;
                  Caption = 'Text Editor', Comment = 'DEU="Texteditor"';
                  Image = Edit;
                  ToolTip = 'Edit the text in the text editor.', Comment = 'DEU="Bearbeiten Sie den Text im Texteditor."';
  
                  trigger OnAction()
                  var
                      ExtendedTextLine: Record "Extended Text Line";
                      NCEXTextEditorMgt: Codeunit "NCEX Text Editor Mgt.";
                      TempBlob: Codeunit "Temp Blob";
                      RecordRef: RecordRef;
                      InStream: InStream;
                      NextLineNo: Integer;
                      TempText: Text;
                  begin
                      Clear(ExtendedTextLine);
                      ExtendedTextLine.SetRange("Table Name", Rec."Table Name");
                      ExtendedTextLine.SetRange("No.", Rec."No.");
                      ExtendedTextLine.SetRange("Language Code", Rec."Language Code");
                      ExtendedTextLine.SetRange("Text No.", Rec."Text No.");
                      RecordRef.GetTable(ExtendedTextLine);
                      if not NCEXTextEditorMgt.EditText(RecordRef, ExtendedTextLine.FieldNo(Text), TempBlob, not CurrPage.Editable()) then
                          exit;
  
                      ExtendedTextLine.LockTable();
                      ExtendedTextLine.DeleteAll();
                      NextLineNo := 10000;
                      TempBlob.CreateInStream(InStream);
                      while (not InStream.EOS()) do begin
                          Clear(ExtendedTextLine);
                          ExtendedTextLine."Table Name" := Rec."Table Name";
                          ExtendedTextLine."No." := Rec."No.";
                          ExtendedTextLine."Language Code" := Rec."Language Code";
                          ExtendedTextLine."Text No." := Rec."Text No.";
                          ExtendedTextLine."Line No." := NextLineNo;
                          NextLineNo += 10000;
                          InStream.ReadText(TempText);
                          ExtendedTextLine.Text := CopyStr(TempText, 1, MaxStrLen(ExtendedTextLine.Text));
                          ExtendedTextLine.Insert();
                      end;
                  end;
              }
          }
      }
  }

Text in einem Blob speichern

procedure EditText(var TempBlob: Codeunit "Temp Blob"; MaxLineStrLen: Integer; MaxTextLen: Integer; ReadOnly: Boolean) TextModified: Boolean

Parameter

• TempBlob Enthält den Text, der editiert werden soll.
• MaxLineStrLen Falls angegeben, kann damit die maximale Anzahl der Zeichen pro Zeile begrenzt werden. Der Text wird bei der Eingabe im Editor automatisch umgebrochen, falls die Länge überschritten wird. Der Umbruch versucht dabei Wörter ganz zu lassen.
• MaxTextLen Falls angegeben, kann damit die maximale Anzahl der Zeichen des gesamten Textes begrenzt werden.
• ReadOnly Gibt an, ob der Editor im schreibgeschützten Modus geöffnet werden soll. Im schreibgeschützten Modus kann der Text nicht geändert werden. Der Text kann aber markiert und Inhalte daraus können kopiert werden.

Szenario

• Wenn der Text direkt zum Datensatz gespeichert werden soll (d.h. keine Aufsplittung auf mehrere Datensätze) und die Lösung über ein Textfeld aufgrund der begrenzten Feldlänge (je nach Definition max. 2048 Zeichen) nicht in Frage kommt, kann der Text auch in einem Blob-Feld gespeichert werden. Optional kann ein weiteres Feld angelegt werden, welches eine Vorschau auf den Inhalt des Blob-Feldes anzeigt. Nachfolgendes Beispiel zeigt eine mögliche Lösung.

Implementierung

• Table

  ...
  field(50000; "Text Preview"; Text[250])
  {
      DataClassification = CustomerContent;
      Caption = 'Text Preview', Comment = 'DEU="Textvorschau"';
  }
  field(50001; "Text Storage"; Blob)
  {
      DataClassification = CustomerContent;
      Caption = 'Text Storage', Comment = 'DEU="Textspeicher"';
  }
  
  procedure EditText(Editable: Boolean)
  var
      NCEXTextEditorMgt: Codeunit "NCEX Text Editor Mgt.";
      TempBlob: Codeunit "Temp Blob";
      InStream: InStream;
      OutStream: OutStream;
      NewText: Text;
  begin
      CalcFields("Text Storage");
      "Text Storage".CreateInStream(InStream);
      TempBlob.CreateOutStream(OutStream);
      CopyStream(OutStream, InStream);
      if not NCEXTextEditorMgt.EditText(TempBlob, 0, 0, not Editable) then
          exit;
      TempBlob.CreateInStream(InStream);
      InStream.Read(NewText);
      SaveText(NewText);
  end;
  
  procedure SaveText(NewText: Text)
  var
      OutStream: OutStream;
  begin
      "Text Storage".CreateOutStream(OutStream);
      OutStream.Write(NewText);
      "Text Preview" := CopyStr(NewText, 1, MaxStrLen("Text Preview"));
  end;
  ...

  Page

  ...
  field("Text Preview"; Rec."Text Preview")
  {
      ApplicationArea = All;
      ToolTip = 'Specifies the text. Click on the field to edit the text.', Comment = 'DEU="Gibt den Text an. Klicken Sie auf das Feld, um den Text zu bearbeiten."';
      Editable = false;
      AssistEdit = true;
  
      trigger OnAssistEdit()
      begin
          Rec.EditText(CurrPage.Editable());
          CurrPage.Update();
      end;
  }
  ...

Docs  /  NAVAX Extension Base  /  Informationen für Entwickler
 Dropzone

Szenario

• Auf der Debitorenliste (Page 22 "Customer List") soll eine Dropzone bereitgestellt werden, mit der Beleganhänge per Drag & Drop hinzugefügt werden können:

  Hinweis

  Dieses Beispiel dient nur zur Veranschaulichung der einfachsten Implementierung. Für Beleganhänge wird empfohlen die NAVAX App NAVAX Drag & Drop Beleganhänge (Drag & Drop Document Attachments) zu verwenden. Diese App basiert ebenfalls auf der NAVAX Dropzone, integriert diese aber direkt in die Beleganhang-FactBox. Weitere Informationen dazu finden Sie unter [Docs] NAVAX Drag & Drop Beleganhänge - Allgemein

Implementierung

1. enumextension Eine NAVAX Dropzone löst bei einem erfolgreichen "Drag & Drop" das OnAfterUpload-Event aus. Der Parameter NCEXDropzoneID des Events gibt dabei an, welche Dropzone das Event ausgelöst hat. Für jede neue Dropzone muss eine eigene NCEXDropzoneID definiert werden, damit diese im Event auch eindeutig identifiziert werden kann. Eine neue NCEXDropzoneID wird über eine enumextension hinzugefügt bzw. angelegt:

   enumextension 50000 "NVXTEST NCEX Dropzone ID" extends "NCEX Dropzone ID"
   {
       value(50000; "NVXTEST Customer")
       {
           Caption = 'NVXTEST Customer', Comment = 'DEU="NVXTEST Debitor"';
       }
   }

   Durch diese Enum-Erweiterung hat der Kunde später auf der Seite NAVAX Dropzone-Einrichtung auch die Möglichkeit, die Einstellungen und Vorgaben für die neue Dropzone einzurichten:
   
2. Dropzone hinzufügen Die neue Dropzone kann danach z.B. als FactBox zur Debitorenliste hinzugefügt werden:

   pageextension 50000 "NVXTEST Customer List" extends "Customer List"
   {
       layout
       {
           addfirst(factboxes)
           {
               part(NVXTESTDropzone; "NCEX Dropzone")
               {
                   ApplicationArea = All;
                   Visible = true;
               }
           }
       }
   
       trigger OnOpenPage()
       begin
           CurrPage.NVXTESTDropzone.Page.SetDropzoneID("NCEX Dropzone ID"::"NVXTEST Customer");
       end;
   
       trigger OnAfterGetCurrRecord()
       begin
           CurrPage.NVXTESTDropzone.Page.SetCurrRecord(Rec);
       end;
   }

   Hinweis

   Dieser Block:

   trigger OnAfterGetCurrRecord()
   begin
       CurrPage.NVXTESTDropzone.Page.SetCurrRecord(Rec);
   end;

   kann auch weggelassen werden, falls man z.B. eine Dropzone benötigt, die nicht Datensatzbezogen arbeitet. (z.B. Import von Zahlungsdateien der NAVAX App NCPI Zahlungsverkehr Import)

   Hinweis

   Für die Funktion SetDropzoneID steht auch eine Überladung mit folgenden zusätzlichen Parametern zur Verfügung:

   • AdditionalCallID Kann frei verwendet werden, und wird dem OnAfterUpload-Event übergeben. Teilen sich z.B. mehrere Pages die selbe NCEXDropzoneID, kann man z.B. als Parameter die ID der Page (z.B. Page::"Purchase Invoices") angeben und später im Event abfragen.
   • AdditionalDropzoneText Kann wenn erforderlich verwendet werden, um den Benutzern zusätzliche Informationen im Dropzone-Bereich anzuzeigen.
   
   
3. OnAfterUpload-Event Im letzten Schritt muss jetzt auf das OnAfterUpload-Event der Dropzone reagiert werden:

   codeunit 50000 "NVXTEST Event Mgt."
   {
       [EventSubscriber(ObjectType::Codeunit, Codeunit::"NCEX Dropzone Mgt.", 'OnAfterUpload', '', false, false)]
       local procedure NVXTEST_NCEXDropzoneMgt_OnAfterUpload(NCEXDropzoneID: Enum "NCEX Dropzone ID"; CurrRecordVariant: Variant; var UploadedTempBlobList: Codeunit "Temp Blob List"; FileNameList: List of [Text]; AdditionalCallID: Integer)
       var
           Customer: Record Customer;
           DocumentAttachment: Record "Document Attachment";
           TempBlob: Codeunit "Temp Blob";
           ConfirmManagement: Codeunit "Confirm Management";
           RecordRef: RecordRef;
           InStream: InStream;
           FileName: Text;
           i: Integer;
           NoOfFiles: Integer;
           NoOfNoContentFiles: Integer;
           NoRecordSelectedErr: Label 'No %1 is selected.', Comment = 'DEU="Es ist kein %1 ausgewählt."';
           UploadMsg: Label 'Do you want to add %1 file(s) to the document attachments of %2 ''%3''?.', Comment = 'DEU="Möchten Sie %1 Datei(en) zu den Beleganhängen von %2 ''%3'' hinzufügen?"';
           NoContentFilesMsg: Label 'Files that have no content cannot be added to the document attachments.\\Number of files not added: %1\Number of files added: %2', Comment = 'DEU="Dateien, die keinen Inhalt haben, können nicht zu den Beleganhängen hinzugefügt werden.\\Anzahl nicht hinzugefügter Dateien: %1\Anzahl hinzugefügter Dateien: %2"';
       begin
           if (NCEXDropzoneID <> NCEXDropzoneID::"NVXTEST Customer") then
               exit;
   
           if (UploadedTempBlobList.Count() = 0) then
               exit;
   
           if not CurrRecordVariant.IsRecord() then
               Error(NoRecordSelectedErr, Customer.TableCaption());
           Customer := CurrRecordVariant;
           if (Customer."No." = '') then
               Error(NoRecordSelectedErr, Customer.TableCaption());
           Customer.Get(Customer."No.");
   
           if not ConfirmManagement.GetResponseOrDefault(StrSubstNo(UploadMsg, UploadedTempBlobList.Count(), Customer.TableCaption(), Customer."No."), true) then
               exit;
   
           RecordRef.GetTable(Customer);
           NoOfFiles := 0;
           NoOfNoContentFiles := 0;
           for i := 1 to UploadedTempBlobList.Count() do begin
               UploadedTempBlobList.Get(i, TempBlob);
               if TempBlob.HasValue() then begin
                   FileNameList.Get(i, FileName);
                   TempBlob.CreateInStream(InStream);
                   Clear(DocumentAttachment);
                   DocumentAttachment.Init();
                   DocumentAttachment.InitFieldsFromRecRef(RecordRef);
                   DocumentAttachment.SaveAttachmentFromStream(InStream, RecordRef, FileName);
                   NoOfFiles += 1;                
               end else
                   NoOfNoContentFiles += 1;
           end;
   
           if (NoOfNoContentFiles <> 0) then
               Message(NoContentFilesMsg, NoOfNoContentFiles, NoOfFiles);
       end;
   }

   Wichtig

   if (NCEXDropzoneID <> NCEXDropzoneID::"NVXTEST Customer") then
       exit;

   Diese if-Bedingung entscheidet darüber, für welche Dropzone der Code ausgeführt werden soll und darf auf keinen Fall weggelassen werden. Der Wert muss mit dem hinzugefügten Wert aus der enumextension übereinstimmen.

Docs  /  NAVAX Extension Base  /  Informationen für Entwickler
 PDF-Viewer

Methods

• ShowPDF

  Displays a pdf in a new page.

  procedure ShowPDF(PDFTempBlob: Codeunit "Temp Blob")

  Parameters

  Type	Name	Description
  Temp Blob	PDFTempBlob	Contains the pdf file to be displayed.

  
  
  

• ShowPDF

  Displays a pdf in a new page.

  procedure ShowPDF(PDFFieldRef: FieldRef)

  Parameters

  Type	Name	Description
  FieldRef	PDFFieldRef	The field that contains the pdf file to be displayed.

  
  
  

• ShowPDF

  Displays a pdf in a new page.

  procedure ShowPDF(Base64PDFTXT: Text)

  Parameters

  Type	Name	Description
  Text	Base64PDFTXT	The field that contains the pdf file to be displayed.

  
  
  

Docs  /  NAVAX Extension Base  /  Informationen für Entwickler
 Dienstprotokoll Anfrage/Antwort

Methods

• ShowJSONRequestResponse

  Displays a JSON format request/response in a new page.

  procedure ShowJSONRequestResponse(RequestFieldRef: FieldRef; ResponseFieldRef: FieldRef)
  procedure ShowJSONRequestResponse(RequestFieldRef: FieldRef; RequestJSONPartFieldRef: FieldRef; ResponseFieldRef: FieldRef; ResponseJSONPartFieldRef: FieldRef)

  Parameters

  Type	Name	Description
  FieldRef	RequestFieldRef	The field that contains the request to be displayed.
  FieldRef	[Optional] RequestJSONPartFieldRef	The field that contains the JSON part of the request to be displayed.
  FieldRef	ResponseFieldRef	The field that contains the response to be displayed.
  FieldRef	[Optional] ResponseJSONPartFieldRef	The field that contains the JSON part of the response to be displayed.

  
  
  

• ShowJSONRequest

  Displays a JSON format request in a new page.

  procedure ShowJSONRequest(RequestFieldRef: FieldRef)
  procedure ShowJSONRequest(RequestFieldRef: FieldRef; RequestJSONPartFieldRef: FieldRef)

  Parameters

  Type	Name	Description
  FieldRef	RequestFieldRef	The field that contains the request to be displayed.
  FieldRef	[Optional] RequestJSONPartFieldRef	The field that contains the JSON part of the request to be displayed.

  
  
  

• ShowJSONResponse

  Displays a JSON format response in a new page.

  procedure ShowJSONResponse(ResponseFieldRef: FieldRef)
  procedure ShowJSONResponse(ResponseFieldRef: FieldRef; ResponseJSONPartFieldRef: FieldRef)

  Parameters

  Type	Name	Description
  FieldRef	ResponseFieldRef	The field that contains the response to be displayed.
  FieldRef	[Optional] ResponseJSONPartFieldRef	The field that contains the JSON part of the response to be displayed.

  
  
  

• ShowXMLRequestResponse

  Displays a XML format request/response in a new page.

  procedure ShowXMLRequestResponse(RequestFieldRef: FieldRef; ResponseFieldRef: FieldRef)
  procedure ShowXMLRequestResponse(RequestFieldRef: FieldRef; RequestXMLPartFieldRef: FieldRef; ResponseFieldRef: FieldRef; ResponseXMLPartFieldRef: FieldRef)

  Parameters

  Type	Name	Description
  FieldRef	RequestFieldRef	The field that contains the request to be displayed.
  FieldRef	[Optional] RequestXMLPartFieldRef	The field that contains the XML part of the request to be displayed.
  FieldRef	ResponseFieldRef	The field that contains the response to be displayed.
  FieldRef	[Optional] ResponseXMLPartFieldRef	The field that contains the XML part of the response to be displayed.

  
  
  

• ShowXMLRequest

  Displays a XML format request in a new page.

  procedure ShowXMLRequest(RequestFieldRef: FieldRef)
  procedure ShowXMLRequest(RequestFieldRef: FieldRef; RequestXMLPartFieldRef: FieldRef)

  Parameters

  Type	Name	Description
  FieldRef	RequestFieldRef	The field that contains the request to be displayed.
  FieldRef	[Optional] RequestXMLPartFieldRef	The field that contains the XML part of the request to be displayed.

  
  
  

• ShowXMLResponse

  Displays a XML format response in a new page.

  procedure ShowXMLResponse(ResponseFieldRef: FieldRef)
  procedure ShowXMLResponse(ResponseFieldRef: FieldRef; ResponseXMLPartFieldRef: FieldRef)

  Parameters

  Type	Name	Description
  FieldRef	ResponseFieldRef	The field that contains the response to be displayed.
  FieldRef	[Optional] ResponseXMLPartFieldRef	The field that contains the XML part of the response to be displayed.

  
  
  

Docs  /  NAVAX Extension Base  /  Informationen für Entwickler
 Update-Benachrichtigung

trigger OnAfterGetCurrRecord()
var
    AppInfo: ModuleInfo;
    UpdateTaskParameters: Dictionary of [Text, Text];
begin
    Clear(UpdateTaskID);
    NavApp.GetCurrentModuleInfo(AppInfo);
    UpdateTaskParameters.Add('AppID', AppInfo.Id());
    CurrPage.EnqueueBackgroundTask(UpdateTaskID, Codeunit::"NCEX Check Update Status Mgt.", UpdateTaskParameters, 0, PageBackgroundTaskErrorLevel::Ignore);
end;

var
    UpdateTaskID: Integer;

trigger OnPageBackgroundTaskCompleted(TaskId: Integer; Results: Dictionary of [Text, Text])
var
    NCEXCheckUpdateStatusMgt: Codeunit "NCEX Check Update Status Mgt.";
begin
    if (TaskId = UpdateTaskID) then
        NCEXCheckUpdateStatusMgt.ShowUpdateNotification(Results);
end;

Docs  /  NAVAX Extension Base  /  Anhang
 Umgebungsbestätigungen (Veraltet)

Beispiel

Prüfung und Bestätigung

• Umgebungen, die als Produktion eingestellt sind, können als Produktionsumgebung oder als Sandboxumgebung bestätigt werden. Wenn Sie die Umgebung als Produktionsumgebung bestätigen, werden alle Informationen als Echtdaten interpretiert. Wenn Sie die Umgebung als Sandboxumgebung bestätigen, werden alle Informationen als Testdaten interpretiert und die Aktion bzw. der Prozess darf erst dann ausgeführt werden, wenn auch die aktuelle Umgebung als Sandbox eingestellt ist. Bei der Bereitstellung über On-Premises sollten bzw. müssen Test- und Entwicklungsdatenbanken als Sandboxumgebung bestätigt werden.

  Warnung

  Bestätigen Sie Ihre aktuelle Umgebung nur dann, wenn Sie sich absolut sicher sind. Sobald die Umgebung bestätigt wurde, ist die Aktion bzw. der Prozess für alle Benutzer bestätigt. Bereits bestätigte Umgebungen können zwar jederzeit gelöscht werden, bereits durchgeführte Aktion werden dadurch allerdings nicht rückgängig gemacht.
• Umgebungen, die als Sandbox eingestellt sind, können nicht als Produktionsumgebung bestätigt werden. Die Bestätigung als Sandboxumgebung ist aus Sicherheitsgründen trotzdem notwendig.

Eine Bestätigung ändern

Aktionen

• Aktuelle Umgebung bestätigen

  Bestätigt die aktuelle Umgebung als Produktionsumgebung oder als Sandboxumgebung.

Docs  /  NAVAX Extension Base  /  Anhang
 NAVAX Registrierung (Dynamics NAV AddOns)

Testversion

Registrierung beantragen

Hinweis

Für die Registrierung, den Aufruf der Onlinehilfe und das Ausführen einiger Aktionen muss der Zugriff auf https://www.nccube.com und https://www.navax.app erlaubt sein. Zusätzlich ist TLS 1.2 erforderlich. Weitere Informationen dazu finden Sie unter How to get earlier versions of the Dynamics NAV development environment to work with TLS 1.2 Public IP von www.navax.app für die Freischaltung an der Firewall: 94.136.22.236, Port: TCP/443 Prüfung der Verbindung zu https://www.navax.app mittels PS: Test-NetConnection navax.app -port 443 (PS muss mit dem M-Tier Service-User ausgeführt werden) CRL-Server Zusätzlich müssen für die Zertifikatsprüfung auch folgende CRL-Server erreichbar sein: https://certificates.godaddy.com/* http://crl.godaddy.com/* oder deren IP: 192.124.249.36

Registrierung aktivieren/aktualisieren

AGB & EULA

https://www.navax.app/EULA.php?L=de

Datenschutz

https://www.navax.app/privacyStatement.php?L=de

Docs  /  NAVAX Extension Base  /  Anhang
 Installationshinweise

Veröffentlichen und Installieren der Erweiterung

[Microsoft Learn] Business Central - Publishing and Installing an Extension

On-Premises

• 1010860 Extension Base by NAVAX

Externe Adressen

• https://www.navax.app

  Für die Lizenzierung, den Aufruf der Onlinehilfe und das Ausführen einiger Aktionen muss der Zugriff auf https://www.navax.app erlaubt sein.
  
  Public IP von www.navax.app für die Freischaltung an der Firewall:
  94.136.22.236, Port: TCP/443
  
  Prüfung der Verbindung zu https://www.navax.app mittels PS:
  Test-NetConnection navax.app -port 443
  (PS muss mit dem M-Tier Service-User ausgeführt werden)
  
  CRL-Server
  Zusätzlich müssen für die Zertifikatsprüfung auch folgende CRL-Server erreichbar sein:
  https://certificates.godaddy.com/*
  http://crl.godaddy.com/*
  oder deren IP: 192.124.249.36

• https://qr01.navax.com:8080

  Für die Erstellung der QR Codes über die Funktion CreateQRCodeRedSoft muss der Zugriff auf https://qr01.navax.com:8080 erlaubt sein.
  
  Prüfung der Verbindung zu https://qr01.navax.com:8080 mittels PS:
  Test-NetConnection qr01.navax.com -port 8080
  (PS muss mit dem M-Tier Service-User ausgeführt werden)

Docs  /  NAVAX Extension Base  /  Anhang
 Versionshinweise

Version 24.2.6.1

• Hinweis

  Diese Version ist auch als Downgrade-Version für Business Central 21, 20 und 14 verfügbar.

• Fehlerbehebungen

• • Korrektur im Zusammenhang mit der Entfernung veralteter Codeteile.

Version 24.2.6.0

• Verbesserungen

• • Wenn HttpClient-Anfragen in den Einstellungen der NAVAX Extension Base Erweiterung nicht zugelassen sind, wird nun eine verbesserte Fehlermeldung angezeigt.

Version 24.2.5.0

• Verbesserungen

• • Die Anzeige der Anfrage/Antwort eines Dienstprotokolls unterstützt jetzt auch XML. Weitere Informationen dazu finden Sie unter Informationen für Entwickler, Dienstprotokoll Anfrage/Antwort.

Version 24.2.4.0

• Änderungen

• • Verbesserung der User Experience.
  • Entfernung veralteter Codeteile.
  • Das Logo der Erweiterung wurde geändert.

Version 24.2.3.0

• Verbesserungen

• • Optimierung der Online-Kommunikation.

Version 24.2.2.0

• Verbesserungen

• • Echtdatengenehmigungen können jetzt für bestimmte Erweiterungen auch in einer Business Central Sandboxumgebung zugelassen werden.

Version 24.2.1.0

• Business Central Update

Version 21.2.1.0

• Verbesserungen

• • Die Anzeige der Anfrage/Antwort eines Dienstprotokolls unterstützt jetzt auch Json Arrays. Weitere Informationen dazu finden Sie unter Informationen für Entwickler, Dienstprotokoll Anfrage/Antwort.

Version 21.2.0.0

• Neuer Produktname

• • Die Erweiterung NCEX Extension Base wurde umbenannt in NAVAX Extension Base.

Version 21.1.17.0

• Verbesserungen

• • Die Seite NAVAX Lizenzverwaltung zeigt jetzt Benachrichtigungen an, wenn Updates für NAVAX-Erweiterungen verfügbar sind. Entwickler können eine Update-Benachrichtigung auch auf der Einrichtungsseite der Erweiterung hinzufügen. Weitere Informationen dazu finden Sie unter Informationen für Entwickler, Update-Benachrichtigung.

Version 21.1.16.0

• Verbesserungen

• • Die Seite NAVAX Lizenzverwaltung unterstützt jetzt das automatische Hinzufügen von NAVAX-Erweiterungen. Bei NAVAX-Erweiterungen, die dieses System nutzen, muss nicht mehr zuerst die entsprechende Einrichtung der Erweiterung geöffnet werden, damit sie in dieser Seite angezeigt werden.

Version 21.1.15.0

• Wichtig

  Für On-Premises ist eine Aktualisierung der Lizenz bzw. folgender Granules erforderlich:

  • 1010860 Extension Base by NAVAX

• Verbesserungen

• • Funktionalität zur Anzeige von PDF-Dateien wurde hinzugefügt. Weitere Informationen dazu finden Sie unter Informationen für Entwickler, PDF-Viewer.
  • Funktionalität zur Anzeige der Anfrage/Antwort eines Dienstprotokolls wurde hinzugefügt. Weitere Informationen dazu finden Sie unter Informationen für Entwickler, Dienstprotokoll Anfrage/Antwort.
  • Im Texteditor wurde die Funktion ShowText hinzugefügt. Die Funktion ist nur zum Anzeigen und nicht zum Bearbeiten eines Textes gedacht. Weitere Informationen dazu finden Sie unter Informationen für Entwickler, Texteditor.
  • Zur Dropzone wurde die Funktion ShowDropzoneSetup hinzugefügt. Weitere Informationen dazu finden Sie unter Informationen für Entwickler, Dropzone.

• Änderungen

• • Umgebungsbestätigungen wurden durch Echtdatengenehmigungen ersetzt und sollten nicht mehr verwendet werden. Weitere Informationen dazu finden Sie unter Einrichtung, Echtdatengenehmigungen.

Version 21.1.14.0

• Verbesserungen

• • Die NAVAX Lizenzübersicht wurde umbenannt in NAVAX Lizenzverwaltung.
  • Die Seite NAVAX News wurde hinzugefügt. Die Seite zeigt aktuelle Neuigkeiten zu den NAVAX-Erweiterungen an und kann direkt oder über die NAVAX Lizenzverwaltung aufgerufen werden.
  • Für Entwickler wurden der Dropzone-Funktion SetDropzoneID die zusätzlichen Parameter AdditionalCallID und AdditionalDropzoneText hinzugefügt. Weitere Informationen dazu finden Sie unter Informationen für Entwickler, Dropzone.

Version 21.1.13.0

• Verbesserungen

• • Da es vermehrt Anfragen zur Wiedereinführung der automatischen Lizenzverlängerung gab, haben wir beschlossen, diese Funktion in leicht veränderter Form wieder zur Verfügung zu stellen. Folgende Änderungen wurden vorgenommen:
    • Die automatischen Lizenzverlängerung wird jetzt nicht mehr automatisch aktiviert, sondern muss für jede Erweiterung manuell in der NAVAX Lizenzübersicht aktiviert werden.
    • Die Lizenzprüfung (und damit auch die automatischen Lizenzverlängerung) wird in den letzten 7 Tagen vor Ablauf der Lizenz nicht mehr vermehrt aufgerufen.
    • Informationen für Entwickler: Falls erforderlich, kann die automatische Lizenzverlängerung beim Aufruf der Lizenzprüfung über den Parameter SkipAutoLicenseRenewal übersprungen werden.
    Weitere Informationen dazu finden Sie unter Einrichtung, NAVAX Lizenzverwaltung.

Version 21.1.12.1

• Fehlerbehebungen

• • Korrektur im Zusammenhang mit der deaktivierten automatischen Lizenzverlängerung.

Version 21.1.12.0

• Verbesserungen

• • Der Lizenzierungsprozess wurde verbessert.

• Änderungen

• • In der NAVAX Lizenzübersicht wurde die Einstellung Automatische Lizenzverlängerung deaktiviert und entfernt. Weitere Informationen dazu finden Sie unter Einrichtung, NAVAX Lizenzverwaltung.

Version 21.1.11.0

• Verbesserungen

• • Der Lizenzierungsprozess wurde verbessert.

• Fehlerbehebungen

• • Einige Meldungen im Bereich Umgebungsbestätigungen wurden korrigiert.

Version 21.1.10.0

• Business Central Update

• Verbesserungen

• • Grundlegende Funktionalität zur Erstellung von Dropzones hinzugefügt. Weitere Informationen dazu finden Sie unter Informationen für Entwickler, Dropzone.
  • Es stehen jetzt 2 Berechtigungssätze zur Verfügung. Weitere Informationen dazu finden Sie unter Allgemein, NAVAX Extension Base.

Version 20.1.9.0

• Verbesserungen

• • Die Online-Kommunikation zeigt jetzt mehr Details an, falls die Verbindung fehlschlägt.

Version 20.1.8.0

• Verbesserungen

• • Die Aktualisierung der Lizenz ist jetzt auch über einen Freischaltungscode möglich. Weitere Informationen dazu finden Sie unter Einrichtung, NAVAX Lizenzverwaltung.
  • In der NAVAX Lizenzübersicht kann die Aktion Aktueller Status jetzt auch für "Derzeit nicht installiert"-Einträge aufgerufen werden. Der Aufruf zeigt dann, um welche Erweiterung es sich dabei handelt.

Version 20.1.7.0

• Änderungen

• • Die Funktion UpdateWebPageViewer im Texteditor ist jetzt nicht mehr local.

Version 20.1.6.0

• Änderungen

• • Der Zusatz "by NAVAX" wurde aus dem Produktnamen entfernt.

Version 20.1.5.0

• Business Central Update

• Verbesserungen

• • In der NAVAX Lizenzübersicht wurde die Einstellung Automatische Lizenzverlängerung hinzugefügt. Weitere Informationen dazu finden Sie unter Einrichtung, NAVAX Lizenzverwaltung.
  • In der NAVAX Lizenzübersicht wurde die Aktion Bewertung abgeben hinzugefügt. Weitere Informationen dazu finden Sie unter Einrichtung, NAVAX Lizenzverwaltung.

Version 19.1.4.0

• Änderungen

• • Die Lizenzierung einer NAVAX-Erweiterung ist jetzt nur mehr in der Produktionsumgebung notwendig. In der Sandboxumgebung können NAVAX-Erweiterungen jetzt unbegrenzt getestet werden. Eine Aktualisierung der Lizenz in einer Sandboxumgebung ist nicht mehr möglich. Weitere Informationen dazu finden Sie unter Einrichtung, NAVAX Lizenzverwaltung.
  • Es werden jetzt innerhalb der letzten 7 Tage (bisher 3 Tage) vor Ablauf der Lizenz vermehrt Hinweise angezeigt.

Version 19.1.3.0

• Verbesserungen

• • Texteditor hinzugefügt. Weitere Informationen dazu finden Sie unter Informationen für Entwickler, Texteditor.

• Änderungen

• • Die Aktion What's New? in der NAVAX Lizenzübersicht wurde umbenannt in Aktueller Status. Die Statusinformationen werden jetzt nicht mehr in einem separaten Browserfenster geöffnet, sondern direkt in Business Central.

Version 19.1.2.0

• Quality of life update

Version 19.1.1.0

• Business Central Update

• Änderungen

• • Die Parameter der Lizenzprüfung wurden geändert.

Version 18.1.0.0

• Änderungen

• • Die Commits in Verbindung mit der Lizenzprüfung wurden entfernt.

Version 18.0.1.0

• Änderungen

• • Die Funktion CreateQRCode der Codeunit NCEX QR Code Mgt. wurde ersetzt durch die Funktionen CreateQRCodeRedSoft und CreateQRCodeTECIT. Weitere Informationen dazu finden Sie unter Informationen für Entwickler, QR-Codes.

Version 18.0.0.0

• Business Central Update

• Änderungen

• • In den Umgebungsbestätigungen wird der Servername jetzt bei einer SaaS-Infrastruktur fix auf den Wert 'SaaS' gesetzt.

Version 17.0.1.0

• Verbesserungen

• • Umgebungsbestätigungen hinzugefügt. Weitere Informationen dazu finden Sie unter Anhang, Umgebungsbestätigungen (Veraltet).
  • Grundlegende Funktionalität zur Erstellung von QR-Codes hinzugefügt. Weitere Informationen dazu finden Sie unter Informationen für Entwickler, QR-Codes.

• Änderungen

• • Die Seite NCEX Lizenzübersicht wurde umbenannt in NAVAX Lizenzübersicht.

Version 17.0.0.0

• Ursprungsversion