UpdateRetentionSourceAuthority

/srv.asmx/UpdateRetentionSourceAuthority

<root success="true" />

<root success="false" error="[ErrorCode] Error message" />

GET /srv.asmx/UpdateRetentionSourceAuthority?authenticationTicket=abc123-def456&currentAuthorityName=SEC&newAuthorityName=SEC%20-%20Securities%20and%20Exchange%20Commission HTTP/1.1
Host: server.example.com

POST /srv.asmx/UpdateRetentionSourceAuthority HTTP/1.1
Content-Type: application/x-www-form-urlencoded

authenticationTicket=abc123-def456&currentAuthorityName=SEC&newAuthorityName=SEC - Securities and Exchange Commission

POST /srv.asmx HTTP/1.1
Content-Type: text/xml; charset=utf-8
SOAPAction: "http://tempuri.org/UpdateRetentionSourceAuthority"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <UpdateRetentionSourceAuthority xmlns="http://tempuri.org/">
      <authenticationTicket>abc123-def456</authenticationTicket>
      <currentAuthorityName>SEC</currentAuthorityName>
      <newAuthorityName>SEC - Securities and Exchange Commission</newAuthorityName>
    </UpdateRetentionSourceAuthority>
  </soap:Body>
</soap:Envelope>

<?xml version="1.0" encoding="utf-8"?>
<root success="true" />

<root success="false" error="Current authority not found." />

<root success="false" error="There is already a Retention Source Authority with same name." />

<root success="false" error="Current authority name cannot be empty" />

<root success="false" error="New authority name cannot be empty" />

<root success="false" error="Character length of the Authority Source Name cannot be greater than 64 character. Please enter shorter name." />

async function updateAuthority(currentName, newName) {
    // Validate new name
    if (!newName || newName.trim().length === 0) {
        alert('New authority name cannot be empty');
        return false;
    }

    if (newName.length > 64) {
        alert('Authority name cannot exceed 64 characters');
        return false;
    }

    // Check if new name already exists
    const authorities = await getRetentionSourceAuthorities();
    if (authorities.includes(newName)) {
        alert('An authority with the new name already exists');
        return false;
    }

    // Confirm update
    if (!confirm(`Rename "${currentName}" to "${newName}"?`)) {
        return false;
    }

    const ticket = getUserAuthTicket();
    const formData = new FormData();
    formData.append('authenticationTicket', ticket);
    formData.append('currentAuthorityName', currentName);
    formData.append('newAuthorityName', newName);

    const response = await fetch('/srv.asmx/UpdateRetentionSourceAuthority', {
        method: 'POST',
        body: formData
    });

    const xmlText = await response.text();
    const parser = new DOMParser();
    const xmlDoc = parser.parseFromString(xmlText, "text/xml");

    const success = xmlDoc.querySelector("root").getAttribute("success");
    if (success === "true") {
        console.log("Authority updated successfully");
        return true;
    } else {
        const error = xmlDoc.querySelector("root").getAttribute("error");
        console.error("Failed to update authority:", error);
        alert(error);
        return false;
    }
}

async function getRetentionSourceAuthorities() {
    const ticket = getUserAuthTicket();
    const response = await fetch(
        `/srv.asmx/GetRetentionSourceAuthorities?authenticationTicket=${ticket}`
    );
    const xmlText = await response.text();
    const parser = new DOMParser();
    const xmlDoc = parser.parseFromString(xmlText, "text/xml");

    const authorities = [];
    xmlDoc.querySelectorAll("Authority").forEach(auth => {
        authorities.push(auth.getAttribute("Name"));
    });
    return authorities;
}

using (var client = new SrvSoapClient())
{
    try
    {
        string currentName = "SEC";
        string newName = "SEC - Securities and Exchange Commission";

        // Validate inputs
        if (string.IsNullOrWhiteSpace(newName))
        {
            Console.WriteLine("New authority name cannot be empty");
            return;
        }

        if (newName.Length > 64)
        {
            Console.WriteLine("Authority name cannot exceed 64 characters");
            return;
        }

        // Check if new name already exists
        var authoritiesResponse = await client.GetRetentionSourceAuthoritiesAsync(authTicket);
        var authorities = authoritiesResponse.Descendants("Authority")
            .Select(a => a.Attribute("Name")?.Value)
            .ToList();

        if (authorities.Contains(newName))
        {
            Console.WriteLine("An authority with the new name already exists");
            return;
        }

        // Confirm update
        Console.WriteLine($"Rename '{currentName}' to '{newName}'? (y/n)");
        var confirm = Console.ReadLine();
        if (confirm?.ToLower() != "y")
        {
            Console.WriteLine("Update cancelled");
            return;
        }

        // Perform update
        var response = await client.UpdateRetentionSourceAuthorityAsync(
            authTicket,
            currentName,
            newName
        );

        var root = response.Root;
        if (root.Attribute("success")?.Value == "true")
        {
            Console.WriteLine("Authority updated successfully");
        }
        else
        {
            var error = root.Attribute("error")?.Value;
            Console.WriteLine($"Error: {error}");
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Exception: {ex.Message}");
    }
}

Current: "HIPAA"
New: "HIPAA - Health Insurance Portability and Accountability Act"

1. Call UpdateRetentionSourceAuthority("HIPAA", "HIPAA - Health Insurance...")
2. Verify update with GetRetentionSourceAuthorities
3. Update any R&D schedules that store the authority name

Current: "GDPR - General Data Protction Regulation" (typo: "Protction")
New: "GDPR - General Data Protection Regulation"

1. Call UpdateRetentionSourceAuthority with corrected spelling
2. Verify correction

Multiple authorities with inconsistent formats:
- "SEC"
- "FINRA - Financial Industry Regulatory Authority"
- "Sarbanes-Oxley Act"

Standardize to "CODE - Full Name" format:
1. Update "SEC" → "SEC - Securities and Exchange Commission"
2. Keep "FINRA - Financial Industry Regulatory Authority" (already correct)
3. Update "Sarbanes-Oxley Act" → "SOX - Sarbanes-Oxley Act"