Einrichtung einer Schnellkonfiguration für Document Central

Document Central kann mit Code erweitert werden, der eine schnelle Konfiguration mit einem Klick ermöglicht. In dieser Dokumentation haben wir als Beispiel die Funktionen in 3 Aktionen aufgeteilt, um eine bessere Erklärung zu gewährleisten. Es ist jedoch auch möglich, die folgenden 3 Funktionen als eine Aktion zu implementieren, was in einem späteren Abschnitt erklärt wird.

Funktionsübersicht

Es wurde eine neue Codeunit mit vier Funktionen hinzugefügt.

3 Funktionen für separate Konfiguration:

• Importieren einer Konfiguration (ImportConfiguration)
• Erstellen eines Repository-Eintrags (CreateRepository)
• Veröffentlichen von Document Central im Repository (PublishDMS)

Funktion für die Ausführung aller oben genannten Funktionalitäten:

• Ausführen aller oben genannten Funktionen (CompleteConfiguration)

Die folgende Dokumentation beschreibt die Parameter der Funktionen und wie sie als Beispiel implementiert werden.

Importieren einer Konfiguration

Für den Import einer Konfiguration für das Document Central muss eine Aktion in einem benutzerdefinierten Bereich erstellt werden, die den folgenden Code enthält.

Parameter

Name	Datentyp	Beschreibung
ParamBase64Text	Text	Enthält die Konfiguration als Base64-String, die in das System importiert wird

Info

Die Konfigurationsdatei, die für diesen Prozess verwendet wird, kann mit dem Konfigurations-Assistenten erstellt werden

Codebeispiel

Das folgende Codebeispiel öffnet einen Datei-Explorer, in dem die Produktkonfiguration ausgewählt werden kann, die Sie in Business Central importieren möchten.

    trigger OnAction()
    var
       LocalCodeunitSIMDMSConfiguration: Codeunit "SIM_DMS Configuration";
       LocalCodeunitTempBlob: Codeunit "Temp Blob";
       LocalCodeunitBase64Convert: Codeunit "Base64 Convert";
       GlobalCodeunitFileManagement: Codeunit "File Management";
       LocalInStream: InStream;
       LocalBase64StringText: Text;
       LocalconfigText: Text;
    begin
       Clear(LocalCodeunitTempBlob);
       GlobalCodeunitFileManagement.BLOBImportWithFilter(LocalCodeunitTempBlob, 'Importdatei wählen', '', 'Alle Dateien (*.*)|*.*', '*.*');
       if not LocalCodeunitTempBlob.HasValue() then exit;
       LocalCodeunitTempBlob.CreateInStream(LocalInStream, TextEncoding::UTF8);
       LocalInStream.Read(LocalconfigText);

       if LocalconfigText = '' then exit;

       LocalBase64StringText:= LocalCodeunitBase64Convert.ToBase64(LocalconfigText);
       LocalCodeunitSIMDMSConfiguration.ImportConfiguration(LocalBase64StringText);
    end;

Erstellen eines Repository-Eintrags

Für das Erstellen eines Repository-Eintrags für das Document Central muss eine Aktion in einem benutzerdefinierten Bereich erstellt werden, die den folgenden Code enthält.

Parameter

Name	Datentyp	Subtyp	Länge	Beschreibung
ParamRepositoryCode	Code		10	Gibt den Namen des Repositories an
ParamEnumSIMDMSArchiveSystem	Enum	"SIM_DMS Archive System"		Gibt den Typ des Repositories an (SharePoint/Datenbank)
ParamRepositorieserverURLText	Text		250	Gibt die URL des Repositories an. Geben Sie die URL ohne den Suffix "/" ein.
ParamEnumSIMCOREAuthenticationMode	Enum	"SIM_CORE Authentication Mode"		Gibt die Authentifizierungsmethode an. Es wird zwischen SharePoint On-Premise mit Kerberos- oder NTLM-Authentifizierung, SharePoint-Formularauthentifizierung und SharePoint Online-Authentifizierung unterschieden.
ParamEnumSIMCOREAuthenticationType	Enum	"SIM_CORE Authentication Type"		Gibt den Authentifizierungstyp an. Bei Verwendung der Basisauthentifizierung mit aktivierter Multi-Faktor-Authentifizierung muss als Benutzerpasswort ein App-Passwort verwendet werden. Bei Verwendung der Modernen Authentifizierung müssen eine Client-ID, eine Mandanten-ID und ein Client-Geheimnis verwendet werden.
ParamRepositoryLangaugeID	Integer			Gibt die Sprache des Repositories an.
ParamAppNameText	Text		250	Gibt den Namen für die Azure AD-Anwendung an
ParamClientIDText	Text		250	Gibt die Client-ID für die Authentifizierung an
ParamTenantIDText	Text		250	Gibt die Mandanten-ID für die Authentifizierung an
ParamClientSecretText	Text		250	Gibt das Client-Geheimnis für die Authentifizierung an
ParamRedirectUrlText	Text		250	Gibt die Umleitungs-URL nach der Authentifizierung an
ParamTenantNameText	Text		250	Gibt den Mandantennamen für die Authentifizierung an

Codebeispiel

Das folgende Codebeispiel erstellt einen Document Central-Repository-Eintrag mit den als Parameter für die Funktion CreateRepository festgelegten Werten, und der Repository-Code wird in die Document Central - Modul Einrichtung eingefügt.

Warning

