...

function randomString([int]$length) {
    $characters = "abcdefghiklmnoprstuvwxyzABCDEFGHKLMNOPRSTUVWXYZ0123456789".ToCharArray()
    For ($loop = 1; $loop -le $length; $loop++) {
        $randomString += ($characters | Get-Random)
    }
    return $randomString
}

$certPath = "C:\Temp\cert.pfx"
$certificatePassword = randomString(12)
$certificatePasswordSecureString  = ConvertTo-SecureString -String $certificatePassword -Force -AsPlainText
$certificateDefaultName = "PrimeDocsIdSCert"

$HT = @{
    Subject="CN=$certificateDefaultName";
    KeyLength = 2048;
    HashAlgorithm = 'SHA256';
    KeyUsage = 'DigitalSignature';
    KeyExportPolicy = 'Exportable';
    KeySpec = 'Signature';
    NotAfter = (Get-Date).AddYears(10) ;
    TextExtension = '2.5.29.37={text}1.3.6.1.5.5.7.3.3';
    CertStoreLocation='cert:\localmachine\my';
}
$certificate = New-SelfSignedCertificate @HT

$certificatePath = 'cert:\localMachine\my\' + $certificate.thumbprint

Export-PfxCertificate -cert $certificatePath -FilePath $certPath -Password $certificatePasswordSecureString

Get-ChildItem Cert:\LocalMachine\My | Where-Object { $_.Subject -match $certificateDefaultName } | Remove-Item

Write-Host "Created certificate file with password '$certificatePassword' created as $certPath"

Admin API

Über die Admin API können Drittsysteme auf die APIs von primedocs zugreifen. Hierfür ist eine folgende Registrierung in der primedocs.config notwendig:

...

Logging

primedocs nutzt NLog für das Logging. Standardmässig loggen alle Server-Applikationen in den Installationsordner und erzeugen eine serverApp.oolog Datei (bis maximal 7 Stück, pro Tag eine).

Es ist ebenfalls möglich in die “Operation-Datenbank” (operationDbConnectionString) zu loggen. Hierfür benötigt diese Einstellung:

<primedocs operationDbConnectionString="..."
          <add iddatabaseLoggingEnabled="[GUID]true" oidcClientId="CustomApiClient" oidcClientSecret="CustomClient_Secret_123" userAuthType="FromConfigAdminApi" />
  </clients>>
           ...
</primedoc>

Connect API

...

Warnungen und Fehler werden danach in die Datenbank geschrieben.

Achtung: Dies funktioniert nur, wenn die NLog.config Dateien nicht manipuliert wurden.

Grundsätzlich ist es aber kein Problem, wenn man die NLog.config Datei auf seine eigenen Bedürfnisse anpasst.

...

Admin API

Über die Admin API können Drittsysteme auf die APIs von primedocs zugreifen. Hierfür ist eine folgende Registrierung in der primedocs.config notwendig:

<primedocs>
...
  <clients>
    <add id="[GUID]" oidcClientId="CustomApiClient" oidcClientSecret="CustomClient_Secret_123" userAuthType="FromConfigConnectApiFromConfigAdminApi" />
  </clients>
...
</primedoc>

Teams / Office / Outlook Integration

Die Integration in Teams sowie die Unterstützung der neuen Office.js-basierten AddIns in Office (Word/PowerPoint/Excel) sowie Outlook muss über die primedocs.config aktiviert werden.

...

Connect API

Über die Connect API können Drittsysteme serverseitig die Dokumentgenerierung von primedocs nutzen. Hierfür ist eine folgende Registrierung in der primedocs.config notwendig:

<primedocs>
...
  <teams<clients>
    <add id="[GUID]" namePrefixoidcClientId="CustomApiClient" />
  <officeAddin id="[GUID]" namePrefix="oidcClientSecret="CustomClient_Secret_123" userAuthType="FromConfigConnectApi" />
  <outlookAddin </clients>
...
</primedoc>

...

Teams / Office / Outlook Integration

Die Integration in Teams sowie die Unterstützung der neuen Office.js-basierten AddIns in Office (Word/PowerPoint/Excel) sowie Outlook muss über die primedocs.config aktiviert werden.

Als id kann jede beliebige GUID verwendet werden.

<primedocs>
...
  <teams id="[GUID]" namePrefix="" />
  <officeAddin id="[GUID]" namePrefix="" />
  <outlookAddin id="[GUID]" namePrefix="" />
</primedocs>

Der namePrefix kann genutzt werden, wenn es mehrere Umgebungen gibt. Die AddIns sind dann in der Form {namePrefix} primedocs benannt.

Im Anschluss kann das Manifest für das Deployment über diese URLs bezogen werden:

Das Manifest kann dann über die Teams bzw. Office Administration verteilt werden.

...

primedocs AI (Preview)

Für die primedocs AI muss folgende Konfiguration in der primedocs.config hinterlegt werden:

<primedocs>
...
  <openAi endpoint="https://....openai.azure.com/" 
          key="..." 
          modelDeploymentName="..." />
</primedocs>

Zusätzlich können im DataSourceAdminApp vordefinierte Prompts hinterlegt werden:

<Prompts>
		<Prompt title="Translate to EN"  icon="fi-gb" >Translate this given text to English</Prompt>
		<Prompt title="Translate to FR"  icon="fi-fr">Translate this given text to French</Prompt>
		...
</Prompts>