Arbeiten mit der Matter-Teammitgliedschaft mithilfe der IntApp Walls-API

Die IntApp Walls API ist ein leistungsstarkes Tool zur Verwaltung ethischer Mauern und zur sicheren Kontrolle des Zugriffs auf sensible Daten. Durch die Nutzung seiner Abläufe können Entwickler effizient mit Materie-Teams interagieren, Mitgliedschaften verwalten und die Einhaltung von Vertraulichkeitsanforderungen sicherstellen.

Die Intapp Walls API ist ein SOAP-Webdienst, der eine programmgesteuerte Schnittstelle für die Interaktion mit der Intapp Walls-Anwendung bereitstellt. Es wird als Standardkomponenten-Webdienst bereitgestellt.

Der Einfachheit halber werden im Beispielcode in diesem Dokument Fehlerprüfung, Ausnahmebehandlung, Protokollierung und andere Vorgehensweisen weggelassen. Es dient nur zur Veranschaulichung und spiegelt nicht unbedingt die besten Codierungspraktiken wider.

Hier gehe ich zwei Schlüsselszenarien durch:

1. Angelegenheitsteammitgliedschaft abrufen und auflisten.
2. Ein neues Mitglied zu einem bestehenden Materie-Team hinzufügen.

Durch das Verständnis und die Verwendung von IntApp Walls-API-Operationen wie „GetMatterTeamForMatter“, „LoadMatterTeam“ und „AddUsersToMatterTeam“ können Sie Aufgaben im Zusammenhang mit der ethischen Wall-Verwaltung rationalisieren. Die folgenden Beispiele enthalten Codeausschnitte und Schritt-für-Schritt-Anleitungen.

Dieses Dokument behandelt nicht die Besonderheiten der Konfiguration des Entwicklungszugriffs auf die IntApp Walls API. Die Verwaltungslösung muss jedoch in Ihrer lokalen Domäne installiert sein und der Webdienst ist normalerweise über eine Datei namens „APIService.svc“ zugänglich, die als Dienstreferenz in Visual Studio hinzugefügt werden sollte.

Der Beispielcode verweist auf die folgenden IntApp Walls API-Vorgänge:

GetMatterTeamForMatter: Ruft die ID des Angelegenheitsteams ab, das mit der angegebenen Angelegenheit verknüpft ist.
LoadMatterTeam: Lädt die Eigenschaften eines Materieteams.
GetDMSUserID: Rufen Sie die DMS-Benutzer-ID ab. Einige der API-Methoden erfordern die DMS-Benutzer-ID für einen Benutzer. Beispielsweise erfordert die CreateWall()-Methode, dass die Benutzer-ID die des DMS ist, nicht die Zeitnehmer-ID eines Benutzers oder die System-ID der Aufzeichnungen. Diese Methode kann verwendet werden, um die DMS-Benutzer-ID mit einer anderen bekannten ID für den Benutzer abzurufen.
LoadMatterTeamMembership: Lädt die Teammitgliedschaft der Angelegenheit.
GetWarningsIfUserIsIncluded: Ruft alle Warnungen ab, die generiert würden, wenn dem angegebenen Benutzer Zugriff auf einen bestimmten Kunden oder eine bestimmte Angelegenheit gewährt (d. h. eingeschlossen) würde. Diese Funktion gibt alle Warnungen zurück, die durch widersprüchliche ethische Mauern generiert werden können.
AddUsersToMatterTeam: Fügt den Benutzer einem vorhandenen Thementeam mit einer angegebenen Rolle hinzu.

Beispiel: Teammitgliedschaft für Angelegenheiten abrufen und auflisten
Das folgende Code-Snippet verwendet die IntApp Walls-API-Operationen „GetMatterTeamForMatter“ und „LoadMatterTeam“, um eine Liste der Matter-Teammitglieder abzurufen und dann die Angaben zur Teammitgliedschaft in die Konsole zu schreiben.

Hinweise:
• Für die Arbeit mit der IntApp-API sind in der Regel bestimmte Berechtigungen erforderlich, die häufig einem Dienstkonto mit entsprechendem IntApp Walls-Zugriff gewährt werden.
• Verweise auf „intapp_web_api“ im folgenden Codeausschnitt beziehen sich auf den Namen Ihrer IntApp-API-Dienstreferenz, wie in Visual Studio definiert.