Wenn bereits ein Repository-Eintrag mit demselben Repository-Code vorhanden ist, wird der vorhandene Repository-Eintrag verwendet

    trigger OnAction()
    var
       LocalCodeunitSIMDMSCompanyConfiguration: Codeunit "SIM_DMS Configuration";
       LocalEnumSIMDMSArchiveSystem: Enum "SIM_DMS Archive System";
       LocalEnumSIMCOREAuthenticationMode: Enum "SIM_CORE Authentication Mode";
       LocalEnumSIMCOREauthenticationType: Enum "SIM_CORE Authentication Type";
    begin
       LocalCodeunitSIMDMSCompanyConfiguration.CreateRepository('SharePoint', LocalEnumSIMDMSArchiveSystem::SharePoint, 'https://tegos.sharepoint.com/sites/simova-portal/archivtestseiten/SampleRepository', LocalEnumSIMCOREAuthenticationMode::SharePointOnline, LocalEnumSIMCOREauthenticationType::Basic, 1033, 'DMS by Simova', '', '', '', '', '');
    end;

Veröffentlichen von Document Central im Repository

Um das Veröffentlichen der Konfiguration im SharePoint auszulösen, muss eine Aktion in einem benutzerdefinierten Bereich erstellt werden, die den folgenden Code enthält.

Parameter

Name	Datentyp	Länge	Beschreibung
ParamUserIDCode	Text	50	Gibt die Business Central-Benutzer-ID an
ParamRepositoryUsernameText	Text	100	Gibt den Benutzernamen des Benutzers an, der für das Repository verwendet werden soll. Wenn SharePoint Online (O365) als Repository verwendet wird, müssen immer die SharePoint Online-Anmeldeinformationen eingegeben werden.
ParamRepositoryPasswordText	Text	250	Gibt das Passwort des Benutzers an, der für das Repository verwendet werden soll. Wenn SharePoint Online (O365) als Repository verwendet wird, müssen immer die SharePoint Online-Anmeldeinformationen eingegeben werden. Wenn Multi-Faktor-Authentifizierung (MFA) verwendet wird, muss hier ein App-Passwort eingegeben werden.

Codebeispiel

Das folgende Codebeispiel führt die Funktion PublishDMS aus, die einen Document Central-Benutzer mit den definierten Parametern erstellt und die Daten im Kontext des erstellten Document Central-Benutzers im Repository veröffentlicht.

Warning

Wenn ein Document Central-Benutzer mit der eingegebenen UserID bereits existiert, wird der bereits vorhandene Benutzer verwendet

    trigger OnAction()
    var
       LocalCodeunitSIMDMSCompanyConfiguration: Codeunit "SIM_DMS Configuration";
    begin
       LocalCodeunitSIMDMSCompanyConfiguration.PublishDMS(CopyStr(UserId, 1, 50), 'sampleRepositoryUsername', 'SampleRepositoryPassword');
    end;

Komfortfunktion

Um alle oben genannten Funktionen mit einem Klick auszulösen, muss eine Aktion in einem benutzerdefinierten Bereich erstellt werden, die den folgenden Code enthält.

Codebeispiel

Das folgende Codebeispiel öffnet einen Datei-Explorer, in dem Sie die Produktkonfiguration auswählen können, die Sie in Business Central importieren möchten. Anschließend wird ein Document Central-Repository-Eintrag mit den als Parameter definierten Werten erstellt und der Repository-Code wird in die Document Central - Modul Einrichtung eingefügt. Danach wird ein Document Central-Benutzer mit den definierten Parametern erstellt und die Daten werden im Kontext des erstellten Document Central-Benutzers im Repository veröffentlicht.

    trigger OnAction()
    var
       LocalCodeunitSIMDMSConfiguration: Codeunit "SIM_DMS Configuration";
       LocalCodeunitTempBlob: Codeunit "Temp Blob";
       LocalCodeunitBase64Convert: Codeunit "Base64 Convert";
       GlobalCodeunitFileManagement: Codeunit "File Management";
       LocalEnumSIMDMSArchiveSystem: Enum "SIM_DMS Archive System";
       LocalEnumSIMCOREAuthenticationMode: Enum "SIM_CORE Authentication Mode";
       LocalEnumSIMCOREauthenticationType: Enum "SIM_CORE Authentication Type";
       LocalInStream: InStream;
       LocalBase64StringText: Text;
       LocalconfigText: Text;
    begin
       Clear(LocalCodeunitTempBlob);
       GlobalCodeunitFileManagement.BLOBImportWithFilter(LocalCodeunitTempBlob, 'Importdatei wählen', '', 'Alle Dateien (*.*)|*.*', '*.*');
       if not LocalCodeunitTempBlob.HasValue() then exit;
       LocalCodeunitTempBlob.CreateInStream(LocalInStream, TextEncoding::UTF8);
       LocalInStream.Read(LocalconfigText);

       if LocalconfigText = '' then exit;

       LocalBase64StringText:= LocalCodeunitBase64Convert.ToBase64(LocalconfigText);
       LocalCodeunitSIMDMSConfiguration.CompleteConfiguration(LocalBase64StringText,'SharePoint', LocalEnumSIMDMSArchiveSystem::SharePoint, 'https://tegos.sharepoint.com/sites/simova-portal/archivtestseiten/SampleRepository', LocalEnumSIMCOREAuthenticationMode::SharePointOnline, LocalEnumSIMCOREauthenticationType::Basic, 1033, 'DMS by Simova', '', '', '', '', '',CopyStr(UserId, 1, 50), 'sampleRepositoryUsername', 'SampleRepositoryPassword');
    end;

Info

Die Reihenfolge der übergebenen Parameter ist wie folgt: Importieren einer Konfiguration, Erstellen eines Repository-Eintrags, Veröffentlichen von Document Central im Repository

Siehe auch

• Modul-Einrichtung
• Einrichtung des Repositorys