Administration du connecteur Alfresco
 |
 |
| Menu Administration | Bouton Alfresco |
Pour utiliser cette fonctionnalité, il est nécessaire de disposer des informations techniques nécessaires auprès des administrateurs de l'instance Alfresco cible (version 5)
Ce paramétrage est nécessaire si l'action système "Envoyer vers Alfresco" est utilisée.
A partir de cet écran, il est possible de :
- renseigner l'URL de l'instance cible Alfresco (API)
- ajouter un compte de connexion
- éditer un compte de connexion
- supprimer un compte de connexion
Adresse de l'API Alfresco
il s'agit de l'URL pointant vers l'API d'une instance Alfresco joignable à partir du serveur Maarch Courrier
Ajouter un compte de connexion
Cliquer sur le bouton "Ajouter" du panneau de gauche.
Les paramètres d'un compte de connexion sont :
| Requis | Intitulé rubrique | Donnée |
|---|---|---|
 |
Libellé | Libellé du compte (visible par les administrateurs) |
|
Identifiant | identifiant du compte Alfresco ouvert sur l'instance Alfresco cible |
|
Mot de passe | mot de passe correspondant à l'identifiant ci-dessus |
|
Dépôt racine | Identifiant du dépôt racine communiqué par l'administrateur Alfresco |
|
Entités rattachées | Sélection d'une ou plusieurs entités pour lesquelles ce compte sera utilisé. Il est possible ainsi de lier les entités à des dépôts racines différents. Un seul dépôt par entité |
Il est possible de tester la configuration de connexion vers l'instance Alfresco cible (version 5)
Précisions sur le comportement de l'action système "Envoyer vers Alfresco"
DOSSIER CIBLE
Dossier choisi par l'utilisateur dans l'arborescence à laquelle les droits de son entité lui donnent accès. Dossier préexistant sur Alfresco
Il n'est pas possible de créer un dossier
DOSSIER CONTENEUR
un dossier est créé sous l'arborescence du DOSSIER CIBLE
Règle de nommage : CHRONO du courrier
-> le format du chrono est paramétrable sur Maarch Courrier -> contrainte technique : le caractère "/" s'il est présent, est remplacé par le caractère "_"
DOCUMENT PRINCIPAL
Enregistrement dans le dossier conteneur du document principal du courrier (Tous types de courriers)
- Format : PDF
- Règle de nommage : Objet du courrier
- Métadonnées associées : voir partie configuration
DOSSIER PIECES JOINTES
En cas de présence de pièces jointes, un dossier PIECES JOINTES est créé sous l'arborescence du DOSSIER CONTENEUR L'ensemble des pièces jointes au courrier principal est enregistré dans ce dossier
Révision :
- format : PDF ou XML (si le document original est de type MIME XML)
- Règle de nommage : Objet de la pièce jointe avec concaténation d'un numéro d'ordre incrémental en cas d'objets identiques (_XX)
- Métadonnées associées : voir partie configuration
Le fait qu'un courrier ait fait l'objet d'un envoi réussi vers Alfresco est tracé en base de donnée Maarch courrier. (avec indication de l'arborescence de dépôt cible)
Un historique de l'action est ajouté au courrier sur Maarch courrier.
FICHIER DE CONFIGURATION DES METADONNEES
Il faut placer le fichier de paramètrage des métadonnées au chemin suivant : apps/maarch_entreprise/xml/alfresco.json
Des exemples se trouvent dans le fichier apps/maarch_entreprise/xml/alfresco.json.default
{
"mapping": {
"document" : {
"cm:title": "subject",
"cm:description": "alt_identifier"
},
"attachment" : {
"cm:name": "title"
},
"folderCreation" : {
"cm:title": "un titre"
}
"folderModification" : {
"cm:description": "une description"
}
}
}
Le fichier se constitue d'un tableau (objet) "mapping" qui contient un tableau "document", un tableau "attachment" et peut contenir un ou deux tableaux "folder...".
Le tableau "document" sert à paramètrer les métadonnées envoyées avec le document principal tandis que le tableau "attachment" celui des pièces jointes associées au document.
La première chaine (ex : "cm:title") correspond à la clé envoyée à Alfresco et la deuxième (ex : "subject") à la valeur qui sera prise.
Valeurs possibles pour la tableau "document" :
| Nom | Description |
|---|---|
| subject | Sujet |
| alt_identifier | Numéro chrono |
| doctypeLabel | Libellé du type de document |
| priorityLabel | Libellé de la priorité |
| doc_date | Date du document |
| admission_date | Date d'arrivée |
| destinationLabel | Libellé de l'entité traitante |
| initiatorLabel | Libellé de l'entité initiatrice |
| destUserLabel | Libellé de l'attributaire |
| process_limit_date | Date limite de traitement |
| currentDate | Date courante |
| senderCompany_[numéro expéditeur] | Société de l'expéditeur concerné |
| senderCivility_[numéro expéditeur] | Civilité de l'expéditeur concerné |
| senderFirstname_[numéro expéditeur] | Prénom de l'expéditeur concerné |
| senderLastname_[numéro expéditeur] | Nom de l'expéditeur concerné |
| senderFunction_[numéro expéditeur] | Fonction de l'expéditeur concerné |
| senderAddress_[numéro expéditeur] | Adresse de l'expéditeur concerné |
| customField_[id custom] | Valeur du champ personnalisé concerné |
| fingerprint | Empreinte numérique du document (SHA512 en général) |
| doctypeSecondLevelLabel | Libellé du parent du type de document |
Valeurs possibles pour la tableau "attachment" :
| Nom | Description |
|---|---|
| title | Sujet |
| identifier | Numéro chrono |
| typeLabel | Libellé du type de pièce jointe |
Tableaux "folderCreation" et "folderModification" :
Les tableaux "folderCreation" et "folderModification" sont optionnels, si présent ils servent à paramétrer respectivement les métadonnées envoyés et la mise à jour des métadonnées du dossier conteneur.
La mise à jour des métadonnées ("folderModification") n'intervient qu'à la fin du processus de l'action, elle ne sera pas effectuée s'il y a eu la moindre erreur durant l'action.
Les valeurs pour les tableaux "folderCreation" et "folderModification" sont de simples chaines de caracteres, nombres ou booléen.