BC20 CU2 - Online-Hilfe mit eigenen Link funktioniert nicht

Bild Microsoft Dynamics 365 Business Central (On-Premises Version)
Forumsregeln
Impressum • Community-Knigge • Nutzungsbedingungen • Datenschutzrichtlinie

Bitte unbedingt im Titel angeben, auf welche Version (BC13, BC14, BC15, ...) sich eure Frage bezieht!

BC20 CU2 - Online-Hilfe mit eigenen Link funktioniert nicht

Beitragvon DobbyNator94 » 5. Juli 2022 22:14

Moin zusammen,

seit BC16 oder 18 haben wir eigene Hilfe-Links in die navsettings.json vom Webserver hinterlegt. Und zwar so:

Code: Alles auswählen
{
    "NAVWebSettings":  {
                           "//AllowedFrameAncestors":  [
                                                           "Specifies the comma seperated list of allowed frame ancestor URIs when web client is hosted inside an iframe.",
                                                           "The uris can contain wildcards. Example values: \u0027https:  mysite.sharepoint.com,https:  yoursite.sharepoint.com\u0027, \u0027https:  *.myportal.com\u0027 "
                                                       ],
                           "AllowedFrameAncestors":  "https://teams.microsoft.com,https://*.dynamics-tie.com,https://*.dynamics.com,https://*.sharepoint.com,https://*.office.com,https://*.officeppe.com,https://*.dynamics-ppe.com,https://*.dynamics-servicestie.com",
                           "//GlobalEndpoints":  "Specifies the comma seperated list of global endpoints that are allowed to call this web site. Must include http scheme and FDQN. E.g. https://financials.microsoft.com; The already defined values are standard values to enable connection via the mobile app.",
                           "GlobalEndpoints":  "null,ms://businesscentral,ms://dynamicsnav",
                           "//AllowNtlm":  "Specifies whether NTLM fallback is permitted when authenticating. To require Kerberos authentication, set this value to false.",
                           "AllowNtlm":  false,
                           "//ClientServicesChunkSize":  [
                                                             "Sets the maximum size, in kilobytes, of a data chunk that is transmitted between Microsoft Dynamics NAV Web client",
                                                             "and Microsoft Dynamics NAV Server. The value should be between 4 and 80."
                                                         ],
                           "ClientServicesChunkSize":  28,
                           "//ClientServicesCompressionThreshold":  [
                                                                        "Sets the threshold in memory consumption at which Microsoft Dynamics NAV Web client starts compressing data sets.",
                                                                        "This limits amount of consumed memory. The value is in kilobytes."
                                                                    ],
                           "ClientServicesCompressionThreshold":  64,
                           "//ClientServicesProtectionLevel":  [
                                                                   "Specifies the security services to protect the data stream between the Microsoft Dynamics NAV Web client and",
                                                                   "Microsoft Dynamics NAV Server. This value must match the value that is specified in the Microsoft Dynamics NAV Server",
                                                                   "configuration file. Valid options include: EncryptAndSign, Sign, None"
                                                               ],
                           "ClientServicesProtectionLevel":  "EncryptAndSign",
                           "//Server":  "The name of the computer running the Microsoft Dynamics NAV Server to connect to.",
                           "Server":  "localhost",
                           "//ServerInstance":  "Name of the Microsoft Dynamics NAV Server instance to connect to (for client) or listen on (for server).",
                           "ServerInstance":  "mittelschicht",
                           "//ClientServicesCredentialType":  [
                                                                  "The type of client credential used for authentication.",
                                                                  "Possible values:",
                                                                  "Windows              - Windows authentication is used, and client will connect with \u0027current user\u0027",
                                                                  "                       this user is expected to be the same and known to both server and client",
                                                                  "                       This is the default mode and is typically used on a LAN with Active Directory,",
                                                                  "                       In this mode X.509 certificates are not used and options set below are ignored",
                                                                  "UserName             - Windows authentication on the server. Client is expected to present username/password",
                                                                  "                       indentifying a windows user known (created) on the server.",
                                                                  "                       Typically the client will ask for these credentials and pass them to the server",
                                                                  "                       Certificates are used to protect the passing of credentials.",
                                                                  "                       This is typically used when only the server is part of an Active Directory, or",
                                                                  "                       when the client is not trusted, e.g. connection over a WAN/Internet",
                                                                  "NavUserPassword      - Authentication is managed by the server but not based on windows users.",
                                                                  "                       Client is expected to present username/password matching a user known to the server.",
                                                                  "                       Typically the client will ask for these credentials and pass them to the server",
                                                                  "                       Certificates are used to protect the passing of credentials.",
                                                                  "                       This mode is used in hosted environments e.g. Azure where the list of allowed users",
                                                                  "                       are maintained by NAV and not based on windows users.",
                                                                  "AccessControlService - Authentication for the Web Client is handled by Microsoft Azure Access Control Service (ACS).",
                                                                  "                       An ACS namespace needs to be set up before. Also the Identity Providers need to be set up",
                                                                  "                       as well as the Relying Party representing the NAV Web Client.",
                                                                  "                       To support ACS, you must specify the WS-Federation Login Endpoint in the Dynamics NAV Server",
                                                                  "                       instance configuration file (key = WSFederationLoginEndpoint)."
                                                              ],
                           "ClientServicesCredentialType":  "Windows",
                           "//ClientServicesPort":  "The listening TCP port for the Microsoft Dynamics NAV Server. This is part of the server\u0027s URL. Valid range: 1-65535",
                           "ClientServicesPort":  7046,
                           "//ManagementServicesPort":  "The listening TCP port for the Microsoft Dynamics NAV management endpoint. Valid range: 1-65535",
                           "ManagementServicesPort":  7045,
                           "//ServicePrincipalNameRequired":  [
                                                                  "Specifies whether the connection to the Dynamics NAV Server instance requires an SPN.",
                                                                  "If true, the connection will only be made to a service with an SPN \u003cServerInstance\u003e/\u003cServer\u003e:\u003cClientServicesPort\u003e",
                                                                  "If false, the connection will be attempted to a service with or without an SPN."
                                                              ],
                           "ServicePrincipalNameRequired":  false,
                           "//SessionTimeout":  [
                                                    "Specifies the amount of time that a connection between the Dynamics NAV Web client and the Dynamics NAV Server can remain idle before the session is stopped.",
                                                    "Time span format: [dd.]hh:mm:ss[.ff]",
                                                    "     dd: days",
                                                    "     hh: hours",
                                                    "     mm: minutes",
                                                    "     ss: seconds",
                                                    "     ff: fractions of a second"
                                                ],
                           "SessionTimeout":  "00:20:00",
                           "//RequireSsl":  "Specifies whether SSL (https) is required. If the values is set to true all cookies will be marked with a \u0027secure\u0027 attribute.",
                           "RequireSsl":  "false",
                           "//ShowPageSearch":  [
                                                    "Specifies whether to show the search action for finding a page or report.",
                                                    "The action appears in the ribbon and navigation pane of the web client."
                                                ],
                           "ShowPageSearch":  true,
                           "//UnknownSpnHint":  "Specifies the connection to the server.",
                           "UnknownSpnHint":  "(net.tcp://localhost:7046/mittelschicht/Service)=NoSpn",
                           "//DnsIdentity":  "The DNS or subject name from the server certificate.",
                           "DnsIdentity":  "",
                           "//AuthenticateServer":  "Specifies whether to authenticate the server.",
                           "AuthenticateServer":  "true",
                           "//HelpServer":  [
                                                "Name of the Microsoft Dynamics NAV Help Server to connect to."
                                            ],
                           "HelpServer":  "",
                           "//HelpServerPort":  "The listening TCP port for the Microsoft Dynamics NAV Help Server. Valid range: 1-65535",
                           "HelpServerPort":  "49000",
                           "//useAdditionalSearchTerms":  "Specifies if the additional search terms should be used when searching.",
                           "useAdditionalSearchTerms":  true,
                           "ProductName":  "firma",
                           "ProductNameShort":  "firma",
                           "ProductNameMarketing":  "firma",
                           "PersonalizationEnabled":  "true",
                           "Designer":  "false"
                       },
    "ApplicationIdSettings":  {
                                  "BaseHelpUrl":  "http://support.firma.com/{0}/",
                                  "BlogLink":  "https://www.firma.com/",
                                  "ComingSoonLink":  "https://info.firma.com/",
                                  "CommunityLink":  "https://www.firma.com/",
                                  "ContactSalesLink":  "https://www.firma.com/",
                                  "SigninHelpLink":  "https://www.firma.com/"
                              }
}


