Zum Inhalt springen

Änderungen von Dokument Kontaktmanagement

Zuletzt geändert von Katharina Prummer am 2025/05/16 10:59
Von Version 72.1
bearbeitet von Katharina Prummer
am 2025/02/28 10:49
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 79.1
bearbeitet von Katharina Prummer
am 2025/05/13 13:35
Änderungskommentar: Neuen Anhang b4it_Anbindung_MSGraph.pdf hochladen

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -419,12 +419,6 @@
419 419  
420 420  
421 421  
422 -
423 -
424 -
425 -
426 -
427 -
428 428  = Einrichtung Ablagepfad/Auscheckpfad Dokumente =
429 429  
430 430  Vorraussetzung: Sie haben die Berechtigung um in die Programmparameter zu kommen.
... ... @@ -448,8 +448,13 @@
448 448  
449 449  = Einrichtung E-Mail Anbindung =
450 450  
451 -[[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 +)))
452 452  
450 +[[image:image-20250228114149-5.png]]
451 +
453 453  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**).
454 454  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**).
455 455  Je nach dem, welche der drei Optionen man auswählt, verändern sich die Einstellungen.
... ... @@ -462,7 +462,7 @@
462 462  
463 463  == E-Mail Modus IMAP/SMTP ==
464 464  
465 -[[image:Email_Anbindung_IMAP_SMTP.png||height="506" style="float:left" width="770"]]
464 +[[image:image-20250228123954-7.png]]
466 466  
467 467  (% style="margin-left:auto; width:714px" %)
468 468  |=(% style="width: 74px;" %)(((
... ... @@ -473,39 +473,16 @@
473 473  |(% style="width:74px" %)(((
474 474  **1**
475 475  )))|(% style="width:636px" %)(((
476 -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 Auswahlliste wählt man "**SMTP**" aus.
477 477  )))
478 478  |(% style="width:74px" %)(((
479 479  **2**
480 -)))|(% style="width:636px" %)(((
481 -Hier bestimmt man den **E-Mail Timeout**.
482 -**Achtung**: Die Angabe ist in Millisekunden. 1 Sekunde entspricht hier also 1000 Millisekunden.
483 -)))
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.
484 484  |(% style="width:74px" %)(((
485 485  **3**
486 486  )))|(% style="width:636px" %)(((
487 -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.
488 488  )))
489 -|(% style="width:74px" %)(((
490 -**4**
491 -)))|(% style="width:636px" %)(((
492 -Hier bestimmt man das **Verfahren**, wie der **Login **zu erfolgen hat.
493 -)))
494 -|(% style="width:74px" %)(((
495 -**5**
496 -)))|(% style="width:636px" %)(((
497 -Hier werden die **ClientID **und **TenantID** eingeblendet.
498 -)))
499 -|(% style="width:74px" %)(((
500 -**6**
501 -)))|(% style="width:636px" %)(((
502 -Hier werden **Absender **und **Empfänger **festgelegt. Möchte man die Einstellung testen, kann man dies über den **Testmail**-Button tun.
503 -)))
504 -|(% style="width:74px" %)(((
505 -**7**
506 -)))|(% style="width:636px" %)(((
507 -Hier legt man die **Anmeldeoption **fest.
508 -)))
509 509  
510 510  
511 511  
... ... @@ -515,59 +515,21 @@
515 515  
516 516  
517 517  
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 568  == E-Mail Modus EWS ==
569 569  
570 -[[image:Email_Anbindung_EWS.png||height="517" width="1067"]]
508 +[[image:image-20250228124752-8.png]]
571 571  
572 572  (% style="width:1066px" %)
573 573  |=(% style="width: 77px;" %)(((
... ... @@ -578,7 +578,7 @@
578 578  |(% style="width:77px" %)(((
579 579  **1**
580 580  )))|(% style="width:985px" %)(((
581 -Möchte man einen **Testdurchlauf **mit dem **EWS-Zugang** starten, gelingt dies über diese Schaltfläche.
519 +In der Auswahlliste "EWS" auswählen
582 582  )))
583 583  |(% style="width:77px" %)(((
584 584  **2**
... ... @@ -590,17 +590,13 @@
590 590  )))|(% style="width:985px" %)(((
591 591  Hier bestimmt man das **Verfahren**, wie der **Login **zu erfolgen hat.
592 592  )))
531 +|(% style="width:77px" %)4|(% style="width:985px" %)Hier kann eine fester E-Mail Adresse und das Passwort zu einem Postfach angeben.
593 593  |(% style="width:77px" %)(((
594 -**4**
533 +**5**
595 595  )))|(% style="width:985px" %)(((
596 596  Hier werden die **ClientID **und **TenantID** eingeblendet.
597 597  )))
598 598  |(% style="width:77px" %)(((
599 -**5**
600 -)))|(% style="width:985px" %)(((
601 -Hier werden **Absender **und **Empfänger **festgelegt. Möchte man die Einstellung testen, kann man dies über den **Testmail**-Button tun.
602 -)))
603 -|(% style="width:77px" %)(((
604 604  **6**
605 605  )))|(% style="width:985px" %)(((
606 606  Hier legt man die **Anmeldeoption **fest.
... ... @@ -608,15 +608,9 @@
608 608  |(% style="width:77px" %)(((
609 609  **7**
610 610  )))|(% style="width:985px" %)(((
611 -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.
612 612  )))
613 -|(% style="width:77px" %)(((
614 -**8**
615 -)))|(% style="width:985px" %)(((
616 -Hier bestimmt man **Kürzel **für das **Hauptdokument **(Beleg) und für **zusätzliche Anlagen **fest.
617 -)))
618 618  
619 -
620 620  == E-Mail Modus MS Graph ==
621 621  
622 622  {{info}}
... ... @@ -623,19 +623,60 @@
623 623  Die **Nutzung **des E-Mail Modus **MS Graph** **setzt voraus**, dass der **Webservice aktiv **ist.
624 624  {{/info}}
625 625  
626 -[[image:Email_MS-Graph.png||height="624" style="float:left" width="1073"]]
554 +=== Einrichtung E-Mail-Anbindung mit MS-Graph und Azure in base4IT ===
627 627  
628 -(% style="margin-left:auto; width:411px" %)
629 -|=(% style="width: 83px;" %)Nummer|=(% style="width: 324px;" %)Beschreibung
630 -|(% style="width:83px" %)**1**|(% style="width:324px" %)Hier werden die **ClientID **und **TenantID** eingeblendet.
631 631  
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
632 632  
633 633  
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.
634 634  
635 635  
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.
636 636  
637 637  
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:
638 638  
578 +[[image:image-20250513133105-1.png]]
639 639  
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:
640 640  
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.
591 +
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 +
641 641  
b4it_Anbindung_MSGraph.pdf
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.kprummer
Größe
... ... @@ -1,0 +1,1 @@
1 +73.7 KB
Inhalt
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