Travailler avec l'adhésion à l'équipe Matter à l'aide de l'API IntApp Walls

L'API IntApp Walls est un outil puissant pour gérer les murs éthiques et contrôler en toute sécurité l'accès aux données sensibles. En tirant parti de ses opérations, les développeurs peuvent interagir efficacement avec les équipes concernées, gérer les adhésions et garantir le respect des exigences de confidentialité.

L'API Intapp Walls est un service Web SOAP qui fournit une interface de programmation pour interagir avec l'application Intapp Walls. Il est déployé en tant que service Web de composant standard.

Par souci de simplicité, l'exemple de code de ce document omet la vérification des erreurs, la gestion des exceptions, la journalisation et d'autres pratiques. Il est destiné à des fins d’illustration uniquement et ne reflète pas nécessairement les meilleures pratiques de codage.

Ici, je passe en revue deux scénarios clés :

1. Récupération et liste des membres de l'équipe concernée.
2. Ajout d'un nouveau membre à une équipe chargée d'un dossier existant.

En comprenant et en utilisant les opérations de l'API IntApp Walls telles que « GetMatterTeamForMatter », « LoadMatterTeam » et « AddUsersToMatterTeam », vous pouvez rationaliser les tâches liées à la gestion éthique des murs. Les exemples suivants incluent des extraits de code et des conseils étape par étape.

Ce document ne couvrira pas les détails de la configuration de l'accès au développement à l'API IntApp Walls. Cependant, la solution de gestion doit être installée sur votre domaine local et le service Web est généralement accessible via un fichier nommé « APIService.svc », qui doit être ajouté comme référence de service dans Visual Studio.

L'exemple de code fait référence aux opérations API IntApp Walls suivantes :

GetMatterTeamForMatter : obtient l'ID de l'équipe chargée du sujet associée au sujet spécifié.
LoadMatterTeam : Charge les propriétés d'une équipe de sujet.
GetDMSUserID : Obtenez l'ID utilisateur DMS. Certaines méthodes API nécessitent l'ID utilisateur DMS pour un utilisateur. Par exemple, la méthode CreateWall() requiert que l'ID utilisateur soit celui du DMS, et non l'ID du chronométreur de l'utilisateur ou l'ID du système d'enregistrement. Cette méthode peut être utilisée pour obtenir l'ID utilisateur DMS en fonction d'un autre ID connu pour l'utilisateur.
LoadMatterTeamMembership : charge l'adhésion à l'équipe du sujet.
GetWarningsIfUserIsIn Included : obtient tous les avertissements qui seraient générés si l'utilisateur spécifié avait accès (c'est-à-dire inclus) à un client ou à un sujet particulier. Cette fonction renvoie tous les avertissements pouvant être générés par des murs éthiques conflictuels.
AddUsersToMatterTeam : ajoute l'utilisateur à une équipe de litige existante avec un rôle spécifié.

Exemple : Récupération et liste des membres de l'équipe Matter
L'extrait de code suivant utilise les opérations de l'API IntApp Walls « GetMatterTeamForMatter » et « LoadMatterTeam » pour récupérer une liste des membres de l'équipe du sujet, puis écrire les détails de l'adhésion à l'équipe dans la console.

Remarques :
• Travailler avec l'API IntApp nécessite généralement des privilèges spécifiques, souvent accordés à un compte de service disposant d'un accès IntApp Walls approprié.
• Les références à « intapp_web_api » dans l'extrait de code ci-dessous font référence au nom de votre référence de service API IntApp telle que définie dans Visual Studio.

Étape 1 : Récupérez le numéro d'identification unique de l'équipe chargée du sujet géré par IntApp Walls.
Récupérez l’ID de l’équipe chargée du sujet associée à un sujet spécifié. Cet ID d'équipe chargé du sujet sera ensuite utilisé pour obtenir les détails de l'adhésion à l'équipe concernée.

Pour y parvenir, invoquez l'opération "GetMatterTeamForMatter", qui nécessite un paramètre "matterID". Le « matterID » est généralement un identifiant généré en interne, parfois appelé « numéro de dossier ». Cette valeur est fournie par l'utilisateur ou le programmeur à partir de sa propre source de type Timekeeper.

