Änderungen von Dokument Kontaktmanagement

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

Von Version 79.1
bearbeitet von Katharina Prummer
am 2025/05/13 13:35
Änderungskommentar: Neuen Anhang b4it_Anbindung_MSGraph.pdf hochladen
Auf Version 74.1
bearbeitet von Katharina Prummer
am 2025/02/28 11:38
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -419,6 +419,10 @@
419 419  
420 420  
421 421  
422 +
423 +
424 +
425 +
422 422  = Einrichtung Ablagepfad/Auscheckpfad Dokumente =
423 423  
424 424  Vorraussetzung: Sie haben die Berechtigung um in die Programmparameter zu kommen.
... ... @@ -447,7 +447,7 @@
447 447  Ab Version 25.1 verfügbar
448 448  )))
449 449  
450 -[[image:image-20250228114149-5.png]]
454 +[[image:Programmparameter_Email_04-2024.png||alt="ProgrammParameter_Email_Anbindung.png" height="373" width="915"]]
451 451  
452 452  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**).
453 453  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**).
... ... @@ -461,7 +461,7 @@
461 461  
462 462  == E-Mail Modus IMAP/SMTP ==
463 463  
464 -[[image:image-20250228123954-7.png]]
468 +[[image:Email_Anbindung_IMAP_SMTP.png||height="506" style="float:left" width="770"]]
465 465  
466 466  (% style="margin-left:auto; width:714px" %)
467 467  |=(% style="width: 74px;" %)(((
... ... @@ -472,16 +472,39 @@
472 472  |(% style="width:74px" %)(((
473 473  **1**
474 474  )))|(% style="width:636px" %)(((
475 -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.
476 476  )))
477 477  |(% style="width:74px" %)(((
478 478  **2**
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.
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 +)))
480 480  |(% style="width:74px" %)(((
481 481  **3**
482 482  )))|(% style="width:636px" %)(((
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 +Indem man ein Häkchen setzt, **aktiviert **man die **SSL**. Dies bedeutet, dass...
484 484  )))
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 +)))
485 485  
486 486  
487 487  
... ... @@ -491,6 +491,15 @@
491 491  
492 492  
493 493  
521 +
522 +
523 +
524 +
525 +
526 +
527 +
528 +
529 +
494 494  == E-Mail Modus Outlook ==
495 495  
496 496  Damit die Funktion genutzt werden kann, muss **Outlook lokal installiert** sein und es muss **mindestens ein E-Mail-Konto** in Outlook eingerichtet sein.
... ... @@ -503,9 +503,13 @@
503 503  
504 504  
505 505  
542 +
543 +
544 +
545 +
506 506  == E-Mail Modus EWS ==
507 507  
508 -[[image:image-20250228124752-8.png]]
548 +[[image:Email_Anbindung_EWS.png||height="517" width="1067"]]
509 509  
510 510  (% style="width:1066px" %)
511 511  |=(% style="width: 77px;" %)(((
... ... @@ -516,7 +516,7 @@
516 516  |(% style="width:77px" %)(((
517 517  **1**
518 518  )))|(% style="width:985px" %)(((
519 -In der Auswahlliste "EWS" aushlen
559 +Möchte man einen **Testdurchlauf **mit dem **EWS-Zugang** starten, gelingt dies über diese Schaltfläche.
520 520  )))
521 521  |(% style="width:77px" %)(((
522 522  **2**
... ... @@ -528,13 +528,17 @@
528 528  )))|(% style="width:985px" %)(((
529 529  Hier bestimmt man das **Verfahren**, wie der **Login **zu erfolgen hat.
530 530  )))
531 -|(% style="width:77px" %)4|(% style="width:985px" %)Hier kann eine fester E-Mail Adresse und das Passwort zu einem Postfach angeben.
532 532  |(% style="width:77px" %)(((
533 -**5**
572 +**4**
534 534  )))|(% style="width:985px" %)(((
535 535  Hier werden die **ClientID **und **TenantID** eingeblendet.
536 536  )))
537 537  |(% style="width:77px" %)(((
577 +**5**
578 +)))|(% style="width:985px" %)(((
579 +Hier werden **Absender **und **Empfänger **festgelegt. Möchte man die Einstellung testen, kann man dies über den **Testmail**-Button tun.
580 +)))
581 +|(% style="width:77px" %)(((
538 538  **6**
539 539  )))|(% style="width:985px" %)(((
540 540  Hier legt man die **Anmeldeoption **fest.
... ... @@ -542,8 +542,13 @@
542 542  |(% style="width:77px" %)(((
543 543  **7**
544 544  )))|(% style="width:985px" %)(((
545 -Hier kann der Exchange Web Service Zugang getestet werden.
589 +Hier bestimmt man den **Ablageordner**. Soll das ganze automatisch verlaufen, setzt man ein Häkchen bei **versendete UP-Belege im Ordner ablegen**.
546 546  )))
591 +|(% style="width:77px" %)(((
592 +**8**
593 +)))|(% style="width:985px" %)(((
594 +Hier bestimmt man **Kürzel **für das **Hauptdokument **(Beleg) und für **zusätzliche Anlagen **fest.
595 +)))
547 547  
548 548  == E-Mail Modus MS Graph ==
549 549  
... ... @@ -551,55 +551,11 @@
551 551  Die **Nutzung **des E-Mail Modus **MS Graph** **setzt voraus**, dass der **Webservice aktiv **ist.
552 552  {{/info}}
553 553  
554 -=== Einrichtung E-Mail-Anbindung mit MS-Graph und Azure in base4IT ===
603 +[[image:Email_MS-Graph.png||height="624" style="float:left" width="1073"]]
555 555  
556 -
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
560 -
561 -
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.
566 -
567 -
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.
572 -
573 -
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:
577 -
578 -[[image:image-20250513133105-1.png]]
579 -
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:
584 -
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 599  (% style="margin-left:auto; width:411px" %)
600 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.
607 +|(% style="width:83px" %)**1**|(% style="width:324px" %)Hier werden die **ClientID **und **TenantID** eingeblendet.
603 603  
604 604  
605 605  
... ... @@ -607,4 +607,5 @@
607 607  
608 608  
609 609  
615 +
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-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