Da sind ja die "ApplicationIdSettings" für zuständig. Seit BC20 allerdings führen die Links im neuen Hilfe und Support-Fenster aber trotzdem noch zu den Microsoft-Seiten. Hat jemand ähnliche Probleme?
Gibts irgendwas neues, was das Ganze erst aktiviert oder ersetzt?

Bei BC18 läuft die gleiche navsettings.json ohne Probleme und verweißt auf die Links.
Hier die Infos von MS:

https://docs.microsoft.com/en-us/dynami ... web-server


Anderes Thema, kennt jemand noch den PowerShell-Befehl zum ersetzen der App-Versionsangabe die unter der Hilfe und Support-Seite angezeigt wird?

Das steht ja normalerweise einmal die Platform-Versionsangabe und die Version der System oder Base-App. Man kann aber auch eine eigene App mit der AppID angeben. Finde bloĂź gerade das richtige PowerShell-CMDlet nicht.

Danke!

GruĂź
Robin
DobbyNator94
 
Beiträge: 7
Registriert: 12. September 2019 10:16
Realer Name: Robin Dobbermann
Arbeitsort: Oyten-Bassen
Bezug zu Microsoft Dynamics: End-Anwender
Microsoft Dynamics Produkt: Microsoft Dynamics 365
Microsoft Dynamics Version: 140