string matterID = "01234"; // matterID supplied by you
string matterTeamID = String.Empty; // the return value

// get the walls matter team id
// example of matter team id "COOLE-033517"
matterTeamID = intapp_web_api.GetMatterTeamForMatter(matterID);

public static string GetMatterTeamForMatter(string matterID)
{
  intapp_web_api.Matter matter = new intapp_web_api.Matter();
  string matterTeamID = string.Empty;

  try
  {
    intapp_web_api.APIServiceClient intapp_web_api = new intapp_web_api.APIServiceClient();
    matterTeamID = intapp_web_api.GetMatterTeamForMatter(matterID);

    if ((string.IsNullOrEmpty(matterTeamID)))
    {
      matterTeamID = "blank";
    }
  }
  catch (Exception ex)
  {
    if (string.IsNullOrEmpty(matterTeamID) || ex.Message == "Error")
    {
      matterTeamID = "blank";
    }
  }
  return matterTeamID;
}

Étape 2 : Charger les résultats de l'équipe du sujet
Définissez la méthode « LoadMatterTeam » et utilisez la variable unique « matterTeamID » de numéro d'identification de l'équipe de sujets gérée par IntApp Walls obtenue lors de l'exécution de la méthode « GetMatterTeamForMatter » pour appeler la méthode « LoadMatterTeam » afin de récupérer l'équipe de sujets. Parcourez la collection "UserMemberships" au sein de l'équipe du sujet et affichez l'ID et le rôle de l'équipe utilisateur sur la console.

public static intapp_web_api.MatterTeam LoadMatterTeam(string matterTeamID)
{
  intapp_web_api.MatterTeam matterTeam = new intapp_web_api.MatterTeam();

  try
  {
    intapp_web_api.APIServiceClient intapp_web_api = new intapp_web_api.APIServiceClient();
    matterTeam = intapp_web_api.LoadMatterTeam(wallscaseteamid);
  }
  catch (Exception ex)
  {
    throw new Exception(ex.Message.ToString());
  }

  return matterTeam;
}

MatterTeam the_matter_team_list = LoadMatterTeam(wallscaseteamid);

using (APIServiceClient intapp_web_api = new APIServiceClient())
{
  // iterate through the usermemberships collection in the matterteam
  foreach (UserMembership user in the_matter_team_list.UserMemberships)
  {
    string _userid = user.UserId.ToString(); // get the user id
    string _therole = user.Role.ToString(); // get the user role

    // output the user team id and role to the console
    Console.WriteLine($"user team id: {_userid}");
    Console.WriteLine($"user team role: {_therole}");
  }
}

Exemple : Ajouter un nouveau membre à une adhésion existante à une équipe de sujet
S'appuyant sur les opérations « GetMatterTeamForMatter » et « LoadMatterTeam » pour récupérer une liste des membres de l'équipe du sujet, l'extrait de code suivant montre comment utiliser l'API IntApp Walls pour vérifier l'appartenance à l'équipe existante et ajouter un nouveau membre à l'équipe s'il ne l'est pas déjà. un membre.

Remarques :
• La manipulation des équipes IntApp Walls via l'API IntApp nécessite des privilèges spécifiques, qui dépassent la portée de ce document. Le demandeur devra également occuper un rôle d'administrateur de sujet IntApp Walls tel que défini dans IntApp Walls.
• Travailler avec l'API IntApp nécessite généralement des privilèges spécifiques, souvent accordés à un compte de service disposant d'un accès IntApp Walls approprié.
• Les références à « intapp_web_api » dans l'extrait de code ci-dessous font référence au nom de votre référence de service API IntApp telle que définie dans Visual Studio.

Étape 1 : À l'aide de l'opération "GetDMSUserID", obtenez le "sAMAccountName" de l'utilisateur que vous souhaitez ajouter à l'équipe Walls.
Le « sAMAccountName » (Security Account Manager Account Name) est un attribut dans Microsoft Active Directory (AD) qui représente le nom de connexion d'un utilisateur utilisé pour s'authentifier auprès du domaine.

string theid = "jsmith"; // the sAMAccountName ad account name of user to add
string wallsuserid = string.Empty;