Schritt 1 Rufen Sie die eindeutige, von IntApp Walls verwaltete Team-ID-Nummer ab.
Rufen Sie die ID des Sachverständigenteams ab, das einem bestimmten Sachverhalt zugeordnet ist. Diese Angelegenheitsteam-ID wird dann verwendet, um die Mitgliedsdetails des Angelegenheitsteams zu erhalten.

Um dies zu erreichen, rufen Sie die Operation „GetMatterTeamForMatter“ auf, die einen „matterID“-Parameter erfordert. Bei der „matterID“ handelt es sich in der Regel um eine intern generierte ID, die manchmal auch als „Fallnummer“ bezeichnet wird. Dieser Wert wird vom Benutzer oder Programmierer aus seiner eigenen Zeitnehmer-Quelle bereitgestellt.

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;
}

Schritt 2: Laden Sie die Matter-Team-Ergebnisse
Definieren Sie die Methode „LoadMatterTeam“ und verwenden Sie die eindeutige, von IntApp Walls verwaltete Matterteam-ID-Nummer „matterTeamID“, die durch die Ausführung der Methode „GetMatterTeamForMatter“ erhalten wurde, um die Methode „LoadMatterTeam“ aufzurufen und das Matterteam abzurufen. Durchlaufen Sie die „UserMemberships“-Sammlung innerhalb des Materieteams und geben Sie die Benutzerteam-ID und -Rolle an die Konsole aus.

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}");
  }
}

Beispiel: Hinzufügen eines neuen Mitglieds zu einer bestehenden Matter-Team-Mitgliedschaft
Aufbauend auf den Vorgängen „GetMatterTeamForMatter“ und „LoadMatterTeam“ zum Abrufen einer Liste von Matter-Teammitgliedern zeigt der folgende Codeausschnitt, wie Sie mit der IntApp Walls-API die vorhandene Teammitgliedschaft überprüfen und dem Team ein neues Mitglied hinzufügen können, falls dies noch nicht geschehen ist ein Mitglied.

Hinweise:
• Für die Manipulation von IntApp Walls-Teams über die IntApp-API sind bestimmte Berechtigungen erforderlich, die den Rahmen dieses Dokuments sprengen. Der Anforderer muss außerdem in einer IntApp Walls-Angelegenheitsadministratorrolle sein, wie in IntApp Walls definiert.
• Für die Arbeit mit der IntApp-API sind in der Regel bestimmte Berechtigungen erforderlich, die häufig einem Dienstkonto mit entsprechendem IntApp Walls-Zugriff gewährt werden.
• Verweise auf „intapp_web_api“ im folgenden Codeausschnitt beziehen sich auf den Namen Ihrer IntApp-API-Dienstreferenz, wie in Visual Studio definiert.

Schritt 1: Rufen Sie mit der Operation „GetDMSUserID“ den „sAMAccountName“ des Benutzers ab, den Sie dem Walls-Team hinzufügen möchten.
Der „sAMAccountName“ (Security Account Manager Account Name) ist ein Attribut in Microsoft Active Directory (AD), das den Anmeldenamen eines Benutzers darstellt, der zur Authentifizierung bei der Domäne verwendet wird.

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;
}

Schritt 2: Überprüfen Sie, ob die Materie in Wänden vorhanden ist.

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;
}

Schritt 3: Wenn die Angelegenheit existiert, ist der Benutzer bereits ein Teammitglied?

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}");
  }
}

Schritt 4: Wird das Hinzufügen des Benutzers zum Matter-Team zu einem internen Konflikt führen?

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;
}

Schritt 5: Schließlich fügen Sie den Benutzer dem Matter-Team hinzu.

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;
  }
}

Fazit
Die IntApp Walls-API bietet eine umfassende Reihe von Vorgängen zur Verwaltung der Teammitgliedschaften von Sachverständigen und zum Schutz sensibler Informationen. Vom Abrufen von Teamdetails bis hin zum Hinzufügen neuer Mitglieder und der Prüfung auf Konflikte ermöglichen diese API-Funktionen eine nahtlose Integration in Ihre Arbeitsabläufe und die Einhaltung ethischer Wall-Richtlinien. Mit der richtigen Implementierung wird die Verwaltung von Sachverständigenteams zu einem optimierten und effizienten Prozess, der die Datenintegrität wahrt.

Das obige ist der detaillierte Inhalt vonArbeiten mit der Matter-Teammitgliedschaft mithilfe der IntApp Walls-API. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!