Re: BC20 CU2 - Online-Hilfe mit eigenen Link funktioniert ni

Beitragvon enh » 5. Juli 2022 23:19

DobbyNator94 hat geschrieben:jemand noch den PowerShell-Befehl zum ersetzen der App-Versionsangabe die unter der Hilfe und Support-Seite angezeigt wird?

Set-NAVApplication -ServerInstance <server instance name> -ApplicationVersion <new application version> -Force

Beispiel:
https://docs.microsoft.com/en-us/dynami ... on-version
enh
 
Beiträge: 2330
Registriert: 5. Februar 2014 15:42
Bezug zu Microsoft Dynamics: Microsoft Partner
Microsoft Dynamics Produkt: Microsoft Dynamics NAV

Re: BC20 CU2 - Online-Hilfe mit eigenen Link funktioniert ni

Beitragvon enh » 5. Juli 2022 23:21

enh
 
Beiträge: 2330
Registriert: 5. Februar 2014 15:42
Bezug zu Microsoft Dynamics: Microsoft Partner
Microsoft Dynamics Produkt: Microsoft Dynamics NAV

Re: BC20 CU2 - Online-Hilfe mit eigenen Link funktioniert ni

Beitragvon DobbyNator94 » 6. Juli 2022 14:06

Genau, das sind die richtigen Seite fĂĽr die Hilfe.

Das wollen wir machen:

Online library
To display content from a website that hosts your user assistance content, specify the URL in the settings for the Business Central Web Server. The navsettings.json file must contain the following setting in the ApplicationIdSettings element:

JSON

Copy
{
"NAVWebSettings": {
// [...more keys]
},
"ApplicationIdSettings": {
//BaseHelpUrl: The location of Help for this application.,
"BaseHelpUrl": "https://mysite.com/{0}/documentation/",
// [...more keys]
}
}
Note

Replace the value of the BaseHelpUrl key with the URL for your own website. The parameter, {0}, represents the locale of the browser that the user is using, such as en-us or da-dk, and is set automatically at runtime.

For more information, see Configuring Business Central Web Server Instances.

Hat das mal jemand getestet in BC20? Bei mir funktioniert es nicht. Meine Config habe ich ja angehangen.

Danke!

GruĂź
Robin
DobbyNator94
 
Beiträge: 7
Registriert: 12. September 2019 10:16
Realer Name: Robin Dobbermann
Arbeitsort: Oyten-Bassen
Bezug zu Microsoft Dynamics: End-Anwender
Microsoft Dynamics Produkt: Microsoft Dynamics 365
Microsoft Dynamics Version: 140


ZurĂĽck zu 365 Business Central (On-Premises)

Wer ist online?

Mitglieder in diesem Forum: Bing [Bot] und 1 Gast