Zum Inhalt springen

Änderungen von Dokument Kontaktmanagement

Zuletzt geändert von Katharina Prummer am 2025/05/16 10:59
Von Version 70.1
bearbeitet von Katharina Prummer
am 2025/02/28 10:48
Ä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,14 +419,6 @@
419 419  
420 420  
421 421  
422 -
423 -
424 -
425 -
426 -
427 -
428 -
429 -
430 430  = Einrichtung Ablagepfad/Auscheckpfad Dokumente =
431 431  
432 432  Vorraussetzung: Sie haben die Berechtigung um in die Programmparameter zu kommen.
... ... @@ -450,8 +450,13 @@
450 450  
451 451  = Einrichtung E-Mail Anbindung =
452 452  
453 -[[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 +)))
454 454  
450 +[[image:image-20250228114149-5.png]]
451 +
455 455  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**).
456 456  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**).
457 457  Je nach dem, welche der drei Optionen man auswählt, verändern sich die Einstellungen.
... ... @@ -464,7 +464,7 @@
464 464  
465 465  == E-Mail Modus IMAP/SMTP ==
466 466  
467 -[[image:Email_Anbindung_IMAP_SMTP.png||height="506" style="float:left" width="770"]]
464 +[[image:image-20250228123954-7.png]]
468 468  
469 469  (% style="margin-left:auto; width:714px" %)
470 470  |=(% style="width: 74px;" %)(((
... ... @@ -475,72 +475,40 @@
475 475  |(% style="width:74px" %)(((
476 476  **1**
477 477  )))|(% style="width:636px" %)(((
478 -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.
479 479  )))
480 480  |(% style="width:74px" %)(((
481 481  **2**
482 -)))|(% style="width:636px" %)(((
483 -Hier bestimmt man den **E-Mail Timeout**.
484 -**Achtung**: Die Angabe ist in Millisekunden. 1 Sekunde entspricht hier also 1000 Millisekunden.
485 -)))
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.
486 486  |(% style="width:74px" %)(((
487 487  **3**
488 488  )))|(% style="width:636px" %)(((
489 -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.
490 490  )))
491 -|(% style="width:74px" %)(((
492 -**4**
493 -)))|(% style="width:636px" %)(((
494 -Hier bestimmt man das **Verfahren**, wie der **Login **zu erfolgen hat.
495 -)))
496 -|(% style="width:74px" %)(((
497 -**5**
498 -)))|(% style="width:636px" %)(((
499 -Hier werden die **ClientID **und **TenantID** eingeblendet.
500 -)))
501 -|(% style="width:74px" %)(((
502 -**6**
503 -)))|(% style="width:636px" %)(((
504 -Hier werden **Absender **und **Empfänger **festgelegt. Möchte man die Einstellung testen, kann man dies über den **Testmail**-Button tun.
505 -)))
506 -|(% style="width:74px" %)(((
507 -**7**
508 -)))|(% style="width:636px" %)(((
509 -Hier legt man die **Anmeldeoption **fest.
510 -)))
511 511  
512 512  
513 -== E-Mail Modus Outlook ==
514 514  
515 -Gibt nur eine vorrausestzung, dass Outlook installiert sein muss und eingerichtet sein muss mit mindestens einem Konto.
516 516  
517 -[[image:Email_Anbindung_Outlook.png||height="415" style="float:left" width="842"]]
518 518  
519 -(% style="margin-left:auto; width:642px" %)
520 -|=(% style="width: 71px;" %)(((
521 -Nummer
522 -)))|=(% style="width: 564px;" %)(((
523 -Beschreibung
524 -)))
525 -|(% style="width:71px" %)(((
526 -**1**
527 -)))|(% style="width:564px" %)(((
528 -Hier werden die **ClientID **und **TenantID** eingeblendet.
529 -)))
530 -|(% style="width:71px" %)(((
531 -**2**
532 -)))|(% style="width:564px" %)(((
533 -Hier legt man die **Anmeldeoption **fest.
534 -)))
535 535  
536 536  
537 537  
538 538  
494 +== E-Mail Modus Outlook ==
539 539  
496 +Damit die Funktion genutzt werden kann, muss **Outlook lokal installiert** sein und es muss **mindestens ein E-Mail-Konto** in Outlook eingerichtet sein.
540 540  
498 +[[image:image-20250228113650-4.png]]
499 +
500 +(% style="margin-left:auto; width:642px" %)
501 +|=(% style="width: 71px;" %)Nummer|=(% style="width: 564px;" %)Beschreibung
502 +|(% style="width:71px" %)1|(% style="width:564px" %)In der Auswahlliste "Outlook" auswählen
503 +
504 +
505 +
541 541  == E-Mail Modus EWS ==
542 542  
543 -[[image:Email_Anbindung_EWS.png||height="517" width="1067"]]
508 +[[image:image-20250228124752-8.png]]
544 544  
545 545  (% style="width:1066px" %)
546 546  |=(% style="width: 77px;" %)(((
... ... @@ -551,7 +551,7 @@
551 551  |(% style="width:77px" %)(((
552 552  **1**
553 553  )))|(% style="width:985px" %)(((
554 -Möchte man einen **Testdurchlauf **mit dem **EWS-Zugang** starten, gelingt dies über diese Schaltfläche.
519 +In der Auswahlliste "EWS" auswählen
555 555  )))
556 556  |(% style="width:77px" %)(((
557 557  **2**
... ... @@ -563,17 +563,13 @@
563 563  )))|(% style="width:985px" %)(((
564 564  Hier bestimmt man das **Verfahren**, wie der **Login **zu erfolgen hat.
565 565  )))
531 +|(% style="width:77px" %)4|(% style="width:985px" %)Hier kann eine fester E-Mail Adresse und das Passwort zu einem Postfach angeben.
566 566  |(% style="width:77px" %)(((
567 -**4**
533 +**5**
568 568  )))|(% style="width:985px" %)(((
569 569  Hier werden die **ClientID **und **TenantID** eingeblendet.
570 570  )))
571 571  |(% style="width:77px" %)(((
572 -**5**
573 -)))|(% style="width:985px" %)(((
574 -Hier werden **Absender **und **Empfänger **festgelegt. Möchte man die Einstellung testen, kann man dies über den **Testmail**-Button tun.
575 -)))
576 -|(% style="width:77px" %)(((
577 577  **6**
578 578  )))|(% style="width:985px" %)(((
579 579  Hier legt man die **Anmeldeoption **fest.
... ... @@ -581,40 +581,64 @@
581 581  |(% style="width:77px" %)(((
582 582  **7**
583 583  )))|(% style="width:985px" %)(((
584 -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.
585 585  )))
586 -|(% style="width:77px" %)(((
587 -**8**
588 -)))|(% style="width:985px" %)(((
589 -Hier bestimmt man **Kürzel **für das **Hauptdokument **(Beleg) und für **zusätzliche Anlagen **fest.
590 -)))
591 591  
548 +== E-Mail Modus MS Graph ==
592 592  
550 +{{info}}
551 +Die **Nutzung **des E-Mail Modus **MS Graph** **setzt voraus**, dass der **Webservice aktiv **ist.
552 +{{/info}}
593 593  
554 +=== Einrichtung E-Mail-Anbindung mit MS-Graph und Azure in base4IT ===
594 594  
595 595  
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
596 596  
597 597  
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.
598 598  
599 599  
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.
600 600  
601 601  
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:
602 602  
578 +[[image:image-20250513133105-1.png]]
603 603  
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:
604 604  
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.
605 605  
592 +[[image:image-20250513133410-2.png]]
606 606  
607 -== E-Mail Modus MS Graph ==
608 608  
609 -{{info}}
610 -Die **Nutzung **des E-Mail Modus **MS Graph** **setzt voraus**, dass der **Webservice aktiv **ist.
611 -{{/info}}
595 +**4. Konfiguration base4IT**
612 612  
613 -[[image:Email_MS-Graph.png||height="624" style="float:left" width="1073"]]
597 +[[image:image-20250228125914-9.png||height="295" width="974"]]
614 614  
615 615  (% style="margin-left:auto; width:411px" %)
616 616  |=(% style="width: 83px;" %)Nummer|=(% style="width: 324px;" %)Beschreibung
617 -|(% style="width:83px" %)**1**|(% style="width:324px" %)Hier werden die **ClientID **und **TenantID** eingeblendet.
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.
618 618  
619 619  
620 620  
... ... @@ -622,9 +622,4 @@
622 622  
623 623  
624 624  
625 -
626 -
627 -
628 -
629 -
630 630  
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