Partner Management

Un article de Typo3 CMS / Documentation Typo3 / Support Typo3.

EXT : Partner Management

Clé d'extension : partner

Copyright 2004 - 2005, typo3@bruehlmeier.com, <typo3@bruehlmeier.com>

Ce document est publié sous licence Open Content disponible sur http://www.opencontent.org/opl.shtml

Le contenu de ce document est relatif à TYPO3 -Gnu/GPL CMS/Framework disponible sur http://www.typo3.com

[modifier] Introduction

[modifier] A quoi ça sert ?

Cette extension manipule tout ce qui est en relation avec le management des associés (personnes, organisations) aussi bien que les rapports entre associés. Donc fondamentalement, cette extension est pour tout ceux ayant besoin de stocker des types de données en relation avec des gens/organisations.

Disons que vous êtes l'administrateur d'un club. Vous pourriez vouloir avoir une base de données pouvant stocker tout les membres du club, mais aussi quelles occupations chaque membre à (par exemple : le président, le caissier, etc.) et quelle type de rapport ils ont (par exemple : Il y a un groupe qui organise des jeux, donc vous auriez une organisation 'Organisateur de Jeux' et les membres en relation avec cette organisation).

Quelques fonctionnalités de cette extension inclues :
- Création d'enregistrements d'associés (personnes, organisations) avec tout types de données en relation ( beaucoup de données d'adresses, contacts illimités, information par associé, status marital, date d'anniversaire, religion, passe-temps, occupations, etc.)
- Maintiens des liaisons entre associés avec types de liaisons librement définissables (comme 'est membre de' ou 'est le mentor de ').
- Module backend (Web>associé) avec trois sous modules
- Recherche : chercher des associés et éditer directement les associés trouvés.
- Rapports : Voir ou télécharger (comme CSV ou PDF) des rapports prédéfinis (par exemple : liste de Date de naissance ou Vue d'ensemble ou rapports) ou ses propres rapports créés avec le concepteur de rapport.
- Outils : Assigner un utilisateur frontend existant aux enregistrements d'associés utilisant des critères de sélection variable ou créer vos propres rapports en utilisant le concepteur de rapport.
- Possibilité de lier un associé à un utilisateur frontend et synchroniser automatiquement les données appropriés.
- Avec l'extension supplémentaire partner_fe (toujours en état alpha) il est possible d'afficher des enregistrements d'associé dans le Frontend et de maintenir ses propres données associé (basé sur l'utilisateur FE assigné).