wallsuserid = intapp_web_api.GetDMSUserID(UserIDSource.WindowsNetworkLogon, $@"YourDomainName\{theid}") // change "YourDomainName" to your domain name

// check if wallsuserid contains a value
if (string.IsNullOrEmpty(wallsuserid))
{
  Console.WriteLine("the user you are trying to add to Walls team does not exists in Walls");
  return;
}

Étape 2 : Vérifiez si le problème existe dans les murs.

string matterID = "01234"; // matterID supplied by you
string matterTeamID = String.Empty; // the return value

// get the walls matter team id
// example of matter team id "COOLE-033517"
matterTeamID = intapp_web_api.GetMatterTeamForMatter(matterID);

public static string GetMatterTeamForMatter(string matterID)
{
  intapp_web_api.Matter matter = new intapp_web_api.Matter();
  string matterTeamID = string.Empty;

  try
  {
    intapp_web_api.APIServiceClient intapp_web_api = new intapp_web_api.APIServiceClient();
    matterTeamID = intapp_web_api.GetMatterTeamForMatter(matterID);

    if ((string.IsNullOrEmpty(matterTeamID)))
    {
      matterTeamID = "blank";
    }
  }
  catch (Exception ex)
  {
    if (string.IsNullOrEmpty(matterTeamID) || ex.Message == "Error")
    {
      matterTeamID = "blank";
    }
  }
  return matterTeamID;
}

Étape 3 : Si le sujet existe, l'utilisateur est-il déjà membre de l'équipe ?

public static intapp_web_api.MatterTeam LoadMatterTeam(string matterTeamID)
{
  intapp_web_api.MatterTeam matterTeam = new intapp_web_api.MatterTeam();

  try
  {
    intapp_web_api.APIServiceClient intapp_web_api = new intapp_web_api.APIServiceClient();
    matterTeam = intapp_web_api.LoadMatterTeam(wallscaseteamid);
  }
  catch (Exception ex)
  {
    throw new Exception(ex.Message.ToString());
  }

  return matterTeam;
}

MatterTeam the_matter_team_list = LoadMatterTeam(wallscaseteamid);

using (APIServiceClient intapp_web_api = new APIServiceClient())
{
  // iterate through the usermemberships collection in the matterteam
  foreach (UserMembership user in the_matter_team_list.UserMemberships)
  {
    string _userid = user.UserId.ToString(); // get the user id
    string _therole = user.Role.ToString(); // get the user role

    // output the user team id and role to the console
    Console.WriteLine($"user team id: {_userid}");
    Console.WriteLine($"user team role: {_therole}");
  }
}

Étape 4 : L'ajout de l'utilisateur à l'équipe Matter provoquera-t-il un conflit interne ?

string theid = "jsmith"; // the sAMAccountName ad account name of user to add
string wallsuserid = string.Empty;

wallsuserid = intapp_web_api.GetDMSUserID(UserIDSource.WindowsNetworkLogon, $@"YourDomainName\{theid}") // change "YourDomainName" to your domain name

// check if wallsuserid contains a value
if (string.IsNullOrEmpty(wallsuserid))
{
  Console.WriteLine("the user you are trying to add to Walls team does not exists in Walls");
  return;
}

Étape 5 : Enfin, ajoutez l'utilisateur à l'équipe Matter.

string matterID = "01234"; // matterID supplied by you

try
{
  matterTeamID = intapp_web_api.GetMatterTeamForMatter(matterID);
}
catch (Exception ex)
{
  if (ex.Message.Contains("The matter") && ex.Message.Contains("does not exist"))
  {
    Console.WriteLine("the matter does do not exist");
    return;
  }
  else
  {
    Console.WriteLine(ex.Message);
    return;
  }
}

Conclusion
L'API IntApp Walls offre un ensemble complet d'opérations pour gérer les adhésions aux équipes chargées du dossier et protéger les informations sensibles. De la récupération des détails de l'équipe à l'ajout de nouveaux membres tout en vérifiant les conflits, ces fonctions API permettent une intégration transparente avec vos flux de travail et le respect des politiques du mur éthique. Avec une bonne mise en œuvre, la gestion des équipes chargées des dossiers devient un processus rationalisé et efficace qui préserve l'intégrité des données.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!