Administration du connecteur Alfresco

Icone Administration
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
obligatoire Libellé Libellé du compte (visible par les administrateurs)
obligatoire Identifiant identifiant du compte Alfresco ouvert sur l'instance Alfresco cible
obligatoire Mot de passe mot de passe correspondant à l'identifiant ci-dessus
obligatoire Dépôt racine Identifiant du dépôt racine communiqué par l'administrateur Alfresco
obligatoire 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
  • Les métadonnées associées sont paramétrées dans un fichier de 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)
  • Les métadonnées associées sont paramétrées dans un fichier de 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.

results matching ""

    No results matching ""