Le modèle de données ci-dessous est basé sur les normes ouvertes suivant par OASIS (http://www.oasis-open.org). Cela devrait rendre plus facile l'échange de donnée avec d'autres outils de management d'associé.
- XNAL V2.0 : Langue extensible de nom et d'adresse (http://www.oasis-open.org/committees/ciq/ciq.html#4)
- xCIL : Langue extensible d'information client (http://www.oasis-open.org/committees/ciq/ciq.html#7)
- xCRL : Langue extensible de rapport client (http://www.oasis-open.org/committees/ciq/ciq.html#8)

[modifier] Photos d'écran

Maintiens d'associé

Information générale

Contact-Infos / rapports

Maintiens de rapport

Information de contact

Recherche d'associé

Liste de date d'anniversaire

Vue d'ensemble des rapports

Concepteur de rapport

[modifier] Configuration

[modifier] Installation

Cette extension dépend de l'extension static_info_tables. Elle doit être installée avant de pouvoir installer l'extension Associé. Veuillez noter que cette extension à besoin de Typo3 version 3.8.0 ou supérieur à cause du fait qu'il utilise un hameçon dans TCEmain n'étant pas disponible dans les version précédente.

Après l'installation, vous pouvez aussi choisir de désactiver la fonction 'divider2tabs', cela veux dire que l'enregistrement associé sera affiché en une grande forme au lieu d'utiliser des onglets. Ce n'est pas recommandé. Si vous voulez ajouter le support PDF pour les rapport de concepteur, vous devez installer aussi l'extension FPDF.

[modifier] Mise à jour

Si vous mettez à jour à partir de la version 0.4.0 ou inférieur, vous devez executer les étapes suivantes.

- Avant d'installer la nouvelle version, veuillez faire un backup de toutes vos données à partir de l'extension. La façon la plus simple de faire cela est d'utiliser le Manager d'Extension. Cliquez sur l'extension 'Associé', puis choisissez Backup/Delete. Cliquez sur 'Télécharger toutes les données de :' et sauvegardez le fichier SQL.

- Après avoir installé la nouvelle version de l'extension, vous aurez l'écran suivant. Cliquez 'Faire les mises à jour' pour ajouter le nouveau tableau à votre base de donnée.

- Après que ce soit fait, choisissez 'Mise à Jour !' à partir du menu déroulant dans le Manager d'Extension (note : vous pouvez avoir besoin de cliquer sur le bouton une fois de plus avant d'avoir l'entrée Mise à Jour).

- Veuillez faire attention aux avertissements et vérifiez que vous avez vraiment fait un backup de vos données avant de procéder ! Si votre backup est bon, cliquez sur 'Mise à Jour' et votre base de donnée sera modifiée pour fonctionner avec la nouvelle version de l'extension.

[modifier] Référence

Ces propriétés doivent être définies comme étant Tsconfig dans l'en-tête du sys-folder ou sont stockés les enregistrements associés.

tx_partner.fieldVisibility.default {
  tx_partner_main {
    last_name = PUBLIC
    last_name.userChange = 0
    first_name = PUBLIC
    first_name.userChange = 0
    street = PUBLIC
    street.userChange = 1
    postal_code = PUBLIC
    postal_code.userChange = 1
    locality = PUBLIC
    locality.userChange = 1
    country = PUBLIC
    country.userChange = 1
    birth_date = PUBLIC
    birth_date.userChange = 1
  }
  tx_partner_contact_info {
    email = RESTRICTED
    email.userChange = 1
  }
}

[tsconfig:plugin.tx_partner]

[modifier] Administration

Avant que vous ne puissiez utiliser cette extension, vous devrez passer par un certain nombre d'administration. Bien que rien de sérieux. Suivant la complexité de vos besoin, cela peut être fait en 15 minutes. Si vous voulez juste faire un test de conduite de l'extension, vous pouvez simplement importer le test de données inclus. Veuillez vous referez au tutorial 'Test de conduite de l'Extension-Associé' pour plus de détails.

[modifier] Configuration basique

- Premièrement, créez un sys-folder pour tous les enregistrements de configuration que vous êtes sur le point de créer. Les enregistrements de configuration doivent être localisés dans le même dossier que les enregistrements d'associés actuel.
- Allez dans le module Web>List et cliquez sur le sys-folder que vous venez de créer.
- Maintenant cliquez sur le bouton 'Nouvel Enregistrement' et commencez la création des enregistrements de configuration dont vous avez besoin. Ce dont vous avez besoin et si vous choisissez de l'utiliser bien sur tout dépend de ce dont vous avez besoin, bien sur. Voici le maximum que vous pouvez configurer :

• Status. Pour les enregistrements d'associé et information de contact. Exemples : 'Actif', 'Passif', 'A archiver'.
  
• Permission de Contact. Pour les enregistrements d'associé. Exemples : 'Non restreint', 'Ne pas contacter', 'Appeler X avant de contacter'.
  
• Titres. Pour les enregistrements d'associé, type 'Personne'. Exemples : 'Mr.', 'Mrs.', 'Herr', 'Frau', 'Monsieur', 'Madame'.
  
• Types d'organisations. Pour les enregistrements d'associé, type 'Organisme'. Exemples : 'Compagnie', 'Club', 'Groupe de jeune'.
  
• Formes Légales. Pour les associés, types 'Organisme'. Exemples : 'Ltd.', 'AG', 'GmbH'.
  
• Status Marital. Pour les associés, type 'personne'. Exemples : 'Célibataire', 'Marié', 'Divorcé'.
  
• Religions. Pour les associés, type 'Personne'. Exemple : 'Chrétien', 'Musulman', 'Bouddhiste'.
  
• Métiers. Pour les associés, type 'Personne'. Exemples : 'Educateur', 'Chef de cellule', 'Technicien'.
  
• Passe-temps. Pour les associés, type 'personne'. Exemple : 'Skier', 'Snowboard', 'Lecture', 'Typo3'.
  
• Cours. Pour les associés, type 'Personne'. Exemples : 'Introduction à Typo3', 'Entrainement à Goalie 2005'. Veuillez noter que ce champ peux disparaître dans une future version et qu'il soit intégré avec une véritable extension d'événement.
  
• Types de relations. Pour les rapports. Exemples : 'A pour membre', 'A pour femme', 'A pour enfant'.

[modifier] Explication de configuration d'enregistrement

Pour la plupart des enregistrements de configuration, vous n'aurez besoin que de remplir une courte description. Il y a des enregistrements qui offre un peu plus, alors jetons y un oeil.

Enregistrements de status

Vous pouvez utiliser ceci pour vos propres intérêts, par exemple si vous avez un club avec des membres actifs et passifs, vous pourriez vouloir utiliser ce champ pour cela. Dans la version actuelle 'au 06/2005), il n'y a pas de fonctionnalité au delà de ce champ. Cela pourrais changer dans une prochaine version, par exemple en cachant les enregistrements avec un certains status.

Quand vous créez un nouveau status, choisissez alors le tableau ou le status peut être utilisé. Le status ne s'afficherait que pour les tableaux sélectionnés.

Titres

Même chose ici, description (courte) et description. Mais il y a un troisième champ : 'Titre de lettre par défaut'. Ce n'est pas encore utilisé par l'extension elle même (au 06/2005), mais le sera dans le future. La raison derrière cela est pour le mailing de masse. Si vous n'entrez pas de titre de lettre différent pour un associé, alors ce titre par défaut sera utilisé pour l'associé. Exemple : Le titre est 'Mr.', vous pouvez entrer quelque chose comme 'Cher Mr.' en tant que 'Titre de lettre par défaut'.

Types de rapports

Sans compter les champs de description, il y a encore plus d'information importante à compléter. Avant que vous ne définissiez les types de rapports, soyez sûr d'avoir compris le concept derrière ! Vous pourriez vouloir lire l'excursion sur 'Associé Principal ou Secondaire' plus haut. La chose la plus importante à comprendre est que chaque type de rapport devrait refléter une 'direction' clairde laquelle associé principal et secondaire peut être dérivé. Sinon, vous aurez des problèmes à définir les hiérarchies, par exemple.

Le meilleur moyen de pratiquer est de former une phrase courte au lieu de juste un mot : 'A pour membre' par exemple montre clairement que l'associé principal doit être l'organisme et le secondaire doit être l'associé. 'A pour femme' montre clairement que l'associé principal sera toujours le mari, l'associé secondaire sera la femme (Oui, vous pouvez aussi opter pour 'A pour mari' ... :-) faites justes une phrase unique). Mais 'Est marié à' est un mauvais exemple, car il n'est pas clair de qui est quoi.

Ensuite vous avez besoin de définir pour quel catégorie de rapports ce type peut être utilisé. 'A pour femme' par exemple, est clairement une option uniquement pour la catégorie 'Personne – Personne'. Par contre 'A pour membre' peut être éligible pour, à la fois, 'Organisme – Personne' et 'Organisme – Organisme', étant donné que le membre peut être soit une personne ou un organisme.

Les titres des rapports dépend aussi du concept d'associé Principal/Secondaire. Mettez vous simplement dans la position de l'associé principale et formulez ce qu'est le rapport par rapport à l'associé secondaire. C'est ce que vous utiliserez pour le premier champ de titre. Et l'opposé, bien sur, pour le second champ.

Exemple : Le type de rapport 'A pour membre' deviendrait 'A pour membre' comme 'Titre de rapport d'associé principal' et 'Est membre de' comme 'Titre de rapport d'associé secondaire'.

Ces valeurs seront affichées dans la boite vue d'ensemble de rapport en haut de l'enregistrement d'associé.

[modifier] Recommendations supplémentaires

Augmentez la taille maximum du titre

La taille maximum du titre dans la configuration standard de Typo3 et de 30 caractères. Ce peux être malvenu, surtout pour l'affichage d'infos de contacts dans la vue-associé. Pour améliorer son utilisation, il est recommandé de configurer la taille maximum du titre à une valeur aux alentours de 50.

• Allez dans Setup
• Changez la taille maximum du titre à la valeur désirée

Configurer un Utilisateur Backend

Si vous voulez configurer un utilisateur Backend pour celui en charge des enregistrements de rédaction des associés, vous pourriez vouloir créer deux nouveaux groupes backend : un pour la rédaction standard des associés et un pour les associés admins. Les admins auront aussi l'autorisation de créer/changer les valeurs de configuration comme décrit ci-dessus (status, titre, rapport, type, etc.). Le rédacteur standard d'associé n'a accès qu'aux enregistrements-associés par Web>Module associé, qui assure de même qu'aucun enregistrement d'info de contact ne sera jamais directement édité en utilisant Web>Module List, car cela résulterait en la perte du lien vers l'enregistrement associé.

Groupe BE pour les associés rédacteurs réguliers.

• Inclure Liste d'accès -> Vérifié
• Modules : Web, Web>Associé, Utilisateur, Utilisateur>Configuration
• Tableaux (Listing et Modification) : Utilisateur Site Web, Associé, Information de contact, Rapports
• Champs d'exclusion autorisé : Suivant vos besoins. Soyez conscients que presque tous les champs-associé sont des champs d'exclusion, donc si vous n'autorisez pas au moins quelques champs ici, vous n'aurez rien à rédiger...
• Montant DB : Recommandé pour monter le sys-folder avec vos enregistrements-associé
• Configuration TS

 # Disable the context menu in the folders list
options.pageTree.disableIconLinkToContextmenu = 1

 # Improved overview in the Web>List module
mod.web_list.listOnlyInSingleTableView = 1

Groupe BE pour les admins associés

• Inclure Liste d'accès -> Vérifié
• Modules : Web>List
• Tableaux (listing et modification) : Statut, Permission de contact, Titres, Types d'organisation, Forme légale, Etat civil, Religions, Métiers, Passe-temps, Cours, Type de Rapports, Rapports.
• Champs d'exclusion autorisé : Suivant vos besoins.
• Sous groupes (Important !) : Le groupe BE pour les rédacteurs associé régulier

Configurer les droits appropriés

N'oubliez pas de configurer les droits appropriés pour le sys-folder avec vos enregistremets associés ! Si vous ne le faites pas, les utilisateurs BE ne pourront pas travailler avec les enregistrements associés même si vous êtes assignés au groupe BE comme décrit ci-dessus. Voici ce que vous devez faire.

• Connectez vous en tant qu'admin.
• Allez dans Web>Module d'accès
• Cliquez sur le sys-folder possédant vos enregistrements associés
• Dans le panneau de droite, cliquez sur Changement d'Autorisations
• Permettez au groupe rédacteur associé régulier la permission 'Montrer la Page' et 'Editer Contenu'

A la fin, ca devrait ressembler à ceci :

[modifier] Manuel de l'utilisateur

Cette section considère que vous avez déjà installé l'extension et configuré tout ce qui devait l'être. Si ce n'est pas le cas, voyez les sections Administration et Configuration. On considère aussi que vous avez quelques connaissances de Typo3.

[modifier] Créer un nouvel associé

• Cliquez sur le module Web>associé
• Dans la liste de dossier, cliquez sur le sys-folder ou vous désirez sauvegarder votre nouvel associé.
• Dans le coin supérieur gauche de la partie droite de l'écran, cliquez sur le lien 'Create new partner' (Créer un nouvel associé).
• La première chose que vous devez faire est de décider quel type d'associé vous désirez créer. Il y a deux possibilités : une personne ou une organisation. La différence devrait être évidente. Une personne est toujours un vrai 'être humain' avec toutes les possibilités comme un status marital ou une date de naissance. Une organisation est tout autre chose : cela peux être une organisation, un groupe de personnes, une compagnie ... tout ce que vous voulez.
• Si vous décidez de changer le type d'associé actuellement sélectionné; vous remarquerez que Typo3 rechargera l'écran. Pourquoi ? Parce que les personnes ont des ensembles de champs différents des organisations.
• Ensuite, remplissez tous les champs que vous devez stocker. S'il vous plait, notez que tous les champs sont bien documentés avec un icône comme ceci (aide sensible au contexte). Par conséquent, j'entrerai maintenant juste dans les détails de quelques spécialités.

• Le champ label ne peut pas être remplit. Il sera créé par l'extension associé et affiché une fois que vous aurez sauvegardé l'associé.
• L'onglet 'Contact info/Relationships' vous donne un aperçu de toute info du contact (téléphone, email, etc.) de l'associé aussi bien que ses rapports avec d'autres associés. D'ici vous pouvez également maintenir des info-contact supplémentaire ou des rapports. Plus de choses concernant cela plus tard.
• Dates : Tout types de données supplémentaires en relation avec l'associé. S'il vous plait, faites attention à la façon spécial dont vous devez entrer les dates dans les champs dates de Naissance et Mort. Vous devez toujours entrer les dates dans le format AAAAMMJJ, du au fait que Typo3 stock les dates de façon interne dans le format UNIX ne sachant pas manipuler les dates avant 1970. heureusement, il y a une meilleur solution dans une future version deu coeur de Typo3, mais pour l'instant, faites juste attention d'entrer les dates dans ce format spécial.
• Activités : cochez toute valeur qui s'applique.
• Frontend : Deux choses principales ici :

Vous pouvez lier l'associé à un utilisateur frontend. L'extension synchronisera alors automatiquement le nom et l'adresse (standard) email de l'associé avec l'enregistrement de l'utilisateur FE. C'est particulièrement utile en conjonction avec l'extension partner_fe qui vous permet d'afficher les données-associé dans le Frontend. Lier l'associé à un utilisateur FE vous permet d'éditer les données-associé dans le Frontend.

• Vous pouvez voir et/ou définir les configurations de champ de visibilité pour l'associé. Les champs qui sont configurés pour la vue Frontend (referez vous à la section Configuration pour les détails concernant cela) peuvent être customisé pour chaque associé. Par exemple le champ 'date de naissance' est configuré pour être un champ public. Cependant un associé souhaiterait que cette information soit uniquement visible aux utilisateurs FE connectés. Donc vous pourriez définir le champ 'date de naissance' pour cet associé comme étant 'restreint'. Les valeurs possibles sont :
• Privé : Veut dire que seul l'utilisateur FE assigné peut voir le champ
• Restreint : veut dire que seul les utilisateurs FE connectés peuvent voir le champ
• Publique : Veut dire que tout les utilisateurs sur le site web peuvent voir le champ.
  

Notez, s'il vous plait, que les résultats actuels de ces configurations sont sujettes à l'implémentation du plugin FE utilisant ces valeurs. Les effets mentionnés ci dessus sont la façon de comment réagit l'extension partner_fe à ces configurations.

[modifier] Créer un nouveau relation

• Afin de créer un nouveau relation, vous devrez ouvrir un associé existant pour l'éditer.
• Dans l'onglet 'Contact info/Relationships', vous pouvez créer un nouveau rapport. Vous devez savoir si l'associé actuel est l'associé primaire ou secondaire du rapport. Si vous n'êtes pas sur de ce qu'est un associé primaire ou secondaire dans un rapport,jetez un oeil à l'excursion 'Associé primaire ou secondaire' ci dessous.
• Choisissez le type de relation. Une fois de plus, vous pourriez vouloir lire l'excursion ci dessous si vous n'êtes pas sur de ce que c'est.
• Remplissez les champs restants (j'imagine que l'aide sensible au contexte devrait être suffisante ici) et sauvegardez.
• Vous voyez maintenant la vue d'ensemble des rapports mis à jours. Vous pourriez vouloir vérifier l'associé que vous venez de connecter pour voir ce qui est la !

Excursion : Associé Primaire ou Secondaire ?

Un relation est toujours constituée d'exactement deux associés. L'un est l'associé primaire, l'autre est l'associé secondaire. Le type de relation définie quel type de relation les deux associés ont. Disons, par exemple, qu'un des associés est le membre de l'autre, comme le membre d'un club. Alors dans ce cas, le type de relation que vous voulez est 'a comme membre'. Vous pouvez déjà voir pas la formulation du type qu'il y a une direction au relation. Club Y 'a comme membre' Mr. Miller et pas l'inverse. Donc Club Y est l'associé Primaire et Mr. Miller est l'associé Secondaire.

Prenons un autre exemple. Vous voudriez savoir qui appartient à une certaine famille. Votre administrateur a configuré le type de relation 'a comme enfant' et 'a comme femme' à cette attention. Cette fois encore vous voyez à partir de la formulation que chacun de ces types a une 'direction'. Donc Mr. Et Mme. Miller ont un enfant, David. Vous créerez auparavant trois nouveaux associés : Mr. Miller, Mme. Miller et David Miller. Afin d'établir la relation de la famille, vous ouvririez l'enregistrement de Mr. Miller et créeriez un nouveau rapport en tant 'qu'associé Primaire'. Ensuite vous choisiriez le type 'a comme enfant' et entreriez David Miller comme associé Secondaire. Deuxièmement, vous créeriez un nouveau rapport, encore Mr. Miller en tant qu'associé Primaire, choisieriez 'a comme femme' comme étant le type et entreriez Mme. Miller comme associé Secondaire. Et voilà, vous venez juste de créer une famille ! :-)

[modifier] Créer un nouvel enregistrement d'information de contact

• Afin de créer un nouvel enregistrement d'information de contact, vous aurez besoin d'ouvrir un associé existant pour l'éditer.
• Allez sur l'onglet 'Contact Info/Relationships' et cliquez sur le lien ' Create New Contact Information'.
• Le flag standard ne peut être configuré qu'une fois par type d'information de contact. Donc pour l'instant vous ne pouvez avoir qu'une email adresse standard. Si le flag à déjà été configuré pour un autre enregistrement d'information de contact, il sera effacé. Notez s'il vous plait que le flag standard comportera toujours un asterisk au début de son étiquette et sera affiché en gras dans la vue d'ensemble de contact/info.
• Le reste devrait être assez explicatif par soit même. Utilisez l'aide sensible au contexte si vous n'êtes pas sûr d'à quoi sert un champ.
• Sauvegardez l'enregistrement vous ramènera à l'associé. Maintenant vous voyez les informations du contact que vous venez de sauvegarder dans la vue d'ensemble d'info de contact.

[modifier] Web>Associé, Recherche d'associé

• Cliquez sur le module web>associé.
• Dans la liste de dossier, cliquez sur le sys-folder ou vous sauvegardez vos enregistrements d'associés.
• Dans le coin en haut à droite, sélectionnez 'Recherche Associé' (Search Partner).
• Maintenant vous pouvez entrer les paramètres de recherche. Votre dernier requête sera automatiquement affichée. Activer la 'recherche exacte' veut dire que les valeurs à droite des paramètres que vous venez d'entrer seront aussi comparés. Par exemple, un associé avec le nom 'Miller-Brown' ne sera pas trouvé en entrant la valeur 'Miller' si la recherche exacte est activée. Si elle n'est pas activée, cet associé sera trouvé.
• Vous pouvez réduire le nombre d'associé affiché en entrant un nombre plus petit dans le champs 'Nombre Max. de résultats'. Si plus d'associés sont trouvés que défini ici, vous pouvez naviguer dans les résultats en utilisant les liens précédent/suivant.

[modifier] Web>Associé, Rapports>liste de date d'anniversaire

• Cliquez sur le module Web>Associé
• Dans la liste de dossier, cliquez sur le sys-folder ou vous avez sauvegardés vos enregistrements d'associés.
• Dans le coin en haut à droite, sélectionnez 'Rapports', puis 'Liste de date d'anniversaire'
• Le système affichera maintenant une liste de toutes les personnes de ce dossier auxquelles vous avez entré une date d'anniversaire. Vous pouvez choisir le nombre de mois dans le futur durant lesquels vous voulez afficher les anniversaires. Le système calcul aussi l'age de l'associé après son anniversaire et vous pouvez directement choisr d'envoyer un email en cliquant sur le bouton email tout à droite. Ceci lancera votre client email par défaut. Les adresses email utilisés sont les adresses email standard des associés.

[modifier] Web>Associé, Rapports>Vue d'ensemble des Relations

• Cliquez sur le module Web>Associé
• Dans la liste de dossier, cliquez sur le sys-folder ou vous avez sauvegardés vos enregistrements d'associés.
• Dans le coin en haut à droite, sélectionnez 'Rapports', puis 'Vue d'ensemble des relations'
• Vous aurez un affichage de la vue de l'arbre des associés et de leurs relations. C'est bien si vous voulez avoir une vue d'ensemble d'une hiérarchie complexe. Vous pouvez sélectionner un type de relation particulier, étant donné que cela n'a pas de sens de mixer l'affichage de différents types. Le système trouvera alors automatiquement les/l'associé(s) de plus haut niveau et commencera les/la vue(s) de l'arbre a partir de la. Veuillez notez que le symbole (+) des parties de l'arbre ne marche pas encore. Ceci est planifié pour une prochaine version de l'extension.

[modifier] Web>Associé, Outils>Changement massif de Relations

Ce sous module peut être très utile si vous devez changer plusieurs relations en une fois. Par exemple, vous pourriez vouloir entrer la structure de l'équipe de votre club. Vous auriez alors à entrer plusieurs relations, au moins un pour chaque membre de l'équipe. Avec cet outil, vous sélectionnez l'équipe à laquelle vous voulez assigner des membres en tant qu'associé principal. Ensuite vous cherchez tout les membres de l'équipe en remplissant simplement le formulaire et avec un simple clic supplémentaire vous pouvez créer toutes les relations d'un coup.

Voici comment faire étape par étape :

• Cliquez sur le module Web>Associé
• Dans la liste de dossier, cliquez sur le sys-folder ou vous avez sauvegardés vos enregistrements d'associés.
• Dans le coin supérieur droit, sélectionnez 'Outils', puis 'Changement massif des relations'
  

Maintenant vous devriez avoir un écran ressemblant à ceci :

• Cherchez l'associé principal en entrant le nom à rechercher dans le champ. En cliquant sur le bouton 'recherche', le système recherchera des partenaires avec le nom de recherche entrés dans le champ étiquette.
• Si un seul associé est trouvé, il est directement sélectionné comme associé principal. Si plus d'un associé est trouvé, sélectionnez l'associé correct dans la liste.

• Maintenant vous vous retrouvez sur l'écran principal des outils. Il est divisé en trois onglets : Relations existantes, Nouvelles relations, et Valeurs par défaut.
• De toute évidence, dans l'onglet Relations Existantes, vous avez toutes les relations de l'associé principal sélectionné. Vous pouvez éditer tous les champs en une fois ou vous pouvez aussi effacer des relations multiples en une fois. Vous ne pouvez pas changer les relations. Si vous voulez faire cela, vous devez effacer la relation et la ré-entrer avec le type de relation appropriée. Notez aussi un dispositif pratique : en cliquant sur l'icône de la poubelle, vous pouvez sélectionner/dé-sélectionner tout les relations existantes (utile si vous souhaitez effacer tout les relations en une fois).

• Dans l'onglet Nouvelles Relations, vous avez un nombre de champs vide pour chercher de nouveaux associés secondaire. Comme la recherche d'associé principal, entrez simplement quelques noms de recherche dans le champ 'Associé Secondaire'. Le système cherchera de nouveau pour ces noms dans le champ étiquette. Choisissez l'associé que vous voulez connecter à l'associé principal par le type de relation sélectionnée.

• Dans l'onglet Valeurs par Défaut, vous pouvez définir les valeurs par défaut pour les nouvelles relations et vous pouvez aussi choisir combien de champ de recherche vous voulez. Les valeurs par défauts choisis seront sauvegardés pour le temps où vous serez connectés, ainsi elles peuvent être réutilisées. Le bouton 'Configurer les valeurs par défaut' sauvegardera les valeurs par défauts pour la session et les valeurs seront utilisées pour les nouvelles relations que vous chercherez à partir de ce moment. Si vous voulez appliquer les valeurs par défaut aux relations que vous avez déjà sélectionnées, choisissez 'Forcer les valeurs par défaut pour tout'.

[modifier] Web>Associé, Outils>Rapport de concepteur

• Cliquez sur le module Web>Associé
• Dans la liste de dossier, cliquez sur le sys-folder ou vous avez sauvegardés vos enregistrements d'associés.
• Dans le coin en haut à droite, sélectionnez 'Outils', ensuite 'Rapport de concepteur'

pour créer un nouveau rapport, cliquez sur le lien en haut 'Créer un nouveau rapport'. Pour changer un rapport cliquez sur l'icône stylo à gauche du rapport que vous voulez changer.

• Dans l'onglet 'Général' vous devez définir la portée des données qui doivent être choisies. Pour maintenant, c'est fait en entrant directement l'état SQL dont vous avez besoin.Dans une des prochaine version de l'extension, cela devrait être fait de façon plus facile aux utilisateurs, similaire à la fonction-core utilisé dans Tools>DB Check>Full Search>Advanced Query (Outils>verification DB>Pleine recherche> Requête avancée). Pour les autres champs, référez vous à l'aide sensitive contextuelle si vous avez un doute.
• Dans l'onglet 'Sélection des champs', vous pouvez définir quels champs doivent être affichés à l'écran et quels champs doivent être inclus lors de la création d'un fichier. Pour le rendement écran, vous pouvez aussi définir une longueur maximum.
• Dans l'onglet 'Formats', sélectionnez quels formats sont autorisés pour le téléchargement de fichiers. Veuillez noter : Le format 'PDF' est uniquement disponible si vous avez l'extension FPDF installé dans votre installation de Typo3. Le support XML viendra dans une version future et utilisera les nouvelles fonctions PHP-5. Pour chaque format sélectionné, vous pouvez définir d'autres options spécifiques au format. Cela devrait s'expliquer de lui même.
• Dans l'onglet 'Pré-visualiser', vous avez une pré-visualisation CSV du rapport après sauvegarde. De plus, vous pouvez télécharger le rapport dans tout les formats disponibles.

[modifier] Web>Associé, Outils> Assigner Utilisateur Frontend

Ce sous module peut être utilisé si vous voulez lier des enregistrements d'un utilisateur FE existant à vos enregistrements d'associés. Cela prend un sens particulièrement lorsque vous utilisez aussi le plugin frontend partner_fe. Il y a deux modes pour tracer les utilisateurs FE aux associés. Une des méthodes (la plus précise) est de comparer les adresses email. L'autre compare les noms. Les deux méthodes finissent en une liste de correspondances suggéré que vous pouvez éditer et ensuite faire la mise à jour en masse. Dès que les associés et les utilisateurs FE sont liés, ils sont automatiquement synchronisés, mais seulement dans la direction Associé -> Utilisateur FE (l'enregistrement de l'associé est considéré comme le maître).

• Cliquez sur le module Web>Associé
• Dans la liste de dossier, cliquez sur le sys-folder ou vous sauvegardez vos enregistrements d'associés.
• Dans le coin en haut à droite, sélectionnez 'Outils', puis 'Assigner un utilisateur Frontend'
• Maintenant vous pouvez choisir une des deux méthodes (par email ou par nom, comme décrit ci-dessus).
• Si vous voulez savoir quels utilisateurs FE ne sont pas encore assignés à un associé, choisissez 'Check Completeness'
• La dernière option affiche une liste d'adresses email d'utilisateur FE assignés. Cette option peut être remplacée par une fonction plus avancée dans une version future.

[modifier] Tutorial

[modifier] Test de conduite de l'extension-Associé

Le plus simple pour tester la conduite de cette extension est de créer une nouvelle base de donnée et ensuite utiliser la donnée de démo fournit comme SQL-dump. Pourquoi ne puis-je pas juste inclure un fichier T3X en utilisant la fonctionnalité d'export standard ? Parce que le rapport entre associés et informations de contact est modelé en 1:n, ce qui n'est pas encore supporté par le coeur. Ce qui veux dire que la fonctionnalité d'import/export standard ne marche pas pour cette extension. Cependant, voici une explication étape par étape pour comment tester la conduite de l'extension facilement en utilisant le SQL-dump mentionné auparavant.

1.Créez une nouvelle base de données : Avec le Typo3 Backend démarré, cliquez sur Outils>Installation. Ensuite choisissez l'option 1 : Configuration basique. Faites défiler vers le bas jusqu'à ce que vous trouviez le champ d'entrée de la base de données. Remplissez le nom de la base de données que vous voulez créer dans le champ 'Créer Base de données'. Faites défiler vers le bas et cliquez sur le bouton 'mise à jour localconf.php' et vous aurez un message de succès 'Base de données Xyz Créé' Vous avez maintenant une base de données vide.

2.Maintenant choisissez l'option 2 : Analyseur de Base de Données. Faites défiler vers le bas et cliquez sur le lien 'Tables mises à jour requises COMPARER'. Faites défiler jusqu'au fond et cliquez 'Ecrire sur la base de données'. Vous avez maintenant une base de données vide, mais avec toutes les tables requises.

3.Maintenant cliquez sur 'Décharge de Données statiques IMPORTER'. Choisissez 'importer le fichier entier'CURRENT_STATIC' directement' et cliquez 'Ecrire dans la base de données' Vous avez maintenant importés toutes les données statiques (par exemple pays).

4.Maintenant cliquez sur 'Créer utilisateur «Admin»'. Entrez un nom d'utilisateur et un mot de passe et cliquez sur 'Ecrire dans la base de données'. Vous avez maintenant créé un utilisateur Admin pour vous connecter à votre nouvelle base de données.

5.Maintenant démarrez votre backend (vous pouvez utiliser le lien tout au fond de la page). On vous demandera de vous connecter. Utilisez les données de connexion de l'admin que vous venez juste de créer.

6.Démarrez Outils>phpMyAdmin et cliquez sur 'SQL'. Cliquez sur le bouton 'Parcourir' et choisissez le fichier typo3conf\ext\partner\doc\partner_demo_data.sql. Soyez sûr d'avoir configuré la police en latin1. Cliquez sur le bouton 'Go'. Vous avez maintenant importé toutes les données-démo pour l'extension associé.

7.C'est fait ! Commencez à utiliser l'extension en démarrant le module Web>associé (Soyez sûr de cliquez sur le sys'folder 'Associé', ou tous les enregistrements sont localisés). Appréciez !

[modifier] FAQ

• Q : Pourquoi n'utilisez vous pas le GRSP (Enregistrement de Stockage de Page Général) pour l'enregistrement tx_partner_val*, qu'ils puissent être partagés avec les enregistrements d'associés dans différent sys-folders ?
• R : Le concept actuel (TYPO 3.8.0) du GRSP n'est pas encore prêt pour l'utiliser de cette façon. Par exemple, en utilisant le plugin FE, le GRSP est déterminé à partir de la page ou le plugin FE est localisé. Cependant, ce GRSP doit pointer vers le sys-folder ou les enregistrements associés sont stockés. Puisqu'il n'est pas possible de créer plus d'un GRSP par page, l'enregistrement tx_partner_val* doit être stocké dans le même sys-folder que les enregistrements associés actuels.

[modifier] Problèmes Connus

• Les champs date de naissance et date de décès ne peuvent pas être manipulés par le champ standard de date de TYPO3, étant donné que l'horodateur UNIX ne peux manipuler les dates que de 1970 à 2038. Donc pour le moment, il s'agit juste d'un champ standard d'entrée de string et les dates doivent être entrées exactement dans le format AAAAMMJJ, sans aucune évaluation Javascript. Ensuite la valeur entrée est évaluée en sauvegardant l'enregistrement dans le TCEmain-hook et si ce n'est pas le bon format, il ne sera pas sauvegardé (mais l'utilisateur n'est pas averti)... C'est vraiment moche, je sais. A mon avis, il devrait y avoir un moyen dans le Typo3 standard pour manipuler les champs de dates non-UNIX, incluant les champ-évaluation.
• Quand un associé est effacé, alors les enregistrements de contact en relation ne sont pas effacé. A mon avis, cela pourrait être aussi une tâche pour le support 1:n par le coeur. Si cela ne viens pascela pourrait prendre un hameçon dans le TCE principal, fonction Effacement de Données. Ce problème n'est pas vraiment gênant, étant donné qu'aucune information incorrect ne sera stockée, mais éventuellement remplira la base de données d'enregistrements obsolètes.
• Un nouveau partenaire est créé et sauvegardé. Si vous créez alors une nouvelle information de contact SANS quitter l'écran d'associé, le système ne retournera pas à l'associé nouvellement créé, mais commencera un nouvel associé au retour. Si vous sauvegardez l'associé deux fois ou si vous quittez l'associé avant de sauvegarder d'abord, cela n'arrivera pas. De même l'information de contact n'est pas perdu. J'imagine que cela peut être un bug dans t3lib_BEfunc::editOnClick, mais je ne peux pas encore le vérifier. Donc pour le moment (06-2005), rappelez vous simplement de soit sauvegarder deux fois ou de quitter le nouvel associé avant de créer l'enregistrement d'information de contact...
• Lors du changement de type d'un associé ou d'une information de contact, l'enregistrement est sauvegardé même s'il est incomplet. Si vous quitter alors le nouvel enregistrement sans ajouter les informations manquantes, vous pouvez créer un enregistrement corrompu. Je ne suis pas sûr de comment cela peut être corrigé, étant donné que c'est le comportement standard des formes TCE.

[modifier] Choses à faire

Il reste une liste de choses à faire assez étendue. Veuillez jeter un oeil au fichier TODO.txt dans la racine du dossier de l'extension. Veuillez également noter qu'il s'agit toujours d'une version Beta ! Je reserve le droit de faire des changements incompatibles (Par exemple dans le model de donnée) dans de futures versions.

[modifier] Liste des Modifications

01.09.2005 – Version 0.4.0

• Première version publique

12.10.2005 – Version 0.5.0

• Nouvel outil pour le changement de masse des rapports : Dans le module Web>Associé dans l menu Outil>Changement de masse de rapports
• Changement dans l'API : Les données pour l'objet d'affaire (par exemple l'associé) est toujours disponible, rangés dans $this->data. (habituellement $this->partner ou $this->contactInfo auparavant).
• Supplément dans l'API : Vous pouvez faire une requête d'information supplémentaire pour l'objet associé en appellant $partnerObj->getContactInfo() ou $partnerObj->getRelationships(). L'information sera alors faite disponible, rangée dans contactInfo ou relationship objects dans $partnerObj->contactInfo ou $partnerObj->relationshipsAsPrimary or $partnerObj->relationshipsAsSecondary. Pour des informations détaillées, veuillez vous référer aux doc API.
• L'API pour les rapport est maintenant complété et peut aussi changer et effacer les rapports.
• Changement des tables tx_partner_val_rel_subtypes en tx_partner_val_rel_types. Le 'sous type' précédant est maintenant le 'type'. C'était du à une erreur dans le modèle de donnée. Le 'type' précédant (par exemple organisme-organisme) est actuellement une propriété de type de rapports et est maintenant correctement indiqué comme 'catégories permises'.