Änderungen von Dokument Kontaktmanagement

Zuletzt geändert von Katharina Prummer am 2025/05/16 10:59

Von Version 80.1
bearbeitet von Katharina Prummer
am 2025/05/16 10:59
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 69.1
bearbeitet von Katharina Prummer
am 2025/02/28 10:47
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -418,6 +418,16 @@
418 418  
419 419  
420 420  
421 +
422 +
423 +
424 +
425 +
426 +
427 +
428 +
429 +
430 +
421 421  = Einrichtung Ablagepfad/Auscheckpfad Dokumente =
422 422  
423 423  Vorraussetzung: Sie haben die Berechtigung um in die Programmparameter zu kommen.
... ... @@ -441,13 +441,8 @@
441 441  
442 442  = Einrichtung E-Mail Anbindung =
443 443  
444 -(% class="box warningmessage" %)
445 -(((
446 -Ab Version 25.1 verfügbar
447 -)))
454 +[[image:Programmparameter_Email_04-2024.png||alt="ProgrammParameter_Email_Anbindung.png" height="373" width="915"]]
448 448  
449 -[[image:image-20250228114149-5.png]]
450 -
451 451  Indem man den Begriff **Programmparameter **in die [[Schnellsuche>>https://wiki.non-profit-manager.org/bin/view/Allgemeine%20Bedienung/Software%20Module/03%20-%20Das%20Modul%20Kontaktmanagement/#HSchnellsuche]] eingibt, gelangt man zu den **Einstellungen **der **Programmparameter **(Ziffer **1**).
452 452  Hier wählt man bei der Rubrik **Allgemein **den Unterpunkt **Mail **(Ziffer **2**) aus und gelangt so zu den Einstellungen des **E-Mail Modus** (Ziffer **3**).
453 453  Je nach dem, welche der drei Optionen man auswählt, verändern sich die Einstellungen.
... ... @@ -460,7 +460,7 @@
460 460  
461 461  == E-Mail Modus IMAP/SMTP ==
462 462  
463 -[[image:image-20250228123954-7.png]]
468 +[[image:Email_Anbindung_IMAP_SMTP.png||height="506" style="float:left" width="770"]]
464 464  
465 465  (% style="margin-left:auto; width:714px" %)
466 466  |=(% style="width: 74px;" %)(((
... ... @@ -471,38 +471,94 @@
471 471  |(% style="width:74px" %)(((
472 472  **1**
473 473  )))|(% style="width:636px" %)(((
474 -In der Auswahllistehlt man "**SMTP**" aus.
479 +Hier macht man Angaben zum **IMAP **Server und zum **SMTP **Server. Dabei steht es dem Anwender frei, ob er eine **IP **oder einen **Namen **eingibt. Dahinter bietet sich Platz für den Port.
475 475  )))
476 476  |(% style="width:74px" %)(((
477 477  **2**
478 -)))|(% style="width:636px" %)Hier macht man Angaben zum **IMAP **Server und zum **SMTP **Server. Dabei steht es dem Anwender frei, ob er eine **IP **oder einen **Namen **eingibt.
483 +)))|(% style="width:636px" %)(((
484 +Hier bestimmt man den **E-Mail Timeout**.
485 +**Achtung**: Die Angabe ist in Millisekunden. 1 Sekunde entspricht hier also 1000 Millisekunden.
486 +)))
479 479  |(% style="width:74px" %)(((
480 480  **3**
481 481  )))|(% style="width:636px" %)(((
482 -Indem man ein Häkchen setzt, **aktiviert **man die **SSL**. Dies bedeutet die Einstellung für das Secure Sockets Layer. Eine Verschlüsselung der Daten.
490 +Indem man ein Häkchen setzt, **aktiviert **man die **SSL**. Dies bedeutet, dass...
483 483  )))
492 +|(% style="width:74px" %)(((
493 +**4**
494 +)))|(% style="width:636px" %)(((
495 +Hier bestimmt man das **Verfahren**, wie der **Login **zu erfolgen hat.
496 +)))
497 +|(% style="width:74px" %)(((
498 +**5**
499 +)))|(% style="width:636px" %)(((
500 +Hier werden die **ClientID **und **TenantID** eingeblendet.
501 +)))
502 +|(% style="width:74px" %)(((
503 +**6**
504 +)))|(% style="width:636px" %)(((
505 +Hier werden **Absender **und **Empfänger **festgelegt. Möchte man die Einstellung testen, kann man dies über den **Testmail**-Button tun.
506 +)))
507 +|(% style="width:74px" %)(((
508 +**7**
509 +)))|(% style="width:636px" %)(((
510 +Hier legt man die **Anmeldeoption **fest.
511 +)))
512 +|(% style="width:74px" %)(((
513 +**8 BRAUCHEN WIR NICHT**
514 +)))|(% style="width:636px" %)(((
515 +Hier bestimmt man den **Ablageordner**. Soll das ganze automatisch verlaufen, setzt man ein Häkchen bei **versendete UP-Belege im Ordner ablegen**.
516 +)))
517 +|(% style="width:74px" %)(((
518 +**9 BRAUCHEN WIR NICHT**
519 +)))|(% style="width:636px" %)(((
520 +Hier bestimmt man **Kürzel **für das **Hauptdokument **(Beleg) und für **zusätzliche Anlagen **fest.
521 +)))
484 484  
485 485  
486 486  
525 +== E-Mail Modus Outlook ==
487 487  
527 +Gibt nur eine vorrausestzung, dass Outlook installiert sein muss und eingerichtet sein muss mit mindestens einem Konto.
488 488  
529 +[[image:Email_Anbindung_Outlook.png||height="415" style="float:left" width="842"]]
489 489  
531 +(% style="margin-left:auto; width:642px" %)
532 +|=(% style="width: 71px;" %)(((
533 +Nummer
534 +)))|=(% style="width: 564px;" %)(((
535 +Beschreibung
536 +)))
537 +|(% style="width:71px" %)(((
538 +**1**
539 +)))|(% style="width:564px" %)(((
540 +Hier werden die **ClientID **und **TenantID** eingeblendet.
541 +)))
542 +|(% style="width:71px" %)(((
543 +**2**
544 +)))|(% style="width:564px" %)(((
545 +Hier legt man die **Anmeldeoption **fest.
546 +)))
547 +|(% style="width:71px" %)(((
548 +**3 BRAUCHEN WIR NICHT**
549 +)))|(% style="width:564px" %)(((
550 +Hier bestimmt man den **Ablageordner**. Soll das ganze automatisch verlaufen, setzt man ein Häkchen bei **versendete UP-Belege im Ordner ablegen**.
551 +)))
552 +|(% style="width:71px" %)(((
553 +**4 BRAUCHEN WIR NICHT**
554 +)))|(% style="width:564px" %)(((
555 +Hier bestimmt man **Kürzel **für das **Hauptdokument **(Beleg) und für **zusätzliche Anlagen **fest.
556 +)))
490 490  
491 491  
492 -== E-Mail Modus Outlook ==
493 493  
494 -Damit die Funktion genutzt werden kann, muss **Outlook lokal installiert** sein und es muss **mindestens ein E-Mail-Konto** in Outlook eingerichtet sein.
495 495  
496 -[[image:image-20250228113650-4.png]]
497 497  
498 -(% style="margin-left:auto; width:642px" %)
499 -|=(% style="width: 71px;" %)Nummer|=(% style="width: 564px;" %)Beschreibung
500 -|(% style="width:71px" %)1|(% style="width:564px" %)In der Auswahlliste "Outlook" auswählen
501 501  
502 502  
503 503  == E-Mail Modus EWS ==
504 504  
505 -[[image:image-20250228124752-8.png]]
566 +[[image:Email_Anbindung_EWS.png||height="517" width="1067"]]
506 506  
507 507  (% style="width:1066px" %)
508 508  |=(% style="width: 77px;" %)(((
... ... @@ -513,7 +513,7 @@
513 513  |(% style="width:77px" %)(((
514 514  **1**
515 515  )))|(% style="width:985px" %)(((
516 -In der Auswahlliste "EWS" aushlen
577 +Möchte man einen **Testdurchlauf **mit dem **EWS-Zugang** starten, gelingt dies über diese Schaltfläche.
517 517  )))
518 518  |(% style="width:77px" %)(((
519 519  **2**
... ... @@ -525,13 +525,17 @@
525 525  )))|(% style="width:985px" %)(((
526 526  Hier bestimmt man das **Verfahren**, wie der **Login **zu erfolgen hat.
527 527  )))
528 -|(% style="width:77px" %)4|(% style="width:985px" %)Hier kann eine fester E-Mail Adresse und das Passwort zu einem Postfach angeben.
529 529  |(% style="width:77px" %)(((
530 -**5**
590 +**4**
531 531  )))|(% style="width:985px" %)(((
532 532  Hier werden die **ClientID **und **TenantID** eingeblendet.
533 533  )))
534 534  |(% style="width:77px" %)(((
595 +**5**
596 +)))|(% style="width:985px" %)(((
597 +Hier werden **Absender **und **Empfänger **festgelegt. Möchte man die Einstellung testen, kann man dies über den **Testmail**-Button tun.
598 +)))
599 +|(% style="width:77px" %)(((
535 535  **6**
536 536  )))|(% style="width:985px" %)(((
537 537  Hier legt man die **Anmeldeoption **fest.
... ... @@ -539,68 +539,45 @@
539 539  |(% style="width:77px" %)(((
540 540  **7**
541 541  )))|(% style="width:985px" %)(((
542 -Hier kann der Exchange Web Service Zugang getestet werden.
607 +Hier bestimmt man den **Ablageordner**. Soll das ganze automatisch verlaufen, setzt man ein Häkchen bei **versendete UP-Belege im Ordner ablegen**.
543 543  )))
609 +|(% style="width:77px" %)(((
610 +**8**
611 +)))|(% style="width:985px" %)(((
612 +Hier bestimmt man **Kürzel **für das **Hauptdokument **(Beleg) und für **zusätzliche Anlagen **fest.
613 +)))
544 544  
545 -== E-Mail Modus MS Graph ==
546 546  
547 -{{info}}
548 -Die **Nutzung **des E-Mail Modus **MS Graph** **setzt voraus**, dass der **Webservice aktiv **ist.
549 -{{/info}}
550 550  
551 -=== Einrichtung E-Mail-Anbindung mit MS-Graph und Azure in base4IT ===
552 552  
553 553  
554 -Die base4it Software bietet ihren Anwendern die Möglichkeiten
555 -• E-Mails aus für sie freigebenen Postfächern einem Kontakt als „Aktivität“ zuzuweisen
556 -• Eine „Aktivität“ als ausgehende E-Mail anzulegen und zu versenden
557 557  
558 558  
559 -Beide Funktionalitäten benötigen eine Anbindung an das E-Mail-System des Kunden. Bei Kunden mit
560 -lokalem Exchange Server erfolgt dies über EWS, bei Exchange in der Cloud mit EWS oder MS-Graph.
561 -Nach aktuellem Stand ist EWS für Exchange Online per 1.Oktober 2026 abgekündigt, ein Wechsel auf
562 -MS-Graph ist erforderlich.
563 563  
564 564  
565 -**~1. Anwendung registrieren**
566 -In Azure muss eine Anwendung registriert werden, der Name kann frei gewählt werden. Alle Kunden,
567 -die bereits für die base4it-EWS-Anbindung eine Anwendung registriert haben, können diese weiter
568 -verwenden, müssen allerdings die MS-Graph API-Berechtigungen (permissions) ergänzen.
569 569  
570 570  
571 -**2. API-Berechtigungen (permissions)**
572 -base4it benötigt nur „delegierte Berechtigungen“ (delegated permissions), alle Zugriffe erfolgen im
573 -Kontext des angemeldeten Users. Folgende Permissions werden benötigt:
574 574  
575 -[[image:image-20250513133105-1.png]]
576 576  
577 -**3. Anwender hinzufügen**
578 -Unter Benutzer und Gruppen müssen die Anwender hinzugefügt werden.
579 579  
580 580  
581 -**4. Authentifizierung**
582 -Bei Zugriff über MS Graph wird von base4it nur OAUTH 2.0 als Authentifizierung unterstützt, daher muss
583 -für die registrierte Anwendung folgender Eintrag im Bereich „Authentifizierung“ → „Mobilgerät und
584 -Desktopanwendung“ vorhanden sein:
585 585  
586 -Bei erstem Zugriff auf das Mailkonto (Abruf der eingegangenen Mails oder Senden einer Aktivität als E-
587 -Mail) erscheint das Microsoft Authentifizierungsfenster zur Anmeldung mit E-Mail-Adresse und
588 -Passwort, danach die konfigurierte 2FA-Authentifizierung. base4it merkt sich nach erfolgreicher
589 -Anmeldung das von Microsoft zurückgegebene Token im Hauptspeicher und verwendet es für die
590 -weiteren Zugriffe bis zum Beenden der Anwendung bzw. dem zeitlichen Ablauf des Tokens, falls
591 -zwischenzeitlich kein Zugriff erfolgt.
592 592  
593 -[[image:image-20250513133410-2.png]]
631 +(% class="wikigeneratedid" id="HE-MailModusMSGraph" %)
632 +E-Mail Modus MS Graph
594 594  
634 +{{info}}
635 +Die **Nutzung **des E-Mail Modus **MS Graph** **setzt voraus**, dass der **Webservice aktiv **ist.
636 +{{/info}}
595 595  
596 -**5. Konfiguration base4IT**
638 +[[image:Email_MS-Graph.png||height="624" style="float:left" width="1073"]]
597 597  
598 -[[image:image-20250228125914-9.png||height="295" width="974"]]
599 -
600 600  (% style="margin-left:auto; width:411px" %)
601 601  |=(% style="width: 83px;" %)Nummer|=(% style="width: 324px;" %)Beschreibung
602 -|(% style="width:83px" %)1|(% style="width:324px" %)In der Auswahlliste "MSGraph" auswählen
603 -|(% style="width:83px" %)**2**|(% style="width:324px" %)Hier werden die **ClientID **und **TenantID** einfügen.
642 +|(% style="width:83px" %)**1**|(% style="width:324px" %)Hier werden die **ClientID **und **TenantID** eingeblendet.
643 +|(% style="width:83px" %)**2**|(% style="width:324px" %)Über den Button **Parameterübersicht **gelangt man zu einer tabellarischen Anzeige der Programmparameter. Hier unterteilen die Spalten unter anderem in die Bereiche, Standardwerte und Datentypen. Außerdem kann man hier via Anklicken der jeweiligen Kästchen auswählen, ob der jeweilige Programmparameter mandbezogen oder usergroupbezogen ist.
644 +|(% style="width:83px" %)**3**|(% style="width:324px" %)Mittels Button **Übersetzungen verwalten** kann man sämtliche Begriffe gemäß der Übersetzungen einsehen und verwalten.
645 +|(% style="width:83px" %)**4**|(% style="width:324px" %)Mit dem Button **Zustandsüberwachung konfigurieren **gelangt man zum Fenster der Zustandsüberwachung. Neben dem Benutzernamen und Überwachungsintervall in Stunden, legt man hier auch die Mailversandoptionen fest. Außerdem definiert man hier noch Absender, Empfänger und Betreff der Mail.
604 604  
605 605  
606 606  
... ... @@ -607,4 +607,11 @@
607 607  
608 608  
609 609  
652 +
653 +
654 +
655 +
656 +
657 +
658 +
610 610  
b4it_Anbindung_MSGraph.pdf
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.kprummer
Größe
... ... @@ -1,1 +1,0 @@
1 -73.7 KB
Inhalt
image-20250228113446-3.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.kprummer
Größe
... ... @@ -1,1 +1,0 @@
1 -86.5 KB
Inhalt
image-20250228113650-4.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.kprummer
Größe
... ... @@ -1,1 +1,0 @@
1 -88.0 KB
Inhalt
image-20250228123954-7.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.kprummer
Größe
... ... @@ -1,1 +1,0 @@
1 -91.6 KB
Inhalt
image-20250228124752-8.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.kprummer
Größe
... ... @@ -1,1 +1,0 @@
1 -123.1 KB
Inhalt
image-20250228125914-9.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.kprummer
Größe
... ... @@ -1,1 +1,0 @@
1 -53.8 KB
Inhalt
image-20250513133105-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.kprummer
Größe
... ... @@ -1,1 +1,0 @@
1 -97.0 KB
Inhalt
image-20250513133410-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.kprummer
Größe
... ... @@ -1,1 +1,0 @@
1 -56.5 KB
Inhalt