Änderungen von Dokument Kontaktmanagement

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

Von Version 71.1
bearbeitet von Katharina Prummer
am 2025/02/28 10:49
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 78.1
bearbeitet von Katharina Prummer
am 2025/05/13 13:35
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -419,13 +419,6 @@
419 419  
420 420  
421 421  
422 -
423 -
424 -
425 -
426 -
427 -
428 -
429 429  = Einrichtung Ablagepfad/Auscheckpfad Dokumente =
430 430  
431 431  Vorraussetzung: Sie haben die Berechtigung um in die Programmparameter zu kommen.
... ... @@ -449,8 +449,13 @@
449 449  
450 450  = Einrichtung E-Mail Anbindung =
451 451  
452 -[[image:Programmparameter_Email_04-2024.png||alt="ProgrammParameter_Email_Anbindung.png" height="373" width="915"]]
445 +(% class="box warningmessage" %)
446 +(((
447 +Ab Version 25.1 verfügbar
448 +)))
453 453  
450 +[[image:image-20250228114149-5.png]]
451 +
454 454  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**).
455 455  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**).
456 456  Je nach dem, welche der drei Optionen man auswählt, verändern sich die Einstellungen.
... ... @@ -463,7 +463,7 @@
463 463  
464 464  == E-Mail Modus IMAP/SMTP ==
465 465  
466 -[[image:Email_Anbindung_IMAP_SMTP.png||height="506" style="float:left" width="770"]]
464 +[[image:image-20250228123954-7.png]]
467 467  
468 468  (% style="margin-left:auto; width:714px" %)
469 469  |=(% style="width: 74px;" %)(((
... ... @@ -474,39 +474,16 @@
474 474  |(% style="width:74px" %)(((
475 475  **1**
476 476  )))|(% style="width:636px" %)(((
477 -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 +In der Auswahllistehlt man "**SMTP**" aus.
478 478  )))
479 479  |(% style="width:74px" %)(((
480 480  **2**
481 -)))|(% style="width:636px" %)(((
482 -Hier bestimmt man den **E-Mail Timeout**.
483 -**Achtung**: Die Angabe ist in Millisekunden. 1 Sekunde entspricht hier also 1000 Millisekunden.
484 -)))
479 +)))|(% 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.
485 485  |(% style="width:74px" %)(((
486 486  **3**
487 487  )))|(% style="width:636px" %)(((
488 -Indem man ein Häkchen setzt, **aktiviert **man die **SSL**. Dies bedeutet, dass...
483 +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.
489 489  )))
490 -|(% style="width:74px" %)(((
491 -**4**
492 -)))|(% style="width:636px" %)(((
493 -Hier bestimmt man das **Verfahren**, wie der **Login **zu erfolgen hat.
494 -)))
495 -|(% style="width:74px" %)(((
496 -**5**
497 -)))|(% style="width:636px" %)(((
498 -Hier werden die **ClientID **und **TenantID** eingeblendet.
499 -)))
500 -|(% style="width:74px" %)(((
501 -**6**
502 -)))|(% style="width:636px" %)(((
503 -Hier werden **Absender **und **Empfänger **festgelegt. Möchte man die Einstellung testen, kann man dies über den **Testmail**-Button tun.
504 -)))
505 -|(% style="width:74px" %)(((
506 -**7**
507 -)))|(% style="width:636px" %)(((
508 -Hier legt man die **Anmeldeoption **fest.
509 -)))
510 510  
511 511  
512 512  
... ... @@ -516,59 +516,21 @@
516 516  
517 517  
518 518  
519 -
520 -
521 -
522 -
523 -
524 -
525 -
526 -
527 -
528 -
529 529  == E-Mail Modus Outlook ==
530 530  
531 -Gibt nur eine vorrausestzung, dass Outlook installiert sein muss und eingerichtet sein muss mit mindestens einem Konto.
496 +Damit die Funktion genutzt werden kann, muss **Outlook lokal installiert** sein und es muss **mindestens ein E-Mail-Konto** in Outlook eingerichtet sein.
532 532  
533 -[[image:Email_Anbindung_Outlook.png||height="415" style="float:left" width="842"]]
498 +[[image:image-20250228113650-4.png]]
534 534  
535 535  (% style="margin-left:auto; width:642px" %)
536 -|=(% style="width: 71px;" %)(((
537 -Nummer
538 -)))|=(% style="width: 564px;" %)(((
539 -Beschreibung
540 -)))
541 -|(% style="width:71px" %)(((
542 -**1**
543 -)))|(% style="width:564px" %)(((
544 -Hier werden die **ClientID **und **TenantID** eingeblendet.
545 -)))
546 -|(% style="width:71px" %)(((
547 -**2**
548 -)))|(% style="width:564px" %)(((
549 -Hier legt man die **Anmeldeoption **fest.
550 -)))
501 +|=(% style="width: 71px;" %)Nummer|=(% style="width: 564px;" %)Beschreibung
502 +|(% style="width:71px" %)1|(% style="width:564px" %)In der Auswahlliste "Outlook" auswählen
551 551  
552 552  
553 553  
554 -
555 -
556 -
557 -
558 -
559 -
560 -
561 -
562 -
563 -
564 -
565 -
566 -
567 -
568 -
569 569  == E-Mail Modus EWS ==
570 570  
571 -[[image:Email_Anbindung_EWS.png||height="517" width="1067"]]
508 +[[image:image-20250228124752-8.png]]
572 572  
573 573  (% style="width:1066px" %)
574 574  |=(% style="width: 77px;" %)(((
... ... @@ -579,7 +579,7 @@
579 579  |(% style="width:77px" %)(((
580 580  **1**
581 581  )))|(% style="width:985px" %)(((
582 -Möchte man einen **Testdurchlauf **mit dem **EWS-Zugang** starten, gelingt dies über diese Schaltfläche.
519 +In der Auswahlliste "EWS" auswählen
583 583  )))
584 584  |(% style="width:77px" %)(((
585 585  **2**
... ... @@ -591,17 +591,13 @@
591 591  )))|(% style="width:985px" %)(((
592 592  Hier bestimmt man das **Verfahren**, wie der **Login **zu erfolgen hat.
593 593  )))
531 +|(% style="width:77px" %)4|(% style="width:985px" %)Hier kann eine fester E-Mail Adresse und das Passwort zu einem Postfach angeben.
594 594  |(% style="width:77px" %)(((
595 -**4**
533 +**5**
596 596  )))|(% style="width:985px" %)(((
597 597  Hier werden die **ClientID **und **TenantID** eingeblendet.
598 598  )))
599 599  |(% style="width:77px" %)(((
600 -**5**
601 -)))|(% style="width:985px" %)(((
602 -Hier werden **Absender **und **Empfänger **festgelegt. Möchte man die Einstellung testen, kann man dies über den **Testmail**-Button tun.
603 -)))
604 -|(% style="width:77px" %)(((
605 605  **6**
606 606  )))|(% style="width:985px" %)(((
607 607  Hier legt man die **Anmeldeoption **fest.
... ... @@ -609,16 +609,9 @@
609 609  |(% style="width:77px" %)(((
610 610  **7**
611 611  )))|(% style="width:985px" %)(((
612 -Hier bestimmt man den **Ablageordner**. Soll das ganze automatisch verlaufen, setzt man ein Häkchen bei **versendete UP-Belege im Ordner ablegen**.
545 +Hier kann der Exchange Web Service Zugang getestet werden.
613 613  )))
614 -|(% style="width:77px" %)(((
615 -**8**
616 -)))|(% style="width:985px" %)(((
617 -Hier bestimmt man **Kürzel **für das **Hauptdokument **(Beleg) und für **zusätzliche Anlagen **fest.
618 -)))
619 619  
620 -
621 -
622 622  == E-Mail Modus MS Graph ==
623 623  
624 624  {{info}}
... ... @@ -625,20 +625,60 @@
625 625  Die **Nutzung **des E-Mail Modus **MS Graph** **setzt voraus**, dass der **Webservice aktiv **ist.
626 626  {{/info}}
627 627  
628 -[[image:Email_MS-Graph.png||height="624" style="float:left" width="1073"]]
554 +=== Einrichtung E-Mail-Anbindung mit MS-Graph und Azure in base4IT ===
629 629  
630 -(% style="margin-left:auto; width:411px" %)
631 -|=(% style="width: 83px;" %)Nummer|=(% style="width: 324px;" %)Beschreibung
632 -|(% style="width:83px" %)**1**|(% style="width:324px" %)Hier werden die **ClientID **und **TenantID** eingeblendet.
633 633  
557 +Die base4it Software bietet ihren Anwendern die Möglichkeiten
558 +• E-Mails aus für sie freigebenen Postfächern einem Kontakt als „Aktivität“ zuzuweisen
559 +• Eine „Aktivität“ als ausgehende E-Mail anzulegen und zu versenden
634 634  
635 635  
562 +Beide Funktionalitäten benötigen eine Anbindung an das E-Mail-System des Kunden. Bei Kunden mit
563 +lokalem Exchange Server erfolgt dies über EWS, bei Exchange in der Cloud mit EWS oder MS-Graph.
564 +Nach aktuellem Stand ist EWS für Exchange Online per 1.Oktober 2026 abgekündigt, ein Wechsel auf
565 +MS-Graph ist erforderlich.
636 636  
637 637  
568 +**~1. Anwendung registrieren**
569 +In Azure muss eine Anwendung registriert werden, der Name kann frei gewählt werden. Alle Kunden,
570 +die bereits für die base4it-EWS-Anbindung eine Anwendung registriert haben, können diese weiter
571 +verwenden, müssen allerdings die MS-Graph API-Berechtigungen (permissions) ergänzen.
638 638  
639 639  
574 +**2. API-Berechtigungen (permissions)**
575 +base4it benötigt nur „delegierte Berechtigungen“ (delegated permissions), alle Zugriffe erfolgen im
576 +Kontext des angemeldeten Users. Folgende Permissions werden benötigt:
640 640  
578 +[[image:image-20250513133105-1.png]]
641 641  
580 +**3. Authentifizierung**
581 +Bei Zugriff über MS Graph wird von base4it nur OAUTH 2.0 als Authentifizierung unterstützt, daher muss
582 +für die registrierte Anwendung folgender Eintrag im Bereich „Authentifizierung“ → „Mobilgerät und
583 +Desktopanwendung“ vorhanden sein:
642 642  
585 +Bei erstem Zugriff auf das Mailkonto (Abruf der eingegangenen Mails oder Senden einer Aktivität als E-
586 +Mail) erscheint das Microsoft Authentifizierungsfenster zur Anmeldung mit E-Mail-Adresse und
587 +Passwort, danach die konfigurierte 2FA-Authentifizierung. base4it merkt sich nach erfolgreicher
588 +Anmeldung das von Microsoft zurückgegebene Token im Hauptspeicher und verwendet es für die
589 +weiteren Zugriffe bis zum Beenden der Anwendung bzw. dem zeitlichen Ablauf des Tokens, falls
590 +zwischenzeitlich kein Zugriff erfolgt.
643 643  
592 +[[image:image-20250513133410-2.png]]
593 +
594 +
595 +**4. Konfiguration base4IT**
596 +
597 +[[image:image-20250228125914-9.png||height="295" width="974"]]
598 +
599 +(% style="margin-left:auto; width:411px" %)
600 +|=(% style="width: 83px;" %)Nummer|=(% style="width: 324px;" %)Beschreibung
601 +|(% style="width:83px" %)1|(% style="width:324px" %)In der Auswahlliste "MSGraph" auswählen
602 +|(% style="width:83px" %)**2**|(% style="width:324px" %)Hier werden die **ClientID **und **TenantID** einfügen.
603 +
604 +
605 +
606 +
607 +
608 +
609 +
644 644  
image-20250228113446-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.kprummer
Größe
... ... @@ -1,0 +1,1 @@
1 +86.5 KB
Inhalt
image-20250228113650-4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.kprummer
Größe
... ... @@ -1,0 +1,1 @@
1 +88.0 KB
Inhalt
image-20250228123954-7.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.kprummer
Größe
... ... @@ -1,0 +1,1 @@
1 +91.6 KB
Inhalt
image-20250228124752-8.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.kprummer
Größe
... ... @@ -1,0 +1,1 @@
1 +123.1 KB
Inhalt
image-20250228125914-9.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.kprummer
Größe
... ... @@ -1,0 +1,1 @@
1 +53.8 KB
Inhalt
image-20250513133105-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.kprummer
Größe
... ... @@ -1,0 +1,1 @@
1 +97.0 KB
Inhalt
image-20250513133410-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.kprummer
Größe
... ... @@ -1,0 +1,1 @@
1 +56.5 KB
Inhalt